Atlassian アカウントの API トークンを管理する
2024 年 12 月 15 日以降、新しい API トークンは 1 年で期限切れになるように既定で設定されています。API トークンの作成時に、有効期限を 1 日から最長 1 年まで設定できます。
2025 年 3 月 13 日以降、2024 年 12 月 15 日より前に作成された API トークンは、1 年で期限切れになるように設定されています。これらの API トークンは 3 月 14 日から 2026年05月12日 までの間に有効期限が切れます。
API トークンを使用して、アトラシアンのクラウド アプリでスクリプトを認証できます。Atlassian アカウントからトークンを生成し、スクリプトにコピー アンド ペーストします。
認証に 2 段階認証を使用する場合、スクリプトでは REST API トークンによって認証する必要があります。
API トークンの使用方法
API トークンの主要なユース ケースは、スクリプトが HTTP 基本認証を使用してアトラシアンのクラウド アプリの REST API にアクセスできるようにすることです。
使用する HTTP ライブラリの詳細によっては、パスワードをトークンで置き換えることができます。たとえば、curl を使用している場合、以下のようにします。
## URL for API Tokens
curl -v https://mysite.atlassian.net --user me@example.com:my-api-token
## URLs for API tokens with scopes for Jira and Confluence
curl -v https://api.atlassian.com/ex/jira/{cloudId} --user me@example.com:my-api-token
curl -v https://api.atlassian.com/ex/confluence/{cloudId} --user me@example.com:my-api-tokenこの例では、me@example.com はトークンの作成に使用した Atlassian アカウントのメール アドレスです。
固定長ではなくさまざまな長さの API トークンを使用することで、トークンの安全性と信頼性を向上させます。スクリプトが固定の API トークン長に依存している場合は、代わりに可変長を処理できることをご確認ください。
API トークンのスコープとは
API トークンが実行する権限を持つアクションを指定できます。これがスコープと呼ばれます。API トークンのスコープは、Jira アプリと Confluence アプリ内のデータへのアクセス レベルを定義します。スコープによって、API トークンの特定の権限を定義できるため、セキュリティが強化されます。
Atlassian アカウントから API トークンを作成するときに、API トークンのスコープを選択できます。API トークンは、スコープの有無にかかわらず作成できます。より安全であるため、スコープ付きの API トークンを作成することをお勧めします。
スコープ付き API トークンを作成する
API トークンのスコープを選択するときは、特定のアクションの実行権限をトークンに付与します。API に Jira と Confluence のコンテンツの表示、書き込み、削除を許可することができます。スコープ付きの API トークンを現在サポートしていないアプリを使用する必要がある場合は、スコープなしのトークンを作成できます。
Jira {{ https://api.atlassian.com/ex/jira/{cloudId}} または
Confluence {https://api.atlassian.com/ex/confluence/{cloudId}} のスコープ付き API トークンを使用するには、Atlassian API を呼び出す必要があります。
API を呼び出すリクエストを作成する方法
スコープ付き API トークンを作成には、次の手順に従います。
https://id.atlassian.com/manage-profile/security/api-tokens にログインします。
スコープ付きの [API トークンを作成する] を選択します。
API トークンの目的を示す名前を入力します。
API トークンの有効期限を選択します。
トークンの有効期限は 1 〜 365 日です。
API トークンでアクセスするアプリを選択します。
スコープを選択して、API トークンが Jira または Confluence で実行できることを決定します。
[作成] を選択します。
[クリップボードにコピー] を選択してから、スクリプトにトークンを貼り付けるか、安全な場所に保存します。
この手順が完了すると、API トークンを復元できなくなります。API トークンをパスワード マネージャーに保存することをお勧めします。
Verify your identity to create or manage API tokens
When you use a password or third-party to log in, we ask you to verify your identity before you create or manage API tokens. We email you a one-time passcode. How to verify your identity
When you log in with single sign-on or a service account, you don’t need to verify your identity.
アイドル セッション時間
When you verify your identity, we create a session for you. When you’re idle for more than 30 minutes, then you need to verify your identity.
API トークンの作成
有効期限が無期限の API トークンは、データに関するセキュリティ上のリスクをもたらします。データ セキュリティを強化するため、既定では、API トークンが 1 年で失効するように設定されます。API トークンの作成時に、有効期限を 1 日から最長 1 年まで設定できます。
パスワードまたはサードパーティのログインを使用してログインした場合、API トークンを作成するには本人確認を求められます。ワンタイム パスコードがメールで送付されます。本人確認の方法
Atlassian アカウントから API トークンを作成します。
https://id.atlassian.com/manage-profile/security/api-tokens にログインします。
[API トークンを作成] を選択します。
API トークンには、その機能を説明する名前を付けてください。
API トークンの有効期限を選択します。
トークンの有効期限は 1 〜 365 日です。
[作成] を選択します。
[クリップボードにコピー] を選択してから、スクリプトにトークンを貼り付けるか、安全な場所に保存します。
この手順が完了すると、API トークンを復元できなくなります。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 日まで変更できます。 |
この内容はお役に立ちましたか?