에이전트 기반 프로젝트 수준 권한

에이전트 기반 전송에는 서비스 에이전트와 전송 에이전트 계정이라는 두 가지 개별 항목에 대한 프로젝트 수준 IAM 권한이 필요합니다.

전송에 파일 시스템, HDFS 또는 S3 호환 스토리지가 포함된 경우에만 이 페이지에서 권한을 구성하세요. 전송이 에이전트리스인 경우 이 페이지에서 역할을 구성하지 말고 소스 및 대상에 대한 액세스 구성으로 바로 진행하세요.

에이전트 기반 전송은 다음 ID를 사용합니다.

  • 서비스 에이전트: Storage Transfer Service에서 전송 에이전트와 작업을 조정하는 데 사용하는 Google 관리 서비스 계정입니다.
  • 전송 에이전트 계정: 클라이언트 머신 또는 인스턴스에서 전송 에이전트를 인증하고 실행하는 데 사용되는 Google Cloud 사용자 계정 또는 사용자 관리형 서비스 계정입니다.

IAM 역할 부여에 대한 일반적인 내용은 리소스에 대한 액세스 권한 부여, 변경, 취소를 참조하세요.

서비스 에이전트 권한

Storage Transfer Service는 서비스 에이전트를 사용하여 에이전트 기반 전송을 조정합니다.

Storage Transfer Service가 Google Cloud와 전송 에이전트 간의 작업을 조정할 수 있도록 하려면 Storage Transfer Service를 실행하는 프로젝트의 서비스 에이전트에 다음 역할을 부여합니다.

  • Storage Transfer Service 에이전트(roles/storagetransfer.serviceAgent)

서비스 에이전트 이메일 주소 가져오기

서비스 에이전트에 역할을 부여하려면 서비스 에이전트의 이메일 주소 식별자가 필요합니다. 서비스 에이전트는 전송 작업을 처음 만들거나, gcloud transfer 설정 명령어를 실행하거나, Google Cloud 콘솔에서 Storage Transfer 페이지를 방문하거나, googleServiceAccounts.get를 호출할 때 자동으로 생성됩니다.

서비스 에이전트 이메일 주소를 가져오려면 다음 안내를 따르세요.

  1. googleServiceAccounts.get 참조 페이지로 이동합니다. 이 메서드 사용해 보기라는 제목의 대화형 패널이 열립니다.
  2. 요청 매개변수에 프로젝트 ID를 입력합니다.
  3. 실행을 클릭합니다.

accountEmail 값을 복사합니다. 이메일 주소는 project-PROJECT_NUMBER@storage-transfer-service.iam.gserviceaccount.com 형식을 사용합니다.

서비스 에이전트 역할 부여

Storage Transfer Service 에이전트 역할을 부여하려면 다음 안내를 따르세요.

Google Cloud 콘솔

  1. Google Cloud 콘솔에서 Storage Transfer Service를 실행하는 프로젝트의 IAM 페이지로 이동합니다.

    IAM으로 이동

  2. 액세스 권한 부여를 클릭합니다.

  3. 새 주 구성원 필드에 서비스 에이전트 이메일 주소를 입력합니다.

  4. 역할 선택 드롭다운 목록에서 Storage Transfer Service 에이전트(roles/storagetransfer.serviceAgent)를 검색하고 선택합니다.

  5. 저장을 클릭합니다.

gcloud

gcloud projects add-iam-policy-binding를 실행합니다.

gcloud projects add-iam-policy-binding PROJECT_ID \
--member="serviceAccount:SERVICE_AGENT_EMAIL" \
--role="roles/storagetransfer.serviceAgent"

다음을 바꿉니다.

전송 에이전트 계정 권한

전송 에이전트는 사용자 계정 또는 사용자 관리형 서비스 계정의 사용자 인증 정보를 사용하여 클라이언트 머신에서 실행됩니다.

  • 사용자 계정은 인증된 사용자의 사용자 인증 정보를 사용합니다.
  • 사용자 관리형 서비스 계정은 서비스 계정 키 또는 ID 제휴를 사용합니다. 서비스 계정을 만들려면 서비스 계정 생성 및 관리를 참조하세요.

전송 에이전트가 Storage Transfer Service에 연결하고, 작업을 수신하고, 상태를 로깅하도록 승인하려면 에이전트 풀을 호스팅하는 Google Cloud 프로젝트에 다음 역할을 할당합니다.

  • 스토리지 전송 에이전트(roles/storagetransfer.transferAgent)

이 역할을 부여하려면 다음 안내를 따르세요.

Google Cloud 콘솔

  1. Google Cloud 콘솔에서 IAM 페이지로 이동합니다.

    IAM으로 이동

  2. 에이전트 풀이 포함된 프로젝트를 선택했는지 확인합니다.

  3. 액세스 권한 부여를 클릭합니다.

  4. 새 주 구성원 필드에 사용자 계정 또는 사용자 관리형 서비스 계정의 이메일 주소를 입력합니다.

  5. 역할 선택 드롭다운 목록에서 Storage Transfer 에이전트(roles/storagetransfer.transferAgent)를 검색하고 선택합니다.

  6. 저장을 클릭합니다.

gcloud

gcloud projects add-iam-policy-binding를 실행합니다.

gcloud projects add-iam-policy-binding AGENT_POOL_PROJECT_ID \
--member="serviceAccount_OR_user:TRANSFER_AGENT_ACCOUNT" \
--role="roles/storagetransfer.transferAgent"

다음을 바꿉니다.

  • AGENT_POOL_PROJECT_ID: 에이전트 풀이 포함된 프로젝트입니다.
  • serviceAccount_OR_user: 전송 에이전트 계정이 서비스 계정인 경우 serviceAccount를 지정하고 에이전트가 사용자 계정으로 설치된 경우 user를 지정합니다.
  • TRANSFER_AGENT_ACCOUNT: 전송 에이전트를 실행하는 계정의 이메일 주소입니다.

다음 단계

프로젝트 권한을 구성한 후 다음 설정 단계를 순서대로 진행합니다.

  1. 에이전트 풀 만들기.
  2. 풀에 전송 에이전트를 설치합니다.
  3. 스토리지 시스템의 액세스 권한을 구성합니다.
  4. 전체 역할 및 권한 참조를 검토합니다.