From b63727d130995b71d07b2420fee276b4e37afb4b Mon Sep 17 00:00:00 2001 From: Adebayo Oluwadunsin Iyanuoluwa <88881603+oiadebayo@users.noreply.github.com> Date: Tue, 19 Aug 2025 11:30:55 +0100 Subject: [PATCH 1/4] Updated docs --- .../git/bitbucket/bitbucket-cloud/installation.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/bitbucket/bitbucket-cloud/installation.md b/docs/build-your-software-catalog/sync-data-to-catalog/git/bitbucket/bitbucket-cloud/installation.md index 70df8c69f4..891ac07e8f 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/git/bitbucket/bitbucket-cloud/installation.md +++ b/docs/build-your-software-catalog/sync-data-to-catalog/git/bitbucket/bitbucket-cloud/installation.md @@ -35,16 +35,16 @@ This page details how to install Port's Bitbucket Cloud integration (powered by :::tip Use of dedicated accounts and tokens -We recommend using workspace tokens from accounts dedicated to the integration, as this will provide a more secure and scalable solution. +We recommend using multiple workspace tokens for the integration, as this will provide a more secure and scalable solution. Using multiple workspace tokens helps distribute the load and avoid rate limiting issues. You can provide multiple workspace tokens as a comma-separated string in the configuration. -Different credentials from the same Bitbucket account share the same rate limits, which can cause issues when using the integration in a large organization. Using dedicated workspace tokens helps manage rate limits more effectively. +If you are using the username and app password, we recommend using a dedicated account for the integration, as different credentials from the same Bitbucket account share the same rate limits, which can cause issues when using the integration in a large organization. ::: The integration requires either a workspace token or an app password with username to authenticate with your Bitbucket Cloud account. You can create a workspace token by following the steps [here](https://support.atlassian.com/bitbucket-cloud/docs/workspace-access-tokens/) or an app password by following [these steps](https://support.atlassian.com/bitbucket-cloud/docs/app-passwords/). The token or app password should have `read` permission scope for each of the supported resources you want to ingest into Port and a `read` and `write` permission scope for the webhooks. -We recommend using workspace tokens when possible, as they provide better security and are easier to manage than app passwords. +We recommend using multiple workspace tokens when possible, as they provide better security, are easier to manage than app passwords, and help avoid rate limiting issues by distributing requests across different tokens. ## Deploy the integration @@ -180,7 +180,7 @@ This table summarizes the available parameters for the installation. | `integration.config.bitbucketUsername` | The username of the Bitbucket Cloud account | ✅ | | `integration.config.bitbucketWorkspace` | The workspace of the Bitbucket Cloud account | ✅ | | `integration.config.bitbucketAppPassword` | The app password of the Bitbucket Cloud account | ✅ | -| `integration.config.bitbucketWorkspaceToken`| The workspace token of the Bitbucket Cloud account | ✅ | +| `integration.config.bitbucketWorkspaceToken`| The workspace token (or comma seperated string of multiple tokens) of the Bitbucket Cloud account | ✅ | | `integration.config.webhookSecret` | The secret used to verify the webhook requests | ❌ | | `scheduledResyncInterval` | The number of minutes between each resync | ❌ | | `initializePortResources` | Default true, When set to true the integration will create default blueprints and the port App config Mapping | ❌ | From 81e2f5dcb78b981a593ad7da9385fbb15b00e30c Mon Sep 17 00:00:00 2001 From: Adebayo Oluwadunsin Iyanuoluwa <88881603+oiadebayo@users.noreply.github.com> Date: Tue, 19 Aug 2025 11:41:57 +0100 Subject: [PATCH 2/4] Update _bitbucket_cloud_one_time_docker_parameters.mdx --- .../_bitbucket_cloud_one_time_docker_parameters.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/bitbucket/bitbucket-cloud/_bitbucket_cloud_one_time_docker_parameters.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/bitbucket/bitbucket-cloud/_bitbucket_cloud_one_time_docker_parameters.mdx index 5967e602b2..9c872e8618 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/git/bitbucket/bitbucket-cloud/_bitbucket_cloud_one_time_docker_parameters.mdx +++ b/docs/build-your-software-catalog/sync-data-to-catalog/git/bitbucket/bitbucket-cloud/_bitbucket_cloud_one_time_docker_parameters.mdx @@ -1,6 +1,6 @@ | Parameter | Description | Example | Required | | ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | -------- | -| `OCEAN__INTEGRATION__CONFIG__BITBUCKET_WORKSPACE_TOKEN` | The workspace token used to query authenticate with your Bitbucket Cloud account | | ✅ | +| `OCEAN__INTEGRATION__CONFIG__BITBUCKET_WORKSPACE_TOKEN` | The workspace token (or comma seperated string of multiple tokens) of the Bitbucket Cloud account | | ✅ | | `OCEAN__INTEGRATION__CONFIG__BITBUCKET_WORKSPACE` | The workspace you want to retrieve git objects from | | ✅ | | `OCEAN__INTEGRATION__CONFIG__BITBUCKET_USERNAME` | The username used to authenticate with your Bitbucket Cloud account | | ✅ | | `OCEAN__INTEGRATION__CONFIG__BITBUCKET_APP_PASSWORD` | The app password used to authenticate with your Bitbucket Cloud account | | ✅ | From a6b74a827b47102fb27ba96093ebbf2ac59c512a Mon Sep 17 00:00:00 2001 From: Adebayo Oluwadunsin Iyanuoluwa <88881603+oiadebayo@users.noreply.github.com> Date: Tue, 19 Aug 2025 11:43:00 +0100 Subject: [PATCH 3/4] Typo correction --- .../_bitbucket_cloud_one_time_docker_parameters.mdx | 2 +- .../git/bitbucket/bitbucket-cloud/installation.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/bitbucket/bitbucket-cloud/_bitbucket_cloud_one_time_docker_parameters.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/bitbucket/bitbucket-cloud/_bitbucket_cloud_one_time_docker_parameters.mdx index 9c872e8618..d11a177ca2 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/git/bitbucket/bitbucket-cloud/_bitbucket_cloud_one_time_docker_parameters.mdx +++ b/docs/build-your-software-catalog/sync-data-to-catalog/git/bitbucket/bitbucket-cloud/_bitbucket_cloud_one_time_docker_parameters.mdx @@ -1,6 +1,6 @@ | Parameter | Description | Example | Required | | ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | -------- | -| `OCEAN__INTEGRATION__CONFIG__BITBUCKET_WORKSPACE_TOKEN` | The workspace token (or comma seperated string of multiple tokens) of the Bitbucket Cloud account | | ✅ | +| `OCEAN__INTEGRATION__CONFIG__BITBUCKET_WORKSPACE_TOKEN` | The workspace token (or comma separated string of multiple tokens) of the Bitbucket Cloud account | | ✅ | | `OCEAN__INTEGRATION__CONFIG__BITBUCKET_WORKSPACE` | The workspace you want to retrieve git objects from | | ✅ | | `OCEAN__INTEGRATION__CONFIG__BITBUCKET_USERNAME` | The username used to authenticate with your Bitbucket Cloud account | | ✅ | | `OCEAN__INTEGRATION__CONFIG__BITBUCKET_APP_PASSWORD` | The app password used to authenticate with your Bitbucket Cloud account | | ✅ | diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/bitbucket/bitbucket-cloud/installation.md b/docs/build-your-software-catalog/sync-data-to-catalog/git/bitbucket/bitbucket-cloud/installation.md index 891ac07e8f..6701deb7aa 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/git/bitbucket/bitbucket-cloud/installation.md +++ b/docs/build-your-software-catalog/sync-data-to-catalog/git/bitbucket/bitbucket-cloud/installation.md @@ -180,7 +180,7 @@ This table summarizes the available parameters for the installation. | `integration.config.bitbucketUsername` | The username of the Bitbucket Cloud account | ✅ | | `integration.config.bitbucketWorkspace` | The workspace of the Bitbucket Cloud account | ✅ | | `integration.config.bitbucketAppPassword` | The app password of the Bitbucket Cloud account | ✅ | -| `integration.config.bitbucketWorkspaceToken`| The workspace token (or comma seperated string of multiple tokens) of the Bitbucket Cloud account | ✅ | +| `integration.config.bitbucketWorkspaceToken`| The workspace token (or comma separated string of multiple tokens) of the Bitbucket Cloud account | ✅ | | `integration.config.webhookSecret` | The secret used to verify the webhook requests | ❌ | | `scheduledResyncInterval` | The number of minutes between each resync | ❌ | | `initializePortResources` | Default true, When set to true the integration will create default blueprints and the port App config Mapping | ❌ | From 82febf3829b6386db6f2e22275ede855e4b5ada8 Mon Sep 17 00:00:00 2001 From: Adebayo Oluwadunsin Iyanuoluwa <88881603+oiadebayo@users.noreply.github.com> Date: Tue, 19 Aug 2025 11:47:04 +0100 Subject: [PATCH 4/4] Fixed grammar --- .../_bitbucket_cloud_one_time_docker_parameters.mdx | 2 +- .../git/bitbucket/bitbucket-cloud/installation.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/bitbucket/bitbucket-cloud/_bitbucket_cloud_one_time_docker_parameters.mdx b/docs/build-your-software-catalog/sync-data-to-catalog/git/bitbucket/bitbucket-cloud/_bitbucket_cloud_one_time_docker_parameters.mdx index d11a177ca2..73ad07cd3d 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/git/bitbucket/bitbucket-cloud/_bitbucket_cloud_one_time_docker_parameters.mdx +++ b/docs/build-your-software-catalog/sync-data-to-catalog/git/bitbucket/bitbucket-cloud/_bitbucket_cloud_one_time_docker_parameters.mdx @@ -1,6 +1,6 @@ | Parameter | Description | Example | Required | | ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | -------- | -| `OCEAN__INTEGRATION__CONFIG__BITBUCKET_WORKSPACE_TOKEN` | The workspace token (or comma separated string of multiple tokens) of the Bitbucket Cloud account | | ✅ | +| `OCEAN__INTEGRATION__CONFIG__BITBUCKET_WORKSPACE_TOKEN` | The workspace token(s) for the Bitbucket Cloud account (can be a single token or comma-separated string of multiple tokens) | | ✅ | | `OCEAN__INTEGRATION__CONFIG__BITBUCKET_WORKSPACE` | The workspace you want to retrieve git objects from | | ✅ | | `OCEAN__INTEGRATION__CONFIG__BITBUCKET_USERNAME` | The username used to authenticate with your Bitbucket Cloud account | | ✅ | | `OCEAN__INTEGRATION__CONFIG__BITBUCKET_APP_PASSWORD` | The app password used to authenticate with your Bitbucket Cloud account | | ✅ | diff --git a/docs/build-your-software-catalog/sync-data-to-catalog/git/bitbucket/bitbucket-cloud/installation.md b/docs/build-your-software-catalog/sync-data-to-catalog/git/bitbucket/bitbucket-cloud/installation.md index 6701deb7aa..d7ec4dc3fe 100644 --- a/docs/build-your-software-catalog/sync-data-to-catalog/git/bitbucket/bitbucket-cloud/installation.md +++ b/docs/build-your-software-catalog/sync-data-to-catalog/git/bitbucket/bitbucket-cloud/installation.md @@ -180,7 +180,7 @@ This table summarizes the available parameters for the installation. | `integration.config.bitbucketUsername` | The username of the Bitbucket Cloud account | ✅ | | `integration.config.bitbucketWorkspace` | The workspace of the Bitbucket Cloud account | ✅ | | `integration.config.bitbucketAppPassword` | The app password of the Bitbucket Cloud account | ✅ | -| `integration.config.bitbucketWorkspaceToken`| The workspace token (or comma separated string of multiple tokens) of the Bitbucket Cloud account | ✅ | +| `integration.config.bitbucketWorkspaceToken`| The workspace token(s) for the Bitbucket Cloud account (can be a single token or comma-separated string of multiple tokens) | ✅ | | `integration.config.webhookSecret` | The secret used to verify the webhook requests | ❌ | | `scheduledResyncInterval` | The number of minutes between each resync | ❌ | | `initializePortResources` | Default true, When set to true the integration will create default blueprints and the port App config Mapping | ❌ |