Atlassian アカウントの API トークンを管理する
After December 15, 2024, by default we set new API tokens to expire in one year. When you create an API token, you can set the expiration date to be from 1 day up to one year.
Beginning February 12, 2025, we will limit the lifespan of your current API tokens. Your API tokens will expire in one year.
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 日まで変更できます。 |
この内容はお役に立ちましたか?