--- 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-10-30T11%3A26%3A50Z&se=2026-10-30T12%3A26%3A50Z&sr=c&sp=r&sig=vIe7%2Foc33lZWNRBDTAV9%2FgZiMR3sgCoamv%2FAxENS7PY%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-10-30T11%3A26%3A50Z&se=2026-10-30T12%3A26%3A50Z&sr=c&sp=r&sig=vIe7%2Foc33lZWNRBDTAV9%2FgZiMR3sgCoamv%2FAxENS7PY%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-10-30T11%3A26%3A50Z&se=2026-10-30T12%3A26%3A50Z&sr=c&sp=r&sig=vIe7%2Foc33lZWNRBDTAV9%2FgZiMR3sgCoamv%2FAxENS7PY%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-10-30T11%3A26%3A50Z&se=2026-10-30T12%3A26%3A50Z&sr=c&sp=r&sig=vIe7%2Foc33lZWNRBDTAV9%2FgZiMR3sgCoamv%2FAxENS7PY%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-10-30T11%3A26%3A50Z&se=2026-10-30T12%3A26%3A50Z&sr=c&sp=r&sig=vIe7%2Foc33lZWNRBDTAV9%2FgZiMR3sgCoamv%2FAxENS7PY%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-10-30T11%3A26%3A50Z&se=2026-10-30T12%3A26%3A50Z&sr=c&sp=r&sig=vIe7%2Foc33lZWNRBDTAV9%2FgZiMR3sgCoamv%2FAxENS7PY%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-10-30T11%3A26%3A50Z&se=2026-10-30T12%3A26%3A50Z&sr=c&sp=r&sig=vIe7%2Foc33lZWNRBDTAV9%2FgZiMR3sgCoamv%2FAxENS7PY%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-10-30T11%3A26%3A50Z&se=2026-10-30T12%3A26%3A50Z&sr=c&sp=r&sig=vIe7%2Foc33lZWNRBDTAV9%2FgZiMR3sgCoamv%2FAxENS7PY%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-10-30T11%3A26%3A50Z&se=2026-10-30T12%3A26%3A50Z&sr=c&sp=r&sig=vIe7%2Foc33lZWNRBDTAV9%2FgZiMR3sgCoamv%2FAxENS7PY%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-10-30T11%3A26%3A50Z&se=2026-10-30T12%3A26%3A50Z&sr=c&sp=r&sig=vIe7%2Foc33lZWNRBDTAV9%2FgZiMR3sgCoamv%2FAxENS7PY%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-10-30T11%3A26%3A50Z&se=2026-10-30T12%3A26%3A50Z&sr=c&sp=r&sig=vIe7%2Foc33lZWNRBDTAV9%2FgZiMR3sgCoamv%2FAxENS7PY%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-10-30T11%3A26%3A50Z&se=2026-10-30T12%3A26%3A50Z&sr=c&sp=r&sig=vIe7%2Foc33lZWNRBDTAV9%2FgZiMR3sgCoamv%2FAxENS7PY%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.