기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

클라이언트 인증 방법

클라이언트 인증 방법은 액세스 토큰을 요청할 때 OAuth 클라이언트가 권한 부여 서버의 토큰 엔드포인트로 인증하는 방법을 제어합니다.

공급자별 자격 증명 공급자의 경우 AgentCore 자격 증명은 각 공급업체의 요구 사항에 따라 클라이언트 인증 방법을 관리하므로 추가 구성이 필요하지 않습니다.

클라이언트 보안 암호 대신 IAM 서명 JWT 어설션으로 인증하거나 기본 제공 공급업체와 요구 사항이 다른 권한 부여 서버를 대상으로 하는 등 보다 세분화된 제어가 필요한 사용 사례의 경우 사용자 지정 공급자를 사용하면 아래에서 지원되는 방법 중에서 선택할 수 있습니다.

지원되는 클라이언트 인증 방법

AgentCore Identity는 클라이언트 인증 방법에 대해 다음 값을 지원합니다.

클라이언트 인증 방법을 구성하는 방법

CustomOauth2에 대한 클라이언트 인증 방법 구성

AWS 콘솔에서 사용자 지정 공급자에 대한 클라이언트 인증 방법을 구성하려면 사용자 지정 공급자를 사용하여 OAuth 클라이언트 추가를 참조하세요. CLI를 사용하여 구성할 수도 있습니다.

CLI 예제: CLIENT_SECRET_BASIC 클라이언트 인증 방법으로 사용

aws bedrock-agentcore-control create-oauth2-credential-provider \
  --cli-input-json '{
    "name": "sample-client-basic",
    "credentialProviderVendor": "CustomOauth2",
    "oauth2ProviderConfigInput": {
      "customOauth2ProviderConfig": {
        "oauthDiscovery": {
          "discoveryUrl": "https://my.idp.com/.well-known/openid-configuration"
        },
        "clientId": "your-client-id",
        "clientSecret": "your-client-secret",
        "clientAuthenticationMethod": "CLIENT_SECRET_BASIC"
      }
    }
  }'

CLI 예제: AWS_IAM_ID_TOKEN_JWT 클라이언트 인증 방법으로 사용

aws bedrock-agentcore-control create-oauth2-credential-provider \
  --cli-input-json '{
    "name": "sample-iam-jwt",
    "credentialProviderVendor": "CustomOauth2",
    "oauth2ProviderConfigInput": {
      "customOauth2ProviderConfig": {
        "oauthDiscovery": {
          "discoveryUrl": "https://my.idp.com/.well-known/openid-configuration"
        },
        "clientId": "your-client-id",
        "clientAuthenticationMethod": "AWS_IAM_ID_TOKEN_JWT"
      }
    }
  }'

CLI 예제: PRIVATE_KEY_JWT 클라이언트 인증 방법으로 사용

aws bedrock-agentcore-control create-oauth2-credential-provider \
  --cli-input-json '{
    "name": "sample-private-key-jwt",
    "credentialProviderVendor": "CustomOauth2",
    "oauth2ProviderConfigInput": {
      "customOauth2ProviderConfig": {
        "oauthDiscovery": {
          "discoveryUrl": "https://your-idp.example.com/.well-known/openid-configuration"
        },
        "clientId": "your-client-id",
        "clientAuthenticationMethod": "PRIVATE_KEY_JWT",
        "privateKeyJwtConfig": {
          "privateKeySource": {
            "kmsKeySource": {
              "kmsKeyArn": "arn:aws:kms:us-east-1:111122223333:key/your-key-id"
            }
          },
          "signingAlgorithm": "RS256"
        }
      }
    }
  }'

KMS 키 설정, 교차 계정 지원 및 서명 알고리즘 옵션을 포함한 전체 구성 참조에 대한 자세한 내용은 프라이빗 키 JWT를 참조하세요.

알림

이 tokenEndpointAuthMethods 필드는 클라이언트 인증 방법을 선호하지 않지만 CLI 및 SDK의 이전 버전과의 호환성을 위해 유지됩니다. 동일한 요청에 둘 다 제공하면 검증 오류가 발생합니다.