From ca7ca62c113c1b8f350f9980f9a909d77b1a5281 Mon Sep 17 00:00:00 2001
From: Veronica Cernea <veronica.cernea@snyk.io>
Date: Wed, 20 Nov 2024 13:16:41 +0000
Subject: [PATCH] GITBOOK-8502: vc-Bitbucket Cloud: update info and fix errors

---
 .../snyk-scm-integrations/bitbucket-cloud.md  | 76 +++++++++----------
 1 file changed, 38 insertions(+), 38 deletions(-)

diff --git a/docs/scm-ide-and-ci-cd-integrations/snyk-scm-integrations/bitbucket-cloud.md b/docs/scm-ide-and-ci-cd-integrations/snyk-scm-integrations/bitbucket-cloud.md
index 6823fdda7e0d..db1dceed8114 100644
--- a/docs/scm-ide-and-ci-cd-integrations/snyk-scm-integrations/bitbucket-cloud.md
+++ b/docs/scm-ide-and-ci-cd-integrations/snyk-scm-integrations/bitbucket-cloud.md
@@ -205,44 +205,44 @@ After manually setting up the languages in your Bitbucket project, Snyk can auto
 
 #### Integrate using Snyk AppRisk <a href="#bitbucket-integrate-using-snyk-apprisk" id="bitbucket-integrate-using-snyk-apprisk"></a>
 
-1. Profile name (`mandatory`): Input your integration profile name.&#x20;
-2. Access Token (`mandatory`): Create your BitBucket PAT from your BitBucket organization.
-   * API URL (`mandatory`) - Input the API URL.
-   * Username (`mandatory`): Input the BitBucket username of your organization.
-   * App password (`mandatory`): Create an [API token](https://developer.atlassian.com/cloud/bitbucket/rest/intro/#app-passwords) from your BitBucket account, with the following permissions:
-     *   **Workspace membership** - Read
-
-         * **Account** - Read
-         * **Projects** - Read
-         * **Repositories** - Read
-         * **Issues** - Read
-
-
-
-         Create a BitBucket app password by following these steps:
-
-         1. Open your BitBucket account&#x20;
-         2. Click the Settings option
-         3. Click the Personal BitBucket settings option&#x20;
-         4. Navigate to the App passwords sub-section from the ACCESS MANAGEMENT section.
-3. Broker Token (`mandatory`): Create and add your Broker token if you use Snyk broker for AppRisk.
-   * Generate your Broker token by following the instructions from the [Obtain your Broker token for Snyk Broker ](../../enterprise-setup/snyk-broker/snyk-broker-code-agent/install-snyk-broker-code-agent-using-docker/obtain-the-required-tokens-for-setup.md#obtain-your-broker-token-for-snyk-broker-code-agent)page.&#x20;
-   * Copy and paste the Broker token on the integration setup menu from the Integration Hub.
-4. Service type (`mandatory`): Select the service type, Cloud, or On-premises.
-5. Add Backstage Catalog (`optional`): If you want to add your Backstage catalog, follow the instructions from the [Backstage file for SCM Integrations](application-context-for-scm-integrations/) page.
-6. API URL (`mandatory`) - Input the API URL.
-7. Username (`mandatory`): Input the BitBucket username of your organization.
-8. App password (`mandatory`): Create an [API token](https://developer.atlassian.com/cloud/bitbucket/rest/intro/#app-passwords) from your BitBucket account, with the following permissions:
-   * **Account** - Read
-   * **Projects** - Read
-9. API URL (`mandatory`) - Input the API URL.
-10. Username (`mandatory`): Input the BitBucket username of your organization.
-11. App password (`mandatory`): Create an [API token](https://developer.atlassian.com/cloud/bitbucket/rest/intro/#app-passwords) from your BitBucket account, with the following permissions:
-    * **Workspace membership** - Read
-    * **Account** - Read
-    * **Projects** - Read
-    * **Repositories** - Read
-    * **Issues** - Read
+* Profile name (`mandatory`): Input your integration profile name.&#x20;
+
+{% hint style="info" %}
+You can choose to integrate using an Access Token or a Broker Token.
+{% endhint %}
+
+**Use an Access Token**
+
+Use an Access Token (`mandatory`) to create your BitBucket PAT from your BitBucket organization.
+
+* API URL (`mandatory`) - Input the API URL.
+* Username (`mandatory`): Input the BitBucket username of your organization.
+* App password (`mandatory`): Create an [API token](https://developer.atlassian.com/cloud/bitbucket/rest/intro/#app-passwords) from your BitBucket account, with the following permissions:
+  * **Account** - Read
+  * **Projects** - Read
+
+{% hint style="info" %}
+Create a BitBucket app password by following these steps:
+
+1. Open your BitBucket account&#x20;
+2. Click the Settings option
+3. Click the Personal BitBucket settings option&#x20;
+4. Navigate to the App passwords sub-section from the ACCESS MANAGEMENT section.
+{% endhint %}
+
+**Use a Broker Token**
+
+Use a Broker Token (`mandatory`) to create and add your Broker token if you use Snyk broker for AppRisk.
+
+* Generate your Broker token by following the instructions from the [Obtain your Broker token for Snyk Broker ](../../enterprise-setup/snyk-broker/snyk-broker-code-agent/install-snyk-broker-code-agent-using-docker/obtain-the-required-tokens-for-setup.md#obtain-your-broker-token-for-snyk-broker-code-agent)page.&#x20;
+* Copy and paste the Broker token on the integration setup menu from the Integration Hub.
+
+**Common options**
+
+The following options apply to both the Access Token and the Broker token.
+
+* Service type (`mandatory`): Select the service type, Cloud, or On-premises.
+* Add Backstage Catalog (`optional`): If you want to add your Backstage catalog, follow the instructions from the [Backstage file for SCM Integrations](application-context-for-scm-integrations/) page.
 
 #### API version <a href="#bitbucket-api-version" id="bitbucket-api-version"></a>