Bitbucket Cloud アドオン

Bitbucket Cloud アプリは Bitbucket とその他のアプリケーションの間のリンクを作成します。現在 Bitbucket では、ユーザーやチームがコード品質ツール、グラフ、Web ホスティング、クラウド ベースの IDE などにアクセスできる幅広いアプリを提供しています。これらのアプリは新機能、既存のサービスとの連携機能、または Bitbucet と同時に実行できる他の製品として紹介されます。

このページの内容

関連ページ

アプリの仕組みについて

アプリは、サードパーティが Bitbucket アカウントに直接アプリケーションを埋め込む方法を提供し、Bitbucket の範囲や機能を拡大します。多くは、新しいページ、タブ、セクションなどの形で UI エレメントとして表示されます。また、アプリは Bitbucket とのやり取りを変えることもできます。たとえば、Bitbucket でイベントが発生した場合にサードパーティ製アプリケーションに通知するように Webhook を使用できます。

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

アプリのセキュリティ

開発者が Bitbucket 用にアプリを作成する場合、各アプリが安全であり、適切な権限を保持するよう、ファクターの組み合わせを使用します。アプリは 2 つの独立した 範囲リストを使用して、権限をリクエストします。これらのリクエストは、次の場合に 2 つの異なるダイアログとして表示されます: 1) アプリが最初にインストールされたとき、および 2) 最初にアプリにアクセスしようとしたとき。

インストール権限

ユーザーまたはチームの管理者がアプリをインストールすると、ダイアログが表示され、アプリケーションのアクセスと権限タイプのリストを示します。アプリの作成者は、アプリ記述子でこれらの範囲を宣言します。このようにして、サードパーティ アプリケーションに対する Bitbucket からの各リクエストに、必要な詳細のみが含まれるようにできます。アプリには、アプリケーションと Bitbucket との間で情報を安全に転送する JSON Web Tokens (JWT) が含まれます。

OAuth コンシューマー権限

各アプリは OAuth コンシューマーを使用して、個々の Bitbucket ユーザーの代理としてリクエストを行います。その結果、不正アクセスや悪意のある変更、または偶発的な変更からお客様の個人データを保護することができます。

ユーザーまたはチームが最近インストールしたアプリを初めて開くと、ウィンドウまたはページが表示され、インストール ダイアログと同様に、OAuth コンシューマーの範囲をリストします。このメッセージには [アクセスの許可] ボタンまたはリンクが含まれ、アプリの使用を開始する場合にはこれをクリックする必要があります。次のダイアログは、アプリにアクセスを許可する際の表示例ですが、表示はアプリに応じて異なる場合があります。

アクセスを許可したアプリケーションのリストを、アカウントの [OAuth 統合アプリケーション] セクションで確認できます。このリストを表示するには、左下のアバターから [Bitbucket settings] をクリックして、[OAuth] リンクをクリックします。

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

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

アプリのインストール

  1. 自分のユーザー アカウントの場合: 左下のアバターから、[統合] を選択します。
    チームの場合: 左下のアバターから、チームを選択するか、[すべてのチームを表示] をクリックして完全な一覧を表示します。サイドバーで [設定] をクリックしてから、[統合の検索] をクリックします。
  2. 必要なアプリを選択して、[追加] をクリックします。
  3. アプリが要求するアクセス権限を確認し、承認する場合は [アクセス権限の付与] をクリックします。

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

アプリの削除

  1. 自分のユーザー アカウントの場合: 左下のアバターから、[Bitbucket settings] を選択します。
    チームの場合: 左下のアバターから、チームを選択するか、[すべてのチームを表示] をクリックして完全な一覧を表示します。サイドバーで [設定] をクリックします。
  2. [統合と機能] の下の [統合の管理] をクリックします。
  3. 削除したいアプリを選択してから、[削除] をクリックします。
  4. ポップアップが表示され、アプリの削除を確認されます。問題ない場合は [削除] をクリックします。

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

独自のアプリを作成する

チームは独自のアプリを構築し、Bitbucket にインストールすることができます。独自のアプリを作成するには、開発者向けガイドを使用して Atlassian Connect for Bitbucket Cloud についての学習します。サンプル アプリから開始することをおすすめします。アプリをセットアップしたら、開発者向けガイドの残り部分を使用して、Bitbucket でのアプリの表示方法や、処理内容についての知識を得ることができます。Bitbucket にアプリを導入する準備が整ったら、次の手順を使用します。

  1. 作成したアプリケーションの URL をコピーします。ngrok を使用している場合、URL は ngrok からコピーした https 転送アドレスです。
  2. [統合の管理] ページから、[URL からアプリをインストール] をクリックします。
  3. 表示されたポップアップに URL を貼り付け、[インストール] をクリックします。

アプリは、他のアプリとともに、[統合の管理] ページに表示されます。

最終更新日 2018 年 1 月 29 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.