Gapps

Gapps एक सुरक्षा अनुपालन मंच है जो विभिन्न सुरक्षा ढाँचों के विरुद्ध आपकी प्रगति को ट्रैक करना आसान बनाता है।

❄️ Gapps साइट देखें
🏠 क्या आप मुझसे संपर्क करने में रुचि रखते हैं? कृपया हमारे डिस्कॉर्ड में शामिल हों

विषय सूची

1. आरंभ करना
2. सामान्य प्रश्न

नई विशेषताएँ ❄️

• SOC2, NIST CSF, NIST-800-53, CMMC, HIPAA, ASVS, ISO27001, CSC CIS18, PCI DSS और SSF जोड़े गए हैं! इस प्रकार कुल 10 ढाँचे हो गए हैं
• मल्टी-टेनेंसी, OIDC (SSO)
• ऑडिटरों के साथ सहयोग
• जोखिम रजिस्टर
• S3/GCS फ़ाइल भंडारण के लिए

अगली बड़ी विशेषताएँ ❄️

• एकीकरण!

मंच से कैप्चर

नियंत्रण डैशबोर्ड

परियोजना अवलोकन

नियंत्रणों की प्रगति ट्रैक करें

आरंभ करना

प्रलेखन प्रलेखन का पालन करें

सामान्य प्रश्न

यदि Gapps शुरू करने का प्रयास करते समय डेटाबेस कनेक्शन त्रुटि मिलती है, तो आपको अपने env चरों को अद्यतन (या हटाना) होगा

[INFO] Checking if we can connect to the database server: postgresql://db1:db1@localhost/db1
[ERROR] could not connect to server: Connection refused
        Is the server running on host "localhost" (127.0.0.1) and accepting
        TCP/IP connections on port 5432?
could not connect to server: Cannot assign requested address
        Is the server running on host "localhost" (::1) and accepting
        TCP/IP connections on port 5432?

यह सामान्यतः डॉकर के अंदर चलने पर दो चरों को अनसेट करके ठीक किया जा सकता है। यदि आप बाहरी डेटाबेस का उपयोग करना चाहते हैं, तो अगला सामान्य प्रश्न देखें

unset SQLALCHEMY_DATABASE_URI
unset POSTGRES_HOST

डेटाबेस कनेक्शन के लिए env चर सेट करें

db1 मान उपयोगकर्ता नाम, डेटाबेस और पासवर्ड के लिए डिफ़ॉल्ट मान है। यदि आप इसे बदलना चाहते हैं, तो क्रमशः db1 को संबंधित मानों से और होस्ट के लिए postgres को अपडेट करें।

export POSTGRES_HOST=${POSTGRES_HOST:-postgres}
export POSTGRES_PASSWORD=${POSTGRES_PASSWORD:-db1}
export POSTGRES_USER=${POSTGRES_USER:-db1}
export POSTGRES_DB=${POSTGRES_DB:-db1}
export SQLALCHEMY_DATABASE_URI="postgresql://db1:db1@postgres/db1"

डेटाबेस रीसेट करना

पहली बार Gapps शुरू करते समय, यह स्वचालित रूप से डेटाबेस मॉडल तैयार करेगा। यदि आप डेटा रीसेट करना चाहते हैं (जैसे सभी डेटा हटा दें), तो आप RESET_DB env चर सेट कर सकते हैं जैसे export RESET_DB=yes।

विकास के लिए Gapps चलाना

कभी-कभी आप Gapps को डॉकर के बाहर चलाना चाह सकते हैं। आप Postgres कंटेनर शुरू करके और फिर Gapps को अग्रभूमि में शुरू करके ऐसा कर सकते हैं।

1. यहाँ पोर्ट घोषणा को अनकमेंट करें
2. Postgres कंटेनर शुरू करें: docker-compose up -d postgres
3. निम्नलिखित env चर सेट करें:

export POSTGRES_HOST=${POSTGRES_HOST:-localhost}
export POSTGRES_PASSWORD=${POSTGRES_PASSWORD:-db1}
export POSTGRES_USER=${POSTGRES_USER:-db1}
export POSTGRES_DB=${POSTGRES_DB:-db1}
export SQLALCHEMY_DATABASE_URI="postgresql://db1:db1@localhost/db1"

4. export FLASK_CONFIG=development;bash run.sh चलाएँ
5. Gapps चल रहा होना चाहिए और डेटाबेस से जुड़ा होना चाहिए। अब आप कोड में बदलाव कर सकते हैं।

डॉकर डेस्कटॉप के साथ चलाना

1. docker-compose.yml फ़ाइल डाउनलोड करें
2. एक उन्नत कमांड प्रॉम्प्ट खोलें और निर्देशिका बदलें (cd) जहाँ docker-compose.yml फ़ाइल डाउनलोड की गई थी (संभवतः डाउनलोड)
3. docker compose up चलाएँ

डिबगिंग के लिए env चर देखें

docker exec -e ONESHOT=yes gapps env

डेटाबेस माइग्रेशन करें

docker exec -e INIT_MIGRATE=yes -e MIGRATE=yes -e ONESHOT=yes gapps bash run.sh

या

docker-compose up -d
docker exec -it gapps bash
python3 manage.py db migrate
python3 manage.py db stamp head
python3 manage.py db upgrade
exit

मैन्युअल रूप से डेटाबेस बनाना

चेतावनी - इससे डेटाबेस का सारा डेटा हट जाएगा!

docker exec -it gapps bash
python3 tools/check_db_connection.py
python3 tools/check_db_models.py
python3 manage.py init_db

संस्करणों को अपग्रेड करना

1.) Docker Hub से वांछित संस्करण के साथ docker-compose.yml फ़ाइल संपादित करें। कम्पोज़ फ़ाइल में जहाँ भी पुराना संस्करण दिखाई दे (4 उदाहरण होने चाहिए), उसे वांछित संस्करण से अपडेट करें। (जैसे bmarsh13/gapps:3.3.9 -> bmarsh13/gapps:3.4.0)
2.) docker-compose up -d
3.) यदि आवश्यक हो तो डेटाबेस माइग्रेशन करें

Gapps में नए ढाँचे लोड करना

आप UI के अंदर हमेशा एक नया ढाँचा और नियंत्रण बना सकते हैं - लेकिन इसमें बहुत समय लगेगा। इसके बजाय, आप Gapps में एक JSON फ़ाइल लोड कर सकते हैं।

प्रारूप में नियंत्रण और उपनियंत्रण शामिल हैं। नीचे दिया गया स्निपेट एक नियंत्रण का उदाहरण दिखाता है जिसमें एक (1) उपनियंत्रण है, लेकिन आप अपनी इच्छानुसार अनेक जोड़ सकते हैं। नियंत्रण के लिए उपनियंत्रण होना अनिवार्य नहीं है (आप शून्य हो सकते हैं)। हालाँकि यह समझ में आ सकता है यदि आप किसी नियंत्रण को विशिष्ट कार्यों में विभाजित करना चाहते हैं जो ट्रैक किए जा सकें। आइए CIS 18 ढाँचे को एक उदाहरण के रूप में लें। आप सभी 18 "डोमेन" को नियंत्रण के रूप में रख सकते हैं और प्रत्येक डोमेन के अंदर के नियंत्रण Gapps में एक उपनियंत्रण होंगे।

[
    {
        "name": "Limit information system access to authorized users, processes acting on behalf of authorized users or",       
        "description": "Maintain list of authorized users defining their identity and associated role and sync with sys",       
        "guidance": "List approved users, services, and devices, and have logical controls in place to prevent unauthor",
        "ref_code": "AC.L1-3.1.1",
        "system_level": false,
        "subcategory": "Identity & Access Management (IAM)",
        "category": "Access Control",
        "dti": "easy",
        "dtc": "easy",
        "meta": {},
        "subcontrols": [
            {
                "ref_code": "3.1.1.a",
                "name": "Authorized users are identified.",
                "description": "Authorized users are identified.",
                "meta": {},
                "tasks": [
                    {
                        "title": "title of the task",
                        "description": "description of the task"
                    }
                ]
            }
        ]
    }
]

इसके बाद, उपरोक्त JSON प्रारूप को एक फ़ाइल में सहेजें (जैसे my_framework.json लेकिन इसका अंत .json से होना चाहिए)। जब Gapps इसे लोड करेगा तो आपके ढाँचे का नाम फ़ाइल नाम से लिया जाएगा (इस मामले में my_framework)। फ़ाइल को app/files/base_controls/ निर्देशिका में सहेजें। आप FRAMEWORK_FOLDER env चर सेट करके लोड निर्देशिका भी बदल सकते हैं। एक बार जब आपका नया ढाँचा एक फ़ाइल में सहेज लिया जाता है और ढाँचा निर्देशिका में रखा जाता है, तो आप UI के अंदर एक नया टेनेंट बना सकते हैं। Gapps स्वचालित रूप से आपके ढाँचे को लोड करेगा। यदि आप किसी मौजूदा टेनेंट में एक ढाँचा जोड़ना चाहते हैं, तो "टेनेंट" पृष्ठ पर जाएँ, टेनेंट को संपादित करें और "रेलोड फ्रेमवर्क्स" बटन पर क्लिक करें।

निर्माण और पुश करना

docker build -t gapps:3.4.3 .
docker tag gapps:3.4.3 bmarsh13/gapps:3.4.3
docker push bmarsh13/gapps:3.4.3

API प्रमाणीकरण

आप अपने ब्राउज़र में निम्नलिखित रूट देखकर एक API टोकन उत्पन्न कर सकते हैं

# Create token that expires in 15 minutes
<gapps-host>/api/v1/token

# Create token that expires in 30 seconds
<gapps-host>/api/v1/token?expiration=30

# Create token that never expires
<gapps-host>/api/v1/token?expiration=0

और यहाँ बताया गया है कि आप प्रमाणीकरण के लिए टोकन का उपयोग कैसे करते हैं (उदाहरण के रूप में curl)

TOKEN="TOKEN HERE"
curl <gapps-host>/api/v1/tenants -H "token: $TOKEN"