다음을 통해 공유

Microsoft Entra ID를 사용하여 싱글 사인온을 위한 Contentstack 구성

이 문서에서는 Microsoft Entra ID와 Contentstack을 통합하는 방법에 대해 알아봅니다. Contentstack을 Microsoft Entra ID와 통합하면 다음을 수행할 수 있습니다.

  • Contentstack에 대한 액세스 권한이 있는 사용자를 Microsoft Entra ID에서 제어합니다.
  • 사용자가 Microsoft Entra 계정을 사용하여 Contentstack에 자동으로 로그인되도록 할 수 있습니다.
  • 하나의 중앙 위치에서 계정을 관리합니다.

필수 조건

이 문서에 설명된 시나리오에서는 다음과 같은 필수 구성 요소가 이미 있다고 가정합니다.

  • Contentstack SSO(Single Sign-On) 기능이 활성화된 구독

시나리오 설명

이 문서에서는 테스트 환경에서 Microsoft Entra SSO를 구성하고 테스트합니다.

  • Contentstack은 SP 및 IDP 시작 SSO를 모두 지원합니다.
  • Contentstack은 Just-In-Time 사용자 프로비저닝을 지원합니다.

Contentstack의 Microsoft Entra ID 통합을 구성하려면 갤러리의 Contentstack을 관리형 SaaS 앱 목록에 추가해야 합니다.

  1. Microsoft Entra 관리 센터에 최소한 클라우드 애플리케이션 관리자로 로그인합니다.
  2. Entra ID>Enterprise 애플리케이션>새 애플리케이션으로 이동합니다.
  3. 갤러리에서 추가 섹션의 검색 상자에 Contentstack을 입력합니다.
  4. 결과 패널에서 Contentstack 을 선택한 다음, 앱을 추가합니다. 앱이 테넌트에 추가될 때까지 잠시 동안 기다려 주세요.

또는 엔터프라이즈 앱 구성 마법사를 사용할 수도 있습니다. 이 마법사에서는 테넌트에 애플리케이션을 추가하고, 앱에 사용자/그룹을 추가하고, 역할을 할당하고, SSO 구성을 연습할 수 있습니다. Microsoft 365 마법사에 대한 자세한 정보

Contentstack에 대한 Microsoft Entra SSO 구성 및 테스트

B.Simon이라는 테스트 사용자를 사용하여 Contentstack에서 Microsoft Entra SSO를 구성하고 테스트합니다. SSO가 작동하려면 Microsoft Entra 사용자와 Contentstack의 관련 사용자 간에 연결 관계를 설정해야 합니다.

Contentstack에서 Microsoft Entra SSO를 구성하고 테스트하려면 다음 단계를 수행합니다.

  1. Microsoft Entra SSO 구성 - 사용자가 이 기능을 사용할 수 있도록 합니다.
    1. Microsoft Entra 테스트 사용자를 만들어 B.Simon에서 Microsoft Entra Single Sign-On을 테스트합니다.
    2. Microsoft Entra 테스트 사용자를 할당 하여 B.Simon이 Microsoft Entra Single Sign-On을 사용할 수 있도록 합니다.
  2. Contentstack SSO 구성 - 애플리케이션 쪽에서 Single Sign-On 설정을 구성합니다.
    1. Contentstack 테스트 사용자 만들기 - B.Simon의 Microsoft Entra 표현과 연결된 해당 사용자를 Contentstack에 만듭니다.
  3. SSO 테스트 - 구성이 작동하는지 확인합니다.

Microsoft Entra SSO 구성

Microsoft Entra 관리 센터에서 Microsoft Entra SSO를 사용하도록 설정하려면 다음 단계를 따릅니다.

  1. Microsoft Entra 관리 센터에클라우드 애플리케이션 관리자로 로그인하고 Entra ID>Enterprise 앱을 찾습니다.

  2. 이제 + 새 애플리케이션 을 선택하고 Contentstack을 검색한 다음 만들기를 선택합니다. 만든 후에는 이제 설치 Single Sign-On 으로 이동하거나 왼쪽 메뉴에서 Single Sign-On 링크를 선택합니다.

    스크린샷은 새 애플리케이션 만들기를 보여줍니다.

  3. 다음으로, Single Sign-On 메서드 선택 페이지에서 SAML을 선택합니다.

    스크린샷은 Single Sign-On 방법을 선택하는 방법을 보여줍니다.

  4. SAML로 Single Sign-On 설정 페이지에서 기본 SAML 구성에 대한 연필 아이콘을 선택하여 설정을 편집합니다.

    스크린샷은 기본 SAML 구성을 편집하는 방법을 보여줍니다.

  5. 기본 SAML 구성 섹션에서 몇 가지 단계를 수행해야 합니다. 이러한 단계에 필요한 정보를 얻으려면 먼저 Contentstack 애플리케이션으로 이동하여 다음과 같은 방식으로 SSO 이름 및 ACS URL 을 만들어야 합니다.

    a. Contentstack 계정에 로그인하고 조직 설정 페이지로 이동하여 Single Sign-On 탭을 선택합니다.

    스크린샷은 기본 SAML 구성의 단계를 보여줍니다.

    b. 선택한 SSO 이름을 입력하고 만들기를 선택합니다.

    스크린샷은 이름을 입력하거나 만드는 방법을 보여줍니다.

    참고

    예를 들어 회사 이름이 “Acme, Inc.”인 경우 여기에 “acme”를 입력합니다. 이 이름은 로그인하는 동안 조직 사용자가 로그인 자격 증명 중 하나로 사용됩니다. SSO 이름은 알파벳(소문자), 숫자(0-9) 및/또는 하이픈(-)만 포함할 수 있습니다.

    다. 만들기를 선택하면 어설션 소비자 서비스 URL 또는 ACS URL과 엔터티 ID, 특성 및 NameID 형식과 같은 기타 세부 정보가 생성됩니다.

    스크린샷은 구성할 값을 생성하는 것을 보여줍니다.

  6. 기본 SAML 구성 섹션으로 돌아가서 위의 단계 집합에서 생성된 엔터티 ID와 ACS URL을 각각 식별자(엔터티 ID) 및 회신 URL 섹션에 붙여넣고 항목을 저장합니다.

    1. Contentstack에서 복사한 엔터티 ID 값을 식별자 텍스트 상자에 붙여넣습니다.

      스크린샷은 식별자 값을 붙여넣는 방법을 보여줍니다.

    2. Contentstack에서 복사한 ACS URL을 회신 URL 텍스트 상자에 붙여넣습니다.

      스크린샷은 회신 URL을 붙여넣는 방법을 보여줍니다.

  7. 이 단계는 선택 사항입니다. 애플리케이션을 SP 시작 모드로 구성하려는 경우 로그온 URL 섹션에 로그온 URL을 입력합니다.

    스크린샷은 로그온 URL을 붙여넣는 방법을 보여줍니다.

    참고

    Contentstack SSO 구성을 완료하면 SSO One-Select URL (즉, 로그온 URL)을 찾을 수 있습니다. 스크린샷은 액세스 페이지를 사용하도록 설정하는 방법을 보여줍니다.

  8. Contentstack 애플리케이션에는 사용자 지정 특성 매핑을 SAML 토큰 특성 구성에 추가해야 하는 특정 형식의 SAML 어설션이 필요합니다. 다음 스크린샷에서는 기본 특성의 목록을 보여 줍니다.

    스크린샷은 특성 구성의 이미지를 보여줍니다.

  9. 위에서 언급한 특성 외에도 Contentstackl 애플리케이션에는 아래에 표시된 SAML 응답에서 다시 전달되어야 하는 몇 가지 특성이 추가로 필요합니다. 이러한 특성도 미리 채워져 있지만 요구 사항에 따라 검토할 수 있습니다. 이 단계는 선택 사항입니다.

    이름 원본 특성
    역할 user.assignedroles

    참고

    Microsoft Entra ID에서 역할을 구성하는 방법을 알아보려면 여기 를 선택하세요.

  10. SAML로 Single Sign-On 설정 페이지의 SAML 서명 인증서 섹션에서 인증서(Base64)를 찾아 다운로드를 선택하여 인증서를 다운로드하고 컴퓨터에 저장합니다.

    스크린샷은 인증서 다운로드 링크를 보여줍니다.

  11. Contentstack 설정 섹션에서 요구 사항에 따라 적절한 URL을 복사합니다.

    구성 URL을 복사하는 스크린샷

Microsoft Entra 테스트 사용자 만들기 및 할당

사용자 계정 만들기 및 할당 빠른 시작의 지침에 따라 B.Simon이라는 테스트 사용자 계정을 만듭니다.

Contentstack SSO 구성

  1. Contentstack 회사 사이트에 관리자 권한으로 로그인합니다.

  2. 조직 설정 페이지로 이동하여 왼쪽 메뉴에서 Single Sign-On 탭을 선택합니다.

  3. Single Sign-On 페이지에서 SSO 구성 섹션으로 이동하여 다음 단계를 수행합니다.

    1. 선택한 유효한 SSO 이름을 입력하고 만들기를 선택합니다.

      스크린샷은 구성의 설정을 보여줍니다.

      참고

      예를 들어 회사 이름이 “Acme, Inc.”인 경우 여기에 “acme”를 입력합니다. 이 이름은 로그인하는 동안 조직 사용자가 로그인 자격 증명 중 하나로 사용됩니다. SSO 이름은 알파벳(소문자), 숫자(0-9) 및/또는 하이픈(-)만 포함할 수 있습니다.

    2. 만들기를 선택하면 어설션 소비자 서비스 URL 또는 ACS URL 및 엔터티 ID, 특성 및 NameID 형식과 같은 기타 세부 정보가 생성되고 다음을 선택합니다.

      스크린샷은 구성 값을 보여줍니다.

  4. Idp 구성 탭으로 이동하여 다음 단계를 수행합니다.

    스크린샷은 ID의 로그인 값을 보여줍니다.

    1. 단일 Sign-On URL 텍스트 상자에 Microsoft Entra 관리 센터에서 복사한 로그인 URL을 붙여넣습니다.

    2. Microsoft Entra 관리 센터에서 다운로드한 인증서(Base64) 를 열고 인증서 필드에 업로드합니다.

    3. 다음을 선택합니다.

  5. 다음으로 Contentstack에서 역할 매핑을 만들어야 합니다.

    참고

    IdP 역할 매핑이 Contentstack 계획의 일부인 경우에만 이 단계를 보고 수행할 수 있습니다.

  6. Contentstack의 SSO 설치 페이지의 사용자 관리 섹션에서 엄격한 모드 (SSO 로그인을 통해서만 조직 사용자에 대한 액세스 권한 부여) 및 세션 시간 제한 (SSO를 통해 로그인한 사용자의 세션 기간 정의)이 표시됩니다. 이러한 옵션 아래에 는 고급 설정 옵션도 표시됩니다.

    스크린샷은 사용자 관리 섹션을 보여줍니다.

  7. 고급 설정을 선택하여 IdP 역할 매핑 섹션을 확장하여 IdP 역할을 Contentstack에 매핑합니다. 이 단계는 선택 사항입니다.

  8. 역할 매핑 추가 섹션에서 + 역할 매핑 추가 링크를 선택하여 다음 세부 정보를 포함하는 IdP 역할의 매핑 세부 정보를 추가합니다.

    스크린샷은 매핑 세부 정보를 추가하는 방법을 보여줍니다.

    1. IdP 역할 식별자에서 매니페스트의 값을 사용할 수 있는 IdP 그룹/역할 식별자(예: "개발자")를 입력합니다.

    2. 조직 역할의 경우 매핑된 그룹/역할에 대한 관리자 또는 멤버 역할을 선택합니다.

    3. Stack-Level 권한(선택 사항)의 경우 스택 및 해당 스택 수준 역할을 이 역할에 할당합니다. 마찬가지로 Contentstack 조직에 대한 역할 매핑을 더 추가할 수 있습니다. 새 역할 매핑을 추가하려면 + 역할 매핑 추가 를 선택하고 세부 정보를 입력합니다.

    4. Microsoft Entra ID는 일반적으로 배열에서 역할을 반환하기 때문에 역할 구분 기호 를 비워 둠

    5. 마지막으로 IdP 역할 매핑 사용 확인란을 선택하여 기능을 사용하도록 설정하고 다음을 선택합니다.

    참고

    자세한 내용은 Contentstack SSO 가이드를 참조하세요.

  9. SSO를 사용하도록 설정하기 전에 지금까지 구성된 SSO 설정을 테스트하는 것이 좋습니다. 이렇게 하려면 다음 단계를 수행하십시오.

    1. 테스트 SSO 단추를 선택하면 조직의 SSO 이름을 지정해야 하는 SSO 페이지를 통해 Contentstack의 로그인으로 이동합니다.
    2. 그런 다음, [계속]을 선택하여 IdP 로그인 페이지로 이동합니다.
    3. 계정에 로그인하고 IdP에 로그인할 수 있는 경우 테스트가 성공합니다.
    4. 연결에 성공하면 다음과 같은 성공 메시지가 표시됩니다.

    스크린샷은 성공적인 테스트 연결을 보여줍니다.

  10. SSO 설정을 테스트한 후 SSO 사용을 선택하여 Contentstack 조직에 SSO를 사용하도록 설정합니다.

    스크린샷은 테스트 사용 섹션을 보여줍니다.

  11. 이 기능을 사용하도록 설정하면 사용자는 SSO를 통해 조직에 액세스할 수 있습니다. 필요한 경우 이 페이지에서 도 SSO를 사용하지 않도록 설정할 수 있습니다.

    스크린샷은 액세스 페이지를 사용하지 않도록 설정하는 것을 보여줍니다.

Contentstack 테스트 사용자 만들기

이 섹션에서는 Contentstack에서 Britta Simon이라는 사용자를 만듭니다. Contentstack는 기본적으로 사용하도록 설정되는 Just-In-Time 사용자 프로비저닝을 지원합니다. 이 섹션에는 작업 항목이 없습니다. Contentstack에 사용자가 아직 없는 경우 인증 후에 새 사용자가 만들어집니다.

SSO 테스트

이 섹션에서는 다음 옵션을 사용하여 Microsoft Entra Single Sign-On 구성을 테스트합니다.

SP 시작됨

  • Microsoft Entra 관리 센터에서 이 애플리케이션을 테스트를 선택합니다. 이 옵션은 로그인 흐름을 시작할 수 있는 Contentstack 로그온 URL로 리디렉션됩니다.

  • Contentstack 로그온 URL로 직접 이동하여 해당 위치에서 로그인 흐름을 시작합니다.

IDP가 시작되었습니다.

  • Microsoft Entra 관리 센터에서 이 애플리케이션 테스트를 선택하면 SSO를 설정한 Contentstack에 자동으로 로그인됩니다.

Microsoft 내 앱을 사용하여 모든 모드에서 애플리케이션을 테스트할 수도 있습니다. 내 앱에서 Contentstack 타일을 선택하면 SP 모드로 구성된 경우 로그인 흐름을 시작하기 위해 애플리케이션 로그온 페이지로 리디렉션되고, IDP 모드로 구성된 경우 SSO를 설정한 Contentstack에 자동으로 로그인됩니다. 내 앱에 대한 자세한 내용은 내 앱 소개를 참조하세요.

관련 콘텐츠

Contentstack를 구성한 후에는 세션 제어를 적용하여 조직의 중요한 데이터의 반출 및 침입을 실시간으로 보호할 수 있습니다. 세션 제어는 조건부 액세스에서 확장됩니다. Cloud Apps용 Microsoft Defender를 사용하여 세션 제어를 적용하는 방법을 알아봅니다.

  • Last updated on