Skip to content

Microsoft Entra SSO

Microsoft Entra SSO는 Microsoft의 클라우드 기반 ID 및 액세스 관리 서비스로, 직원들이 로그인하고 리소스에 액세스할 수 있도록 도와줍니다. Entra SSO를 사용하면 비즈니스 요구 사항에 따라 앱 및 앱 리소스에 대한 액세스를 제어할 수 있습니다.

요구 사항

설정 시 Assertion Consumer Service(ACS) URL을 제공해야 합니다.

요구 사항 세부 정보
Assertion Consumer Service(ACS) URL https://<SUBDOMAIN>.braze.com/auth/saml/callback
일부 ID 공급자에서는 이를 Reply URL, Audience URL 또는 Audience URI로 부르기도 합니다.
Entity ID 기본값은 braze_dashboard입니다.

이 대시보드에 고유한 Entity ID를 부여하려면 커스텀 Entity ID를 활성화하고 생성된 값(braze_dashboard_<COMPANY_ID>)을 대신 사용하세요. 단계에 대해서는 커스텀 Entity ID 사용을 참조하세요.
RelayState API 키 ID 공급자 로그인을 활성화하려면 설정 > API 키로 이동하여 sso.saml.login 권한이 있는 API 키를 생성하세요.

서비스 제공자(SP) 시작 로그인(Microsoft Entra SSO 내)

  1. Microsoft Entra 관리 센터에서 Identity > Applications > Enterprise Applications로 이동한 다음 New application을 선택합니다.
  2. 검색 상자에서 Braze를 검색하고 결과 패널에서 선택한 다음 Add를 선택합니다.

2단계: Microsoft Entra SSO 구성

  1. Microsoft Entra 관리 센터에서 Braze 애플리케이션 통합 페이지로 이동하여 Single sign-on을 선택합니다.
  2. Select a single sign-on method 페이지에서 방법으로 SAML을 선택합니다.
  3. Set up Single Sign-On with SAML 페이지에서 Basic SAML Configuration의 편집 아이콘을 선택합니다.
  4. Braze 인스턴스와 다음 패턴을 결합한 Reply URL을 입력하여 IdP 시작 모드로 애플리케이션을 구성합니다: https://<SUBDOMAIN>.braze.com/auth/saml/callback.
  5. 동일한 Basic SAML Configuration 섹션에서 커스텀 Entity ID를 사용하는 경우가 아니라면 Identifier (Entity ID)를 braze_dashboard로 유지합니다. 커스텀 Entity ID를 사용하는 경우, Braze 보안 설정에 표시된 값과 일치하도록 대시보드에서 생성된 값(braze_dashboard_<COMPANY_ID>)을 입력합니다.
  6. Relay State 필드에 생성된 Relay State API 키를 입력하여 RelayState를 구성합니다.
  1. Braze가 기대하는 특정 형식으로 SAML 어설션을 포맷합니다. 사용자 속성 및 사용자 클레임에 대한 다음 탭을 참조하여 이러한 속성과 값의 형식을 파악하세요.

Application Integration 페이지의 User Attributes 섹션에서 이러한 값을 관리할 수 있습니다.

다음 속성 쌍을 사용합니다:

  • givenname = user.givenname
  • surname= user.surname
  • emailaddress = user.mail
  • name = user.userprincipalname
  • email = user.userprincipalname
  • first_name = user.givenname
  • last_name = user.surname
  • Unique User Identifier = user.userprincipalname

Set up Single Sign-On with SAML 페이지에서 Edit를 선택하여 User Attributes 대화 상자를 엽니다. 그런 다음 올바른 형식에 따라 사용자 클레임을 편집합니다.

다음 클레임 이름 쌍을 사용합니다:

  • claims/givenname = user.givenname
  • claims/surname = user.surname
  • claims/emailaddress = user.userprincipalname
  • claims/name = user.userprincipalname
  • claims/nameidentifier = user.userprincipalname

Manage claim 섹션에서 이러한 사용자 클레임과 값을 관리할 수 있습니다.

  1. Set up Single Sign-On with SAML 페이지로 이동한 다음 SAML Signing Certificate 섹션으로 스크롤하여 요구 사항에 따라 적절한 Certificate (Base64)를 다운로드합니다.
  2. Set up Braze 섹션으로 이동하여 Braze 구성에 사용할 적절한 URL을 복사합니다.

3단계: Braze 내에서 Microsoft Entra SSO 구성

Microsoft Entra 관리 센터에서 Braze를 설정하면 Microsoft Entra가 대상 URL(로그인 URL)과 x.509 인증서를 제공하며, 이를 Braze 계정에 입력합니다.

계정 매니저가 계정에 SAML SSO를 활성화한 후 다음을 수행합니다:

  1. 설정 > 회사 설정 > 관리자 설정 > 보안 설정으로 이동하여 SAML SSO 섹션을 켜기로 토글합니다.
  2. 같은 페이지에서 다음을 추가합니다:
요구 사항 세부 정보
SAML Name 로그인 화면의 버튼 텍스트로 표시됩니다. 일반적으로 “Microsoft Entra”와 같은 ID 공급자의 이름입니다.
Target URL Microsoft Entra에서 제공하는 로그인 URL입니다.
Certificate x.509 PEM 인코딩된 인증서는 ID 공급자가 제공합니다.
New Stuff!