パーソナル アクセス トークンを使用する

パーソナル アクセス トークン (PAT) を使用して、スクリプトを安全に使用し、外部アプリケーションと Atlassian アプリケーションを連携できます。外部システムが侵害された場合、トークンを取り消すだけで済みます。パスワードを変更し、すべてのスクリプトや連携に変更を反映する必要はありません。

個人アクセス トークンは、ユーザー名とパスワードの使用に代わる、複数のサービスの認証を安全に行う方法です。 

はじめる前に

次の Atlassian アプリケーションの Data Center およびサーバー エディションで、パーソナル アクセス トークンを作成して使用できます。 

• Jira Core 8.14 以降
• Jira Software 8.14 以降
• Jira Service Management 4.15 以降
• Confluence 7.9 以降 

個人アクセス トークンの管理者ビューは、これらのアプリケーションの Data Center バージョンで使用できます。 

アプリケーションでの PAT の作成

1. Atlassian アプリケーションで、次の項目に移動します。
   
   • Confluence では、画面の右上にある自分のプロファイル画像を選択してから、[設定] > [パーソナル アクセス トークン] の順に選択します。
   • Jira では、画面の右上にある自分のプロファイル画像を選択してから、[パーソナル アクセス トークン] を選択します。
2. [Create token (トークンを作成)] を選択します。
3. 新しいトークンに名前を付けます。

4. オプションで、セキュリティ上の理由から、設定した日数が経過すると自動的に失効するようにトークンを設定できます。 

   EXPIRES SOON ステータスは、実際の有効期限日の 5 日前に表示されます。トークンが失効すると、再度アクティブ化することはできません。新しいトークンを作成する必要があります。

5. [Create] をクリックします。

パーソナル アクセス トークンが作成されます。トークンをコピーし、安全なスペースに保存します。

REST API を使用した PAT の作成

次の本文を使用して POST HTTP リクエストを送信します。

{
    "name": "tokenName",
    "expirationDuration": 90
}

送信先のアドレス:

{{baseUrlOfYourInstance}}/rest/pat/latest/tokens

応答で PAT を受け取ります。 

PAT の使用

認証にパーソナル アクセス トークンを使用するには、REST API コールの Authorization ヘッダーでベアラ トークンとして渡す必要があります。

cURL を使用して、ベアラ トークンで REST API を呼び出す例を次に示します。

curl -H "Authorization: Bearer <yourToken>" https://{confluenceBaseUrl}/rest/api/content

PAT の取り消し

セキュリティ侵害など、何かしらの理由でトークンを無効化する必要がある場合は、Atlassian アプリケーションからすばやく実行できます。 

1. Atlassian アプリケーションで、次の項目に移動します。
   
   • Jira で画面の右上にある自分のプロファイル画像を選択してから、[パーソナル アクセス トークン] を選択します。
   • Confluence では、画面の右上にある自分のプロファイル画像を選択してから、[設定] > [パーソナル アクセス トークン] の順に選択します。
2. 削除する添付ファイルの横の [Revoke (無効化)] を選択します。
3. 選択を確認します。 

トークンは無効化され、認証には使用できなくなりました。 

トークンの作成を制限する

管理者はシステム プロパティを使用してユーザーが作成できるトークンの数を制限し、失効ルールを設定できます。 

 アプリケーションでのシステム プロパティの適用方法を確認するには、次の手順に従います。

• Jira については「開始時にプロパティおよびオプションを設定する」をご参照ください。
• Confluence については、「システム プロパティを設定する」を参照してください。

パーソナル アクセス トークンを管理する  

Data Center アプリケーションでは、管理者はサイトで作成されたすべてのトークンのリストを表示し、任意のトークンを無効化できます。

パーソナル アクセス トークンを管理するには、次の手順を実行します。

1. Atlassian アプリケーションで、次の項目に移動します。
   • Jira で > [システム] > [パーソナル アクセス トークンの管理] を選択します。
   • Confluence で、 > [セキュリティ] > [パーソナル アクセス トークンの管理] を選択します。

このビューでは、作成者、作成日、有効期限、トークンが最後に認証に使用された日時でトークンをフィルタリングできます。管理者はトークンを個別に無効化し、複数のトークンを一括で削除できます。一括で無効化するには、無効化するトークンを選択し、[Bulk revoke (一括無効化)] をクリックします。