トークンの操作

はじめに

Catalyst CLIは、CLIセッションを特定のユーザーアカウントに関連付けて検証するトークンを提供します。CLIにログインしている場合、実行するコマンドは内部的にトークンによって認証されます。ただし、トークンを手動で生成し、アクティブなログインセッションなしですべてのCLIアクティビティを実行するために使用することもできます。

トークンは、CLIに独自にログインする必要がない継続的インテグレーションシステムなどのリモートシステムからCatalyst CLIにアクセスする場合に非常に便利です。生成したCLIトークンを使用して、CIシステムにCatalystへのアクセス認証を提供し、CLIコマンドをリモートで実行できます。

CLIトークンは、CLIからユーザーアカウントにログインしている場合にのみ生成できます。生成後は、アクティブなログインセッションがなくても、任意のデバイスからそのトークンを使用してCLI操作をリモートで実行できます。このトークンはそのユーザーアカウントの認証要素として機能し、指定したプロジェクトへのコマンド実行のマッピングを継続します。

また、Catalystプロジェクトのコラボレーターに特定のユーザーアカウントのトークンを提供して、ユーザーログイン資格情報を提供することなくCLI操作を実行できるようにすることもできます。

トークンが生成されると、そのトークンを識別するための一意のIDが作成されます。トークンを取り消す際には、このトークンIDを使用する必要があります。

トークンを使用する際は、以下の重要な点に留意してください：

• トークンはCLIからのみ生成でき、CLIターミナルでのみ使用できます。CLI環境外ではトークンを操作できません。
• 特定のデバイスのターミナルでトークンを生成した場合、そのトークンは同じターミナルからのみ取り消すことができます。別のデバイスのターミナルからは取り消すことができません。ただし、そのトークンを使用して任意のデバイスや環境からCLI操作を実行できます。
• トークンは、生成時のユーザーアカウントのデータセンターに関連付けられます。そのため、コマンド実行にトークンを使用すると、同じデータセンターからCatalystにアクセスされます。
• Catalyst CLIで生成されたトークンは永久に有効です。個人的に取り消さない限り、期限切れにはなりません。
• ユーザーアカウントに複数のトークンを作成し、任意のデバイスからいつでもそれらのトークンを使用できます。