Bitbucket Cloud アプリの概要
Bitbucket Cloud アプリは、Bitbucket とその他のアプリケーションの間にリンクを作成します。
アプリは、Bitbucket アカウントにサードパーティ アプリケーションを直接埋め込む方法を提供し、Bitbucket の範囲や機能を拡大します。アプリは Bitbucket 内で新しいページ、タブ、またはセクションのように Bitbucket インターフェイスの拡張機能として表示できます。
また、アプリは Bitbucket とやり取りする方法を変えることもできます。たとえば、Bitbucket アプリは特定のイベントが発生した場合 (プル リクエストがマージされた場合など) にサードパーティ製アプリケーションに通知するように Webhook を使用できます。
Bitbucket アプリのベンダーは Atlassian Connect フレームワークを使用して連携を構築し、Bitbucket UI に拡張ポイントを作成します。また、アプリは Bitbucket の REST API を呼び出し、Bitbucket からデータやその他の情報を送信/取得できます。
アプリのセキュリティ
開発者が Bitbucket 用にアプリを作成する場合、各アプリが安全であり、適切な権限を保持するよう、ファクターの組み合わせを使用します。アプリは 2 つの独立したスコープのリストを使用して権限をリクエストします。これらのリクエストは、次の場合に 2 つの異なるダイアログとして表示されます: 1) アプリが最初にインストールされたとき、および 2) 最初にアプリにアクセスしようとしたとき。
インストール権限
ユーザーまたはチームの管理者がアプリをインストールすると、ダイアログが表示され、アプリケーションのアクセスと権限タイプのリストを示します。アプリの作成者は、アプリ記述子でこれらの範囲を宣言します。このようにして、サードパーティ アプリケーションに対する Bitbucket からの各リクエストに、必要な詳細のみが含まれるようにできます。アプリには、アプリケーションと Bitbucket との間で情報を安全に転送する JSON Web Tokens (JWT) が含まれます。
OAuth コンシューマー権限
各アプリは OAuth コンシューマーを使用して、個々の Bitbucket ユーザーの代理としてリクエストを行います。その結果、不正アクセスや悪意のある変更、または偶発的な変更からお客様の個人データを保護することができます。
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.
アプリのインストールと削除
アプリは、自分のユーザー アカウントまたはチームのアカウントにインストールできます。ユーザー アカウントからアプリをインストールした場合、アプリはユーザーがアクセス可能なリポジトリでのみ利用できます。管理者がチーム アカウントでアプリをインストールした場合、アプリはチーム アカウントの一部であるリポジトリでのみ利用できます。
アプリのインストール
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.
上部のナビゲーション バーにある [設定] (歯車アイコン ) を選択します。
[設定] ドロップダウン メニューから [ワークスペース設定] を選択します。
Select Marketplace under Apps and features on the left side menu.
Pick an app you want, then select Add.
Review the access permissions the app is requesting and select Grant access if you approve.
インストールの一環として、一部のアプリでサービスへのサインオンや権限提供を求める場合があります。その場合、アプリのサイトへリダイレクトされます。また、サードパーティのサイトからアプリの機能を調節できる場合もあります。
アプリの削除
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.
上部のナビゲーション バーにある [設定] (歯車アイコン ) を選択します。
[設定] ドロップダウン メニューから [ワークスペース設定] を選択します。
[アプリと機能] セクションで [インストール済みアプリ] を選択します。
Select the app you want to remove, then select Remove.
A pop-up appears, making sure you want to remove the app. Select Remove if you are sure.
チームのためにアプリをインストールしていた場合、アプリを削除するとチーム メンバーはそのアプリを使用できなくなります。チーム メンバーが引き続きアプリを使用したい場合、個人アカウントから個々にインストールできます。
独自のアプリを作成する
チームは独自のアプリを構築し、Bitbucket にインストールすることができます。独自のアプリを作成するには、開発者向けガイドを使用して Atlassian Connect for Bitbucket Cloud について学習します。サンプル アプリから開始することをおすすめします。アプリをセット アップしたら、開発者向けガイドの残り部分を使用して、Bitbucket でのアプリの表示方法や、処理内容についての知識を得ることができます。Bitbucket にアプリを導入する準備が整ったら、次の手順を実行します。
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.
上部のナビゲーション バーにある [設定] (歯車アイコン ) を選択します。
[設定] ドロップダウン メニューから [ワークスペース設定] を選択します。
[アプリと機能] セクションで [インストール済みアプリ] を選択します。
Select Enable development mode.
Select Install app from URL.
作成したアプリケーションの URL をコピーします。
Paste in the URL in the field in the Install app from URL dialog, then select Install.
アプリが他のアプリとともに、[インストール済みアプリ] ページに表示されます。
この内容はお役に立ちましたか?