Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[xs] Add project_admin permissions #2028

Merged
merged 2 commits into from
Mar 17, 2025
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 9 additions & 4 deletions docs/deployment/connect-scm.md
Original file line number Diff line number Diff line change
Expand Up @@ -139,16 +139,21 @@ You have successfully connected an org in Semgrep AppSec Platform with an organi

<TabItem value='bitbucket-data-center'>


1. Create an HTTP Access Token for your project following the steps outlined in [<i class="fas fa-external-link fa-xs"></i> Bitbucket Data Center documentation](https://confluence.atlassian.com/bitbucketserver/http-access-tokens-939515499.html). Ensure that the access token is created with `PROJECT_ADMIN` permissions.
1. Copy the token for use in the next steps.
1. Sign in to [<i class="fas fa-external-link fa-xs"></i> Semgrep AppSec Platform](https://semgrep.dev/login).
1. Optional: If you have created more than one Semgrep account, select the account you want to make a connection for by clicking on the **Navigation bar > Your account name > The account you want to connect**.<br />
<img src="/docs/img/more-accounts-dropdown.png" height="350px" />
1. Go to **<i class="fa-solid fa-gear"></i> Settings** > **Source code managers**, and click **Add > Bitbucket Data Center**.
1. In the **Connect your Bitbucket project (key)** dialog box, provide:
- The **Name of your Bitbucket project (key)**. This must be the project key, which you can find by navigating to `<YOUR_BITBUCKET_DATA_CENTER_BASE_URL>/projects`.
- The **URL** to access your installation of Bitbucket Data Center
- The **Access Token** that [grants Semgrep permission to communicate with your project](https://confluence.atlassian.com/bitbucketserver/http-access-tokens-939515499.html). Semgrep expects an [HTTP access token](https://confluence.atlassian.com/bitbucketserverm0930/http-access-tokens-1431540960.html).
2. Click **Connect** to save and proceed.
3. The Bitbucket project is now listed under **Source code managers**. Click **Test** to verify that the new connection was installed correctly.
- The **URL** to access your installation of Bitbucket Data Center; this is your fully-qualified domain name.
- The **Access Token** that grants Semgrep permission to communicate with your project. Semgrep expects an [HTTP access token](https://confluence.atlassian.com/bitbucketserver/http-access-tokens-939515499.html) with `PROJECT_ADMIN` permissions.
1. Click **Connect** to save and proceed.
1. The Bitbucket project is now listed under **Source code managers**. Click **Test** to verify that the new connection was installed correctly.
1. To enable merge request comments, click **<i class="fa-solid fa-toggle-large-on"></i> Incoming webhooks**.
1. Optional: Click **Auto scan** to onboard all current and future repositories under your project to Semgrep Managed Scanning.

</TabItem>
<TabItem value='github-enterprise'>
Expand Down