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

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

Amazon Cognito のアプリクライアントシークレットを AWS Secrets Manager で管理できるようになりました。新規のアプリクライアントで有効化すると応答に ClientSecretArn が返ること、Secrets Manager から取得した値で認証できることを AWS CLI で確認しました。
2026.11.20

はじめに

2026年11月19日に、Amazon Cognito のアプリクライアントシークレットを AWS Secrets Manager に保存して管理できるようになったことが発表されました。

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

この記事では、新規のアプリクライアントで Secrets Manager での管理を有効化し、保存された値を取得して、その値で認証するところまでを AWS CLI で試します。

検証環境

  • リージョン: ap-northeast-1
  • AWS CLI: 2.41.2
  • ユーザープール: 検証用に新規作成

以降のコマンドは、次の環境変数を設定したシェルで実行します。

export AWS_REGION=ap-northeast-1

アプリクライアントの作成

アプリクライアントシークレットは、サーバー側で動くアプリが自分自身を Cognito に示すための秘密値で、API リクエストに含める SECRET_HASH の計算に使います。新規のアプリクライアントでの有効化は、create-user-pool-client に --publish-secrets-in-aws-secrets-manager を付けて行います。Secrets Manager に保存されるのは Cognito が生成したシークレットなので、--generate-secret と併用します。--explicit-auth-flows は、後述の認証で USER_PASSWORD_AUTH を使うための指定です。

aws cognito-idp create-user-pool-client \
  --user-pool-id <ユーザープールID> \
  --client-name verify-managed-secret \
  --generate-secret \
  --publish-secrets-in-aws-secrets-manager \
  --explicit-auth-flows ALLOW_USER_PASSWORD_AUTH ALLOW_REFRESH_TOKEN_AUTH \
  --output json

応答には、ClientSecret の代わりに ClientSecretArn が含まれていました。

{
    "UserPoolClient": {
        "UserPoolId": "ap-northeast-1_EXAMPLE",
        "ClientName": "verify-managed-secret",
        "ClientId": "1example23456789",
        "ClientSecretArn": "arn:aws:secretsmanager:ap-northeast-1:123456789012:secret:cognito-idp!1example23456789-AbCdEf",
        "LastModifiedDate": "2026-11-20T09:58:52.732000+09:00",
        "CreationDate": "2026-11-20T09:58:51.833000+09:00",
        "RefreshTokenValidity": 30,
        "TokenValidityUnits": {},
        "ExplicitAuthFlows": [
            "ALLOW_USER_PASSWORD_AUTH",
            "ALLOW_REFRESH_TOKEN_AUTH"
        ],
        "AllowedOAuthFlowsUserPoolClient": false,
        "EnableTokenRevocation": true,
        "EnablePropagateAdditionalUserContextData": false,
        "AuthSessionValidity": 3,
        "ClientType": "REGULAR"
    }
}

作成後に describe-user-pool-client を実行しても、応答に ClientSecret は含まれず、ClientSecretArn が返りました。

比較のために、--publish-secrets-in-aws-secrets-manager を付けず --generate-secret だけでアプリクライアントを作成しました。この場合は、create-user-pool-client と describe-user-pool-client のどちらの応答にも平文の ClientSecret が含まれ、ClientSecretArn は含まれませんでした。次は create-user-pool-client の応答の先頭部分です。ClientSecret の値は伏せています。

{
    "UserPoolClient": {
        "UserPoolId": "ap-northeast-1_EXAMPLE",
        "ClientName": "verify-unmanaged-secret",
        "ClientId": "1example23456789",
        "ClientSecret": "<マスク済み>",
        ...
    }
}

サービスリンクロール AWSServiceRoleForAmazonCognitoIdp が、アプリクライアントの作成直後にアカウントへ自動作成されたことを確認しました。

シークレットの値の取得

ClientSecretArn を get-secret-value の --secret-id に渡すと、シークレットの値を取得できます。ARN に含まれる ! はシェルの履歴展開の対象になるため、シングルクォートで囲みます。

aws secretsmanager get-secret-value --secret-id '<ClientSecretArn>' --output json

SecretString は JSON 形式で、シークレット本体は clientSecretValue キーに格納されています。次の応答では、clientSecretValue の実際の値を <MASKED> に置き換えています。

{
  "ARN": "arn:aws:secretsmanager:ap-northeast-1:123456789012:secret:cognito-idp!1example23456789-AbCdEf",
  "Name": "cognito-idp!1example23456789",
  "VersionId": "EXAMPLE1-90ab-cdef-fedc-ba987EXAMPLE",
  "SecretString": "{\"userPoolClientId\":\"1example23456789\",\"userPoolId\":\"ap-northeast-1_EXAMPLE\",\"clientSecretValue\":\"<MASKED>\"}",
  "VersionStages": [
    "AWSCURRENT"
  ],
  "CreatedDate": "2026-11-20T09:58:52.550000+09:00"
}

取得した値での認証

シークレットを持つアプリクライアントで認証するには、SECRET_HASH を渡す必要があります。SECRET_HASH は、ユーザー名とクライアントIDを連結した文字列から、clientSecretValue を鍵とする HMAC-SHA256 を計算し、Base64 エンコードした値です。

https://docs.aws.amazon.com/cognito/latest/developerguide/signing-up-users-in-your-app.html

認証の確認には、パスワードが確定済みのテストユーザーを使います。作成コマンドは次のとおりです。

テストユーザーの作成
export POOL=<ユーザープールID>
export TESTUSER=<テストユーザー名>
export TESTPW=<テストユーザーのパスワード>

aws cognito-idp admin-create-user --user-pool-id $POOL --username $TESTUSER --message-action SUPPRESS --output json
aws cognito-idp admin-set-user-password --user-pool-id $POOL --username $TESTUSER --password "$TESTPW" --permanent

次のスクリプトを auth-with-managed-secret.sh として保存します。末尾の jq は、出力に含まれるトークンを <MASKED> に置き換えるためのものです。

#!/usr/bin/env bash
# Secrets Manager から clientSecretValue を取得し、SECRET_HASH を計算して initiate-auth を実行する
# 必要な環境変数: SECRET_ARN, CID, TESTUSER, TESTPW, AWS_REGION
set -euo pipefail
SECRET=$(aws secretsmanager get-secret-value --secret-id "$SECRET_ARN" --query SecretString --output text | jq -r .clientSecretValue)
SECRET_HASH=$(printf '%s' "${TESTUSER}${CID}" | openssl dgst -sha256 -hmac "$SECRET" -binary | base64)
aws cognito-idp initiate-auth \
  --client-id "$CID" \
  --auth-flow USER_PASSWORD_AUTH \
  --auth-parameters "USERNAME=$TESTUSER,PASSWORD=$TESTPW,SECRET_HASH=$SECRET_HASH" \
  --output json \
  | jq '.AuthenticationResult |= with_entries(if .key|test("Token$") then .value="<MASKED>" else . end)'

テストユーザーの作成時に設定した TESTUSER と TESTPW、検証環境で設定した AWS_REGION に加えて、SECRET_ARN と CID を設定してからスクリプトを実行します。

export SECRET_ARN='<ClientSecretArn>'
export CID=<クライアントID>

bash auth-with-managed-secret.sh

応答には AuthenticationResult が含まれていました。Secrets Manager から取得した値で計算した SECRET_HASH が受け入れられ、テストユーザーとして認証できました。

{
  "ChallengeParameters": {},
  "AuthenticationResult": {
    "AccessToken": "<MASKED>",
    "ExpiresIn": 3600,
    "TokenType": "Bearer",
    "RefreshToken": "<MASKED>",
    "IdToken": "<MASKED>"
  }
}

まとめ

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

従来は、API の応答に平文の ClientSecret が含まれていました。今回のアップデートで有効化したアプリクライアントでは、応答に ClientSecretArn が返り、Secrets Manager から取得した値で計算した SECRET_HASH でテストユーザーの認証が通ることを確認できました。

Secrets Managerの料金は別途発生しますが、アプリクライアントシークレットの露出リスクを抑えたい場合に、今回のアップデートをお試しください。

この記事をシェアする

AWSのお困り事はクラスメソッドへ

関連記事