ADFS에 Cisco Webex Control Hub 통합


구성 안내서는 SSO 통합에 대한 특정 예제를 안내하지만, 모든 가능성에 대한 각각의 구성은 제공하지 않습니다. 예를 들어, nameid-format urn:oasis:names:tc:SAML:2.0:nameid-format:transient에 대한 통합 단계는 문서화되었습니다. urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified 또는 urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress 등 다른 형식도 SSO 통합에 대해 작동하지만, 문서 범위에는 속하지 않습니다.

Cisco Webex 조직(Cisco Webex Teams, Cisco Webex MeetingsCisco Webex Control Hub에서 관리되는 기타 서비스 포함)에서 사용자에 대해 이 통합을 설정하십시오. Webex 사이트가 Cisco Webex Control Hub에서 통합된 경우, Webex 사이트에는 해당 사용자 관리가 적용됩니다. 이러한 방법으로 Cisco Webex Meetings에 액세스할 수 없으며, Cisco Webex Control Hub에서 관리되지 않는 경우, 개별 통합을 실행하여 Cisco Webex Meetings에 대해 SSO를 활성화해야 합니다. (자세한 정보는 사이트 관리의 SSO 통합에서 Webex에 대해 싱글 사인온 구성을 참조)

ADFS의 인증 메커니즘에 구성된 내용에 따라, IWA(Integrated Windows Authentication)가 기본적으로 활성화될 수 있습니다. 활성화되는 경우, 처음 이메일 프롬프트 중에 입력된 이메일 주소와 관계없이, Windows(Webex TeamsCisco 디렉터리 커넥터 등)를 통해 실행된 응용프로그램이 로그인된 사용자로 인증됩니다.

Cisco Webex 메타데이터를 로컬 시스템으로 다운로드

1

https://admin.webex.com의 고객 보기에서 설정으로 이동한 후 인증으로 스크롤합니다.

2

수정을 클릭하고 제3자 ID 공급자 통합을 클릭합니다. (고급)을(를) 선택한 후 다음을 클릭합니다.

3

메타데이터 파일을 다운로드합니다.

Cisco Webex 메타데이터 파일명은 idb-meta-<org-ID>-SP.xml입니다.

ADFS에 Cisco Webex 메타데이터 설치

시작하기 전에

Cisco Webex Control Hub 은(는) ADFS 2.x 이상을 지원합니다.

Windows 2008 R2에는 ADFS 1.0만 포함됩니다. Microsoft에서 최소 ADFS 2.x를 설치해야 합니다.

SSO 및 Cisco Webex 서비스에 대해 ID 공급자(IdP)는 다음 SAML 2.0 사양을 따라야 합니다.

  • NameID 형식 속성을 urn:oasis:names:tc:SAML:2.0:nameid-format:transient으로 설정하십시오.

  • IdP에 있는 클레임이 Cisco 디렉터리 커넥터에서 선택된 속성에 매핑된 값이 포함된 uid 속성 이름 또는 Cisco Webex 아이덴티티 서비스에서 선택된 속성과 일치하는 사용자 속성을 포함하도록 구성합니다. (예를 들어, 이 속성은 E-mail-Addresses 또는 User-Principal-Name일 수 있음) 안내에 대해서는 https://www.cisco.com/go/hybrid-services-directory에서 사용자 정의 속성 정보를 참조하십시오.

1

관리자 권한으로 ADFS 서버에 로그인합니다.

2

ADFS 관리 콘솔을 열고 트러스트 관계 > 신뢰 당사자 트러스트 > 신뢰 당사자 트러스트 추가를 찾아봅니다를 선택합니다.

3

신뢰 당사자 트러스트 추가 마법사 창에서 시작을 선택합니다.

4

데이터 소스 선택에 대해 파일에서 트러스트 당사자에 대한 데이터 가져오기를 선택하고 다운로드한 Cisco Webex Control Hub 메타데이터 파일을 찾은 후 다음을 선택합니다.

5

표시명 지정에 대해 와 같이 이 신뢰 당사자 트러스트에 대한 표시명을 만들고 Cisco Webex다음을 선택합니다.

6

발행 인증 규칙 선택에 대해 모든 사용자가 이 신뢰 당사자에게 액세스할 수 있도록 허용을 선택하고 다음을 선택합니다.

7

트러스트 추가 준비에 대해 다음 을 선택하고 ADFS에 신뢰 당사자 추가하기 작업을 마칩니다.

인증을 허용할 클레임 규칙 만들기 Cisco Webex

1

기본 ADFS 분할 창에서 작성한 트러스트 관계를 선택한 후 클레임 규칙 편집을 선택합니다. 발행 변환 규칙 탭에서 규칙 추가를 선택합니다.

2

규칙 유형 선택 단계에서 LDAP 속성을 클레임으로 보내기를 선택한 후 다음을 선택합니다.

  1. 클레임 규칙 이름을 입력합니다.

  2. Active Directory를 속성 스토어로 선택합니다.

  3. 이메일 주소 LDAP 속성을 uid 나가는 클레임 유형으로 매핑합니다.

    이 규칙은 사용자를 식별하기 위해 ADFS에 어떤 필드가 Cisco Webex(으)로 매핑되었는지를 알립니다. 표시된 대로 정확히 나가는 클레임 유형을 적습니다.

  4. 변경 사항을 저장합니다.

3

규칙 추가를 다시 선택한 후 사용자 정의 규칙을 사용하여 클레임 보내기를 선택한 후 다음을 선택합니다.

이 규칙은 Cisco Webex에서 제공하지 않는 “spname qualifier” 속성으로 ADFS를 제공합니다.

  1. 텍스트 편집기를 열고 다음 콘텐츠를 복사합니다.

    c:[Type == "http://schemas.microsoft.com/ws/2008/06/identity/claims/windowsaccountname"] => issue(Type = "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier", Issuer = c.Issuer, OriginalIssuer = c.OriginalIssuer, Value = c.Value, ValueType = c.ValueType, Properties["http://schemas.xmlsoap.org/ws/2005/05/identity/claimproperties/format"] = "urn:oasis:names:tc:SAML:2.0:nameid-format:transient", Properties["http://schemas.xmlsoap.org/ws/2005/05/identity/claimproperties/namequalifier"] = "URL1", Properties["http://schemas.xmlsoap.org/ws/2005/05/identity/claimproperties/spnamequalifier"] = "URL2");

    텍스트에서 URL1 및 URL2를 다음과 같이 대체합니다.
    • URL1은 다운로드한 ADFS 메타데이터 파일의 entityID입니다.

      예를 들어, 다음은 표시되는 내용의 샘플입니다. <EntityDescriptor xmlns="urn:oasis:names:tc:SAML:2.0:metadata" entityID="http://ad0a.identitylab20.ciscolabs.com/adfs/services/trust" ID="_55515dde-8147-4183-8a85-b704d26b5dba">

      ADFS 메타데이터 파일의 entityID만 복사하고 텍스트 파일에 붙여넣어 URL1을 변경합니다.

    • URL2는 다운로드한 Cisco Webex 메타데이터 파일에 있는 첫 번째 줄에 위치합니다.

      예를 들어, 다음은 표시되는 내용의 샘플입니다. <EntityDescriptor xmlns="urn:oasis:names:tc:SAML:2.0:metadata" entityID=" https://idbroker.webex.com/35a15b0a-0eg1-4029-9f63-a8c54df5df59">

      Cisco Webex 메타데이터 파일의 entityID만 복사하고 텍스트 파일에 붙여넣어 URL2를 변경합니다.

  2. 업데이트된 URL을 사용하여 텍스트 편집기("c:"로 시작됨)에서 규칙을 복사하고 ADFS 서버에 있는 사용자 정의 규칙 상자에 붙여넣습니다.

    완료된 규칙은 다음과 같습니다.
  3. 마침을 선택하여 규칙을 만들고 클레임 규칙 편집 창을 종료합니다.

4

기본 창에서 신뢰 당사자 트러스트를 선택한 후 오른쪽 분할창에서 등록 정보를 선택합니다.

5

등록 정보 창이 나타나면 고급 탭에서 SHA-256을 찾은 후 확인을 선택하여 변경 사항을 저장합니다.

6

파일을 다운로드하려면 내부 ADFS 서버에서 다음 URL을 찾습니다. https://AD_FS_Server>/FederationMetadata/2007-06/FederationMetadata.xml


 

올바르게 서식화된 XML 파일을 찾기 위해 페이지를 오른쪽 클릭하고 페이지 리소스를 확인해야 할 수도 있습니다.

7

로컬 머신에 파일을 저장합니다.

다음에 수행할 작업

관리 포털에서 ADFS 메타데이터를 다시 Cisco Webex(으)로 가져오기할 준비가 되었습니다.

IdP 메타데이터 가져오기 및 테스트 후에 싱글 사인온 활성화

Cisco Webex 메타데이터를 내보내기한 후 IdP를 구성하고 해당 IdP 메타데이터를 로컬 시스템으로 다운로드하면 Cisco Webex 조직으로 가져오기할 준비가 됩니다(Control Hub에서).

1

다음 중 하나를 선택합니다.

  • 브라우저에서 Cisco Webex Control Hub – 디렉터리 메타데이터 내보내기 페이지로 돌아간 후 다음을 클릭합니다.
  • Control Hub이(가) 브라우저 탭에 더 이상 열려 있지 않은 경우, https://admin.webex.com의 고객 보기에서 설정으로 이동하고 인증으로 스크롤한 후 타사 ID 공급자 통합(고급)을 선택합니다. 그 후 신뢰할 수 있는 메타데이터 파일 페이지에서 다음을 클릭합니다(이전에 이미 실행했음).
2

IdP 메타데이터 가져오기 페이지에서 IdP 메타데이터 파일을 페이지로 드래그하고 드롭하거나, 파일 찾아보기 옵션을 사용하여 메타데이터 파일을 찾고 업로드합니다. 다음을 클릭합니다.

메타데이터가 서명되지 않았으며, 셀프 서명된 인증서 또는 비공개 기업 인증 기관(CA)에서 서명된 경우, 메타데이터에 있는 인증 기관이 서명한 인증서 필요 (더욱 안전)을 사용할 것을 권장합니다. 인증서가 셀프 서명된 경우, 덜 안전 옵션을 선택해야 합니다.

3

SSO 연결 테스트를 선택하고 새로운 브라우저 탭이 열리면 로그인하여 IdP로 인증합니다.


 

인증 오류를 수신하는 경우, 자격 증명과 관련된 문제일 수 있습니다. 사용자이름 및 비밀번호를 확인한 후 다시 시도하십시오.

Webex Teams 오류는 일반적으로 SSO 설정과 관련된 문제를 의미합니다. 이러한 경우, 해당 단계를 다시 실행합니다. 특히 Control Hub 메타데이터를 IdP 설정에 복사하고 붙여넣는 단계를 주의하십시오.

4

Control Hub 브라우저 탭으로 돌아갑니다.

  • 테스트가 성공적이면 이 테스트에 성공했습니다를 선택합니다. 싱글 사인온 옵션을 활성화하고 다음을 클릭합니다.
  • 테스트에 실패하면 이 테스트에 실패했습니다를 선택합니다. 싱글 사인온 옵션을 비활성화하고 다음을 클릭합니다.

다음에 수행할 작업

자동 이메일 표시하기 않기에 있는 절차를 따라 조직에서 새로운 Webex Teams 사용자에게 발송하는 이메일을 비활성화할 수 있습니다. 해당 문서에는 조직에 있는 사용자에게 통신문을 발송하는 모범 사례도 포함됩니다.

ADFS 문제 해결하기

Windows 로그에 있는 ADFS 오류

Windows 로그에 ADFS 이벤트 로그 오류 코드 364가 나타날 수도 있습니다. 이벤트 세부 사항은 유효하지 않은 인증서를 식별합니다. 이러한 경우, ADFS 호스트는 포트 80에 있는 방화벽을 통해 인증서의 유효성을 검증할 수 없습니다.

페더레이션 ID

페더레이션 ID는 대소문자를 구분합니다. 조직 이메일 주소인 경우, ADFS에서 발송한 것과 동일하게 입력하십시오. 그렇지 않으면 Cisco Webex은(는) 일치하는 사용자를 찾을 수 없습니다.

사용자 정의 클레임 규칙은 발송하기 전에 LDAP 속성을 정상화하기 위해 쓸 수 없습니다.

환경에서 설정한 ADFS 서버에서 메타데이터를 가져오기합니다.

필요한 경우 ADFS 관리에서 서비스 > 엔드포인트 > 메타데이터 > 유형:페더레이션 메타데이터 를 탐색하여 URL을 확인할 수 있습니다.

시간 동기화

ADFS 서버의 시스템 시계가 네트워크 시간 프로토콜(NTP)을 사용하는 신뢰할 수 있는 인터넷 시간 소스와 동기화되었는지 확인하십시오. 다음 PowerShell 명령어를 사용하여 Cisco Webex 신뢰 당사자 트러스트 관계 전용의 시계를 조절합니다.

Set-ADFSRelyingPartyTrust -TargetIdentifier "https://idbroker.webex.com/$ENTITY_ID_HEX_VALUE" -NotBeforeSkew 3

16진수 값은 귀하의 환경에 대해 고유합니다. Cisco Webex 메타데이터 파일에 있는 SP EntityDescriptor ID 값에서 해당 값을 교체하십시오. 예:

<EntityDescriptor xmlns="urn:oasis:names:tc:SAML:2.0:metadata" entityID=" https://idbroker.webex.com/c0cb726f-a187-4ef6-b89d-46749e1abd7a">