[アップデート] Amazon Cognito のアプリクライアントシークレットを AWS Secrets Manager で管理できるようになったので試してみた

[アップデート] Amazon Cognito のアプリクライアントシークレットを AWS Secrets Manager で管理できるようになったので試してみた

Amazon Cognito のアプリクライアントシークレットを AWS Secrets Manager で管理できるようになりました。実際にアプリクライアントで有効にし、ローテーションの前後でどのシークレットが使えるのかを検証しました。
2026.11.20

はじめに

2026 年 11 月 19 日、Amazon Cognito のアプリクライアントシークレットを AWS Secrets Manager で管理できるようになりました。

これを有効にすると、Cognito がクライアントシークレットを Secrets Manager に保存し、一定期間でローテーションしてくれます。アプリ側からは Secrets Manager から最新の値を読み出して使う形になります。

https://aws.amazon.com/about-aws/whats-new/2026/11/cognito-secrets-manager-integration/

この記事では、新しいアプリクライアントと既存のアプリクライアントのそれぞれで管理を有効にし、ローテーションの前後でどのシークレットが使えるのかを検証してみます。

クライアントシークレットのローテーションとの違い

Cognito では、2026 年 2 月にもクライアントシークレットのローテーションとカスタムシークレットがサポートされていました。

https://dev.classmethod.jp/articles/amazon-cognito-client-secret-lifecycle/

こちらは、AddUserPoolClientSecret で新しいシークレットを追加し、DeleteUserPoolClientSecret で古いシークレットを削除する仕組みです。1 つのアプリクライアントに最大 2 つのシークレットを持たせられるので、アプリ側の切り替えを待ってから古い方を削除できます。

今回の機能では、この追加と削除を Cognito が自動で行ってくれます[1]。

項目 2 月に追加された機能 Secrets Manager での管理
ローテーション 自分で API を呼び出す Cognito が既定で 7 日ごとに行う
シークレットの値の取得 シークレットを作成したときの応答 Secrets Manager の GetSecretValue
カスタムシークレット 使える 使えない

新しいアプリクライアントで管理を有効にする

マネジメントコンソールでアプリクライアントを作成すると、「AWS Secrets Manager にシークレットを保存 - 推奨」が既定になっていました。

アプリケーションクライアントの作成画面で「AWS Secrets Manager にシークレットを保存 - 推奨」が ON になっている

一方、API や AWS CLI では無効がデフォルトでした。CLI では、--generate-secret と一緒に --publish-secrets-in-aws-secrets-manager を指定します。

aws cognito-idp create-user-pool-client \
  --user-pool-id ap-northeast-1_NtwV7jZ7h \
  --client-name managed-new \
  --generate-secret \
  --publish-secrets-in-aws-secrets-manager \
  --allowed-o-auth-flows client_credentials \
  --allowed-o-auth-scopes blog-api/read \
  --allowed-o-auth-flows-user-pool-client

応答には ClientSecretArn が含まれていました。シークレットの平文は含まれないようですね。

{
    "UserPoolClient": {
        "UserPoolId": "ap-northeast-1_NtwV7jZ7h",
        "ClientName": "managed-new",
        "ClientId": "4a6qri5mspfaeqc11sf8cjg38n",
        "ClientSecretArn": "arn:aws:secretsmanager:ap-northeast-1:123456789012:secret:cognito-idp!4a6qri5mspfaeqc11sf8cjg38n-oXyHGe",
        "AllowedOAuthFlows": [
            "client_credentials"
        ],
        "AllowedOAuthScopes": [
            "blog-api/read"
        ],
        "AllowedOAuthFlowsUserPoolClient": true
    }
}

describe-user-pool-client や、コンソールのアプリケーションクライアントの詳細画面でもシークレットは確認できませんでした。「クライアントシークレット」タブを確認すると、Cognito の API やコンソールからはシークレットを作成・表示・削除できないとしっかり明記されていました。

アプリケーションクライアントの詳細画面に Secrets Manager のシークレット ARN が表示され、クライアントシークレットタブに Secrets Manager で管理されている旨が表示されている

Secrets Manager 側には cognito-idp!<クライアント ID> という名前のシークレットが作られていました。

aws secretsmanager describe-secret \
  --secret-id 'cognito-idp!4a6qri5mspfaeqc11sf8cjg38n'
{
    "Name": "cognito-idp!4a6qri5mspfaeqc11sf8cjg38n",
    "RotationEnabled": true,
    "RotationRules": {
        "AutomaticallyAfterDays": 7
    },
    "NextRotationDate": "2026-11-28T08:59:59+09:00",
    "VersionIdsToStages": {
        "3565a8de-9849-4e2b-a0ba-4921b94feea5": [
            "AWSCURRENT"
        ],
        "879111fc-51ab-4459-9652-bc54dd56cce8": [
            "AWSPENDING"
        ]
    },
    "OwningService": "cognito-idp"
}

気になったのは VersionIdsToStages で、作成した直後から AWSPENDING のバージョンがありました。新しく作ったアプリクライアントでも、作成と同時に初回のローテーションが始まるようです。

Secrets Manager から取得したシークレットでトークンを取得する

get-secret-value で取得できる SecretString は、以下のような JSON でした。

{
  "clientSecretValue": "<クライアントシークレット>",
  "userPoolId": "ap-northeast-1_NtwV7jZ7h",
  "userPoolClientId": "4a6qri5mspfaeqc11sf8cjg38n"
}

clientSecretValue を取り出し、トークンエンドポイントに client_credentials でリクエストします。

SECRET=$(aws secretsmanager get-secret-value \
  --secret-id 'cognito-idp!4a6qri5mspfaeqc11sf8cjg38n' \
  --query SecretString --output text | jq -r .clientSecretValue)

curl -s -u "4a6qri5mspfaeqc11sf8cjg38n:$SECRET" \
  -d "grant_type=client_credentials&scope=blog-api/read" \
  https://<ドメインのプレフィックス>.auth.ap-northeast-1.amazoncognito.com/oauth2/token
{"access_token":"eyJraWQiOi...","expires_in":3600,"token_type":"Bearer"}

と、Secrets Manager から取得したシークレットで、問題なくトークンを取得できました!

初回のローテーションの途中だったので、AWSPENDING のバージョンの値でも試してみましたところ、こちらでもトークンを取得できました。

初回のローテーションは、作成から数分で完了しました。AWSPENDING だった値が AWSCURRENT になり、最初の値は AWSPREVIOUS になります。どちらの値でも、引き続きトークンを取得できました。

既存のアプリクライアントで有効にしてみる

次は、平文のシークレットを持つ既存のアプリクライアントで管理を有効にしてみます。

update-user-pool-client で --publish-secrets-in-aws-secrets-manager を指定します。UpdateUserPoolClient では、指定しなかった設定が既定値に戻ってしまう[2]ので、OAuth の設定も併せて指定しています。

aws cognito-idp update-user-pool-client \
  --user-pool-id ap-northeast-1_NtwV7jZ7h \
  --client-id mso4rdlid0as421uodoue4dp9 \
  --client-name existing \
  --publish-secrets-in-aws-secrets-manager \
  --allowed-o-auth-flows client_credentials \
  --allowed-o-auth-scopes blog-api/read \
  --allowed-o-auth-flows-user-pool-client

応答には ClientSecretArn が返り、Secrets Manager にシークレットが作られました。AWSCURRENT の値は、有効にする前から使っていた平文のシークレットと同じです。有効にしただけでは、既存のシークレットを使っているアプリは影響を受けないということですね。

この時もすぐに初回のローテーションが始まり、数分で完了しました。

手動でローテーションする

初回のローテーションが終わった後も、有効にする前からの平文のシークレットは AWSPREVIOUS として使えるまま残っていました。この古い値がいつ使えなくなるのかを確かめるため、次のローテーションを見てみます。

Secrets Manager の rotate-secret でローテーションしてみました。

aws secretsmanager rotate-secret \
  --secret-id 'cognito-idp!mso4rdlid0as421uodoue4dp9'

実行の前後でそれぞれの値でトークンを取得できるかを試したところ、以下のようになりました。

値 実行前 実行から 30 秒ほど後 完了後
有効にする前からの平文のシークレット AWSPREVIOUS、使える AWSPREVIOUS、使えない バージョンが削除された
初回のローテーションで作られた値 AWSCURRENT、使える AWSCURRENT、使える AWSPREVIOUS、使える
今回のローテーションで作られた値 なし AWSPENDING、使える AWSCURRENT、使える

ローテーションは実行から数分で完了し、有効にする前からの平文のシークレットは、ローテーションの完了を待たずに実行してすぐ使えなくなりました。

これに関連してか、ドキュメントではアプリの起動時に Secrets Manager から読み出すこと、認証に失敗したら読み出し直して再試行することが推奨されています。

管理を有効にすると使えなくなる操作

管理を有効にしたアプリクライアントでは、AddUserPoolClientSecret でシークレットを操作できなくなります。試してみると以下のエラーが返りました。

aws cognito-idp add-user-pool-client-secret \
  --user-pool-id ap-northeast-1_NtwV7jZ7h \
  --client-id 4a6qri5mspfaeqc11sf8cjg38n
aws: [ERROR]: An error occurred (InvalidParameterException) when calling the AddUserPoolClientSecret operation: Cannot add a new secret to a client when the client's secrets are managed by AWS Secrets Manager.

delete-user-pool-client-secret も同様に拒否されました。

aws: [ERROR]: An error occurred (InvalidParameterException) when calling the DeleteUserPoolClientSecret operation: Cannot delete a secret managed by AWS Secrets Manager

カスタムシークレットとの併用もできません。--client-secret と --publish-secrets-in-aws-secrets-manager を同時に指定すると、作成の時点で拒否されます。

aws: [ERROR]: An error occurred (InvalidParameterException) when calling the CreateUserPoolClient operation: Cannot specify both custom secret and publishSecretsInAWSSecretsManager. Use only one option.

なお、ドキュメントにはこれらの操作が InvalidInputException で失敗すると書かれていますが、検証時点で実際に返ってきたのは InvalidParameterException でした。エラーの種類で処理を分けている場合は気を付けてください。

管理を無効に戻す

最後に、既存のアプリクライアントで管理を無効に戻してみます。

aws cognito-idp update-user-pool-client \
  --user-pool-id ap-northeast-1_NtwV7jZ7h \
  --client-id mso4rdlid0as421uodoue4dp9 \
  --client-name existing \
  --no-publish-secrets-in-aws-secrets-manager \
  --allowed-o-auth-flows client_credentials \
  --allowed-o-auth-scopes blog-api/read \
  --allowed-o-auth-flows-user-pool-client

応答には平文の ClientSecret が返りました。値は直前の AWSCURRENT と同じです。

管理を外すと Cognito がシークレットを Cognito 側に戻し、従来のアプリクライアントと同じく平文を返すようになるためです。

一方、Secrets Manager のシークレットはすぐに削除され、get-secret-value は ResourceNotFoundException になりました。restore-secret でも復元できませんでした。

aws: [ERROR]: An error occurred (ResourceNotFoundException) when calling the RestoreSecret operation: Secrets Manager can't find the specified secret.

無効にした時点で、Secrets Manager から読み出しているアプリは新しい値を取得できなくなるため、先にアプリ側を平文のシークレットを使う形に戻しておく必要がありそうです。

おわりに

Secrets Manager での管理を有効にすると、クライアントシークレットのローテーションを Cognito に任せられるようになりました。有効にすると、作成時でも既存のクライアントでもすぐに初回のローテーションが始まる点は注意が必要そうです。

また、古い値は次のローテーションが始まるとすぐ使えなくなるため、アプリは定期的に読み出し直し、認証に失敗したら読み出し直す作りにしておくのが安心です。

脚注
  1. https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-settings-client-apps.html ↩︎

  2. https://docs.aws.amazon.com/cognito-user-identity-pools/latest/APIReference/API_UpdateUserPoolClient.html ↩︎

この記事をシェアする

関連記事