자습서: Khoros Care와 Azure Active Directory SSO(Single Sign-On) 통합Tutorial: Azure Active Directory single sign-on (SSO) integration with Khoros Care

이 자습서에서는 Khoros Care를 Azure AD(Azure Active Directory)와 통합하는 방법에 대해 알아봅니다.In this tutorial, you'll learn how to integrate Khoros Care with Azure Active Directory (Azure AD). Khoros Care를 Azure AD와 통합하면 다음을 수행할 수 있습니다.When you integrate Khoros Care with Azure AD, you can:

  • Khoros Care에 대한 액세스 권한이 있는 사용자를 Azure AD에서 제어합니다.Control in Azure AD who has access to Khoros Care.
  • 사용자가 자신의 Azure AD 계정으로 Khoros Care에 자동으로 로그인되도록 설정합니다.Enable your users to be automatically signed-in to Khoros Care with their Azure AD accounts.
  • 단일 중앙 위치인 Azure Portal에서 계정을 관리합니다.Manage your accounts in one central location - the Azure portal.

Azure AD와 SaaS 앱 통합에 대한 자세한 내용은 Azure Active Directory를 사용한 애플리케이션 액세스 및 Single Sign-On이란 무엇인가요?를 참조하세요.To learn more about SaaS app integration with Azure AD, see What is application access and single sign-on with Azure Active Directory.

필수 구성 요소Prerequisites

시작하려면 다음 항목이 필요합니다.To get started, you need the following items:

  • Azure AD 구독An Azure AD subscription. 구독이 없는 경우 체험 계정을 얻을 수 있습니다.If you don't have a subscription, you can get a free account.
  • Khoros Care SSO(Single Sign-On)가 설정된 구독Khoros Care single sign-on (SSO) enabled subscription.

시나리오 설명Scenario description

이 자습서에서는 테스트 환경에서 Azure AD SSO를 구성하고 테스트합니다.In this tutorial, you configure and test Azure AD SSO in a test environment.

Khoros Care가 Azure AD에 통합되도록 구성하려면 갤러리에서 Khoros Care를 관리형 SaaS 앱 목록에 추가해야 합니다.To configure the integration of Khoros Care into Azure AD, you need to add Khoros Care from the gallery to your list of managed SaaS apps.

  1. Azure Portal에 회사 또는 학교 계정, 개인 Microsoft 계정으로 로그인합니다.Sign in to the Azure portal using either a work or school account, or a personal Microsoft account.
  2. 왼쪽 탐색 창에서 Azure Active Directory 서비스를 선택합니다.On the left navigation pane, select the Azure Active Directory service.
  3. 엔터프라이즈 애플리케이션 으로 이동한 다음, 모든 애플리케이션 을 선택합니다.Navigate to Enterprise Applications and then select All Applications.
  4. 새 애플리케이션을 추가하려면 새 애플리케이션 을 선택합니다.To add new application, select New application.
  5. 갤러리에서 추가 섹션의 검색 상자에 Khoros Care 를 입력합니다.In the Add from the gallery section, type Khoros Care in the search box.
  6. 결과 패널에서 Khoros Care 를 선택한 다음, 앱을 추가합니다.Select Khoros Care from results panel and then add the app. 앱이 테넌트에 추가될 때까지 잠시 동안 기다려 주세요.Wait a few seconds while the app is added to your tenant.

Khoros Care에 대한 Azure AD Single Sign-On 구성 및 테스트Configure and test Azure AD single sign-on for Khoros Care

B.Simon 이라는 테스트 사용자를 사용하여 Khoros Care에서 Azure AD SSO를 구성하고 테스트합니다.Configure and test Azure AD SSO with Khoros Care using a test user called B.Simon. SSO가 작동하려면 Azure AD 사용자와 Khoros Care의 관련 사용자 간에 연결 관계를 설정해야 합니다.For SSO to work, you need to establish a link relationship between an Azure AD user and the related user in Khoros Care.

Khoros Care에서 Azure AD SSO를 구성하고 테스트하려면 다음 구성 요소를 완료합니다.To configure and test Azure AD SSO with Khoros Care, complete the following building blocks:

  1. Azure AD SSO 구성 - 사용자가 이 기능을 사용할 수 있도록 합니다.Configure Azure AD SSO - to enable your users to use this feature.
    1. Azure AD 테스트 사용자 만들기 - B.Simon을 사용하여 Azure AD Single Sign-On을 테스트합니다.Create an Azure AD test user - to test Azure AD single sign-on with B.Simon.
    2. Azure AD 테스트 사용자 할당 - B. Simon이 Azure AD Single Sign-On을 사용할 수 있도록 합니다.Assign the Azure AD test user - to enable B.Simon to use Azure AD single sign-on.
  2. Khoros Care SSO 구성 - 애플리케이션 쪽에서 Single Sign-On 설정을 구성합니다.Configure Khoros Care SSO - to configure the single sign-on settings on application side.
    1. Khoros Care 테스트 사용자 만들기 - B.Simon의 Azure AD 표현과 연결된 해당 사용자를 Khoros Care에 만듭니다.Create Khoros Care test user - to have a counterpart of B.Simon in Khoros Care that is linked to the Azure AD representation of user.
  3. SSO 테스트 - 구성이 작동하는지 여부를 확인합니다.Test SSO - to verify whether the configuration works.

Azure AD SSO 구성Configure Azure AD SSO

Azure Portal에서 Azure AD SSO를 사용하도록 설정하려면 다음 단계를 수행합니다.Follow these steps to enable Azure AD SSO in the Azure portal.

  1. Azure PortalKhoros Care 애플리케이션 통합 페이지에서 관리 섹션을 찾은 다음, Single Sign-On 을 선택합니다.In the Azure portal, on the Khoros Care application integration page, find the Manage section and select single sign-on.

  2. Single Sign-On 방법 선택 페이지에서 SAML 을 선택합니다.On the Select a single sign-on method page, select SAML.

  3. SAML로 Single Sign-On 설정 페이지에서 기본 SAML 구성 에 대한 편집(연필 모양) 아이콘을 클릭하여 설정을 편집합니다.On the Set up single sign-on with SAML page, click the edit/pen icon for Basic SAML Configuration to edit the settings.

    기본 SAML 구성 편집

  4. IDP 섹션에서 애플리케이션을 구성하려면 기본 SAML 구성 섹션에서 다음 필드 값을 입력합니다.On the Basic SAML Configuration section, if you wish to configure the application in IDP initiated mode, enter the values for the following fields:

    a.a. 식별자 텍스트 상자에서 https://<SUBDOMAIN>.response.lithium.com 패턴을 사용하여 URL을 입력합니다.In the Identifier text box, type a URL using the following pattern: https://<SUBDOMAIN>.response.lithium.com

    b.b. 회신 URL 텍스트 상자에서 https://<SUBDOMAIN>.response.lithium.com/sso/saml/v2/idp_response 패턴을 사용하여 URL을 입력합니다.In the Reply URL text box, type a URL using the following pattern: https://<SUBDOMAIN>.response.lithium.com/sso/saml/v2/idp_response

  5. SP 시작 모드에서 애플리케이션을 구성하려면 추가 URL 설정 를 클릭하고 다음 단계를 수행합니다.Click Set additional URLs and perform the following step if you wish to configure the application in SP initiated mode:

    로그인 URL 텍스트 상자에서 https://<SUBDOMAIN>.response.lithium.com 패턴을 사용하여 URL을 입력합니다.In the Sign-on URL text box, type a URL using the following pattern: https://<SUBDOMAIN>.response.lithium.com

    참고

    이러한 값은 실제 값이 아닙니다.These values are not real. 실제 식별자, 회신 URL 및 로그온 URL을 사용하여 이러한 값을 업데이트합니다.Update these values with the actual Identifier, Reply URL and Sign-on URL. 이러한 값을 얻으려면 Khoros Care 클라이언트 지원 팀에 문의하세요.Contact Khoros Care Client support team to get these values. Azure Portal의 기본 SAML 구성 섹션에 표시된 패턴을 참조할 수도 있습니다.You can also refer to the patterns shown in the Basic SAML Configuration section in the Azure portal.

  6. Khoros Care 애플리케이션에는 특정 형식의 SAML 어설션이 필요하기 때문에 SAML 토큰 특성 구성에 사용자 지정 특성 매핑을 추가해야 합니다.Khoros Care application expects the SAML assertions in a specific format, which requires you to add custom attribute mappings to your SAML token attributes configuration. 다음 스크린샷에서는 기본 특성의 목록을 보여 줍니다.The following screenshot shows the list of default attributes.

    이미지

  7. 위에서 언급한 특성 외에도 Khoros Care 애플리케이션에는 아래에서 표시된 SAML 응답에서 다시 전달되어야 하는 몇 가지 특성이 추가로 필요합니다.In addition to above, Khoros Care application expects few more attributes to be passed back in SAML response which are shown below. 이러한 특성도 미리 채워져 있지만 요구 사항에 따라 검토할 수 있습니다.These attributes are also pre populated but you can review them as per your requirements.

    NameName 원본 특성Source Attribute
    FirstNameFirstName user.givennameuser.givenname
    LastNameLastName user.surnameuser.surname
  8. SAML로 Single Sign-On 설정 페이지의 SAML 서명 인증서 섹션에서 페더레이션 메타데이터 XML 을 찾고, 다운로드 를 선택하여 인증서를 컴퓨터에 다운로드 및 저장합니다.On the Set up single sign-on with SAML page, in the SAML Signing Certificate section, find Federation Metadata XML and select Download to download the certificate and save it on your computer.

    인증서 다운로드 링크

  9. Khoros Care 설정 섹션에서 요구 사항에 따라 적절한 URL을 복사합니다.On the Set up Khoros Care section, copy the appropriate URL(s) based on your requirement.

    구성 URL 복사

Azure AD 테스트 사용자 만들기Create an Azure AD test user

이 섹션에서는 Azure Portal에서 B.Simon이라는 테스트 사용자를 만듭니다.In this section, you'll create a test user in the Azure portal called B.Simon.

  1. Azure Portal의 왼쪽 창에서 Azure Active Directory, 사용자, 모든 사용자 를 차례로 선택합니다.From the left pane in the Azure portal, select Azure Active Directory, select Users, and then select All users.
  2. 화면 위쪽에서 새 사용자 를 선택합니다.Select New user at the top of the screen.
  3. 사용자 속성에서 다음 단계를 수행합니다.In the User properties, follow these steps:
    1. 이름 필드에 B.Simon을 입력합니다.In the Name field, enter B.Simon.
    2. 사용자 이름 필드에서 username@companydomain.extension을 입력합니다.In the User name field, enter the username@companydomain.extension. 예들 들어 B.Simon@contoso.com입니다.For example, B.Simon@contoso.com.
    3. 암호 표시 확인란을 선택한 다음, 암호 상자에 표시된 값을 적어둡니다.Select the Show password check box, and then write down the value that's displayed in the Password box.
    4. 만들기 를 클릭합니다.Click Create.

Azure AD 테스트 사용자 할당Assign the Azure AD test user

이 섹션에서는 Azure Single Sign-On을 사용할 수 있도록 B.Simon에게 Khoros Care에 대한 액세스 권한을 부여합니다.In this section, you'll enable B.Simon to use Azure single sign-on by granting access to Khoros Care.

  1. Azure Portal에서 엔터프라이즈 애플리케이션 을 선택한 다음, 모든 애플리케이션 을 선택합니다.In the Azure portal, select Enterprise Applications, and then select All applications.

  2. 애플리케이션 목록에서 Khoros Care 를 선택합니다.In the applications list, select Khoros Care.

  3. 앱의 개요 페이지에서 관리 섹션을 찾고 사용자 및 그룹 을 선택합니다.In the app's overview page, find the Manage section and select Users and groups.

    "사용자 및 그룹" 링크

  4. 사용자 추가 를 선택한 다음, 할당 추가 대화 상자에서 사용자 및 그룹 을 선택합니다.Select Add user, then select Users and groups in the Add Assignment dialog.

    사용자 추가 링크

  5. 사용자 및 그룹 대화 상자의 사용자 목록에서 B.Simon 을 선택한 다음, 화면 아래쪽에서 선택 단추를 클릭합니다.In the Users and groups dialog, select B.Simon from the Users list, then click the Select button at the bottom of the screen.

  6. SAML 어설션에 역할 값이 필요한 경우 역할 선택 대화 상자의 목록에서 사용자에 대한 적절한 역할을 선택한 다음, 화면의 아래쪽에 있는 선택 단추를 클릭합니다.If you're expecting any role value in the SAML assertion, in the Select Role dialog, select the appropriate role for the user from the list and then click the Select button at the bottom of the screen.

  7. 할당 추가 대화 상자에서 할당 단추를 클릭합니다.In the Add Assignment dialog, click the Assign button.

Khoros Care SSO 구성Configure Khoros Care SSO

Khoros Care 쪽에서 Single Sign-On을 구성하려면 Azure Portal에서 다운로드한 페더레이션 메타데이터 XML 과 적절히 복사한 URL을 Khoros Care 지원 팀으로 보내야 합니다.To configure single sign-on on Khoros Care side, you need to send the downloaded Federation Metadata XML and appropriate copied URLs from Azure portal to Khoros Care support team. 이렇게 설정하면 SAML SSO 연결이 양쪽에서 제대로 설정됩니다.They set this setting to have the SAML SSO connection set properly on both sides.

Khoros Care 테스트 사용자 만들기Create Khoros Care test user

이 섹션에서는 Khoros Care에서 Britta Simon이라는 사용자를 만듭니다.In this section, a user called Britta Simon is created in Khoros Care. Khoros Care는 Just-In-Time 사용자 프로비저닝을 지원하며, 기본적으로 사용하도록 설정되어 있습니다.Khoros Care supports just-in-time user provisioning, which is enabled by default. 이 섹션에 작업 항목이 없습니다.There is no action item for you in this section. Khoros Care에 사용자가 아직 없는 경우 인증 후에 새 사용자가 만들어집니다.If a user doesn't already exist in Khoros Care, a new one is created after authentication.

SSO 테스트Test SSO

이 섹션에서는 액세스 패널을 사용하여 Azure AD Single Sign-On 구성을 테스트합니다.In this section, you test your Azure AD single sign-on configuration using the Access Panel.

액세스 패널에서 Khoros Care 타일을 클릭하면 SSO를 설정한 Khoros Care에 자동으로 로그인됩니다.When you click the Khoros Care tile in the Access Panel, you should be automatically signed in to the Khoros Care for which you set up SSO. 액세스 패널에 대한 자세한 내용은 액세스 패널 소개를 참조하세요.For more information about the Access Panel, see Introduction to the Access Panel.

추가 리소스Additional resources