Auth - AWS Serverless Application Model
構文プロパティ例

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Auth

GraphQL API 用の認可を設定します。

構文

AWS Serverless Application Model （AWS SAM) テンプレートでこのエンティティを宣言するには、次の構文を使用します。

YAML

Additional:
- AuthProvider
LambdaAuthorizer: LambdaAuthorizerConfig
OpenIDConnect: OpenIDConnectConfig
Type: String
UserPool: UserPoolConfig

プロパティ

Additional

GraphQL API 向けの、追加の認可タイプのリストです。

タイプ: AuthProvider のリスト

必須: いいえ

AWS CloudFormation 互換性: このプロパティは に固有 AWS SAM であり、 AWS CloudFormation 同等のものはありません。

LambdaAuthorizer

Lambda 関数オーソライザーのオプションの認可設定を指定します。このオプションプロパティは、Type を AWS_LAMBDA として指定する場合に設定できます。

タイプ: LambdaAuthorizerConfig

必須: いいえ

AWS CloudFormation 互換性: このプロパティは、 AWS::AppSync::GraphQLApiリソースの LambdaAuthorizerConfigプロパティに直接渡されます。

OpenIDConnect

OpenID Connect 準拠サービスのオプションの認可設定を指定します。このオプションプロパティは、Type を OPENID_CONNECT として指定する場合に設定できます。

タイプ: OpenIDConnectConfig

必須: いいえ

AWS CloudFormation 互換性: このプロパティは、 AWS::AppSync::GraphQLApiリソースの OpenIDConnectConfigプロパティに直接渡されます。

Type

アプリケーションと AWS AppSync GraphQL API 間のデフォルトの認可タイプ。

許可される値のリストと説明については、「AWS AppSync デベロッパーガイド」の「認証と認可」を参照してください。

Lambda オーソライザー () を指定するとAWS_LAMBDA、 は GraphQL API と Lambda 関数間のアクセス許可をプロビジョニングする AWS Identity and Access Management (IAM) ポリシー AWS SAM を作成します。

型: 文字列

必須: はい

AWS CloudFormation 互換性: このプロパティは、 AWS::AppSync::GraphQLApiリソースの AuthenticationTypeプロパティに直接渡されます。

UserPool

Amazon Cognito ユーザープールを使用するためのオプションの認可設定を指定します。このオプションプロパティは、Type を AMAZON_COGNITO_USER_POOLS として指定する場合に設定できます。

タイプ: UserPoolConfig

必須: いいえ

AWS CloudFormation 互換性: このプロパティは、 AWS::AppSync::GraphQLApiリソースの UserPoolConfigプロパティに直接渡されます。

例

デフォルトとその他の認可タイプの設定

この例では、まず Lambda オーソライザーを GraphQL API のデフォルトの認可タイプとして設定します。

AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
...
Resources:
  MyGraphQLAPI:
    Type: AWS::Serverless::GraphQLApi
    Properties:
      Auth:
        Type: AWS_LAMBDA
        LambdaAuthorizer:
          AuthorizerUri: !GetAtt Authorizer1.Arn
          AuthorizerResultTtlInSeconds: 10
          IdentityValidationExpression: hello

次に、 AWS SAM テンプレートに以下を追加して、GraphQL API のその他の認可タイプを設定します。

        Additional:
        - Type: AWS_IAM
        - Type: API_KEY
        - Type: OPENID_CONNECT
          OpenIDConnect:
            AuthTTL: 10
            ClientId: myId
            IatTTL: 10
            Issuer: prod

これにより、次の AWS SAM テンプレートが作成されます。

AWSTemplateFormatVersion: '2010-09-09'
Transform: AWS::Serverless-2016-10-31
...
Resources:
  MyGraphQLAPI:
    Type: AWS::Serverless::GraphQLApi
    Properties:
      Auth:
        Type: AWS_LAMBDA
        LambdaAuthorizer:
          AuthorizerUri: !GetAtt Authorizer1.Arn
          AuthorizerResultTtlInSeconds: 10
          IdentityValidationExpression: hello
        Additional:
        - Type: AWS_IAM
        - Type: API_KEY
        - Type: OPENID_CONNECT
          OpenIDConnect:
            AuthTTL: 10
            ClientId: myId
            IatTTL: 10
            Issuer: prod