OAuth アクセスを許可する

OAuth アクセス トークンについて

OAuth アクセス トークンによって、次のことが可能になります:

  • 外部の OAuth 準拠の Web アプリまたは Web サイト (別称「コンシューマー」) で Jira ガジェットを使用すること

  • ご使用の Jira ユーザーアカウント限定または専用の Jira データへのアクセス権をこのガジェットに付与すること

はじめる前に

Your Jira administrator must establish an OAuth relationship with this external web app or instance by approving it as an OAuth consumer. For example, if you want to add a Jira gadget to your Bamboo homepage and allow this gadget to access your restricted Jira data, then your Jira administrator must first approve Bamboo as an OAuth consumer.

コンシューマー上の Jira ガジェットは、一種のキーとして機能する OAuth アクセス トークンによって Jira データへのアクセスを許可されます。コンシューマーがこのアクセス トークンを所有している限り、Jira ガジェットは公開されている Jira データと Jira ユーザー アカウント専用の Jira データの両方にアクセスできます。アクセス トークンは Jira ユーザー アカウントからいつでも取り消せます。すべてのアクセス トークンは 7 日後に失効します。アクセス トークンが取り消されるか、失効すると、Jira ガジェットは Jira インスタンスの公開データにのみアクセスできるようになります。

次の条件が満たされている場合にのみ、OAuth アクセス トークンは、ユーザープロファイルに表示されます。

  1. Jira 管理者が OAuth を使用して、 Jira インスタンスとコンシューマー間のアプリ リンクを確立した場合。Jira 管理者の場合、「AppLink を使用して他のアプリにリンクする」を参照してください。

  2. You have accessed a Jira gadget on a consumer and have allowed this gadget access to your Jira data. (More on this step in the next section.)

OAuth アクセス トークンの発行

OAuth アクセス トークンは Jira によって発行され、コンシューマー上のガジェットによる Jira データ (自分の Jira ユーザー アカウント専用データ) へのアクセスを可能にします。

  1. コンシューマー上 (Bamboo など) で Jira ガジェットを使用していて、このガジェットによる専用の Jira データへのアクセスが必要な場合、まず Jira にログインするように求められます (まだ Jira にログインしてない場合)。

  2. Once you have logged in to Jira, you will be prompted with a Request for access message. 
    At this point, Jira is preparing to issue the Jira gadget (on the consumer) with an OAuth access token.

  3. To grant the gadget access to your Jira data, select Approve access. The consumer app will receive the OAuth access token from your Jira instance. This access token is specific to this gadget and as long as the token resides with the gadget, your gadget will have access to your Jira data.

OAuth アクセス トークンの取り消し

OAuth アクセス トークンを取り消すことで、コンシューマー上の Jira ガジェットに対して、Jira ユーザー アカウント専用の Jira データへのアクセスを拒否できます。自身が以前 Jira に発行を許可した OAuth アクセス トークンのみを取り消すことができます。

  1. [プロファイルと設定] > [個人設定] の順に選択します。

  2. ページの一番下の [接続済みアプリケーション] セクションで [アプリケーションの管理]を選択します。

  3. Your list of OAuth access tokens is presented in a table, with each access token presented in separate rows and each property of these tokens presented in a separate column. Refer to the OAuth access token table details section.

  4. OAuth アクセス トークンを取り消したい Jira ガジェットとガジェットに関連付けられたコンシューマー アプリを見つけ、[アクション] 列で [OAuth アクセス トークンの取り消し] リンクを選択します。

  5. You may be prompted to confirm this action. If so, select OK.

ガジェットのアクセストークンは取り消され、コンシューマー上の Jira ガジェットは、公開されている Jira データにしかアクセスできなくなります。

OAuth アクセス トークン表の詳細

列名

説明

コンシューマー

コンシューマに追加された Jira ガジェットの名前。

コンシューマーの説明

このコンシューマー アプリの説明。Jira およびそのコンシューマーとの間に OAuth 関係が確立された時に、コンシューマー自体の OAuth 設定からこの情報が取得されています。コンシューマーが別の Atlassian アプリである場合、この情報は OAuth 管理設定のコンシューマー情報タブにある「説明」フィールドから取得されます。アプリの管理者はこの [コンシューマー情報] の詳細をカスタマイズできます。

発行日

Jira によって OAuth アクセス トークンがコンシューマに発行された日付。これは、ガジェットからの( 自分の Jira ユーザーアカウントの内部扱いとなっている)Jira データへのアクセスを承認した直後の日付になります。

有効期限

The date when the OAuth access token expires. This is seven days after the Issued On date. When this date is reached, the access token will be automatically removed from this list.

操作

The functionality for revoking the access token.

 

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。