--- title: "GitGuardian" slug: "gitguardian" updated: 2025-03-17T16:34:55Z published: 2025-03-17T16:34:55Z canonical: "docs.databee.buzz/gitguardian" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.databee.buzz/llms.txt > Use this file to discover all available pages before exploring further. # GitGuardian GitGuardian is the code security platform. With automated secrets detection and remediation, GitGuardian platform enables Dev, Sec, and Ops to collaborate on a Secure Software Development Lifecycle. More information can be found at [GitGuardian website](https://www.gitguardian.com/monitor-internal-repositories-for-secrets). **Integration Method:** API **Tables**: Account Change (3001), Authentication (3002), Incident Finding (2005) The integration supports the following events. | **Event** | **Description** | | --- | --- | | Audit Logs | Lists all the audit logs. | | Secret Incidents | Retrieves secret incident detected by the GitGuardian dashboard. | This integration supports the following versions. | GitGuardian Version | Secrets Detection Engine v2.131 | | --- | --- | | GitGuardian API version | v1.1.0 | ## Prerequisites - The user should have access to a [GitGuardian workspace](https://dashboard.gitguardian.com/) with Admin privileges. - The user should have access to DataBee console. ## Configuration Overview 1. Generate an API token with the required scopes: 1. audit_logs:read 2. incidents:read 2. Add [GitGuardian](/user-manual/docs/gitguardian#databee-configuration) in the DataBee console with the below parameters. | **DataBee Parameter** | **GitGuardian Parameter** | | --- | --- | | Token | Personal Access Token | ## GitGuardian Configuration 1. Log on to [GitGuardian Workspace](https://dashboard.gitguardian.com/) using a user account with Admin privileges. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/gitguardian-mar2025-image-bci4f4m5.png?sv=2026-02-06&spr=https&st=2026-11-16T13%3A38%3A04Z&se=2026-11-16T14%3A38%3A04Z&sr=b&sp=r&sig=CmW5CQrvU75vHNvT6rplAudDWqOA7iwsRT49YpnG878%3D) 2. Navigate to **Settings.** ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/gitguardian-mar2025-image-ea3hdnwr.png?sv=2026-02-06&spr=https&st=2026-11-16T13%3A38%3A04Z&se=2026-11-16T14%3A38%3A04Z&sr=b&sp=r&sig=nJ%2FXa450eF%2B6L6lo03jtHv8qRWm8c61lcqx2KPc9hbw%3D) 3. Click **Personal access tokens.** ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/gitguardian-mar2025-image-mw9tefr7.png?sv=2026-02-06&spr=https&st=2026-11-16T13%3A38%3A04Z&se=2026-11-16T14%3A38%3A04Z&sr=b&sp=r&sig=wPsb6qAXHK7eM7oS%2BG0mw1eRujrPiubAn%2BkgWjj%2FtDU%3D) 4. Click **+ Create token** button. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/gitguardian-mar2025-image-dx91ceq8.png?sv=2026-02-06&spr=https&st=2026-11-16T13%3A38%3A04Z&se=2026-11-16T14%3A38%3A04Z&sr=b&sp=r&sig=J09X%2BLvu8CZ4pFBrfymxG1yyuCQQWMiz3YOfzhiGN%2Fw%3D) 5. Give an appropriate token name and select Never from the dropdown for ‘Expires’. Make sure to select incidents:read under incidents section. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/gitguardian-mar2025-image-83qcnpam.png?sv=2026-02-06&spr=https&st=2026-11-16T13%3A38%3A04Z&se=2026-11-16T14%3A38%3A04Z&sr=b&sp=r&sig=Dhd452a1%2BGNOc5A8T%2BkrEoVL4%2FWkkiOQu4YqpsN%2B4fQ%3D) 6. Select audit_logs:read and then click **Create token.** ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/gitguardian-mar2025-image-go24y9r9.png?sv=2026-02-06&spr=https&st=2026-11-16T13%3A38%3A04Z&se=2026-11-16T14%3A38%3A04Z&sr=b&sp=r&sig=T7jC0smfQldGSjGI6wiCG%2Bwr1dyXpEHegR2u4JV7%2Fqg%3D) 7. Click the Copy icon and store the generated Personal access token somewhere safe as it will be required later. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/gitguardian-mar2025-image-huixz83y.png?sv=2026-02-06&spr=https&st=2026-11-16T13%3A38%3A04Z&se=2026-11-16T14%3A38%3A04Z&sr=b&sp=r&sig=2xLHS6l253RaEU2SIsM9PZ5q0VwO1x8KI%2ByxZX%2B5oS0%3D) ## DataBee Configuration 1. Login to the DataBee UI, navigate to **Data** > **Data Feeds** and click the **Add New Data Feed** button. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/gitguardian-mar2025-image-nneyuz23.png?sv=2026-02-06&spr=https&st=2026-11-16T13%3A38%3A04Z&se=2026-11-16T14%3A38%3A04Z&sr=b&sp=r&sig=wUvBFIfLklfg2CJEpXtwHZH23xjAopfIC4xgCtXXFdY%3D) 2. Search for the **GitGuardian** and click it. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/gitguardian-mar2025-image-2v9p8y8f.png?sv=2026-02-06&spr=https&st=2026-11-16T13%3A38%3A04Z&se=2026-11-16T14%3A38%3A04Z&sr=b&sp=r&sig=2d8tEYRZgjMKhv41oNt07tAHBtVwmBlC4aakoeUT9Ao%3D) 3. Click on the **API Ingest** option for collection method. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/gitguardian-mar2025-image-7dmjrc23.png?sv=2026-02-06&spr=https&st=2026-11-16T13%3A38%3A04Z&se=2026-11-16T14%3A38%3A04Z&sr=b&sp=r&sig=ros4IXZm419C2KfeAHGg8g8zctOYumTKbDYKncJPyfU%3D) 4. Enter feed contact information and click **Next.** **![A screenshot of a computer AI-generated content may be incorrect.](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/gitguardian-mar2025-image-6ad5uziy.png?sv=2026-02-06&spr=https&st=2026-11-16T13%3A38%3A04Z&se=2026-11-16T14%3A38%3A04Z&sr=b&sp=r&sig=IOALVDxcqUbMAg9iSWPSlrM4ZdxH%2B%2Fhy5TaC%2FiMQDbs%3D)** 5. In the configuration page, confirm the following: - API Base URL: this is the base URL that DataBee will interact with. - Authorization Method: Bearer Token - Token: paste the Personal Access Token generated earlier in the GitLab console. - Event types: preselected for all the event types that integration pulls. ![A screenshot of a computer AI-generated content may be incorrect.](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/gitguardian-mar2025-image-ghzvl5mi.png?sv=2026-02-06&spr=https&st=2026-11-16T13%3A38%3A04Z&se=2026-11-16T14%3A38%3A04Z&sr=b&sp=r&sig=dIQk6vxVMPxUnyNrw14EIONE5KZ8vvwywKLNoJcbEj4%3D) 6. Click **Submit.** ## Troubleshooting Tips - Ensure the token is pasted correctly. Since you cannot view the token after the 1st time, re-create the token, paste it on a text editor to ensure no spaces or unexpected characters are included and reconfigure the DataBee feed. - Ensure the GitGuardian scopes/permissions are correct.