個人アクセストークンを使用すると、Alibaba Cloud DevOps API の呼び出しと、HTTP 経由での git オペレーションの実行が可能になります。このトピックでは、個人アクセストークンのセキュリティガイドラインと取得方法について説明します。
トークンの認可
-
トークンを作成する際には、トークンがアクセスできる API 権限を選択し、有効期間を設定する必要があります。権限を選択する際は最小権限の原則に従い、有効期間は実際に必要な期間に設定し、トークンを永続化しないようにしてください。
-
トークンは、リクエストを行ったユーザーと同じリソースにアクセスし、同じオペレーションを実行できますが、トークンに付与された API 権限スコープによってさらに制限されます。トークンは、ユーザーに追加の権限を付与することはできません。
安全な保管
認証情報は、パスワードやその他の機密情報と同様に取り扱ってください。
-
暗号化されていないメッセージ、電子メール、インスタントメッセージ、または同様のシステムでトークンを共有しないでください。
-
コマンドラインでトークンをプレーンテキストで渡さないでください。
-
暗号化されていないトークンをパブリックコードリポジトリやその他の管理されていないシステムにプッシュしないでください。
慎重な使用
-
ソースコードにトークンをハードコーディングしたり、パブリックリポジトリにプッシュしたりしないでください。代わりに、トークンを環境変数に保存し、API オペレーションを呼び出す際にその変数を読み取ってリクエストボディにトークンを追加してください。これにより、コードへの不正アクセスによるトークンの漏洩を防ぎ、データ侵害につながるリスクを回避できます。
-
永続的なトークンを避け、定期的または必要に応じてトークンをローテーションする習慣を身につけてください。
-
トークンが漏洩したことが判明した場合は、直ちに削除してください。
操作手順
API 呼び出しと Git オペレーションに使用されるトークンのセキュリティを維持するため、Alibaba Cloud DevOps は、トークンの作成時にのみトークンを返して表示します。以降のリクエストでは、元のトークンを取得することはできません。また、Alibaba Cloud DevOps は、作成されたトークンを保管前に暗号化するため、保管中のトークンのセキュリティが確保されます。
トークンをリクエストして使用する際は、「最小権限、安全な保管、慎重な使用」というセキュリティ原則に従い、潜在的なセキュリティリスクを軽減してください。
-
[Alibaba Cloud DevOps ワークベンチ]にログオンします。ログオン方法の詳細については、「アカウントとログオン」をご参照ください。
-
[ワークベンチ] ページで、右上隅にある [プロフィール写真] をクリックし、表示されるメニューで [個人設定] をクリックします。
-
[個人設定] ページで、[アクセストークン] をクリックし、[アクセストークンの作成] をクリックして、次のパラメーターを設定します。
パラメータ
説明
[トークン名]
トークンのカスタム名。名前は最大 64 文字です。
[説明]
個人アクセストークンの任意の説明。
[有効期限]
トークンの有効期間。
警告トークンの有効期限が切れた後は、API オペレーションの呼び出しに使用できません。
[権限の選択]
シナリオに必要な権限。設定する際は最小権限の原則に従ってください。
-
設定が正しいことを確認し、ページ下部の[作成]をクリックします。
-
生成されたトークンを保存してください。トークンはこの 1 回のみ表示され、再度表示することはできません。