Amazon API Gateway
개발자 안내서

API Gateway 콘솔을 사용한 API 키 설정

API 키를 설정하려면 다음 작업을 수행합니다.

  • API 메서드를 구성해 API 키를 요구합니다.

  • 리전의 API에 대해 API 키를 생성하거나 가져옵니다.

API 키를 설정하기 전에 API를 생성하여 단계에 배포해야 합니다.

API Gateway 콘솔을 사용하여 API를 만들고 배포하는 방법에 대한 지침은 각각 Amazon API Gateway에서 REST API 생성Amazon API Gateway에서 REST API 배포 단원을 참조하십시오.

메서드에서 API 키 요구

다음 절차에서는 API 키를 요구하도록 API 메서드를 구성하는 방법에 대해 설명합니다.

API 메서드를 구성해 API 키를 요구하려면

  1. AWS Management 콘솔에 로그인하고 https://console.aws.amazon.com/apigateway/에서 API Gateway 콘솔을 엽니다.

  2. API Gateway 기본 탐색 창에서 리소스를 선택합니다.

  3. 리소스에서 새 메서드를 생성하거나 기존 메서드를 선택합니다.

  4. 메서드 요청(Method Request)을 선택합니다.

  5. Authorization Settings(권한 부여 설정) 섹션에서 API Key Required(API 키가 필요함)true를 선택합니다.

  6. 확인 표시 아이콘을 선택하여 설정을 저장합니다.

  7. API를 배포하거나 다시 배포하여 요구 사항을 적용합니다.

API 키가 필요함(API Key Required) 옵션이 false로 설정되어 있고 이전 단계를 실행하지 않는 경우, API 단계와 연결된 어떤 API 키도 해당 메서드에 사용되지 않습니다.

API 키 생성

사용량 계획에 사용하기 위해 이미 API키를 생성했거나 가져온 경우, 이 절차와 다음 절차를 건너뛰십시오.

API 키를 생성하려면

  1. AWS Management 콘솔에 로그인하고 https://console.aws.amazon.com/apigateway/에서 API Gateway 콘솔을 엽니다.

  2. API Gateway 기본 탐색 창에서 API Keys(API 키)를 선택합니다.

  3. 작업 드롭다운 메뉴에서 API 키 생성(Create API Key)을 선택합니다.

    
                            사용량 계획을 위한 API 키 생성
  4. API 키 생성(Create API Key)에서 다음을 수행합니다.

    1. 이름 입력 필드에 API 키 이름(예: MyFirstKey)을 입력합니다.

    2. Auto Generate(자동 생성)을 선택하여 API Gateway가 키 값을 생성하도록 하거나 사용자 지정을 선택하여 수동으로 키를 입력합니다.

    3. Save를 선택합니다.

    
                            사용량 계획을 위한 API 키 생성
  5. 필요에 따라 앞의 단계를 반복하여 API 키를 추가 생성합니다.

API 키 가져오기

다음 절차에서는 사용량 계획에 사용할 API 키를 가져오는 방법을 설명합니다.

API 키를 가져오려면

  1. 기본 탐색 창에서 API 키(API Keys)를 선택합니다.

  2. 작업 드롭다운 메뉴에서 API 키 가져오기(Import API keys)를 선택합니다.

  3. 쉼표로 구분된 키 파일을 로드하려면 CSV 파일 선택(Select CSV File)을 선택합니다. 수동으로 키를 입력할 수도 있습니다. 파일 형식에 대한 자세한 내용은 API Gateway API 키 파일 형식을 참조하십시오.

    
                            API 사용량 계획 엔터티
  4. 경고 실패(Fail on warnings)를 선택해 오류 발생 시 가져오기를 중단하거나 경고 무시(Ignore warnings)를 선택해 오류 발생 시에도 유효한 키 항목을 계속 가져옵니다.

  5. 선택한 API 키 가져오기를 시작하려면 가져오기를 선택합니다.

API 키를 설정했으므로 이제 사용량 계획 생성 및 사용으로 진행할 수 있습니다.