- 홈
- /
- 문서
Control Hub에 Entra ID 마법사 앱을 설정하세요.
Microsoft Entra ID에서 사용자 및 그룹을 관리하는 경우 Control Hub의 Entra ID 마법사 앱을 사용하여 Webex와 사용자 및 그룹을 동기화하세요.
Control Hub에서 Entra ID를 활성화합니다.
Webex for Government에서 Entra ID 마법사 앱은 GCC Moderate Entra ID 및 GCC High Entra ID 고객 모두에게 제공됩니다.
이 문서에 설명된 기능 중 일부는 아직 모든 고객에게 제공되지 않습니다.
시작하기 전에
애플리케이션 에 대해 테넌트 전체 관리자 동의를 부여할 수 있는 권한이 있는 Entra ID 계정에 액세스할 수 있는지 확인하십시오.
Entra ID 마법사 앱을 설정하려면 Control Hub 조직에서 정식 관리자 권한이 있어야 합니다.
| 1 | |
| 2 |
조직 설정 으로 이동한 다음 Microsoft Entra ID 마법사 앱까지 아래로 스크롤합니다. |
| 3 |
구성 을 시작하려면 설정을 클릭합니다. |
| 4 |
(선택 사항) Webex for Government 관리자의 경우 Entra Worldwide 또는 Entra GCC High 중 하나를 선택하고 진행을 클릭합니다. Entra Worldwide 는 GCC Moderate와 Commercial 모두에 대해 Entra AD로 마법사를 보냅니다. Entra GCC High 는 GCC High용 Entra AD로 마법사를 보냅니다.
|
| 5 |
Entra ID 관리자 계정을 인증하세요. Entra ID에서 전역 관리자 또는 특권 역할 관리자가 아닌 경우, Entra ID 마법사 앱에 대한 권한 부여를 요청할 수 있습니다. Entra ID에서 관리자 권한이 있는 경우 . 활동아래에서 관리자 동의 요청 을 선택하고 Cisco Webex Identity Integration 을 클릭한 다음 권한 검토 및 수락을 선택합니다. 이 프로세스를 통해 Webex 애플리케이션에 일반 인증이 부여됩니다. 마지막으로 모두(미리 보기) 탭을 클릭하고 Cisco Webex Identity Integration 을 선택한 다음 애플리케이션 검토를 클릭합니다. 에서 Cisco에 대한 관리자 동의 부여 를 클릭하여 Control Hub에서 Entra ID를 활성화하는 데 필요한 모든 권한을 부여하십시오. 이 프로세스에 대한 자세한 내용은 Microsoft 지원 을 참조하십시오. |
| 6 |
권한을 검토하고 수락 을 클릭하여 계정에 Entra ID 테넌트에 대한 액세스 권한을 부여하십시오. Cisco Webex Identity Integration 은 Entra ID 내의 Entra ID 엔터프라이즈 애플리케이션입니다. 위저드 앱은 이 애플리케이션에 연결하여 Entra ID 그래프 API에 접근합니다. 해당 시스템에 접근하는 데 필요한 권한은 시스템을 지원하고 사용하는 데 필요한 최소한의 권한입니다. |
| 7 |
SMB 고객에 대해 동기화 기본값 체크 박스를 체크 하고 진행을 클릭하여 기본 설정을 수락합니다. 기업 고객에 대해 다음 단계로 이동하고 구성을 계속합니다. 기본 설정을 수락하는 경우, 다음을 원합니다.
![]() |
| 8 |
엔터프라이즈 고객(사용자 1,000명 이상) 또는 설정을 수동으로 구성하려는 고객은 속성 탭을 클릭하고 속성을 매핑하십시오. 저장을 클릭합니다. Entra ID에서 Webex로 다른 사용자 속성을 매핑하거나 속성 페이지를 사용하여 기존 사용자 속성 매핑을 변경할 수 있습니다. 매핑을 올바르게 구성하도록 확인하여 사용자 정의할 수 있습니다. 사용자이어로 매핑한 값은 중요합니다. Webex는 사용자의 이메일 주소를 사용자 이름으로 사용합니다. 기본적으로 Entra ID의 userPrincipalName(UPN)은 Control Hub의 이메일 주소(사용자 이름)에 매핑됩니다. 첫 번째 설정 중에 매핑을 편집할 수 없습니다. 이때 해당 인스턴스는 완전히 구축되지 않은 것으로, 사용자 정의한 매핑 속성의 인스턴스가 없습니다. 그러나 설정이 완료되면 편집 을 클릭하여 변경할 수 있습니다. |
| 9 |
사용자 탭을 클릭하여 동기화 범위에 사용자를 추가 합니다. 사용자 이름을 입력하여 검색하고 동기화 범위에 사용자를 추가할 수 있습니다. 오른쪽의 휴지통 아이콘을 클릭하여 동기화 범위에서 사용자를 제거할 수도 있습니다. 저장을 클릭합니다. Entra ID의 모든 사용자를 선택하려면 모든 사용자 선택을 선택하십시오. 선택한 경우, 이 옵션은 그룹을 동시에 동기화하기 때문에 범위에서 그룹을 선택하지는 않습니다. 초기화 과정에 오랜 시간이 필요하기 때문에 수 백 여명의 사용자를 사용하는 중요 기업 고객에 대해 모든 사용자 선택을 사용하는 것은 권장하지 않습니다. Control Hub에서 실수로 많은 사용자를 동기화하는 경우, 해당 사용자를 삭제하는 데에도 더 이상 시간이 소요됩니다. 저장을 클릭합니다. |
| 10 |
그룹 탭에서 개별 그룹을 검색하고 Webex에 추가할 수 있습니다.
|
| 11 |
(선택 사항) 더보기 탭에서 고급 동기화 옵션을 구성할 수 있습니다.
|
| 12 |
동기화가 즉시 또는 나중에 실행되도록 허용할지 결정할 수 있습니다. 지금 허용 옵션을 선택하면 다음 동기화에 모든 설정이 적용됩니다. 저장 및 나중에 허용 옵션을 선택하는 경우, 자동 동기화를 허용할 때까지 동기화가 시작되지 않습니다. |
| 13 |
해당 애플리케이션은 Entra ID와 통신하여 구성을 설정하고 동기화 일정을 예약합니다. |
- 활동적인: 동기화가 성공적으로 완료되었습니다.
- 건강격리: 동기화 작업이 여러 차례 실패한 후 Entra ID에서 격리되었습니다. 자세한 내용은 Entra ID 문서 를 참조하십시오.
- 실행 안 함: 이 상태는 최초 설정 후에만 나타납니다. 초기 설정 후 서비스가 아직 실행되지 않았습니다.
요약 보기 를 클릭하면 마지막 동기화 시간 및 날짜, 동기화된 사용자 수, 건너뛴 사용자 수 또는 실패한 사용자 수와 같은 추가 정보를 확인할 수 있습니다.
사용자
- 동기화됨: Webex에 성공적으로 동기화된 사용자 수를 보여줍니다.
- 건너뛰었습니다: 마지막 동기화에서 누락된 사용자 수를 보여줍니다. 예를 들어, Entra ID 마법사 앱 동기화 범위에 추가되지 않은 Entra ID의 신규 사용자입니다. 이 사용자들은 Webex와 동기화되지 않았습니다. 동기화 범위에 추가하여 Webex와 동기화하십시오.
- 실패: 동기화에 실패한 사용자 수를 보여줍니다. 해당 사용자의 동기화 실패 원인에 대한 자세한 내용은 Entra ID 애플리케이션 프로비저닝 감사 로그를 확인하십시오. 이러한 사용자를 즉시 동기화해야 하는 경우요청 시 사용자를 프로비저닝할 수 있습니다.
기존 Cisco Webex Enterprise 앱 구성을 Entra ID Wizard 앱으로 마이그레이션하세요.
이미 Entra ID에 Cisco Webex Enterprise 앱을 설정한 경우 모든 구성을 Entra ID 마법사 앱으로 자동으로 마이그레이션할 수 있습니다. Entra ID의 모든 기능을 Control Hub에서 관리할 수 있으며, 기존 설정은 그대로 유지됩니다.
| 1 | |||||||||||
| 2 |
조직 설정 으로 이동 한 후 디렉터리 동기화 섹션 으로 스크롤 다운 합니다. | ||||||||||
| 3 |
구성 을 시작하려면 설정을 클릭합니다. | ||||||||||
| 4 |
Entra ID 구성으로 Entra ID 관리자 계정을 인증하십시오. 다음 단계에서 설명하는 권한이 있는 계정을 사용하는지 확인하십시오. | ||||||||||
| 5 |
권한을 검토하고 수락 을 클릭하여 계정에 Entra ID 테넌트에 대한 액세스 권한을 부여하십시오. Cisco Webex Identity Synchronization 은 Entra ID 내의 Entra ID 엔터프라이즈 애플리케이션입니다. 위저드 앱은 이 애플리케이션에 연결하여 Entra ID 그래프 API에 접근합니다. 액세스하기 위해 필요한 권한은 지원 및 사용에 필요한 최소 권한입니다.
| ||||||||||
| 6 |
기존 앱 마이그레이션을 선택하세요. | ||||||||||
| 7 |
추가 읽기 전용 권한 요청을 수락한 후 마법사 앱으로 마이그레이션할 기존 앱을 선택한 다음 진행을 선택합니다. 선택한 기존 앱이 동일한 Control Hub에 사용자를 프로비저닝하지 않으면 마이그레이션이 실패합니다. | ||||||||||
| 8 |
마이그레이션이 완료되면 오류가 없는지 확인하기 위해 자동 동기화를 활성화하기 전에 테스트 실행 을 수행하는 것이 좋습니다. |
예행연습을 실시하세요
자동 동기화를 활성화하기 전에 오류가 없는지 확인하기 위해 먼저 모의 실행을 해보는 것이 좋습니다. 모의 실행이 완료되면 모의 실행 보고서를 다운로드하여 자세한 정보를 확인할 수 있습니다. 보고서에서 사용 가능한 열은 다음과 같습니다.
| 열 이름 | 설명 |
|---|---|
| 개체 유형 | Entra ID의 객체 유형(예: 사용자 또는 그룹). |
| 액션 유형 | 동기화 중에 객체에 대해 수행될 작업 유형입니다. 가능한 액션 유형은 다음과 같습니다.
|
| 엔트라 ID | Entra ID에 있는 객체의 ID입니다. |
| 이름 입력 | Entra ID에 있는 객체의 이름입니다. |
| Webex 이름 | Webex에서 객체의 이름입니다. |
| 이유 | 동기화 중에 특정 유형의 작업이 발생하는 이유. |
| 1 |
관리자 계정으로 Control Hub에 로그인하세요. |
| 2 |
조직 설정 으로 이동 한 후 디렉터리 동기화 섹션 으로 스크롤 다운 합니다. |
| 3 |
동기화할 인스턴스 옆에 있는 세 개의 세로 점을 클릭한 다음 테스트 실행을 선택합니다. |
| 4 |
시뮬레이션 실행이 완료되면 요약 다운로드 를 클릭하여 보고서를 CSV 파일로 다운로드하십시오. |
Entra ID 동기화를 비활성화합니다.
Control Hub와 Entra ID 간의 동기화를 일시 중지하는 것은 간단하며 기존 구성에 영향을 미치지 않습니다. 동기화는 언제든지 다시 시작할 수 있습니다.
동기화가 비활성화되면 이전에 동기화되었던 사용자 및 그룹은 수동으로 추가된 사용자 또는 그룹처럼 Control Hub 내에서 직접 관리할 수 있습니다. 동기화를 다시 활성화하면 이러한 사용자 및 그룹이 다시 동기화되고 동기화가 일시 중지된 동안 변경한 내용은 Entra ID로 덮어쓰여집니다.
| 1 | |
| 2 |
조직 설정 으로 이동하여 Microsoft Entra ID 마법사 앱까지 아래로 스크롤합니다. |
| 3 |
Entra ID 동기화 토글을 끄세요. |
자동 동기화 활성화 또는 비활성화
Entra ID 마법사 앱과 해당 백엔드 서비스는 자동 동기화가 활성화되어 있는지 확인하여 Entra ID에서 Webex로 사용자 또는 그룹을 동기화할 시기를 결정합니다. 자동 프로비저닝 사용자 및 그룹 동기화를 허용하려면 자동 동기화 를 활성화하십시오. 자동 동기화를 비활성화하면 마법사 앱은 Webex와 아무것도 동기화하지 않지만 기존 구성은 유지됩니다.
일반적으로 사용자는 Microsoft 정책에 따라 40 분마다 동기화됩니다.
동기화된 사용자 또는 그룹을 변경하려면 자동 동기화 만 비활성화하는 것이 아니라 Entra ID 동기화 를 비활성화해야 합니다.
| 1 |
고객 관리자 권한으로 Control Hub에 로그인하십시오. |
| 2 |
조직 설정 으로 이동 한 후 디렉터리 동기화 섹션 으로 스크롤 다운 합니다. |
| 3 |
자동 동기화를 활성화하려면 오른쪽으로 토글을 전환합니다. 자동 동기화 토 글을 왼쪽으로 전환하여 비활성화합니다. |
Entra ID 마법사 앱 구성을 편집합니다.
| 1 |
관리자 계정으로 Control Hub에 로그인하세요. |
| 2 |
조직 설정 으로 이동 한 후 디렉터리 동기화 섹션 으로 스크롤 다운 합니다. |
| 3 |
구성 편집을 클릭하세요. |
| 4 |
왼쪽 열에서 Entra ID에서 가져온 속성을 선택하여 속성 매핑을 사용자 지정하세요. Webex 클라우드에 있는 대상 속성이 오른쪽 열에 있습니다. 속성 매핑에 대한 자세한 내용은 Entra ID Wizard 앱 속성 매핑 을 참조하십시오. |
| 5 |
사용자 및 그룹 탭에서 동기화 범위에서 사용자 및 그룹을 추가하거나 제거합니다. 중첩된 그룹은 클라우드와 자동으로 동기화되지 않습니다. 동기화하려는 그룹 안에 중첩된 그룹이 있는지 반드시 확인하세요. |
| 6 |
추가 탭 에서 필요한 경우 기본 설정을 변경합니다. |
| 7 |
저장 을 클릭하여 수정된 구성을 저장합니다. 업데이트는 다음 동기화에 적용됩니다. Entra ID 자동 동기화 메커니즘은 사용자 및 사용자 그룹의 동기화를 처리합니다. |
Webex 인스턴스 이름을 수정하세요.
Entra ID 엔터프라이즈 애플리케이션 목록에서 Cisco Webex Identity 인스턴스 이름이 표시되는 방식을 변경합니다.
| 1 |
관리자 계정으로 Control Hub에 로그인하세요. |
| 2 |
조직 설정 으로 이동 한 후 디렉터리 동기화 섹션 으로 스크롤 다운 합니다. |
| 3 |
인스턴스 이름 편집을 클릭하세요. |
| 4 |
새 인스턴스 이름을 입력한 다음 저장을 클릭합니다. |
Entra ID 마법사 앱 구성을 삭제합니다.
Entra ID 마법사 앱을 삭제하면 Entra ID 동기화 구성도 함께 제거됩니다. Webex 또는 Entra ID는 설정 정보를 저장하지 않습니다. 향후 Entra ID 동기화 기능을 사용하려면 전체 설정을 다시 구성해야 합니다.
Entra ID 내에서 Cisco Webex 애플리케이션을 삭제하지 마십시오.
| 1 |
관리자 계정으로 Control Hub에 로그인하세요. |
| 2 |
조직 설정 으로 이동 한 후 디렉터리 동기화 섹션 으로 스크롤 다운 합니다. |
| 3 |
인스턴스를 삭제하려면 클릭하세요. |
| 4 |
Entra ID 인스턴스 삭제? 페이지에서 Webex에서 동의 계약을 제거하려면 Entra ID 관리자 동의 취소 를 선택하십시오. 이 옵션을 선택하는 경우, 자격 증명을 입력하고 다시 권한을 부여해야 합니다. |
| 5 |
삭제를 클릭합니다. |
Webex 온디맨드에 사용자 권한을 부여합니다.
Entra ID 동기화와 관계없이 사용자를 Webex에 즉시 프로비저닝하고 결과를 즉시 확인할 수 있습니다. 이는 설정 중에 문제를 해결할 때 도움이 됩니다.
| 1 |
관리자 계정으로 Control Hub에 로그인하세요. |
| 2 |
조직 설정 으로 이동하여 디렉터리 동기화 섹션까지 아래로 스크롤합니다. |
| 3 |
요청 시 사용자 프로비저닝을 클릭하세요. |
| 4 |
프로비저닝할 사용자를 검색하여 선택한 다음 프로비저닝을 클릭합니다. |
| 5 |
완료되면 다음 결과 중 하나가 표시됩니다.
|
| 6 |
건너뛰거나 실패한 경우 동일한 사용자를 다시 프로비저닝하려면 다시 시도 를 클릭하십시오. |
| 7 |
다른 사용자 프로비저닝 을 클릭하여 프로비저닝 페이지로 돌아갑니다. |
| 8 |
완료되면 완료 를 클릭하세요. |
Entra ID로 인증된 도메인을 Control Hub로 가져오기
고객은 Entra ID에 수백 개의 도메인을 인증받았을 수 있습니다. Entra ID는 Control Hub와 연동되지만, 인증된 도메인을 Control Hub로 가져오려면 별도의 작업이 필요합니다. 이렇게 하면 유지관리 또는 설정 과정에서 많은 수고를 절감할 수 있습니다.
| 1 |
Control Hub의 조직 설정 탭 에서 도메인 시크로 이동합니다. |
| 2 |
Entra ID를 사용하여 ] 추가를 클릭하세요. |
| 3 |
확인된 도메인 추가 페이지에서 추가할 도메인을 검색하고 선택합니다. |
| 4 |
추가를 클릭합니다. 인증된 도메인은 인증된 도메인 목록에 표시됩니다.
|
Entra ID 마법사 앱 속성 매핑
Entra ID Wizard 앱은 속성 표현식에 대한 모든 변경 사항을 지원하고 동기화할 수 있습니다. 예를 들어 Entra ID에서는 displayName 를 매핑하여 surname 및 givenName 속성을 모두 표시할 수 있습니다. 이러한 변경 사항은 마법사 앱에 나타납니다.
Entra ID에서 매핑 속성 표현식에 대한 자세한 내용은 Microsoft 도움말 사이트에서 확인할 수 있습니다.
다음 표에서 Entra ID의 특정 속성에 대한 정보를 확인하십시오.
Entra ID는 null 값을 동기화하지 않습니다. Entra ID에서 속성 값을 null로 설정해도 Webex에서는 해당 속성이 삭제되거나 null 값으로 대체되지 않습니다. 자세한 내용은 Microsoft 도움말 사이트 의 제한 사항을 참조하십시오.
|
입력 ID 속성(소스) |
Webex 사용자 속성 (대상) | 설명 |
|---|---|---|
|
userPrincipalName |
userName |
Webex에서 사용자를 식별하는 고유 ID입니다. 이는 이메일 형식입니다. |
|
displayName |
displayName |
Webex 응용 프로그램에 표시하는 사용자의 이름. |
|
surname |
name.familyName |
|
|
givenName |
name.givenName |
|
|
objectId |
externalId |
Entra ID에 있는 사용자의 UID입니다. 일반적으로 이는 16-Bytes 문자열입니다. 이 매핑은 변경하는 것은 권장하지 않습니다. |
|
jobTitle |
title |
|
|
usageLocation |
addresses[type eq "work"].country |
주소 [type eq "work"].country에 사용설정 매핑을 사용할 것이 좋습니다. 다른 속성을 선택하는 경우, 속성 값이 표준을 준수하는지 확인해야 합니다. 예를 들어, 미국은 미국일 수 있습니다. 중국은 CN해야하며, 그렇습니다. |
|
city |
addresses[type eq "work"].locality |
|
|
streetAddress |
addresses[type eq "work"].streetAddress |
|
|
state |
addresses[type eq "work"].region |
|
|
postalCode |
addresses[type eq "work"].postalCode |
|
|
telephoneNumber |
phoneNumbers[type eq "work"].value |
|
|
mobile |
phoneNumbers[type eq "mobile"].value |
|
|
facsimileTelephoneNumber |
phoneNumbers[type eq "fax"].value |
|
|
manager |
manager |
사용자의 관리자 정보를 Webex와 동기화하여 사용자가 연락처 카드에서 항상 정확한 관리자 정보를 볼 수 있도록 합니다. 사용자를 생성할 때 Entra ID는 해당 사용자의 관리자 개체가 Webex Identity에 있는지 여부를 확인합니다. 아니오인 경우 사용자의 관리자 속성은 무시됩니다. 관리자 속성이 있는 경우, 해당 속성이 사용자의 연락처 카드에 표시되려면 다음 두 가지 조건을 충족해야 합니다.
이러한 조건은 사용자의 인증 토큰이 만료되었을 때 사용자의 관리자 속성이 업데이트되었는지 확인합니다. 관리자 속성 변경 사항은 사용자가 변경 후 처음 로그인할 때까지 사용자 연락처 카드에 반영되지 않습니다. |
FAQ
Cisco Directory Connector 프로비저닝에서 Entra ID Wizard 앱으로 마이그레이션하려면 어떻게 해야 합니까?
설치 과정에서 마법사 앱은 조직에서 디렉터리 커넥터를 사용하는지 여부를 감지합니다. 활성화된 경우, Entra ID 사용 여부와 디렉터리 커넥터 차단 여부를 선택할 수 있는 대화 상자가 나타납니다. Entra ID 마법사 앱 구성을 계속하려면 블록 을 클릭하여 확인하십시오.
마법사 앱을 구성하기 전에 디렉터리 커넥터를 비활성화하도록 선택할 수도 있습니다. 설정이 완료되면 마법사 앱이 사용자 프로필을 관리합니다. 하지만 마법사 앱은 동기화 범위에 추가된 사용자만 관리할 수 있습니다. 디렉터리 커넥터를 통해 동기화되었지만 동기화 범위에 포함되지 않은 사용자는 마법사 앱을 사용하여 관리할 수 없습니다.
Microsoft Entra에서 싱글 사인온(SSO)을 구성할 수 있나요?
Control Hub 고객 조직과 Microsoft Entra ID를 ID 공급자로 사용하는 배포 간에 단일 로그인( SSO ) 통합 을 구성할 수 있습니다.
Webex에서 사용자 아바타는 언제 업데이트되나요?
Webex Identity에서 사용자를 생성할 때 사용자 아바타가 Webex에 동기화됩니다. 이 업데이트는 사용자의 아바타가 Entra ID에서 업데이트되어야 합니다. 그런 다음 위저드 앱은 엔트라 ID에서 새 아바타를 가져옵니다. 사용자 연락처 카드는 변경 후 사용자가 처음 로그인할 때 업데이트됩니다.
동기화 직후 사용자가 Control Hub의 그룹에 나타나지 않는 이유는 무엇이며, 어떻게 해결할 수 있습니까?
사용자 및 그룹 동기화는 독립적인 프로세스입니다. 사용자별 동기화는 개별적으로 진행될 수 있지만, 그룹 동기화는 12시간마다 자동으로 이루어집니다. 그룹을 통해 사용자가 동기화되었지만 Control Hub의 그룹에 즉시 나타나지 않는 경우에도 이는 정상적인 동작입니다. 사용자가 기본 사용자 목록에는 나타나지만 그룹에는 나타나지 않는 경우 추가 조치는 필요하지 않습니다. 다음 그룹 동기화 주기가 완료될 때까지 기다리기만 하면 됩니다.
Entra ID에서 사용자를 비활성으로 표시하면 Webex 조직에서 해당 사용자에게 어떤 변화가 발생하나요?
Entra ID에서 비활성 으로 표시된 사용자는 Control Hub에서도 동일한 표시가 적용됩니다. 비활성 사용자는 동기화에서 제외되며 향후 Control Hub의 변경 사항에도 반영되지 않습니다. 그러나 비활성 사용자는 직접 제거하기 전까지 Control Hub 조직에 계속 표시됩니다.
