Sourcetree または別のアプリに API トークンを追加する

To get started using API tokens with Sourcetree, you'll need to create the API token in Bitbucket Cloud and specify the necessary scope to connect to your account, view your workspaces, and work with your repositories in Sourcetree.

スコープ付き API トークンを作成する

1. Select your profile in the upper-right corner of the top navigation bar.

2. Under Account settings.

3. Atlassian アカウント ページの上部のナビゲーション バーにある [セキュリティ] タブを選択します。

4. [API トークンの作成と管理] を選択します。

5. Select Create API token with scopes. If you want to be able to authenticate against your user account, view your data, and work with your repositories (clone/push/pull to the repoository and work with pull requests (optional), you will need to select all of the following scopes: 
   read:user:bitbucket
   read:workspace:bitbucket
   read:repository:bitbucket
   write:repository:bitbucket
   read:pullrequest:bitbucket (optional)
   write:pullrequest:bitbucket (optional)
   More information on scopes can be found in our API scopes documentation.

6. API トークンに名前と有効期限を指定し (通常は、トークンを使用するアプリに関連するものを指定する)、[次へ] を選択します。

7. アプリとして [Bitbucket] を選択し、[次へ] を選択します。

8. Select the scopes (permissions) the API token needs and select Next. For detailed descriptions of each permission, see: API Token permissions. Note: This step is required for your API token to access Bitbucket APIs or perform Git commands.

9. トークンを確認し、[トークンを作成] ボタンを選択します。ページに新しい API トークンが表示されます。

10. 生成された API トークンをコピーして、記録するか、アクセス権を付与するアプリに貼り付けます。

Configure Sourcetree to work with your API token

Sourcetree に API トークンを追加するには、次の手順に従います。

1. アカウント情報を追加または編集するタブに移動します。

   1. (Windows) Go to Tools, then Options. From the Options dialog, select the Authentication tab.

   2. (macOS) Go to Sourcetree, then Preferences. From the dialog that options, select the Accounts tab.

2. [編集] を選択してアカウントの詳細を編集するか、[追加] を選択して新しいアカウントを追加します。

3. Select Bitbucket as the host.

4. Select API Token as the Auth Type.

5. Enter the user email associated with your Bitbucket Cloud user account into the User Email field.

6. Paste your API token from above into the API Token field.

7. [OK] または [保存] を選択してアカウントの詳細を保存します。

Cloning a repository in Sourcetree

1. Once you’re ready to clone a new remote repository, select the Remote tab.

2. Find the repository you wish to clone and select the Clone button. This will clone the repository using the API token that you've configured in Sourcetree.

その他の考慮事項

As API tokens have a configurable expiry date, once the expiry date has passed, you will need to create a new API token and configure your settings in Sourcetree to reflect this new token as outlined in the above processes.

Renovate

Renovate ボットに API トークンを追加するには、次の手順に従います。

1. config.js ファイルの password として API トークンを設定します。

2. 環境変数 RENOVATE_PASSWORD として API トークンを設定します。

3. CLI で --password= を使用して Renovate を実行するときに API トークンを設定します。

4. bot アカウントの username を Atlassian メールとして設定します。

Other third-party applications

API トークンを別のアプリに追加する場合は、アプリのドキュメントで API トークンの適用方法を参照してください。

Bitbucket での認証にアプリ パスワードを使用するその他のアプリについては、ユーザー名を Atlassian メールに置き換え、以前のアプリ パスワードを新たに生成された API トークンに置き換えます。