SSO 연동 개요

SSO 연동 기능을 사용하면 조직의 기존 ID 시스템을 사용하여 크리테오에 액세스할 수 있습니다. 별도의 크리테오 로그인 정보가 필요하지 않습니다. 기능을 설정하면 연동된 도메인의 사용자가 크리테오에 액세스할 때 ID 공급자 로그인 페이지로 리디렉션됩니다.

크리테오는 연동을 위해 SAML 2.0을 사용합니다. 두 시스템이 메타데이터를 교환하여 트러스트를 구축합니다.

용어

역할

시스템 예

서비스 공급자(SP)

크리테오 - 사용자가 액세스하려는 애플리케이션

—

아이덴티티 공급자(IDP)

사용자를 인증하고 크리테오에 SAML 어서션을 전송하는 조직의 ID 시스템

Okta, Microsoft Entra ID(Azure AD), AD FS

SSO 연동은 모든 클라이언트에 사용할 수 있습니다. 시작하려면 크리테오 담당자에게 문의하십시오.

시작하기 전에

크리테오 담당자에게 연락하기 전에 다음 정보를 수집하십시오. 크리테오 팀은 온보딩 프로세스에서 다음 정보가 필요합니다.

항목

세부 정보

연동할 도메인

사용자가 로그인할 이메일 도메인입니다.(예: yourcompany.com) 하나로 시작해 나중에 추가할 수 있습니다.

테스트 사용자

연동을 활성화하기 전에 검증할 이메일 주소 목록입니다. 테스트를 시작하려면 모든 테스트 사용자가 활성화된 크리테오 계정을 보유하고 있어야 합니다.

IDP 유형

조직에서 사용하는 ID 공급자 및 사용자 매치를 위해 보낼 SAML 속성입니다. 크리테오는 emailAddress를 추천합니다.

환경

운영션 환경에 별도의 메타데이터 파일을 사용할 계획인지, 테스트 및 운영 환경이 동일한 IDP 메타데이터를 공유하는지 여부입니다.

목표 시행 날짜

연동된 도메인의 모든 사용자에 대해 SSO를 활성화할 날짜입니다.

IDP 값 위치

온보딩 중에 서명 인증서, IDP 엔터티 및 SSO URL을 크리테오와 공유해주셔야 합니다. 세 가지를 모두 한 번에 수집하는 가장 빠른 방법은 IDP의 메타데이터 XML 파일을 내보내는 것입니다. 이 파일은 모두 하나의 파일에 포함되어 있습니다. 아래는 주요 ID 공급자에서 이 값을 찾는 방법입니다.

Okta

가장 빠른 경로는 SAML 애플리케이션에서 직접 IDP 메타데이터 XML을 다운로드하는 것입니다. 엔터티 ID, SSO URL 및 서명 인증서가 하나의 파일에 포함되어 있습니다.

크리테오용으로 구성된 Okta 애플리케이션에서 Sign On → SAML Signing Certificates → Actions → View IdP metadata로 이동한 다음, XML 파일을 저장합니다.

참조:

Microsoft Entra ID(Azure AD)

크리테오가 필요로 하는 값이 위치한 두 개 소스:

  • 엔터프라이즈 앱 SSO 페이지 - 로그인 URL, Entra 식별자 및 인증서 다운로드를 제공합니다. 엔터프라이즈 애플리케이션 → Single sign-on 설정 페이지로 이동합니다.

  • 테넌트 전체 연동 메타데이터 엔드포인트 - 보통 가장 빠른 단일 소스입니다. 경로: https://login.microsoftonline.com/<tenant>/FederationMetadata/2007-06/FederationMetadata.xml

참조:

AD FS

AD FS는 온프레미스 소프트웨어이므로 값을 찾을 수 있는 단일 고객측 가이드가 없습니다. 별도의 두 단계가 필요합니다.

  • 연동 메타데이터 URL - 엔터티 ID 및 SSO 엔드포인트를 제공합니다.

  • 토큰 서명 인증서 - Service → Certificates 아래의 AD FS 관리 콘솔에서 별도로 내보내기를 합니다.

위의 참조 자료와 관련해 도움이 필요하시면 크리테오 담당자에게 문의하십시오.

참조:

크리테오가 제공하는 사항

온보딩이 시작되면 크리테오는 서비스 공급자(SP) 메타데이터 파일을 공유합니다. 이 파일을 IDP에서 크리테오 애플리케이션을 설정하는 데 사용합니다. 여기에는 다음 값이 포함됩니다.

필드

설명

오디언스 URI(엔터티 ID)

크리테오의 SSO 서비스에 대한 고유 식별자

회신 URL(ACS URL)

성공적으로 로그인 후 IDP가 SAML 어서션을 전송하는 대상 URL

X509 인증서

크리테오의 서명 인증서

SSO 온보딩 프로세스

​1단계: 온보딩 요청

크리테오 담당자에게 SSO 연동 프로세스를 시작해줄 것을 요청합니다. 요청이 접수되면 크리테오 담당자가 다음 내용을 포함하는 안내 이메일을 발송합니다.

  • SP 메타데이터 파일 및 해당 키 값(오디언스 URI(엔터티 ID), 회신 URL(ACS URL), 이름 ID 형식 및 X509 인증서)은 IDP에서 서비스 공급자로 크리테오를 설정하는 데 필요합니다.

  • 연동을 진행하기 전에 크리테오가 필요한 정보를 요청합니다.

이 이메일을 IT 팀 담당자에 전달해 IDP 설정을 시작하도록 합니다.

2단계: IDP 설정 및 응답

크리테오에서 제공한 SP 메타데이터 파일을 사용하여 귀사의 ID 공급자에서 크리테오를 서비스 공급자로 구성합니다. IDP가 메타데이터 업로드를 지원하는 경우 파일을 직접 사용할 수 있습니다. 그렇지 않으면 SAML 설정에 개별 값을 수동으로 추가합니다.

IDP 설정이 준비되면 다음과 같이 안내 이메일에 회신합니다.

  1. 사용자 IDP 메타데이터 파일 - 응답에 XML 파일을 첨부합니다. 또는 값을 개별적으로 제공할 수도 있습니다.

    • IDP 엔터티 ID

    • SSO 엔드포인트 URL

    • 서명 인증서

  2. 연동할 도메인 - SSO를 사용해야 하는 이메일 도메인(예: @yourcompany.com)

  3. ID 제공자 - IDP의 이름(예: Microsoft Entra ID, Okta, AD FS)

  4. 사용자 ID - 크리테오가 사용자를 매치하는 데 사용할 SAML 속성. emailAddress를 권장합니다.

  5. 테스트 사용자 - 롤아웃 전에 SSO를 테스트할 사용자의 이메일 주소

  6. 환경 - 운영 환경에 별도의 메타데이터 파일을 제공할 것인지 여부

  7. 목표 시행 날짜(선택 사항)

3단계: 크리테오 검증 및 설정

크리테오 팀은 귀하의 답변을 검토하고 기술적 세부 사항을 확인합니다. 누락되었거나 명확하지 않은 부분이 있으면 진행하기 전에 바로 문제를 해결할 수 있도록 후속 조치를 취합니다.

검증이 완료되면 지정된 테스트 사용자들을 위한 SSO를 설정하고 테스트를 시작할 수 있음을 알립니다.

4단계: 활성화 테스트

크리테오는 도메인의 모든 사용자가 아닌 동의한 테스트 사용자에게만 SSO를 활성화합니다. 테스트를 시작할 수 있는 URL을 이메일로 전송합니다.

최상의 결과를 얻으려면 각 사용자는 아래 단계를 사용하여 SSO를 테스트해야 합니다.

  1. 기존 쿠키 또는 세션을 사용하지 못하도록 시크릿 창을 엽니다.

  2. account.criteo.com으로 이동하여 업무용 이메일 주소를 입력합니다.

  3. 귀사의 로그인 페이지로 리디렉션됩니다.

  4. 크리테오 계정의 로그인 정보가 아니라 회사 로그인 정보를 사용하여 로그인합니다.

  5. 로그인에 성공하면 개인 정보가 포함된 계정 정보 페이지가 나타납니다. 이는 SSO 테스트에 성공했음을 나타냅니다.

테스트가 완료되면 평소처럼 크리테오 플랫폼에 액세스할 수 있습니다.

SSO는 이 단계에서 사용자별로 활성화됩니다. 다른 사용자는 실행 전환이 완료될 때까지 평소대로 로그인합니다.

5단계: 테스트

테스트 사용자는 크리테오가 공유한 URL을 통해 로그인하고 다음을 확인합니다.

  • IDP 로그인 페이지로 리디렉션되는가

  • 로그인 후 크리테오 계정으로 리디렉션되는가

  • 올바른 계정과 데이터를 볼 수 있는가

문제가 있는 경우 동일한 이메일 스레드를 통해 크리테오 팀과 스크린샷 또는 오류 메시지를 공유합니다. 이 단계에서 요청을 하면 연동을 되돌릴 수 있습니다.

6단계: 실행

모든 테스트 사용자가 성공적으로 로그인하면 크리테오는 합의된 날짜에 연동된 도메인의 모든 사용자에 대해 SSO를 활성화합니다.

실행 후 문제가 발생하면 크리테오에 문의하여 설정을 롤백하거나 수정하십시오.

SSO 유지 관리

일부 필드는 초기 온보딩 중에 설정되며 거의 변경할 필요가 없습니다. 그 외의 경우에는 연동 기간 동안 정기적으로 업데이트해야 합니다.

거의 변경되지 않는 항목

온보딩 중에 설정되고 안정적으로 유지됩니다.

  • SP 엔터티 ID

  • SP ACS/응답 URL

  • IDP 엔터티 ID

  • 사용자 매치에 사용되는 SAML 속성

​시간이 지나면서 업데이트되는 항목

필드

변경되는 이유

크리테오의 SP 서명 인증서

발급일로부터 5년간 유효합니다. 크리테오는 갱신이 필요할 때 귀하에게 통지합니다.

귀하의 IDP 서명 인증서

유효기간은 IDP 설정에 따라 다릅니다. 만료되기 전에 회전 - 업데이트된 메타데이터 파일을 미리 크리테오와 공유합니다.

연동된 이메일 도메인

운영 개시 후 새 도메인을 추가하거나 이전 도메인을 제거할 수 있습니다.

IDP 메타데이터

IDP 시스템을 마이그레이션하거나 환경을 변경하는 경우 업데이트가 필요할 수 있습니다.

실행 후 이러한 필드를 업데이트하려면 크리테오 담당자에게 문의하십시오.