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

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

2023 年 1 月 18 日にアトラシアン アカウントの API トークンを延長しました。固定長ではなく、可変長を使用することで、トークンの安全性と信頼性を向上します。2023 年 1 月 18 日より前に作成されたトークンは影響を受けていません。

ユーザー側で必要な操作について

スクリプトが固定の API トークン長に依存している場合は、代わりに可変長を処理できることをご確認ください。

この変更は、2023 年 1 月 18 日以降に作成された新しいトークンにのみ適用されます。既存のトークンは影響を受けませんでした。スクリプトがすでに Atlassian アカウントの可変長 API トークンに対応している場合、この変更による影響はありません。必要なアクションはありません。

ご不明な点がある場合は、サポート チームまでお問い合わせください。

API トークンの作成

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

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

2. [API トークンの作成] をクリックします。

3. 表示されたダイアログで覚えやすく簡単な [ラベル] をトークンに対して入力し、[作成] をクリックします。

4. [クリップボードにコピー] をクリックしてから、スクリプトまたは他の場所にトークンを貼り付けて保存します。

注意:

• セキュリティ上の理由のため、作成ダイアログを閉じた後は、トークンを表示できません。トークンが再度必要な場合は新しいトークンを作成します。

• パスワードと同様、トークンは安全に保存する必要があります。

API トークンの使用

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

使用する HTTP ライブラリの詳細によっては、パスワードをトークンで単純に置き換えられます。たとえば、curl を使用する際は、以下のようにできます。

ここでの me@example.com は、トークンの作成に使用している Atlassian アカウントのメール アドレスを示します。

API トークンを取り消す

取り消されたトークンは機能しなくなり、アカウントから完全に削除されます。現在使用中の API トークンを取り消す場合は、新しいトークンに置き換えられます。

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

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

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

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

Tokens de API

Puedes utilizar un token de API para autenticar un script u otro proceso con un producto de Atlassian Cloud.Tan solo tienes que generar el token en tu cuenta de Atlassian, copiarlo y pegarlo en el script.

Si usas la verificación en dos pasos para la autenticación, el script deberá usar un token de API de REST.

Creación de un token de API

Crea un token de API en tu cuenta de Atlassian:

1. Inicia sesión en https://id.atlassian.com/manage/api-tokens.

2. Haz clic en Crear token de API.

3. En el cuadro de diálogo que aparezca, introduce una Etiqueta fácil de recordar y concisa para tu token y haz clic en Crear.

4. Haz clic en Copiar al portapapeles y, a continuación, pega el token en tu script o en cualquier otro lugar para guardarlo:

Nota:

• Por cuestiones de seguridad, no se puede ver el token después de cerrar el cuadro de diálogo de creación.Si es necesario, crea un nuevo token.

• Debes guardar el token de forma segura, como cualquier otra contraseña.

Uso de un token de API

Uno de los principales casos en los que se utilizan los tokens de API es para permitir que los scripts accedan a las API de REST relativas a los productos de Atlassian Cloud con una autenticación HTTP básica.

En función de los detalles de la biblioteca HTTP que uses, basta con sustituir tu contraseña por el token.Por ejemplo, si empleas el comando curl, puedes hacer algo así:

Ten en cuenta que, aquí, me@example.com es la dirección de correo electrónico de la cuenta de Atlassian que estás utilizando para crear el token.

Jetons d'API

Vous pouvez utiliser un jeton d'API pour authentifier un script ou un autre processus auprès d'un produit Atlassian Cloud.Générez le jeton depuis votre compte Atlassian, puis copiez-le et collez-le dans le script.

Si vous utilisez la validation en deux étapes, votre script doit faire appel à un jeton d'API REST pour l'authentification.

Créer un jeton d'API

Pour créer un jeton d'API depuis votre compte Atlassian, procédez comme suit :

1. Connectez-vous à l'adresse : https://id.atlassian.com/manage/api-tokens.

2. Cliquez sur Créer un jeton d'API.

3. Dans la boîte de dialogue qui s'affiche, saisissez une étiquette courte et facile à retenir pour votre jeton, puis cliquez sur Créer.

4. Cliquez sur Copier dans le presse-papiers, puis collez le jeton dans votre script ou ailleurs pour l'enregistrer:

Remarque:

• Pour des raisons de sécurité, il n'est pas possible de voir le jeton après avoir fermé la boîte de dialogue de création ; si nécessaire, créez de nouveau un jeton.

• Vous devez stocker le jeton en toute sécurité, comme pour tout mot de passe.

Utiliser un jeton d'API

Un des principaux cas d'usage des jetons d'API consiste à permettre aux scripts d'accéder aux API REST pour les produits Atlassian Cloud en utilisant l'authentification de base HTTP.

En fonction des détails de la bibliothèque HTTP que vous utilisez, il suffit de remplacer votre mot de passe par le jeton.Par exemple, lorsque vous utilisez la commande curl, vous pouvez avoir :

Remarque : ici, me@example.com est l'adresse e-mail associée au compte Atlassian que vous utilisez pour créer le jeton.

Tokens de API

Você pode usar um token de API para autenticar um script ou outro processo com um produto Atlassian Cloud.Você gera o token a partir de sua conta da Atlassian e, em seguida, copia e cola no script.

Se você usar a verificação em duas etapas para autenticar, o script vai precisar usar um token de API REST para autenticar.

Crie um token de API

Crie um token de API a partir de sua conta da Atlassian:

1. Entre em https://id.atlassian.com/manage/api-tokens.

2. Clique em Criar token de API.

3. Na caixa de diálogo que aparece, digite uma Categoria curta e fácil de lembrar para o token e clique em Criar.

4. Clique em Copiar para área de transferência e, em seguida, cole o token no script ou em qualquer outro lugar para salvar:

Observação:

• Por motivos de segurança, não é possível visualizar o token após fechar a caixa de diálogo de criação: se for necessário, crie um novo token.

• Você deve armazenar o token com segurança, como o faz com as senhas.

Use um token de API

Um caso de uso primário para tokens de API é permitir que scripts acessem APIs REST para produtos do Atlassian Cloud usando autenticação básica HTTP.

Dependendo dos dados da biblioteca de HTTP que você usa, substitua sua senha pelo token.Por exemplo, ao utilizar curl, você poderia fazer algo assim:

Observe que me@example.com aqui é o endereço de e-mail da conta da Atlassian que está sendo usada para criar o token.

API トークン

Mit einem API-Token können Sie ein Skript oder einen anderen Prozess bei einem Atlassian Cloud-Produkt authentifizieren.Dazu müssen Sie nur über Ihr Atlassian-Konto das Token erstellen, es kopieren und es im Skript einfügen.

Wenn Sie die Zwei-Faktor-Authentifizierung nutzen, ist bei Ihrem Skript ein REST-API-Token zur Authentifizierung erforderlich.

Erstellen eines API-Tokens

So erstellen Sie ein API-Token über Ihr Atlassian-Konto:

1. Loggen Sie sich unter https://id.atlassian.com/manage/api-tokensein.

2. Klicken Sie auf Create API token (API-Token erstellen).

3. Geben Sie im daraufhin angezeigten Dialogfeld ein leicht zu merkendes, kurzes Label für Ihr Token ein, und klicken Sie dann auf Create (Erstellen).

4. Klicken Sie auf Copy to clipboard (In die Zwischenablage kopieren), und fügen Sie das Token dann in Ihr Skript ein oder fügen Sie es an anderer Stelle ein, um es zu speichern:

Hinweis:

• Aus Sicherheitsgründen kann das Token nach dem Schließen des Erstellungsdialogfelds nicht noch einmal angezeigt werden.Erstellen Sie bei Bedarf ein neues Token.

• Bewahren Sie das Token ebenso wie alle anderen Passwörter sicher auf.

Verwenden eines API-Tokens

In erster Linie werden API-Token genutzt, um Skripts den Zugriff auf REST-APIs für Atlassian Cloud-Produkte unter Verwendung der grundlegenden HTTP-Authentifizierung zu gewähren.

Je nach den Details der von Ihnen genutzten HTTP-Bibliothek müssen Sie einfach nur Ihr Passwort durch das Token ersetzen.Bei curl könnte dies beispielsweise wie folgt aussehen:

Hinweis: me@example.com ist hier die E-Mail-Adresse des zum Erstellen des Tokens verwendeten Atlassian-Kontos.