다음을 통해 공유


자습서: 자동 사용자 프로비저닝을 위한 Playvox 구성

이 자습서에서는 자동 사용자 프로비전을 구성하기 위해 Playvox 와 Microsoft Entra ID 모두에서 수행해야 하는 단계를 설명합니다. 구성된 경우 Microsoft Entra ID는 Microsoft Entra 프로비전 서비스를 사용하여 사용자 또는 그룹을 Playvox에 자동으로 프로비전 및 프로비전 해제합니다. 이 서비스의 기능, 사용법, 자주 묻는 질문과 답변 등 중요 세부 정보는 Microsoft Entra ID를 사용한 SaaS 애플리케이션에 대한 사용자 프로비전 및 프로비전 해제 자동화를 참조하세요.

지원되는 기능

  • Playvox에서 사용자 만들기
  • Playvox에서 더 이상 액세스할 필요가 없는 사용자 제거
  • Microsoft Entra ID와 Playvox 간에 사용자 특성을 동기화된 상태로 유지합니다.

필수 조건

이 자습서의 시나리오에서는 사용자에게 이미 다음 필수 구성 요소가 있다고 가정합니다.

1단계: 프로비저닝 배포 계획

  1. 프로비저닝 서비스의 작동 방식에 대해 알아봅니다.

  2. 프로비저닝 범위에 포함될 사용자를 결정합니다.

  3. Microsoft Entra ID와 Playvox 간에 매핑할 데이터를 결정합니다.

2단계: Microsoft Entra ID를 사용하여 프로비저닝을 지원하도록 Playvox 구성

  1. Playvox 관리 콘솔에 로그인하고 설정 > API 키로 이동합니다.

  2. API 키 만들기를 선택합니다.

    Playvox 사용자 인터페이스에서 API 키 만들기 단추의 위치를 보여 주는 부분 스크린샷

  3. API 키에 대해 의미 있는 이름을 입력한 다음, 저장을 선택합니다. API 키가 생성되면 닫기를 선택합니다.

  4. 만든 API 키에서 세부 정보 아이콘을 선택합니다.

    Playvox 사용자 인터페이스에서 세부 정보 아이콘(돋보기 그림)의 위치를 보여 주는 부분 스크린샷

  5. BASE64 KEY 값을 복사하여 저장합니다. 나중에 Azure Portal에서 Playvox 애플리케이션의 프로비저닝 탭에 있는 비밀 토큰 텍스트 상자에 이 값을 입력해야 합니다.

    BASE64 KEY 값이 강조 표시된 세부 정보 API 키 메시지 상자의 스크린샷

Playvox에 대한 프로비저닝 관리를 시작하려면 애플리케이션 갤러리로부터 Microsoft Entra 테넌트에 Playvox를 추가합니다. 자세히 알아보려면 빠른 시작: 애플리케이션을 Microsoft Entra 테넌트에 추가를 참조하세요.

이전에 Playvox에서 SSO(Single Sign-On)를 설정한 경우 동일한 애플리케이션을 사용할 수 있습니다. 그러나 통합을 처음으로 테스트할 때에는 별도의 앱을 만드는 것이 좋습니다.

4단계: 프로비저닝 범위에 있는 사용자 정의

Microsoft Entra 프로비저닝 서비스를 사용하면 애플리케이션에 대한 할당이나 사용자 또는 그룹의 특성을 기준으로 프로비저닝되는 사용자의 범위를 지정할 수 있습니다. 할당을 기준으로 앱에 프로비저닝할 사용자의 범위를 지정하려면 Microsoft Entra ID에서 앱에 대한 사용자 할당 관리를 참조하여 사용자와 그룹을 애플리케이션에 할당하는 방법을 알아봅니다. 사용자 또는 그룹의 특성만을 기준으로 프로비저닝할 사용자의 범위를 지정하려면 범위 지정 필터를 사용한 특성 기반 애플리케이션 프로비저닝에서 설명하는 대로 범위 지정 필터를 사용합니다.

다음 사항을 기억하세요.

  • Playvox에 사용자를 할당할 때 기본 액세스 이외의 역할을 선택해야 합니다. 기본 액세스 역할이 있는 사용자는 프로비저닝 대상에서 제외되고 프로비저닝 로그에 실질적으로 권한을 부여받지 않은 것으로 표시됩니다. 애플리케이션에서 사용할 수 있는 유일한 역할이 기본 액세스 역할인 경우 애플리케이션 매니페스트를 업데이트하여 다른 역할을 추가할 수 있습니다.

  • 소규모로 시작합니다. 모든 사용자에게 배포하기 전에 소수의 사용자 또는 그룹 집합으로 테스트합니다. 할당된 사용자 또는 그룹을 기반으로 프로비저닝 범위가 설정된 경우 앱에 하나 또는 두 개의 사용자 또는 그룹만 할당하여 집합의 크기를 제어할 수 있습니다. 프로비저닝 범위에 모든 사용자와 그룹이 포함된 경우 특성 기반 범위 지정 필터를 지정하여 테스트 집합의 크기를 제한할 수 있습니다.

5단계: Playvox에 대한 자동 사용자 프로비저닝 구성

이 섹션에서는 Microsoft Entra ID의 사용자 또는 그룹 할당을 기반으로 사용자 또는 그룹 만들기, 업데이트 및 사용하지 않도록 설정하도록 Microsoft Entra 프로비전 서비스를 구성하는 단계를 안내합니다.

Microsoft Entra ID에서 Playvox에 대한 자동 사용자 프로비저닝을 구성하려면 다음을 수행합니다.

  1. 최소한 클라우드 애플리케이션 관리자Microsoft Entra 관리 센터에 로그인합니다.

  2. ID>애플리케이션>엔터프라이즈 애플리케이션으로 이동합니다.

    엔터프라이즈 애플리케이션 및 모든 애플리케이션 항목이 강조 표시된 Azure Portal의 부분 스크린샷

  3. 애플리케이션 목록에서 Playvox를 검색하여 선택합니다.

    애플리케이션 검색 상자가 강조 표시된 애플리케이션 목록의 부분 스크린샷

  4. 프로비전 탭을 선택합니다.

    프로비저닝 메뉴 항목을 보여 주는 부분 스크린샷

  5. 프로비전 모드자동으로 설정합니다.

    프로비저닝 모드 드롭다운 목록 상자에서 선택한 자동 옵션을 보여 주는 프로비저닝 탭의 부분 스크린샷

  6. 관리자 자격 증명 섹션에서 Playvox 테넌트 URL을 다음과 같이 입력합니다.

    https://{tenant}.playvox.com/scim/v1

    앞서 2단계에서 복사한 비밀 토큰을 입력합니다. 그런 다음 연결 테스트를 선택하여 Microsoft Entra ID에서 Playvox에 연결할 수 있는지 확인합니다. 연결에 실패하면 Playvox 계정에 관리자 권한이 있는지 확인하고 다시 시도합니다.

    테넌트 URL과 비밀 토큰 텍스트 상자가 화면에 나타나고 연결 테스트 링크가 강조 표시된 관리자 자격 증명 섹션을 보여 주는 부분 스크린샷

  7. 알림 메일 텍스트 상자에 프로비저닝 오류 알림을 받을 사용자 또는 그룹의 메일 주소를 입력합니다. 그런 다음, 오류가 발생할 경우 이메일 알림 보내기 확인란을 선택합니다.

    알림 메일 텍스트 상자와 메일 알림 확인란을 보여 주는 부분 스크린샷

  8. 저장을 선택합니다.

  9. 매핑 섹션에서 Microsoft Entra 사용자를 Playvox에 동기화를 선택합니다.

  10. 특성 매핑 섹션에서 Microsoft Entra ID에서 Playvox로 동기화되는 사용자 특성을 검토합니다. 일치 속성으로 선택한 특성은 업데이트 작업을 위해 Playvox의 사용자 계정을 일치시키는 데 사용됩니다. 일치하는 대상 특성을 변경하려는 경우 Playvox API에서 해당 특성을 기준으로 하는 사용자 필터링을 지원하는지 확인해야 합니다. 변경 내용을 커밋하려면 저장을 선택합니다.

    Attribute Type 필터링에 지원됨
    userName 문자열
    활성 부울
    displayName 문자열
    emails[type eq "work"].value 문자열
    name.givenName 문자열
    name.familyName 문자열
    name.formatted 문자열
    externalId 문자열
  11. 범위 지정 필터를 구성하려면 범위 지정 필터 자습서의 지침을 참조하세요.

  12. Playvox에 대해 Microsoft Entra 프로비전 서비스를 사용하도록 설정하려면 설정 섹션에서 프로비전 상태켜기로 변경합니다.

    켜짐으로 설정된 프로비저닝 상태를 보여 주는 설정 섹션의 부분 스크린샷.

  13. 설정 섹션의 범위에서 원하는 값을 선택하여 Playvox에 프로비저닝할 사용자 또는 그룹을 정의합니다.

    범위 드롭다운 목록 상자를 보여 주는 설정 섹션의 부분 스크린샷

  14. 프로비저닝할 준비가 되면 저장을 선택합니다.

    저장 및 취소 옵션을 보여 주는 부분 스크린샷

이 작업은 설정 섹션의 범위에 정의된 모든 사용자 및/또는 그룹의 초기 동기화 주기를 시작합니다. 초기 주기는 이후의 주기보다 오래 걸립니다. Microsoft Entra 프로비저닝 서비스가 실행되고 있으면 약 40분 간격으로 이후 주기가 진행됩니다.

6단계: 배포 모니터링

프로비저닝이 구성되면 다음 리소스를 사용하여 배포를 모니터링합니다.

추가 리소스

다음 단계