AppNeta API 액세스

에서 시작되는 토큰 기반 인증 흐름을 사용하여 AppNeta API와 상호작용할 수 있습니다 Google Cloud.

시작하기 전에

필요한 Google Cloud 액세스 토큰을 생성하려면 프로젝트 내에서 작업해야 합니다. Google Cloud Cloud Network Insights를 사용 설정한 프로젝트를 사용하는 것이 좋습니다.

토큰을 요청하는 사용자 또는 서비스 계정에는 다음 역할 중 하나가 Google Cloud 프로젝트에 있어야 합니다.

  • 계정에 Cloud Network Insights 리소스에 대한 읽기 전용 액세스 권한을 부여하려면 프로젝트에서 다음 역할 중 하나를 부여합니다.
    • Cloud Network Insights 뷰어(roles/networkmanagement.CloudNetworkInsightsViewer)
    • 네트워크 관리 뷰어 (networkmanagement.viewer)
    • 기본 뷰어 역할
  • 계정에 Cloud Network Insights 리소스에 대한 전체 액세스 권한 을 부여하려면 프로젝트에서 다음 역할 중 하나를 부여합니다.
    • Cloud Network Insights 편집자(roles/networkmanagement.CloudNetworkInsightsEditor)
    • 네트워크 관리 관리자 (networkmanagement.admin)

AppNeta API 토큰 만들기

AppNeta API와 함께 사용되는 제공업체별 토큰으로 교환할 Google Cloud 액세스 토큰 을 생성하여 AppNeta API 토큰을 만들 수 있습니다.

액세스 토큰 Google Cloud 생성

API 호출을 실행하는 사용자 또는 서비스 계정에 대한 Google Cloud 액세스 토큰을 생성합니다. 환경 및에 인증되는 방법에 따라 액세스 토큰 Google Cloud 을 가져오는 방법은 여러 가지가 있습니다 Google Cloud.

  • 서비스 계정: Google Cloud인프라 (예: Compute Engine, Google Kubernetes Engine)에서 애플리케이션을 실행하거나 서비스 계정 키를 사용하는 경우 Cloud 클라이언트 라이브러리 또는 메타데이터 서버를 사용하여 토큰을 가져올 수 있습니다.
  • 기타 환경: Google Cloud 다양한 인증 메커니즘을 제공합니다.

상황에 가장 적합한 방법을 선택하는 방법에 대한 포괄적인 가이드는 인증 토큰 유형 을 참고하세요.

Google Cloud CLI가 설치 및 구성되어 있는 경우 복사할 토큰을 gcloud CLI 명령어를 사용하여 생성할 수 있습니다.

  gcloud auth print-access-token

애플리케이션 기본 사용자 인증 정보를 사용하려면 다음 gcloud CLI 명령어를 사용합니다.

gcloud auth application-default print-access-token

토큰 교환

복사된 Google Cloud 액세스 토큰을 사용하여 Network Management API를 호출하여 AppNeta의 제공업체별 액세스 토큰을 생성합니다.

AppNeta 토큰은 토큰을 생성하는 데 사용된 Google Cloud 토큰이 만료되면 만료됩니다. Google Cloud 액세스 토큰은 일반적으로 1시간 동안 유효합니다. AppNeta 토큰의 수명을 최대한 늘리려면 generateProviderAccessToken호출을 실행할 때마다 새 Google Cloud 액세스 토큰을 사용하는 것이 좋습니다.

gcloud

gcloud network-management network-monitoring-providers generate-provider-access-token NETWORK_MONITORING_PROVIDER --location=global --gcp-access-token=GCP_ACCESS_TOKEN

다음을 바꿉니다.

  • NETWORK_MONITORING_PROVIDER: 제공업체 이름입니다. 다른 이름을 적극적으로 설정하지 않은 경우 external을 사용합니다.
  • GCP_ACCESS_TOKEN: 에서 생성한 토큰입니다 Google Cloud.

curl

curl -H "Authorization: Bearer GCP_ACCESS_TOKEN" 

 "https://networkmanagement.googleapis.com/v1/projects/PROJECT_ID/locations/global/networkMonitoringProviders/external:generateProviderAccessToken?gcp_access_token=GCP_ACCESS_TOKEN"

다음을 바꿉니다.

  • GCP_ACCESS_TOKEN: 에서 생성한 토큰입니다 Google Cloud.
  • PROJECT_ID: Cloud Network Insights가 사용 설정된 프로젝트입니다.

이 호출의 응답에는 AppNeta API 엔드포인트에 대해 직접 요청을 인증하는 데 사용하는 providerAccessToken이 포함되어 있습니다.

AppNeta 토큰 사용

AppNeta API를 호출할 때 providerAccessToken을 승인 헤더의 전달자 토큰으로 사용합니다. 사용 가능한 엔드포인트 및 요청 형식에 대한 자세한 내용은 AppNeta API 문서 를 참고하세요.

`401 오류가 발생하면 새 Google Cloud 액세스 토큰 또는 애플리케이션 기본 사용자 인증 정보 토큰을 생성한 후 토큰을 다시 교환합니다.