API 키 사용

API 키 만들기

API 키는 사용 및 결제에 관한 프로젝트와 관련된 요청을 인증하는 고유 식별자입니다. 프로젝트에 연결된 API 키가 하나 이상 있어야 합니다.

API 키를 만들려면 다음 단계를 따르세요.

Console

  1. Google Maps Platform > 사용자 인증 정보 페이지로 이동합니다.

    사용자 인증 정보 페이지로 이동하기

  2. 사용자 인증 정보 페이지에서 사용자 인증 정보 만들기 > API 키를 클릭합니다.
    API 키 생성 완료 대화상자에 새로 만든 API 키가 표시됩니다.
  3. 닫기를 클릭합니다.
    새 API 키는 사용자 인증 정보 페이지의 API 키 아래 나열됩니다.
    (프로덕션에 사용하기 전에 API 키를 제한하세요.)

Cloud SDK

gcloud alpha services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Google Cloud SDK, Cloud SDK 설치 및 다음 명령어에 대해 자세히 알아보세요.

API 키 제한

API 키를 애플리케이션에 필요한 API에서만 사용하도록 제한하는 것이 좋습니다. API 키를 제한하면 불필요한 요청으로부터 애플리케이션이 보호되어 애플리케이션의 보안이 강화됩니다. 자세한 내용은 API 키 권장사항을 참고하세요.

API 키를 제한하는 경우 애플리케이션에 서명하는 데 사용된 서명 키의 SHA-1 인증서 디지털 지문을 제공해야 합니다. 다음과 같은 두 가지 인증서 유형이 있습니다.

  • 디버그 인증서: 테스트 중인 앱 및 기타 비프로덕션 코드에서만 이 인증서 유형을 사용합니다. 디버그 인증서로 서명된 앱은 게시하지 마세요. Android SDK 도구는 디버그 빌드를 실행할 때 이 인증서를 자동으로 생성합니다.
  • 출시 인증서: 앱을 앱 스토어에 출시할 준비가 되면 이 인증서를 사용합니다. 출시 빌드를 실행하면 Android SDK 도구에서 이 인증서가 생성됩니다.

Android 애플리케이션 서명 및 인증서에 대한 자세한 내용은 앱 서명 가이드를 참고하세요.

서명 인증서 지문을 찾는 방법에 대한 지침은 아래 참고 자료를 확인하세요.

API 키를 제한하는 방법은 다음과 같습니다.

Console

  1. Google Maps Platform > 사용자 인증 정보 페이지로 이동합니다.

    사용자 인증 정보 페이지로 이동하기

  2. 제한을 설정할 API 키를 선택합니다. API 키 속성 페이지가 나타납니다.
  3. 키 제한사항에서 다음 제한사항을 설정합니다.
    • 애플리케이션 제한:
      1. Android 앱을 선택합니다.
      2. + 패키지 이름 및 디지털 지문 추가를 클릭합니다.
      3. 패키지 이름과 SHA-1 인증서 디지털 지문을 입력합니다. 예를 들면 다음과 같습니다.
        com.example.android.mapexample
        BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
    • API 제한:
      1. 키 제한을 클릭합니다.
      2. API 선택 드롭다운에서 Navigation SDK를 선택합니다. Navigation SDK가 표시되지 않으면 enable해야 합니다.
  4. 변경을 완료하려면 저장을 클릭합니다.

Cloud SDK

기존 키를 나열합니다.

gcloud services api-keys list --project="PROJECT"

기존 키에 대한 기존 제한을 삭제합니다.

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --clear-restrictions

기존 키에 새로운 제한을 설정합니다.

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --api-target="maps-android-backend.googleapis.com"
    --allowed-application="sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME"

Google Cloud SDK, Cloud SDK 설치 및 다음 명령어에 대해 자세히 알아보세요.

다음 단계

이제 API 키가 있으므로 Android 스튜디오 프로젝트 설정에 설명된 대로 Android 스튜디오 프로젝트를 만들고 구성할 수 있습니다.

Android 스튜디오 프로젝트 설정