정책을 생성하여 사용자에 연결 - Amazon API Gateway

정책을 생성하여 사용자에 연결

사용자가 API 관리 서비스 또는 API 실행 서비스를 호출할 수 있도록 허용하려면 API Gateway 엔터티에 대한 액세스를 제어하는 IAM 정책을 생성해야 합니다.

JSON 정책 편집기를 사용하여 정책을 생성하려면

  1. AWS Management Console에 로그인하여 https://console.aws.amazon.com/iam/ 에서 IAM 콘솔을 엽니다.

  2. 왼쪽의 탐색 창에서 정책을 선택합니다.

    정책을 처음으로 선택하는 경우 관리형 정책 소개 페이지가 나타납니다. 시작을 선택합니다.

  3. 페이지 상단에서 정책 생성을 선택합니다.

  4. 정책 편집기 섹션에서 JSON 옵션을 선택합니다.

  5. 다음 JSON 정책 문서를 입력합니다.

    {
  "Version": "2012-10-17",
  "Statement" : [
    {
      "Effect" : "Allow",
      "Action" : [
        "action-statement"
      ],
      "Resource" : [
        "resource-statement"
      ]
    },
    {
      "Effect" : "Allow",
      "Action" : [
        "action-statement"
      ],
      "Resource" : [
        "resource-statement"
      ]
    }
  ]
}

  6. Next(다음)를 선택합니다.

    참고

    언제든지 시각적 편집기 옵션과 JSON 편집기 옵션 간에 전환할 수 있습니다. 그러나 변경을 적용하거나 시각적 편집기에서 다음을 선택한 경우 IAM은 시각적 편집기에 최적화되도록 정책을 재구성할 수 있습니다. 자세한 내용은 IAM 사용 설명서의 정책 재구성을 참조하십시오.

  7. 검토 및 생성 페이지에서 생성하는 정책에 대한 정책 이름과 설명(선택 사항)을 입력합니다. 이 정책에 정의된 권한을 검토하여 정책이 부여한 권한을 확인합니다.

  8. 정책 생성을 선택하고 새로운 정책을 저장합니다.

이 설명에서 필요에 따라 action-statement 및 resource-statement를 대체하고 다른 설명을 추가하여, 사용자가 관리하도록 허용할 API Gateway 엔터티, 사용자가 호출할 수 있는 API 또는 두 항목을 모두 지정합니다. 기본적으로 해당하는 명시적 Allow 설명이 없는 한, 용자에게는 권한이 없습니다.

방금 IAM 정책을 생성했지만, 연결하기 전까지는 아무런 효과가 없습니다.

액세스 권한을 제공하려면 사용자, 그룹 또는 역할에 권한을 추가하세요:

  • AWS IAM Identity Center의 사용자 및 그룹:

    권한 세트를 생성합니다. AWS IAM Identity Center 사용 설명서의 권한 세트 생성의 지침을 따릅니다.

  • 보안 인증 공급자를 통해 IAM에서 관리되는 사용자:

    ID 페더레이션을 위한 역할을 생성합니다. IAM 사용 설명서의 서드 파티 자격 증명 공급자의 역할 만들기(페더레이션)의 지침을 따릅니다.

  • IAM 사용자:

    • 사용자가 맡을 수 있는 역할을 생성합니다. IAM 사용 설명서에서 IAM 사용자의 역할 생성의 지침을 따릅니다.

    • (권장되지 않음)정책을 사용자에게 직접 연결하거나 사용자를 사용자 그룹에 추가합니다. IAM 사용 설명서에서 사용자(콘솔)에 권한 추가의 지침을 따르십시오.

IAM 정책 문서를 IAM 그룹에 연결하려면

  1. 기본 탐색 창에서 그룹을 선택합니다.

  2. 선택한 그룹 아래에서 권한 탭을 선택합니다.

  3. [Attach policy]를 선택합니다.

  4. 앞서 생성한 정책 문서를 선택한 후 정책 연결을 선택합니다.

API Gateway에서 다른 AWS 서비스를 자동으로 호출하도록 하려면 Amazon API Gateway 유형의 IAM 역할을 생성합니다.

Amazon API Gateway 유형의 역할을 생성하려면

  1. 기본 탐색 창에서 역할을 선택합니다.

  2. 새 역할 생성을 선택합니다.

  3. 역할 이름에 이름을 입력한 후 다음 단계를 선택합니다.

  4. 역할 유형 선택(Select Role Type)의 AWS 서비스 역할(AWS Service Roles)에서 Amazon API Gateway 옆에 있는 선택(Select)을 선택합니다.

  5. 사용 가능한 관리형 IAM 권한 정책을 선택합니다. 예를 들어 API Gateway가 CloudWatch에 메트릭을 기록하도록 하려면, 정책 연결에서 AmazonAPIGatewayPushToCloudWatchLog를 선택한 후 다음 단계를 선택합니다.

  6. 신뢰할 수 있는 주체(Trusted Entities)에서 apigateway.amazonaws.com이 항목으로 나열되는지 확인한 후 역할 생성을 선택합니다.

  7. 새로 생성한 역할에 대해 권한 탭을 선택한 다음, 정책 연결을 선택합니다.

  8. 앞서 생성한 사용자 지정 IAM 정책 문서를 선택한 후 정책 연결을 선택합니다.