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

# HttpApiFunctionAuth
<a name="sam-property-function-httpapifunctionauth"></a>

이벤트 수준에서 권한 부여를 구성합니다.

특정 API \$1 경로 \$1 방법에 대한 권한 부여 구성 

## 구문
<a name="sam-property-function-httpapifunctionauth-syntax"></a>

 AWS Serverless Application Model (AWS SAM) 템플릿에서이 개체를 선언하려면 다음 구문을 사용합니다.

### YAML
<a name="sam-property-function-httpapifunctionauth-syntax.yaml"></a>

```
  [AuthorizationScopes](#sam-function-httpapifunctionauth-authorizationscopes): List
  [Authorizer](#sam-function-httpapifunctionauth-authorizer): String
```

## 속성
<a name="sam-property-function-httpapifunctionauth-properties"></a>

 `AuthorizationScopes`   <a name="sam-function-httpapifunctionauth-authorizationscopes"></a>
이 API, 경로 및 메서드에 적용할 수 있는 권한 부여 범위.  
여기에 나열된 범위는 `DefaultAuthorizer`이(존재한다면) 적용한 어떤 범위보다도 우선합니다.  
*유형*: 목록  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은에 고유 AWS SAM 하며 CloudFormation 동등한 속성이 없습니다.

 `Authorizer`   <a name="sam-function-httpapifunctionauth-authorizer"></a>
특정 함수를 위한 `Authorizer` IAM 인증을 사용하려면 `AWS_IAM`을 지정하고, 템플릿의 `true` 섹션에서 `EnableIamAuthorizer`에 관하여 `Globals`를 지정하십시오.  
API에서 글로벌 권한 부여자를 지정한 상태에서 특정 함수를 공개하려면 `Authorizer`을 `NONE`로 설정하여 변경하십시오.  
*유형*: 문자열  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은에 고유 AWS SAM 하며 CloudFormation 동등한 속성이 없습니다.

## 예제
<a name="sam-property-function-httpapifunctionauth--examples"></a>

### 함수-권한 부여
<a name="sam-property-function-httpapifunctionauth--examples--function-auth"></a>

함수 수준에서 권한 부여

#### YAML
<a name="sam-property-function-httpapifunctionauth--examples--function-auth--yaml"></a>

```
Auth:
  Authorizer: OpenIdAuth
  AuthorizationScopes:
    - scope1
    - scope2
```

### IAM 권한 부여
<a name="sam-property-function-httpapifunctionauth--examples--iam-authorization"></a>

이벤트 수준에서 IAM 권한 부여를 지정합니다. 이벤트 수준에서 `AWS_IAM` 권한 부여를 사용하려면 템플릿의 `true` 섹션에서 `EnableIamAuthorizer`에 관하여 `Globals`를 지정해야 합니다. 자세한 내용은 [AWS SAM 템플릿의 글로벌 섹션](sam-specification-template-anatomy-globals.md)을 참조하십시오.

#### YAML
<a name="sam-property-function-httpapifunctionauth--examples--iam-authorization--yaml"></a>

```
Globals:
  HttpApi:
    Auth:
      EnableIamAuthorizer: true

Resources:
  HttpApiFunctionWithIamAuth:
    Type: AWS::Serverless::Function
    Properties:
      Events:
        ApiEvent:
          Type: HttpApi
          Properties:
            Path: /iam-auth
            Method: GET
            Auth:
              Authorizer: AWS_IAM
      Handler: index.handler
      InlineCode: |
        def handler(event, context):
          return {'body': 'HttpApiFunctionWithIamAuth', 'statusCode': 200}
      Runtime: python3.9
```