Atlassian アカウントの API トークンを管理する
2024 年 12 月 15 日以降、既定では、API トークンが 1 年で失効するように設定されます。API トークンの作成時に、有効期限を 1 日から最長 1 年まで設定できます。
これは、既存の API トークンには影響しません。
API トークンを使用して、アトラシアンのクラウド製品でスクリプトを認証できます。Atlassian アカウントからトークンを生成し、スクリプトにコピー アンド ペーストします。
認証に 2 段階認証を使用する場合、スクリプトでは REST API トークンによって認証する必要があります。
API トークンの使用方法
API トークンの主要なユース ケースは、スクリプトが HTTP 基本認証を使用してアトラシアンのクラウド製品の REST API にアクセスできるようにすることです。
使用する HTTP ライブラリの詳細によっては、パスワードをトークンで置き換えることができます。たとえば、curl を使用している場合、以下のようにします。
1
curl -v https://mysite.atlassian.net --user me@example.com:my-api-token
この例では、me@example.com はトークンの作成に使用した Atlassian アカウントのメール アドレスです。
固定長ではなくさまざまな長さの API トークンを使用することで、トークンの安全性と信頼性を向上させます。スクリプトが固定の API トークン長に依存している場合は、代わりに可変長を処理できることをご確認ください。
API トークンの作成
有効期限が無期限の API トークンは、データに関するセキュリティ上のリスクをもたらします。データ セキュリティを強化するため、既定では、API トークンが 1 年で失効するように設定されます。API トークンの作成時に、有効期限を 1 日から最長 1 年まで設定できます。
Atlassian アカウントから API トークンを作成します。
https://id.atlassian.com/manage-profile/security/api-tokens にログインします。
[API トークンを作成] を選択します。
API トークンには、その機能を説明する名前を付けてください。
API トークンの有効期限を選択します。
トークンの有効期限は 1 〜 365 日です。
[作成] を選択します。
[クリップボードにコピー] を選択してから、スクリプトにトークンを貼り付けるか、安全な場所に保存します。
この手順が完了すると、API トークンを復元できなくなります。API トークンをパスワード マネージャーに保存することをお勧めします。
API トークンを取り消す
トークンを取り消すと、そのトークンは機能しなくなり、アカウントから完全に削除されます。既存の API トークンを取り消す場合は、新しいトークンに置き換えることができます。
API トークンを取り消すには、次の手順に従います。
https://id.atlassian.com/manage-profile/security/api-tokens にログインします。
取り消す API トークンの [取り消し] を選択します。
アカウントのすべての API トークンを取り消すには、[すべての API トークンを取り消す] を選択します。
API トークンの設定
API トークンは、Confluence Cloud、Jira Cloud、Jira Align REST API で使用できます。Bitbucket Cloud を使用している場合は、アプリ パスワードをご参照ください。
| 説明 |
---|---|
トークン名 | トークンにその機能を説明する名前を付けます。 |
トークンの有効期限 | 既定では、トークンが 1 年で失効するように設定されます。これは現在のトークンと新しいトークンに適用されます。 API トークンを作成するときに、トークンの有効期限を 1 日から 365 日まで変更できます。 |
この内容はお役に立ちましたか?