# GCP Integration with ComplianceBot

<mark style="color:blue;">**Integrating GCP**</mark> with <mark style="color:blue;">**ComplianceBot**</mark> allows you to monitor your cloud infrastructure's compliance posture, ensuring adherence to industry standards. This guide will walk you through setting up the integration, running compliance checks, and understanding your compliance results in ComplianceBot

To navigate to the <mark style="color:blue;">**'Integrations**</mark>' section in the ComplianceBot dashboard, follow these steps:

* <mark style="color:orange;">**Access Settings**</mark><mark style="color:orange;">:</mark> Log in to ComplianceBot and go to the <mark style="color:blue;">**Settings**</mark> menu from the main navigation panel.
* <mark style="color:orange;">**Select Integrations**</mark><mark style="color:orange;">:</mark> Within Settings, click on the <mark style="color:blue;">**Integrations**</mark> tab to view the list of supported cloud platforms
* <mark style="color:orange;">**Select GCP**</mark>: From the list of available integrations, choose GCP<mark style="color:blue;">.</mark>

#### <mark style="color:blue;">Sign into GCP and Select Your Project</mark>

* <mark style="color:orange;">**Sign into GCP**</mark><mark style="color:orange;">:</mark> Log into your Google Cloud Platform account.
* <mark style="color:orange;">**Select Your Project**</mark><mark style="color:orange;">:</mark> Choose the project where you want to create a service account for ComplianceBot integration.

<figure><img src="https://3100958617-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8SOAfKaNuQuOj7MI6cUE%2Fuploads%2FwyDl8veedMoA9smgq6kM%2FScreenshot%202024-09-25%20at%204.03.42%20PM.png?alt=media&#x26;token=b68a75d5-73c2-4d87-b08d-85aa9a204798" alt=""><figcaption></figcaption></figure>

#### <mark style="color:blue;">Create a Service Account</mark>

* <mark style="color:orange;">**Navigate to IAM & Admin**</mark><mark style="color:orange;">:</mark> Go to the GCP Console, select “<mark style="color:blue;">IAM & Admin</mark>” and click on “<mark style="color:blue;">Service Accounts</mark>” from the left panel.

<figure><img src="https://3100958617-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8SOAfKaNuQuOj7MI6cUE%2Fuploads%2F0INKhwE8ugC9gJ7YIfuE%2FScreenshot%202024-09-25%20at%204.06.49%20PM.png?alt=media&#x26;token=c0810120-c3cc-4187-8daa-0a36075856aa" alt=""><figcaption></figcaption></figure>

<mark style="color:orange;">**Create a Service Account**</mark><mark style="color:orange;">:</mark> Click on <mark style="color:blue;">“Create Service Account”</mark> and fill in the required fields:

* **Service Account Name**
* **Service Account ID**
* **Description**

<mark style="color:orange;">**Create and Continue**</mark><mark style="color:orange;">:</mark> Click <mark style="color:blue;">“Create and Continue”</mark> to proceed.

<figure><img src="https://3100958617-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8SOAfKaNuQuOj7MI6cUE%2Fuploads%2FZ366330YDh8NYplkJG4f%2FScreenshot%202024-09-25%20at%204.10.18%20PM.png?alt=media&#x26;token=c7c69c7b-abae-4398-bb8d-e424163c4bde" alt=""><figcaption></figcaption></figure>

#### <mark style="color:blue;">Assign Permissions</mark>

#### <mark style="color:orange;">**Assign Viewer Permissions:**</mark> Assign the role <mark style="color:blue;">“Viewer”</mark> to the service account for read-only access.

<mark style="color:orange;">**Complete Setup**</mark><mark style="color:orange;">:</mark> Click <mark style="color:blue;">“Continue,”</mark> then <mark style="color:blue;">“Done”</mark> to finish creating the service account.

<figure><img src="https://3100958617-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8SOAfKaNuQuOj7MI6cUE%2Fuploads%2F8Dtl0A9nurVpJrmUIW7n%2FScreenshot%202024-09-25%20at%204.16.57%20PM.png?alt=media&#x26;token=9a41ef2e-7921-42fc-a97e-ca310ed65b80" alt=""><figcaption></figcaption></figure>

#### <mark style="color:blue;">Generate and Download Keys</mark>

<mark style="color:orange;">**Access the Service Account**</mark><mark style="color:orange;">:</mark> Click on the service account you just created.

<figure><img src="https://3100958617-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8SOAfKaNuQuOj7MI6cUE%2Fuploads%2FRUqzneIJGymWTGPTSKkk%2FScreenshot%202024-09-25%20at%204.25.39%20PM.png?alt=media&#x26;token=fd415b25-be1f-4692-a7fa-7604fa09e105" alt=""><figcaption></figcaption></figure>

* <mark style="color:orange;">**Navigate to the Keys Tab**</mark><mark style="color:orange;">:</mark>  Go to the <mark style="color:blue;">“Keys”</mark> tab and click <mark style="color:blue;">“Add Key.”</mark>

<figure><img src="https://3100958617-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8SOAfKaNuQuOj7MI6cUE%2Fuploads%2FmlExBFQNKvM2GKU6rMoP%2FScreenshot%202024-09-25%20at%204.26.29%20PM.png?alt=media&#x26;token=2292598d-da04-422e-aa8f-923f2de3ea2f" alt=""><figcaption></figcaption></figure>

* <mark style="color:orange;">**Add a New Key**</mark><mark style="color:orange;">:</mark> Select <mark style="color:blue;">“JSON”</mark> as the key type, and a key file will be downloaded to your device.

<figure><img src="https://3100958617-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8SOAfKaNuQuOj7MI6cUE%2Fuploads%2FnSvVyVwUXEKR0eTWM4Tx%2FScreenshot%202024-09-25%20at%204.26.38%20PM.png?alt=media&#x26;token=32fd9aa8-83a0-4a78-8fe5-2d6a1e249a68" alt=""><figcaption></figcaption></figure>

<mark style="color:orange;">**Integrate GCP in ComplianceBot :**</mark> Within Settings, click on the <mark style="color:blue;">**Integrations**</mark> tab to view the list of supported cloud platforms Provide your <mark style="color:blue;">**GCP**</mark> account name in the specified field.

<figure><img src="https://3100958617-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8SOAfKaNuQuOj7MI6cUE%2Fuploads%2FDbRHjDWsML4Ykmqjtao9%2FScreenshot%202024-09-25%20at%204.39.41%20PM.png?alt=media&#x26;token=23c6a4cb-1551-4df0-98e5-60d81f492ea3" alt=""><figcaption></figcaption></figure>

<mark style="color:blue;">**Configure Sync Options**</mark>

<mark style="color:orange;">**Choose Sync Type**</mark>: Select whether you want data to sync automatically or manually.

* If automatic, set the frequency (e.g., daily, weekly). In this example, we’ll proceed with manual syncing.
* Upload the previously downloaded JSON key file into ComplianceBot.

<figure><img src="https://3100958617-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8SOAfKaNuQuOj7MI6cUE%2Fuploads%2FEJxy7HcvCS125yxwvUlC%2FScreenshot%202024-09-25%20at%204.42.55%20PM.png?alt=media&#x26;token=c76ce876-0c2d-49cc-8b36-09f3c6c8481c" alt=""><figcaption></figcaption></figure>

#### <mark style="color:blue;">Test the Connection</mark>

* <mark style="color:orange;">**Test Integration**</mark><mark style="color:orange;">:</mark> Click <mark style="color:blue;">“Test Connection”</mark> to verify the GCP integration.
* <mark style="color:orange;">**Save Settings**</mark><mark style="color:orange;">:</mark> Once the test is successful, click <mark style="color:blue;">“Save”</mark> to finalize the integration.

#### <mark style="color:blue;">Run Manual Compliance Checks</mark>

<mark style="color:orange;">**Initiate Sync**</mark><mark style="color:orange;">:</mark> Go to the <mark style="color:blue;">“Manage”</mark> section under GCP and click <mark style="color:blue;">“Sync Now.”</mark>

<mark style="color:orange;">**Monitor Sync Status**</mark><mark style="color:orange;">:</mark> Wait for the sync status to update to <mark style="color:blue;">“Success.”</mark> This process checks your GCP resources for compliance and security issues.

<mark style="color:orange;">**View Results**</mark><mark style="color:orange;">:</mark> Results will be available in the cloud section once the sync is complete.

<figure><img src="https://3100958617-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8SOAfKaNuQuOj7MI6cUE%2Fuploads%2FFcT46fdl60xzNhXqELSc%2FScreenshot%202024-09-25%20at%204.47.53%20PM.png?alt=media&#x26;token=5ff2f4ea-5a0e-4114-a096-7ffb8efa8f7b" alt=""><figcaption></figcaption></figure>

#### <mark style="color:blue;">Navigate the ComplianceBot Dashboard</mark>

<mark style="color:orange;">**Access the Cloud Section**</mark><mark style="color:orange;">:</mark> View the results of your compliance checks by navigating to the cloud section.

* <mark style="color:orange;">**Summary**</mark><mark style="color:orange;">:</mark> Get a quick overview of your compliance status, including passed and failed tests.
* <mark style="color:orange;">**Resource Breakdown**</mark><mark style="color:orange;">:</mark> View resources categorized by compliance status: compliant, warning, or danger.
* <mark style="color:orange;">**Severity Categorization**</mark><mark style="color:orange;">:</mark> Failed tests are sorted by severity, allowing you to prioritize critical issues.

<figure><img src="https://3100958617-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8SOAfKaNuQuOj7MI6cUE%2Fuploads%2FutPH8G1M7u1dfgWrCthn%2FScreenshot%202024-09-25%20at%205.17.24%20PM.png?alt=media&#x26;token=9588d055-c95a-4210-9336-fd69297b733c" alt=""><figcaption></figcaption></figure>

#### <mark style="color:blue;">Utilize Filters for Detailed Views</mark>

* <mark style="color:orange;">**Framework Filter**</mark><mark style="color:orange;">:</mark> Filter tests based on specific compliance standards like HIPAA.

<figure><img src="https://3100958617-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8SOAfKaNuQuOj7MI6cUE%2Fuploads%2FpfmcBn6A3xP0BmL34V98%2Fimage.png?alt=media&#x26;token=3e94c4d2-d857-4bd8-bef5-62096bd3b909" alt=""><figcaption></figcaption></figure>

* <mark style="color:orange;">**Connector Filter**</mark><mark style="color:orange;">:</mark> Select a particular cloud provider (e.g., AWS, GCP) to focus on its resources.

<figure><img src="https://3100958617-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8SOAfKaNuQuOj7MI6cUE%2Fuploads%2FAqnR5QeOYgwvjSeI5tPR%2FScreenshot%202024-09-25%20at%205.19.55%20PM.png?alt=media&#x26;token=8c7ec95c-507f-4688-bc28-8838addec461" alt="" width="394"><figcaption></figcaption></figure>

* <mark style="color:orange;">**Account Filter**</mark><mark style="color:orange;">:</mark> Narrow results to a specific cloud account for detailed review.

<figure><img src="https://3100958617-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8SOAfKaNuQuOj7MI6cUE%2Fuploads%2F8axTidgtN0s3Sc9ZFNJN%2Fimage.png?alt=media&#x26;token=38e0fe55-a412-426b-b19b-39486fbe38e7" alt="" width="420"><figcaption></figcaption></figure>

* <mark style="color:orange;">**Service Filter**</mark><mark style="color:orange;">:</mark> Focus on specific services, such as Compute Engine or Storage.

<figure><img src="https://3100958617-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8SOAfKaNuQuOj7MI6cUE%2Fuploads%2FndQadAUNBDzFvVb9twOY%2FScreenshot%202024-09-25%20at%205.20.09%20PM.png?alt=media&#x26;token=2c15b97f-784d-4b44-9583-9342ab1f1b68" alt="" width="298"><figcaption></figcaption></figure>

<mark style="color:blue;">**Explore the Tests Tab**</mark>

Access the <mark style="color:blue;">Tests</mark> tab for detailed test outcomes.

* <mark style="color:orange;">**Danger**</mark><mark style="color:orange;">:</mark> Critical issues.
* <mark style="color:orange;">**Warning**</mark><mark style="color:orange;">:</mark> Non-critical issues.
* <mark style="color:orange;">**Compliant**</mark><mark style="color:orange;">:</mark> Passed tests.

<figure><img src="https://3100958617-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8SOAfKaNuQuOj7MI6cUE%2Fuploads%2FXL7VMDdFK6AIKPhruAOE%2FFrame%2035684.png?alt=media&#x26;token=237713f1-120a-41a4-86cc-57b2c8760238" alt=""><figcaption></figcaption></figure>

<mark style="color:blue;">Managing Test Results</mark>

<mark style="color:orange;">**Ignoring a Test**</mark><mark style="color:orange;">:</mark>

* Click the ignore symbol on the right side of the test to move it to the <mark style="color:blue;">“Ignored”</mark> section.
* Ignored tests will no longer impact your compliance score.

<mark style="color:orange;">**Include Ignored Tests**</mark><mark style="color:orange;">:</mark> Toggle the <mark style="color:blue;">“Include Ignored Tests”</mark> switch to view previously ignored tests in&#x20;

<mark style="color:blue;">Export Test Results</mark>

<mark style="color:orange;">**Export Results**</mark><mark style="color:orange;">:</mark> Click the <mark style="color:blue;">“Export”</mark> button to download your compliance test results for reporting or further analysis.your results.

<figure><img src="https://3100958617-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8SOAfKaNuQuOj7MI6cUE%2Fuploads%2FJ00EGdjwh9q90P21UG9n%2FFrame%2035684.png?alt=media&#x26;token=690e6ac5-121b-480c-b6c6-9cf64af9acc4" alt=""><figcaption></figcaption></figure>