Atlassian アカウントの API トークンを管理する

API トークンを使用して、アトラシアンのクラウド製品でスクリプトを認証できます。Atlassian アカウントからトークンを生成し、スクリプトにコピー アンド ペーストします。

認証に 2 段階認証を使用する場合、スクリプトでは REST API トークンによって認証する必要があります。

API トークンの使用方法

API トークンの主要なユース ケースは、スクリプトが HTTP 基本認証を使用してアトラシアンのクラウド製品の REST API にアクセスできるようにすることです。

使用する HTTP ライブラリの詳細によっては、パスワードをトークンで置き換えることができます。たとえば、curl を使用している場合、以下のようにします。

この例では、me@example.com はトークンの作成に使用した Atlassian アカウントのメール アドレスです。

固定長ではなくさまざまな長さの API トークンを使用することで、トークンの安全性と信頼性を向上させます。スクリプトが固定の API トークン長に依存している場合は、代わりに可変長を処理できることをご確認ください。

API トークンの作成

有効期限が無期限の API トークンは、データに関するセキュリティ上のリスクをもたらします。データ セキュリティを強化するため、既定では、API トークンが 1 年で失効するように設定されます。API トークンの作成時に、有効期限を 1 日から最長 1 年まで設定できます。

Atlassian アカウントから API トークンを作成します。

1. https://id.atlassian.com/manage-profile/security/api-tokens にログインします。

2. [API トークンを作成] を選択します。

3. API トークンには、その機能を説明する名前を付けてください。

4. API トークンの有効期限を選択します。

   1. トークンの有効期限は 1 〜 365 日です。

5. [作成] を選択します。

6. [クリップボードにコピー] を選択してから、スクリプトにトークンを貼り付けるか、安全な場所に保存します。

この手順が完了すると、API トークンを復元できなくなります。API トークンをパスワード マネージャーに保存することをお勧めします。

API トークンを取り消す

トークンを取り消すと、そのトークンは機能しなくなり、アカウントから完全に削除されます。既存の API トークンを取り消す場合は、新しいトークンに置き換えることができます。

API トークンを取り消すには、次の手順に従います。

1. https://id.atlassian.com/manage-profile/security/api-tokens にログインします。

2. 取り消す API トークンの [取り消し] を選択します。

アカウントのすべての API トークンを取り消すには、[すべての API トークンを取り消す] を選択します。

API トークンの設定

API トークンは、Confluence Cloud、Jira Cloud、Jira Align REST API で使用できます。Bitbucket Cloud を使用している場合は、アプリ パスワードをご参照ください。