# Google Cloud Storage — 비즈스프링 데이터 전송 서비스 가이드

>  Google Cloud Storage 사전 준비사항 Google Cloud Storage 권한 설정을 위해서는 다음 사항들이 필요합니다: Google Cloud Console에 접근할 수 있는 계정 IAM 권한을 설정할 수 있는 관리자 권한 비즈스프링 서비스 계정 이메일 : <mark

## 핵심 요약
- 비즈스프링 데이터 전송 서비스를 위해 Google Cloud Storage 버킷에 권한을 설정하는 절차를 안내하는 문서입니다.
- 사전에 Google Cloud Console 접근 권한과 IAM 관리자 권한, 비즈스프링 서비스 계정 이메일이 필요합니다.
- 데이터 전송 전용 버킷을 생성하고 저장 위치, 스토리지 클래스, 액세스 제어를 설정하는 방법을 설명합니다.
- Permissions 탭에서 비즈스프링 서비스 계정에 Storage Object Admin 권한을 부여하는 절차를 안내합니다.
- 권한 설정 반영에는 최대 5분 정도 소요될 수 있으며 최소 권한 부여를 권장합니다.

# Google Cloud Storage

## 사전 준비사항

Google Cloud Storage 권한 설정을 위해서는 다음 사항들이 필요합니다:

* Google Cloud Console에 접근할 수 있는 계정
* IAM 권한을 설정할 수 있는 관리자 권한
* 비즈스프링 서비스 계정 이메일 : <mark style="color:green;">**operator@bizspring-gp.iam.gserviceaccount.com**</mark>

## 권한 설정 절차

#### 1. Google Cloud Console 접속 및 프로젝트 선택

* [Google Cloud Console](https://console.cloud.google.com)에 접속합니다.
* GCS 버킷이 있는 프로젝트 선택합니다.

#### 2. 버킷 설정

데이터를 전송 받기 위한 버킷을 생성(설정)합니다. 해당 버킷은 비즈스프링 데이터 전송 서비스 전용으로, 다른 용도로 공유하지 않는 것을 권장합니다.

기존에 생성된 버킷을 사용할 경우 권한 탭으로 이동

*   구글 클라우드 콘솔(Console) 대시보드에서 탐색 메뉴 아이콘을 클릭해 Cloud Storage > Buckets(버킷)을 선택합니다.<br>

    <figure><img src="https://833346546-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuRHttLujjQSrMe3DxhOs%2Fuploads%2F8WsViPzhaimdgMURdmmr%2Fimage.png?alt=media&#x26;token=11329d3a-2f22-49c5-aa9f-b2419db03ae9" alt=""><figcaption></figcaption></figure>
*   CREATE(만들기) 혹은 CREATE BUCKET(버킷 만들기)를 클릭합니다.

    <figure><img src="https://833346546-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuRHttLujjQSrMe3DxhOs%2Fuploads%2FgjZ2SihI23xQUK9gancq%2Fimage.png?alt=media&#x26;token=ca3cf482-11e3-45d7-8781-5135f2839f34" alt=""><figcaption></figcaption></figure>
*   버킷을 생성합니다.&#x20;



    <figure><img src="https://833346546-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuRHttLujjQSrMe3DxhOs%2Fuploads%2FZrBBUMSmf2vjdWgkIR1U%2Fimage.png?alt=media&#x26;token=2b0406f5-83a7-4afa-8c6f-555e9426518f" alt=""><figcaption></figcaption></figure>

    * 고유한 버킷명 설정 : 지정한 버킷 이름은 비즈스프링 데이터 내보내기 설정에서 동일하게 사용
    * 저장 위치 선택 (추천: asia-northeast3)
    * 스토리지 클래스 선택 (추천: Standard)
    * 액세스 제어 설정 (추천:  Fine-grained)<br>

#### 3. 권한 부여

Permissions(권한) 탭으로 이동한 후 다음 단계에 따라 비즈스프링 서비스 계정에 필요한 권한을 부여합니다.

<figure><img src="https://833346546-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuRHttLujjQSrMe3DxhOs%2Fuploads%2FIDyF7RYvYYcEkNAV6zBb%2Fimage.png?alt=media&#x26;token=1c2cf367-647f-4fd1-a43c-bfa7614a459c" alt=""><figcaption></figcaption></figure>

* **\[+ GRANT ACCESS**(액세스 권한 부여)**]** 버튼을 클릭합니다.
* **Add principals**(새 구성원) **입력란**에 비즈스프링 서비스 계정 이메일을 입력합니다.
* **Select a role**(역할 선택)에서 다음 권한을 추가합니다:
  * Storage Object Admin(저장소 개체 관리자)&#x20;
* \[저장] 버튼을 클릭하여 권한 설정을 완료합니다.

#### 4. 권한 설정 확인

권한 부여가 완료되면 IAM 목록에서 다음 사항을 확인해 주세요:

<figure><img src="https://833346546-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FuRHttLujjQSrMe3DxhOs%2Fuploads%2FDHOJlaZkDbf81Z2NI2rM%2Fimage.png?alt=media&#x26;token=a3019c09-804d-4b03-a254-464fb697f615" alt=""><figcaption></figcaption></figure>

* 비즈스프링 서비스 계정이 목록에 추가되었는지 확인
* Storage Object Admin 권한이 정확히 부여되었는지 확인

## 주의사항

* 권한 설정 변경 사항은 최대 5분 정도의 시간이 소요될 수 있습니다.
* 보안을 위해 필요한 최소한의 권한만 부여하는 것을 권장합니다.

설정이 완료되면 비즈스프링 서비스에서 고객사의 데이터를 안전하게 처리할 수 있습니다.


## FAQ
**Q. Google Cloud Storage 권한 설정을 위해 사전에 무엇이 필요한가요?**

A. Google Cloud Console에 접근할 수 있는 계정과 IAM 권한을 설정할 수 있는 관리자 권한이 필요합니다. 또한 비즈스프링 서비스 계정 이메일(operator@bizspring-gp.iam.gserviceaccount.com)이 필요합니다.

**Q. 버킷은 새로 만들어야 하나요, 기존 버킷을 사용해도 되나요?**

A. 새로 생성하거나 기존에 생성된 버킷을 사용할 수 있습니다. 다만 해당 버킷은 비즈스프링 데이터 전송 서비스 전용으로 사용하고 다른 용도로 공유하지 않는 것을 권장합니다.

**Q. 버킷 생성 시 어떤 설정을 추천하나요?**

A. 저장 위치는 asia-northeast3, 스토리지 클래스는 Standard, 액세스 제어는 Fine-grained를 추천합니다. 버킷 이름은 비즈스프링 데이터 내보내기 설정에서 동일하게 사용해야 합니다.

**Q. 비즈스프링 서비스 계정에 어떤 권한을 부여해야 하나요?**

A. Permissions 탭에서 GRANT ACCESS를 클릭하고 비즈스프링 서비스 계정 이메일을 입력한 뒤, 역할로 Storage Object Admin(저장소 개체 관리자)을 추가하면 됩니다. 저장 후 IAM 목록에서 계정과 권한이 정확히 부여되었는지 확인해야 합니다.

**Q. 권한 설정 후 바로 적용되나요?**

A. 권한 설정 변경 사항은 최대 5분 정도의 시간이 소요될 수 있습니다. 또한 보안을 위해 필요한 최소한의 권한만 부여하는 것이 권장됩니다.

---
출처: https://bizspring.ai/kb/ref/manual/비즈스프링-데이터-전송-서비스-가이드-google-cloud-storage · 최종 갱신 2026-08-28T10:35:26.677+00:00