게이트웨이 대상에 액세스할 권한 부여 유형 및 자격 증명을 지정합니다.

CreateGatewayTarget 요청 본문에서 credentialProviderConfigurations 배열에 자격 증명 공급자 구성을 지정합니다. 구성은 설정한 아웃바운드 권한 부여 유형에 따라 다릅니다. 자격 증명 공급자 구성의 API 구조에 대한 참조 정보는 CredentialProviderConfiguration을 참조하세요. 아웃바운드 권한 부여에 대한 자세한 내용은 게이트웨이에 대한 아웃바운드 권한 부여 설정을 참조하세요.

자격 증명 공급자 구성에 대해 자세히 알아보려면 주제를 선택합니다.

AgentCore Gateway 서비스 역할(IAM) 권한 부여

대상에 대한 AgentCore Gateway 서비스 역할을 통해 IAM 권한 부여를 사용하는 경우를 GATEWAY_IAM_ROLE credentialProviderType로 지정합니다. 구성은 대상 유형에 따라 다릅니다.

Lambda, API Gateway, Smithy 및 Connector 대상의 경우

대상 서비스 이름이 AgentCore Gateway 서비스에 이미 알려져 있으므로 iamCredentialProvider 구성이 필요하지 않습니다. 다음 예제와 같이 credentialProviderType 구성만 사용합니다.

{
    "credentialProviderType": "GATEWAY_IAM_ROLE"
}

MCP 서버 및 OpenAPI 대상의 경우

MCP 서버 및 OpenAPI 대상의 경우 서명 버전 iamCredentialProvider 4(Sig V4) 서명에 사용되는 서비스 이름도에 제공해야 합니다. AWS V4 service 필드는 필수 사항입니다. region 필드는 선택 사항이며 기본적으로 게이트웨이의 리전으로 설정됩니다.

{
    "credentialProviderType": "GATEWAY_IAM_ROLE",
    "credentialProvider": {
        "iamCredentialProvider": {
            "service": "execute-api",
            "region": "us-west-2"
        }
    }
}

다음 표에서는 iamCredentialProvider 객체의 필드를 설명합니다.

OAuth 권한 부여

OAuth 권한 부여를 사용하는 경우를 OAUTH credentialProviderType로 지정합니다. credentialProvider 필드가 매핑되는 객체에서 oauthCredentialProvider 필드 이름을 OAuthCredentialProvider 객체에 매핑하고 아웃바운드 권한 부여 설정에 따라 값을 제공합니다.

OAuthCredentialProvider의 구조는 설정한 인증 패턴 유형에 따라 다릅니다. 다양한 인증 패턴에 대한 자세한 내용은 지원되는 인증 패턴을 참조하세요.

다음 방법 중 하나를 선택합니다.

API 키 권한 부여

API 키 권한 부여를 설정하는 경우를 API_KEY credentialProviderType로 지정합니다. credentialProvider 필드가 매핑되는 객체에서 apiKeyCredentialProvider 필드 이름을 ApiKeyCredentialProvider 객체에 매핑하고 아웃바운드 권한 부여 설정에 따라 값을 제공합니다. 다음 JSON은 구조를 보여줍니다.

{
    "credentialProviderType": "API_KEY",
    "credentialProvider": {
        "apiKeyCredentialProvider": {
            "providerArn": "string",
            "credentialLocation": "HEADER" | "QUERY_PARAMETER",
            "credentialParameterName": "string",
            "credentialPrefix": "string"
        }
    }
}

호출자 IAM 자격 증명 권한 부여

게이트웨이가 호출자의 IAM 자격 증명 및 권한을 사용하여 다운스트림 대상에 대한 요청에 서명하도록 하려면를 credentialProviderType로 지정합니다CALLER_IAM_CREDENTIALS. 이 권한 부여 유형을 사용하면 게이트웨이는 SigV4를 사용하여 게이트웨이 호출자를 대신하여 다운스트림 대상에 요청합니다. 이렇게 하면 다운스트림 대상이 원래 게이트웨이를 호출한 사용자를 기반으로 IAM 정책을 적용할 수 있습니다.

{
    "credentialProviderType": "CALLER_IAM_CREDENTIALS"
}

JWT 패스스루 권한 부여

게이트웨이가 수신 요청의 보유자 토큰을 수정하지 않고 다운스트림 대상으로 직접 전달하도록 하려면를 credentialProviderType로 지정합니다JWT_PASSTHROUGH. 게이트웨이는 인바운드 토큰을 검증한 다음 아웃바운드 요청의 대상으로 전달합니다. 이는 대상 서비스가 원래 호출자의 토큰을 사용하여 자체 인증을 처리할 때 유용합니다.

{
    "credentialProviderType": "JWT_PASSTHROUGH"
}