시작하기

이 페이지에서는 개발자가 Cloud de Confiance by S3NS API를 사용하는 방법을 설명합니다.

Cloud de Confiance API를 처음 사용하는 경우 이 가이드의 단계에 따라 curl 명령어를 사용하여 API를 호출할 수 있습니다. 애플리케이션을 개발하기 전에 curl 명령어를 사용하여 API를 실험할 수 있습니다.

S3NS 프로젝트 만들기

Cloud de Confiance API를 사용하려면 사용자 계정 (S3NS 계정 또는 외부 ID 공급업체의 계정)과S3NS 프로젝트가 있어야 합니다. 프로젝트는 개발자 계정과 같습니다. 프로젝트는 Cloud de Confiance 리소스의 리소스 컨테이너 역할을 합니다. 또한 Cloud de Confiance by S3NS 서비스 사용에 대한 격리 경계를 제공하므로 프로젝트 수준에서 할당량 한도와 청구를 독립적으로 관리할 수 있습니다. 사용 원격 분석 및 대시보드는 프로젝트별로도 그룹화됩니다. 아직 프로젝트가 없는 경우 Cloud de Confiance 콘솔을 사용하여 프로젝트를 만들 수 있습니다.

프로젝트는 API 키, OAuth 클라이언트, 서비스 계정, Compute Engine VM, Cloud Storage 버킷, BigQuery 데이터 세트를 비롯한 다양한 리소스를 소유할 수 있습니다. 애플리케이션이 Cloud de Confiance API를 호출하면 애플리케이션 사용자 인증 정보를 소유한 프로젝트를 클라이언트 프로젝트라고 하고 대상 리소스를 소유한 프로젝트를 리소스 프로젝트라고 합니다. API 요청이 여러 리소스를 사용하는 경우 여러 리소스 프로젝트가 관련됩니다.

어떤 이유로든 Cloud de Confiance 사용을 중지하려면 Cloud de Confiance 콘솔을 사용하여 프로젝트를 삭제하면 됩니다. 보관 기간이 지나면 프로젝트와 프로젝트의 모든 리소스가 삭제됩니다. 다른 유형의 데이터에는 다른 보관 기간이 있습니다.

API 검색

Cloud de Confiance API를 사용하기 전에 Cloud de Confiance 콘솔 API 라이브러리를 사용하여 사용 가능한Cloud de Confiance API를 찾아보고 비즈니스 요구에 가장 부합되는 항목을 찾아야 합니다.

API 사용 설정

일부 Cloud de Confiance API는 기본적으로 사용 설정되어 있습니다. 기본적으로 사용 설정되지 않은 Cloud de ConfianceAPI를 사용하려면 프로젝트에 사용 설정해야 합니다. 클라이언트 프로젝트와 리소스 프로젝트를 포함한 애플리케이션과 관련된 서비스와 프로젝트에 따라 여러 프로젝트에서 API를 사용 설정해야 할 수 있습니다. 다른 API에 종속된 API를 사용 설정하면 해당 API도 동시에 사용 설정됩니다.

API를 사용 설정하려면 API에 대한 서비스 약관 및 청구 책임에 동의해야 합니다. API를 사용 설정하려면 프로젝트에 대해 serviceusage.services.enable 권한이 필요합니다. 자세한 정보는 서비스 사용량 액세스 제어를 참조하세요.

Console을 사용해 프로젝트에서 API를 사용 설정하는 방법은 다음과 같습니다.

  1. Cloud de Confiance 콘솔 API 라이브러리로 이동합니다.
  2. 프로젝트 목록에서 사용할 프로젝트를 선택합니다.
  3. API 라이브러리에서 사용 설정할 API를 선택합니다. API를 찾는 데 도움이 필요하면 검색 필드와 필터를 사용하세요.
  4. API 페이지에서 사용 설정을 클릭합니다.

오용 및 실수로 인한 요금 결제가 발생하지 않도록 동일한 페이지에서 더 이상 사용하지 않는 프로젝트에 API를 중지할 수 있습니다. 또한 gcloud CLI 및 Service Usage API를 사용하여 Cloud API를 사용 설정하거나 사용 중지할 수 있습니다.

gcloud services enable pubsub.googleapis.com
gcloud services disable pubsub.googleapis.com

결제 사용 설정

일부 Cloud API는 사용 요금이 부과됩니다. 프로젝트에서 이러한 API 사용을 시작하기 전에 프로젝트에서 결제를 사용 설정해야 합니다. 프로젝트의 API 사용량은 프로젝트에 연결된 결제 계정으로 청구됩니다.

API 인증

API 인증 방법은 개발 환경과 API에서 지원하는 인증 방법에 따라 다릅니다.

다양한 환경에서 사용할 애플리케이션 기본 사용자 인증 정보를 설정하는 것이 가장 일반적인 접근 방식이며 대부분의 애플리케이션에 권장됩니다. API가 API 키를 지원하는 경우 또 다른 옵션이 있습니다. 애플리케이션이 최종 사용자가 소유한 Cloud 리소스에 액세스해야 하는 경우 OAuth 2.0 클라이언트 ID를 만들고 인증 라이브러리를 사용합니다.

인증에 대한 일반적인 정보는 Google에서 인증을 참조하세요.

애플리케이션 빌드

Cloud API를 사용하여 애플리케이션을 구축하는 경우, 가능하다면 Cloud de Confiance 클라이언트 라이브러리를 사용하는 것이 좋습니다. 클라이언트 라이브러리는 인증, 오류 처리, 재시도, 페이로드 유효성 검사와 같은 편의를 위한 일반적인 API 기능을 처리합니다. 클라이언트 라이브러리가 애플리케이션 대신Cloud de Confiance API를 호출할 수 있도록 초기화 중에 애플리케이션 사용자 인증 정보를 클라이언트 라이브러리에 전달해야 합니다.

추가 정보