콘텐츠로 건너뛰기

워크로드 ID 페더레이션을 위한 Snowflake 구성

이 페이지에서는 워크로드 ID 페더레이션으로 Snowflake를 Braze Cloud Data Ingestion(CDI)에 연결하는 방법을 설명합니다. 역할, 웨어하우스, 데이터베이스 권한 부여 및 나머지 소스 설정은 데이터 웨어하우스 통합, 연결된 소스 또는 SQL 편집기를 참조하세요.

워크로드 ID 페더레이션을 사용하면 Braze는 Snowflake용 Braze AWS ID에 바인딩된 서비스 사용자로 Snowflake에 인증합니다. 이 사용자에게는 비밀번호와 RSA 키가 없습니다. RSA 키 페어 인증도 계속 지원됩니다. 기존 키 페어 자격 증명은 그대로 작동하며 마이그레이션할 필요가 없습니다.

워크로드 ID 페더레이션과 RSA 키 페어 인증은 별도의 설정 경로입니다. 자격 증명 양식에서 선택한 방식에 맞는 단계를 따르세요.

자격 증명 양식에 Workload Identity Federation이 없으면 Key pair를 사용하세요.

이 워크스페이스의 Snowflake 주체 사용

Snowflake 자격 증명 양식의 구문에는 Snowflake용 Braze 주체가 포함되어 있습니다. 이 주체는 Snowflake용 Braze AWS 역할의 Amazon 리소스 이름(ARN)입니다. 이 값은 워크스페이스와 Braze 인스턴스마다 고유합니다.

Braze는 Snowflake에 대해 Google BigQuery 및 Google Cloud Storage와는 다른 AWS 역할을 사용합니다. 연결하려는 워크스페이스의 Snowflake 자격 증명 양식에서 구문을 복사하세요. BigQuery 또는 Google Cloud Storage 자격 증명 양식의 주체는 Google 소스용 Braze AWS 역할이므로 Snowflake가 이 사용자에 대해 이를 거부합니다.

사전 요구 사항

구문을 실행하기 전에 다음을 수행하세요.

동일한 Snowflake 계정에 연결하는 Braze 워크스페이스마다 별도의 Snowflake 사용자를 만드세요. 하나의 워크스페이스 내에서는 여러 통합에 같은 사용자를 재사용할 수 있습니다.

생성된 구문이 하는 일

Braze는 Snowflake 자격 증명 양식에서 구문을 생성합니다. 이 구문은 Username과 Role을 입력하면 바뀌며, Snowflake용 Braze 주체를 포함합니다. 양식에서 생성된 구문을 실행하세요. 이 페이지에서는 실행하는 내용을 이해할 수 있도록 구문을 설명합니다.

사용자 생성

Create user는 새 Snowflake 사용자를 위한 옵션입니다. 이 구문은 다음을 수행하는 CREATE USER 명령입니다.

  • WORKLOAD_IDENTITY를 TYPE = AWS로 설정하고, ARN을 이 자격 증명 양식에 표시된 Snowflake용 Braze 주체로 설정합니다. 이 바인딩을 통해 Braze가 해당 사용자로 인증할 수 있습니다.
  • TYPE = SERVICE를 설정합니다. 이 사용자는 비밀번호와 RSA 공개 키가 없는 서비스 사용자입니다. Snowflake는 서비스 사용자에 대해 WORKLOAD_IDENTITY를 허용합니다.
  • DEFAULT_ROLE을 입력한 역할로 설정합니다. Braze가 연결하면 Snowflake가 해당 역할을 활성화합니다.
  • 해당 역할을 사용자에게 부여하여 사용자가 그 역할을 사용할 수 있게 합니다.

사용자 변경

Alter user는 이미 존재하는 사용자 이름을 위한 옵션입니다. 이 구문은 다음을 수행하는 ALTER USER 명령입니다.

  • TYPE = SERVICE를 설정합니다. 워크로드 ID 페더레이션에는 서비스 사용자가 필요합니다. 사용자에게 아직 비밀번호가 있으면 Snowflake는 사용자를 Braze 주체에 바인딩하기 전에 이 변경을 거부합니다. 구문을 실행하기 전에 비밀번호를 제거하거나 새 서비스 사용자를 만드세요.
  • WORKLOAD_IDENTITY를 TYPE = AWS로 설정하고, ARN을 동일한 Snowflake 주체로 설정합니다.
  • 입력한 역할을 부여합니다. 사용자에게 이미 해당 역할이 있으면 권한을 부여해도 사용자는 변경되지 않습니다.

양식에서 생성된 그대로 구문을 사용하세요. 이 구문은 TYPE = AWS와 Snowflake용 Braze 주체의 ARN을 설정합니다.

구문 실행

  1. Braze에서 Data Settings > Cloud Data Ingestion > Sources로 이동하여 Add data source를 선택한 다음 Snowflake를 선택합니다.
  2. Credential name을 입력한 다음 Workload Identity Federation을 선택합니다.
  3. Braze setup에서 Account Locator, Username, Role을 입력합니다. 계정 로케이터 값은 2.1단계: Snowflake 연결 정보 추가를 참조하세요.
  4. Create user 또는 Alter user를 선택합니다.
  5. Copy statement를 사용할 수 있게 되면 Copy statement를 선택합니다. 구문에 아직 주체에 대한 입력 안내가 표시되면 Braze가 이를 대체할 때까지 기다리세요. 양식에 이 배포에서 워크로드 ID 페더레이션을 사용할 수 없다고 표시되면 대신 Key pair를 선택하세요.
  6. Snowsight에서 워크시트를 열고 구문을 실행합니다.
  7. Braze 자격 증명 양식으로 돌아가 Save credential을 선택합니다.
  8. 소스의 웨어하우스, 데이터베이스, 스키마를 입력하고 Test connection을 선택한 다음 Connect to Source를 선택합니다.

Snowflake 자격 증명 검토

자격 증명을 저장한 후 Credentials 페이지에서 검토하세요. 각 소스에는 고유한 섹션이 있습니다.

  1. Data Settings > Cloud Data Ingestion > Credentials로 이동합니다.
  2. Snowflake Data Access Credentials를 찾습니다.
  3. 해당 섹션에서 자격 증명 이름을 선택합니다.

세부 정보 Modal에는 Authentication method, Account Locator, Username, Role이 표시됩니다. Used by에는 해당 자격 증명을 사용하는 소스와 동기화가 나열됩니다.

워크로드 ID 페더레이션 자격 증명에는 RSA 공개 키가 포함되지 않습니다. 키 페어 자격 증명에는 RSA public key (primary)도 표시됩니다. View를 선택하면 현재 공개 키에 대한 ALTER USER 구문이 펼쳐집니다. 키를 교체하려면 Rotate credential을 선택한 다음 Generate new key를 선택하세요. Snowflake 워크시트에서 새 구문을 실행합니다. Braze는 이전 공개 키를 보조 키로 옮기며, 새 공개 키를 설치하는 동안 보조 키는 계속 활성 상태로 유지됩니다. 나머지 키 페어 설정은 Snowflake 사용자 인증을 참조하세요.

문제 해결

구문을 복사할 준비가 되지 않음

Copy statement는 다음 두 가지 경우에 사용할 수 없는 상태로 유지됩니다.

  • 양식에 “Error loading the Braze principal ARN”이 표시되는 경우. 페이지를 새로고침하고 자격 증명 양식을 다시 여세요.
  • 양식에 “Workload Identity Federation is not available on this deployment yet. Use a key pair instead.”가 표시되는 경우. Key pair를 선택하세요.

구문을 실행한 후 연결 테스트가 실패함

다음 사항을 확인하세요.

  • Username과 Role이 입력된 후 이 워크스페이스의 Snowflake 자격 증명 양식에서 생성된 구문을 실행했는지
  • Snowflake 사용자가 TYPE = SERVICE이며 비밀번호가 없는지
  • 사전 요구 사항의 역할, 웨어하우스, 데이터베이스 권한 부여가 존재하고 구문의 역할 부여가 성공했는지
  • 계정에서 네트워크 정책을 사용하는 경우 Braze IP 주소가 허용되어 있는지. 1.5단계: Snowflake 네트워크 정책에서 Braze IP 허용(선택 사항)을 참조하세요.

사용자에게 비밀번호가 있어 사용자 변경이 실패함

Snowflake는 아직 비밀번호가 있는 사용자에 대해 TYPE = SERVICE를 거부하므로 사용자는 현재 유형을 유지합니다. 비밀번호를 제거하고 구문을 다시 실행하거나, Create user를 선택하고 새 사용자 이름을 사용하세요.

Braze 고객 참여 플랫폼 문서.

리소스
법적 고지
회사
© 2026 Braze, Inc. All rights reserved.
브레이즈 상태 확인
New Stuff!