Bitbucket Cloud アプリの概要

Bitbucket Cloud apps create a link between Bitbucket and other applications. 

アプリは、Bitbucket アカウントにサードパーティ アプリケーションを直接埋め込む方法を提供し、Bitbucket の範囲や機能を拡大します。アプリは Bitbucket 内で新しいページ、タブ、またはセクションのように Bitbucket インターフェイスの拡張機能として表示できます。

また、アプリは Bitbucket とやり取りする方法を変えることもできます。たとえば、Bitbucket アプリは特定のイベントが発生した場合 (プル リクエストがマージされた場合など) にサードパーティ製アプリケーションに通知するように Webhook を使用できます。

Bitbucket アプリのベンダーは Atlassian Connect フレームワークを使用して連携を構築し、Bitbucket UI に拡張ポイントを作成します。また、アプリは Bitbucket の REST API を呼び出し、Bitbucket からデータやその他の情報を送信/取得できます。

アプリのセキュリティ

When developers create apps for Bitbucket, they use a combination of factors to make sure each app is secure and has access to the right permissions. Apps use two separate lists of scopes to request these permissions. These requests appear as two different dialogs: 1) when the app is first installed and 2) when you first try to access the app.

インストール権限

When you or your team's administrator installs an app, a dialog appears with a list of what the application will be able to access and the type of permissions it will have. The creator of the app declares these scopes in the app descriptor. That way, each request from Bitbucket to the third-party application contains only the necessary details. Included with the app are JSON Web Tokens (JWT), which transfer information securely between the application and Bitbucket.

OAuth コンシューマー権限

Each app also uses OAuth consumers to make requests on behalf of individual Bitbucket users. As a result, your personal data remains protected from unauthorized access and malicious or accidental changes.

On the first encounter of an app that you or your team has recently installed, you'll see a window or page, similar to the installation dialog, that lists the scopes for the OAuth consumer. This message also includes a Grant access button or link, which you need to select if you want to start using the app. 

You can see the list of applications that you have granted access to under the OAuth integrated applications section in your account. To see this list, seelct Personal settings from your avatar in the bottom left, then select the OAuth link.

アプリのインストールと削除

アプリは、自分のユーザー アカウントまたはチームのアカウントにインストールできます。ユーザー アカウントからアプリをインストールした場合、アプリはユーザーがアクセス可能なリポジトリでのみ利用できます。管理者がチーム アカウントでアプリをインストールした場合、アプリはチーム アカウントの一部であるリポジトリでのみ利用できます。

アプリのインストール

1. Navigate to the proper workspace, if you are not already there. To find a particular workspace, select your profile avatar, then the workspace listed under Recent workspaces, or select All workspaces to display an entire list from which you can choose.

2. 上部のナビゲーション バーにある [設定] (歯車アイコン ) を選択します。

3. [設定] ドロップダウン メニューから [ワークスペース設定] を選択します。

4. Select Marketplace under Apps and features on the left side menu.

5. Pick an app you want, then select Add.

6. Review the access permissions the app is requesting and select Grant access if you approve.

インストールの一環として、一部のアプリでサービスへのサインオンや権限提供を求める場合があります。その場合、アプリのサイトへリダイレクトされます。また、サードパーティのサイトからアプリの機能を調節できる場合もあります。

アプリの削除

1. Navigate to the proper workspace, if you are not already there. To find a particular workspace, select your profile avatar, then select the workspace listed under the Recent workspaces, or select All workspaces to display an entire list from which you can choose.

2. 上部のナビゲーション バーにある [設定] (歯車アイコン ) を選択します。

3. [設定] ドロップダウン メニューから [ワークスペース設定] を選択します。

4. [アプリと機能] セクションで [インストール済みアプリ] を選択します。

5. Select the app you want to remove, then select Remove.

6. A pop-up appears, making sure you want to remove the app. Select Remove if you are sure.

チームのためにアプリをインストールしていた場合、アプリを削除するとチーム メンバーはそのアプリを使用できなくなります。チーム メンバーが引き続きアプリを使用したい場合、個人アカウントから個々にインストールできます。

独自のアプリを作成する

Your team can build their own apps and install them on Bitbucket. To create one yourself, use the developer guide to learn all about Atlassian Connect for Bitbucket Cloud. Our example app is a good place to start. Once you have the app set up, you can use the rest of the developer guide to update how the app appears in Bitbucket and what it does. When you are ready to see your app in Bitbucket, use the following steps.

1. Navigate to the proper workspace, if you are not already there. To find a particular workspace, select your profile avatar, then select the workspace listed under the Recent workspaces, or select All workspaces to display an entire list from which you can choose.

2. 上部のナビゲーション バーにある [設定] (歯車アイコン ) を選択します。

3. [設定] ドロップダウン メニューから [ワークスペース設定] を選択します。

4. [アプリと機能] セクションで [インストール済みアプリ] を選択します。

5. Select Enable development mode. 

6. Select Install app from URL.

7. 作成したアプリケーションの URL をコピーします。

8. Paste in the URL in the field in the Install app from URL dialog, then select Install.

アプリが他のアプリとともに、[インストール済みアプリ] ページに表示されます。