資格情報のローテーションを行う

Auth0 Dashboardでアプリケーションの資格情報をローテーションする方法：

1. ［Auth0 Dashboard］ > ［Applications（アプリケーション）］ > ［Applications（アプリケーション）］に移動し、更新したいアプリケーションを選択します。

2. ［Credentials（資格情報）］タブに切り替えます。

3. ［Available Credentials（利用可能な資格情報）］セクションで、［Add New Key（新しいキーを追加）］を選択します。

4. 新しい資格情報の名前、PEM形式の公開鍵、新しい資格情報のアルゴリズムを設定します。

5. ［Add Credential（資格情報の追加）］を選択します。

6. 新しい資格情報を有効にするには、資格情報のメニューに移動し、［Enable for Private Key JWT use（秘密鍵JWTの使用を有効にする）］を選択します。

7. 新しい資格情報を使用するためにアプリケーションを更新したら、元の資格情報は無効にします。

   1. ［Disable for Private Key JWT Use（秘密鍵JWTの使用を無効にする）］を選択します。

   2. 無効にしたら、資格情報のメニューに戻り、［Delete Credential（資格情報の削除）］を選択します。

下のローテーション例は、credentialは使用している既存の資格情報、credential2は既存の資格情報に代わる新しい資格情報です。

1. 新しいキーペアを生成します。

2. Management APIに対してPOST要求を使用して、資格情報リソースを作成します。

   アプリケーションでの保管は現在、一度に2つの資格情報までに制限されています。新しい資格情報を繰り返しローテーションするには、使用していない資格情報を削除する必要があります。

3. Management APIのクライアントの更新エンドポイントにPATCH要求を行い、認証方法private_key_jwtに資格情報を関連付けます。

   curl --location --request PATCH 'https://{domain}/api/v2/clients/{clientId} \
     --header 'Authorization: Bearer {managementApiAccessToken} \
     --header 'Content-Type: application/json' \
     --data-raw '{
             "client_authentication_methods": {
                "private_key_jwt": {
                   "credentials": [{ "id": {credentialId1} }, { "id": {credentialId2} }]
                }
             }
      }'

   Was this helpful?

   Yes /No

   パラメーター	説明
   clientId	更新したいアプリケーション。
   credentialId1	使用している既存の資格情報のID。
   credentialId2	新しい資格情報のID。
   managementApiAccessToken	update:clientsとupdate:credentialsのスコープを持つManagement APIのアクセストークン。

4. アプリケーションを更新し、新しい秘密鍵を使用して、Auth0認証APIに対してアサーションを署名します。

5. 使用していないキーをアプリケーションから削除します。

   curl --location --request PATCH 'https://{domain}/api/v2/clients/{clientId} \
     --header 'Authorization: Bearer $management_access_token' \
     --header 'Content-Type: application/json' \
     --data-raw '{
             "client_authentication_methods": {
                "private_key_jwt": {
                   "credentials": [{ "id": {credentialId2} }]
                }
             }
      }'

   Was this helpful?

   Yes /No

6. 使用していないキーをアプリケーションから削除します。これにより、ストレージから資格情報を永久に削除します。資格情報をアプリケーションから解除しなければ、削除できません。

   curl --location --request DELETE 'https://{domain}/api/v2/clients/{clientId}/credentials/{credentialId}' \
     --header 'Authorization: Bearer {managementApiAccessToken}

   Was this helpful?

   Yes /No

   パラメーター	説明
   clientId	更新したいアプリケーション。
   credentialId	削除したい古い資格情報のID。
   managementApiAccessToken	delete:credentialsのスコープを持つManagement APIのアクセストークン。