이 문서에서
dropdown icon
싱글 사인온 및 컨트롤 허브
    프로필
    이름ID 포맷
    싱글 로그아웃
컨트롤 허브와 ADFS를 통합하세요
Webex 메타데이터를 로컬 시스템에 다운로드하세요
ADFS에 웹엑스 메타데이터를 설치해요
Webex 인증을 위한 클레임 규칙 생성하기
IdP 메타데이터를 가져오고 테스트 후 싱글 사인온 활성화해요
ADFS에서 웹엑스 릴링 파티 트러스트를 업데이트하세요
dropdown icon
ADFS 문제 해결
    윈도우 로그의 ADFS 오류들
    페더레이션 ID
    시간 동기화
컨트롤 허브에서 Active Directory 페더레이션 서비스 (ADFS) 로 싱글 사인온 구성해요
list-menu이 문서에서
list-menu피드백이 있습니까?

컨트롤 허브와 Active Directory 페더레이션 서비스 (ADFS 2.x 이상) 를 ID 공급자 (IdP) 로 사용하는 배포 간에 싱글 사인온 (SSO) 통합을 구성할 수 있어요.

싱글 사인온 및 컨트롤 허브

싱글 사인온 (SSO) 은 사용자가 하나 이상의 애플리케이션에 액세스하기 위해 자격 증명을 제공하도록 허용하는 세션 또는 사용자 인증 프로세스예요. 프로세스는 권한이 부여된 모든 애플리케이션에 대해 사용자를 인증해요. 그러면 사용자가 특정 세션 중에 응용 프로그램을 전환할 때 더 이상 메시지가 나타나지 않아요.

보안 주장 마크업 언어 (SAML 2.0) 페더레이션 프로토콜은 Webex 클라우드와 ID 공급자 (IdP) 간의 SSO 인증을 제공하는 데 사용돼요.

프로필

웹엑스 앱은 웹 브라우저 SSO 프로필만 지원해요. 웹 브라우저 SSO 프로필에서, Webex App은 다음 바인딩을 지원해요.

  • SP 시작 POST -> POST 바인딩

  • SP에서 리디렉션 시작 -> POST 바인딩

이름ID 포맷

SAML 2.0 프로토콜은 특정 사용자에 대한 통신을 위한 여러 NameID 형식을 지원해요. 웹엑스 앱은 다음 NameID 포맷을 지원해요.

  • URN: 오아시스: 이름: TC:SAML:2.0: 이름 ID 형식: 일시적

  • URN: 오아시스: 이름: TC:SAML:1.1 이름 ID 형식: 지정 안 됨

  • URN: 오아시스: 이름: TC:SAML:1.1 이름 ID 형식: 이메일 주소

IdP에서 로드하는 메타데이터에서 첫 번째 항목은 Webex에서 사용하도록 구성되어 있어요.

싱글 로그아웃

웹엑스 앱은 단일 로그아웃 프로필을 지원해요. Webex 앱에서 사용자는 SAML 단일 로그아웃 프로토콜을 사용하여 세션을 종료하고 IdP로 로그아웃을 확인하는 애플리케이션에서 로그아웃할 수 있어요. 당신의 IdP가 단일 로그아웃으로 구성되어 있는지 확인하세요.

컨트롤 허브와 ADFS를 통합하세요

구성 가이드는 SSO 통합의 구체적인 예를 보여 주지만 모든 가능성에 대한 완전한 구성을 제공하지는 않아요. 예를 들어, 네임ID 형식 URN:OASIS:이름:TC:SAML:2.0:이름ID 형식:트랜시언트의 통합 단계가 문서화되어 있어요. URN:OASIS:이름:TC:SAML:1.1: 이름ID-형식:미지정 또는 URN:OASIS:이름:TC:SAML:1.1:이름ID-형식:이메일 주소 같은 다른 형식은 SSO 통합에 적합하지만 설명서의 범위를 벗어납니다.

Webex 조직의 사용자를 위해 이 통합을 설정하세요 (Webex 앱 및 제어 Webex Meetings 허브에서 관리하는 기타 서비스 포함). 웹엑스 사이트가 컨트롤 허브에 통합된 경우, 웹엑스 사이트는 사용자 관리를 상속해요. 컨트롤 Webex Meetings 허브에서 관리되지 않고 이런 방식으로 접속할 수 없다면 별도의 통합을 해서 SSO를 활성화해야 해요. Webex Meetings

ADFS의 인증 메커니즘에 구성된 내용에 따라 기본적으로 통합 Windows 인증 (IWA) 이 활성화될 수 있어요. 활성화된 경우, Windows를 통해 실행되는 애플리케이션 (예: Webex 앱 및 Cisco 디렉토리 커넥터) 은 초기 이메일 프롬프트에 입력한 이메일 주소와 상관없이 로그인한 사용자로 인증돼요.

Webex 메타데이터를 로컬 시스템에 다운로드하세요

ID 공급자를 구성하기 전에 Webex 메타데이터를 다운로드하세요. 이 파일에는 조직의 Webex 서비스 제공업체 설정이 포함되어 있으며, ID 제공업체는 해당 설정을 사용하여 Webex를 인식하고 SAML 로그인 응답을 올바른 위치로 다시 보냅니다. ID 공급자에서 SAML 애플리케이션을 구성할 때 이 메타데이터 파일을 사용하세요.

1

컨트롤 허브에 로그인해요.

2

관리 > 보안 > 인증으로 가세요.

3

ID 공급자 탭으로 가서 SSO 활성화를 클릭해요.

4

IdP를 선택해 주세요.

5

조직의 인증서 유형을 선택하세요.

  • Cisco 자체 서명—이 선택 추천해요. 5년에 한 번만 갱신하면 되도록 인증서에 서명하겠습니다.
  • 공공 인증 기관에서 서명했어요. 더 안전하지만 메타데이터를 자주 업데이트해야 해요.
6

메타데이터 파일 다운로드해요.

웹엑스 메타데이터 파일 이름은 idb-meta- -SP.xml 예요. <org-ID>

ADFS에 웹엑스 메타데이터를 설치해요

시작하기 전에

컨트롤 허브는 ADFS 2.x 이상을 지원해요.

윈도우 2008 R2는 ADFS 1.0만 포함해요. 마이크로소프트에서 최소 ADFS 2.x를 설치해야 해요.

SSO와 웹엑스 서비스의 경우, ID 제공자 (IdP) 는 다음 SAML 2.0 사양을 준수해야 해요.

  • 네임ID 포맷 속성을 URN:OASIS:NAMES:TC:SAML:2.0:네임ID 포맷: 일시적 상태로 설정해요

  • Cisco 디렉토리 커넥터에서 선택한 속성 또는 Webex ID 서비스에서 선택한 속성과 일치하는 사용자 속성에 매핑된 값과 함께 uid 속성 이름을 포함하도록 IdP에 클레임을 구성하세요. (이 속성은 예를 들어 이메일 주소 또는 사용자-주체-이름일 수 있어요.)지침은 https://www.cisco.com/go/hybrid-services-directory 에 있는 사용자 지정 속성 정보를 참조하세요.

1

관리자 권한으로 ADFS 서버에 로그인해요.

2

ADFS 관리 콘솔을 열고 신뢰 관계 > 신뢰 당사자 트러스트 > 신뢰 당사자 트러스트 추가로 이동해요.

3

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

4

데이터 소스 선택에서 파일에서 신뢰 당사자 데이터 가져오기를 선택하고 다운로드한 컨트롤 허브 메타데이터 파일로 이동한 후 다음을 선택해요.

5

표시 이름 지정의 경우, Webex와 같은 신뢰할 수 있는 당사자 트러스트의 표시 이름을 생성하고 다음을 선택해요.

6

발급 승인 규칙 선택에서 모든 사용자가 이 신뢰 당사자 접근 허용을 선택하고 다음을 선택해요.

7

신뢰를 추가할 준비가 되셨으면, 다음을 선택하고 ADFS에 신뢰 신뢰 추가 완료하세요.

Webex 인증을 위한 클레임 규칙 생성하기

1

ADFS 기본 창에서 생성한 신뢰 관계를 선택한 다음 클레임 규칙 편집을 선택해요. 발급 변환 규칙 탭에서 규칙 추가를 선택해요.

2

규칙 유형 선택 단계에서 LDAP 속성을 클레임으로 보내기를 선택하고 다음을 선택해요.

  1. 클레임 규칙 이름을 입력하세요.

  2. 속성 Active Directory스토어로 선택하세요.

  3. 이메일 주소 LDAP 속성을 uid 발신 클레임 유형에 매핑하세요.

    이 규칙은 사용자를 식별하기 위해 어떤 필드를 Webex에 매핑할지 ADFS에 알려줘요. 나가는 클레임 유형의 철자를 표시된 대로 정확히 입력하세요.

  4. 변경 사항을 저장하세요.

3

규칙 추가를 다시 선택하고 사용자 지정 규칙을 사용하여 클레임 보내기를 선택하고 다음을 선택해요.

이 규칙은 Webex에서 제공하지 않는 “스팸 한정자” 속성을 ADFS에 제공해요.

  1. 텍스트 편집기를 열고 다음 내용을 복사하세요.

    c: [유형 == "http://schemas.microsoft.com/ws/2008/06/identity/claims/windowsaccountname “] => 문제 (유형 =" http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier “, 발급자 = C.Issuer, OriginalIssuer = C.OriginalIssuer, 값 = C.Value, 값 유형 = C.ValueType, 속성 [” http://schemas.xmlsoap.org/ws/2005/05/identity/claimproperties/format “] = “URN:OASIS:NAMES:TC:SAML:2.0:이름ID-형식:일시적”, 속성 [” “] =" URL1 “, 속성 [” http://schemas.xmlsoap.org/ws/2005/05/identity/claimproperties/namequalifierhttp://schemas.xmlsoap.org/ws/2005/05/identity/claimproperties/spnamequalifier “] =" URL2 “);

    텍스트의 URL1과 URL2를 다음과 같이 바꾸세요.

    • URL1은 다운로드한 ADFS 메타데이터 파일의 엔티티 ID예요.

      예를 들어, 다음은 당신이 보는 것의 샘플이에요. <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는 다운로드한 Webex 메타데이터 파일의 첫 줄에 있어요.

      예를 들어, 다음은 보이는 것의 샘플이에요. <엔티티디스크립터 XMLNS="URN:OASIS:NAMES:TC:SAML:2.0:메타데이터” 엔티티ID=” https://idbroker.webex.com/35a15b0a-0eg1-4029-9f63-a8c54df5df59 “>

      Webex 메타데이터 파일에서 EntityID만 복사하여 텍스트 파일에 붙여넣어 URL2를 대체하세요.

  2. 업데이트된 URL을 사용하여 텍스트 편집기 (“c:”부터 시작) 에서 규칙을 복사하여 ADFS 서버의 사용자 지정 규칙 상자에 붙여넣으세요.

    완성된 규칙은 다음과 같아야 해요.

  3. 완료를 선택해서 규칙을 만든 다음 클레임 규칙 편집 창을 나가세요.

4

메인 윈도우에서 신뢰 당사자 신탁을 선택한 다음 오른쪽 창에서 속성을 선택해요.

5

속성 창이 나타나면 고급 탭, SHA-256 으로 이동한 다음 확인을 선택하여 변경 사항을 저장하세요.

6

내부 ADFS 서버에서 다음 URL로 이동하여 파일을 다운로드하세요. https: //< AD_FS_Server >/페더레이션메타데이터/2007-06/페더레이션메타데이터.xml

올바른 형식의 XML 파일을 얻으려면 페이지를 마우스 오른쪽 버튼으로 클릭하고 페이지 소스를 봐야 할 수도 있어요.

7

파일을 로컬 컴퓨터에 저장해요.

다음에 뭘 해야 돼요?

관리 포털에서 ADFS 메타데이터를 Webex로 다시 가져올 준비가 됐어요.

IdP 메타데이터를 가져오고 테스트 후 싱글 사인온 활성화해요

Webex 메타데이터를 내보내고, IdP를 구성하고, IdP 메타데이터를 로컬 시스템에 다운로드하면, Control Hub에서 Webex 조직으로 가져올 준비가 되었습니다.

시작하기 전에

ID 공급자 (IdP) 인터페이스에서 SSO 통합을 테스트하지 마세요. 우리는 서비스 제공자가 시작한 (SP에서 시작한) 플로우만 지원해요. 따라서 이 통합에는 컨트롤 허브 SSO 테스트를 사용해야 해요.

1

하나 고르세요:

  • 브라우저의 컨트롤 허브 — 인증서 선택 페이지로 돌아가서 다음을 클릭해요.
  • 브라우저 탭에 컨트롤 허브가 더 이상 열려 있지 않으면 다시 여세요. Control Hub의 고객 보기에서 관리 > 보안 > 인증으로 이동하고 IdP를 선택한 다음 작업 > 메타데이터 가져오기를 선택하세요.
2

IdP 메타데이터 가져오기 페이지에서 IdP 메타데이터 파일을 페이지에 드래그 앤 드롭하거나 파일 브라우저 옵션을 사용하여 메타데이터 파일을 찾아 업로드하세요. 다음을 클릭해요.

가능하면 보안 강화 옵션을 사용하세요. 당신의 IdP가 공용 CA를 사용하여 메타데이터에 서명한 경우에만 가능해요.

다른 모든 경우에는 덜 안전한 옵션을 사용해야 해요. 여기에는 메타데이터가 서명되지 않았거나, 자체 서명되거나, 사설 CA에서 서명되지 않은 경우가 포함돼요.

Okta는 메타데이터에 서명하지 않으므로 Okta SSO 통합에는 '덜 보안'을 선택해야 해요.

3

SSO 설정 테스트를 선택하고 새 브라우저 탭이 열리면 로그인해서 IdP로 인증해요.

인증 오류 받으면 자격 증명에 문제가 있을 수 있어요. 사용자 이름과 비밀번호를 확인하고 다시 시도하세요.

Webex 앱 오류는 보통 SSO 설정 관련 문제를 의미해요. 이 경우 단계를 다시 진행하세요. 특히 컨트롤 허브 메타데이터를 복사하여 IdP 설정에 붙여넣는 단계를 살펴보세요.

SSO 로그인 경험을 직접 보려면 이 화면에서 클립보드에 URL 복사를 클릭하여 개인 브라우저 창에 붙여넣을 수도 있어요. 거기에서 SSO로 로그인하는 방법을 안내할 수 있어요. 이 단계는 기존 세션에 로그인했을 수 있는 액세스 토큰으로 인한 오탐을 막아줘요.

4

컨트롤 허브 브라우저 탭으로 돌아가세요.

  • 테스트가 성공적이었으면, 성공 테스트를 선택해.SSO 켜고 다음 클릭해요.
  • 테스트가 실패하면 테스트 실패를 선택해.SSO 끄고 다음 클릭해요.

첫 번째 라디오 버튼을 선택하고 SSO를 활성화하지 않으면 SSO 구성이 조직에 적용되지 않아요.

다음에 뭘 해야 돼요?

Okta에서 Webex 클라우드로 사용자 프로비저닝을 하려면 Okta 사용자를 컨트롤 허브로 동기화하기에 있는 절차를 사용하세요.

엔트라 ID에서 Webex 클라우드로 사용자 프로비저닝을 하려면 Microsoft Entra ID 사용자를 컨트롤 허브에 동기화하기에 있는 절차를 사용하세요.

자동 이메일 표시의 절차에 따라 조직의 새로운 Webex App 사용자에게 전송되는 이메일을 비활성화할 수 있어요. 문서에는 조직 사용자들에게 통신 내용을 보내는 모범 사례도 들어 있어요.

ADFS에서 웹엑스 릴링 파티 트러스트를 업데이트하세요

이 작업은 구체적으로 Webex의 새 SAML 메타데이터로 ADFS를 업데이트하는 것에 관한 거예요. ADFS로 SSO를 구성해야 하거나 새 Webex SSO 인증서를 위해 SAML 메타데이터를 사용하여 (다른) IdP를 업데이트해야 하는 경우 관련 문서가 있어요.

시작하기 전에

ADFS에서 웹엑스 릴링 파티 트러스트를 업데이트하려면 먼저 컨트롤 허브에서 SAML 메타데이터 파일을 내보내야 해요.

1

관리자 권한으로 ADFS 서버에 로그인해요.

2

Webex에서 ADFS 서버의 임시 로컬 폴더에 SAML 메타데이터 파일을 업로드해요. 예. //ADFS_서버 <org-ID>이름/TEMP/IDB-Meta- -SP.xml.

3

파워셸 여세요.

4

Get-ADFS 의존형 파티 트러스트를 실행해서 모든 신뢰 당사자 트러스트를 읽어보세요.

Webex 신뢰 당사자 신뢰의 TargetName 파라미터를 참고하세요. 우리는 “Webex”를 예시로 사용하지만 당신의 ADFS에서는 다를 수 있어요.

5

업데이트 실행 - ADFS 신뢰 파티 트러스트 - 메타데이터 파일 “//ADFS_ServerName/temp/IDB-Meta <org-ID>- -SP.xml" - 대상 이름 "웹엑스".

파일 이름과 대상 이름을 사용자 환경의 올바른 값으로 바꿔야 해요.

https://docs.microsoft.com/powershell/module/adfs/update-adfsrelyingpartytrust 봐요.

Webex SP 5년 인증서를 다운로드했고 서명 또는 암호화 인증서 취소를 설정한 경우, 다음 두 명령을 실행해야 해요. Set-ADFSRelyingPartyTrust - 서명 인증서 취소 확인 없음 - 암호화 인증서 취소 확인 없음 - 대상 이름 "Webex".

6

컨트롤 허브에 로그인한 다음 SSO 통합을 테스트해 보세요.

  1. 관리 > 보안 > 인증으로 가세요.

  2. ID 공급자 탭에서 IdP로 가서 클릭해요 More menu.

  3. IdP 테스트를 선택하세요.

  4. 활성화하기 전에 SSO 연결을 테스트해 보세요. 이 단계는 시험 실행처럼 작동하며 다음 단계에서 SSO를 활성화하기 전까지는 조직 설정에 영향을 주지 않아요.

    SSO 로그인 경험을 직접 보려면 이 화면에서 클립보드에 URL 복사를 클릭하여 개인 브라우저 창에 붙여넣을 수도 있어요. 거기에서 SSO로 로그인하는 방법을 안내할 수 있어요. 이렇게 하면 웹 브라우저에 캐시된 정보 중 SSO 구성을 테스트할 때 오탐 결과를 초래할 수 있는 정보를 제거하는 데 도움이 돼요.

  5. 테스트를 완료하려면 로그인하세요.

ADFS 문제 해결

윈도우 로그의 ADFS 오류들

윈도우 로그에서 ADFS 이벤트 로그 오류 코드 364가 보일 수 있어요. 이벤트 세부 정보에서 유효하지 않은 인증서가 식별돼요. 이런 경우 ADFS 호스트는 포트 80의 방화벽을 통해 인증서를 검증할 수 없어요.

신뢰 당사자 트러스트를 위한 인증서 체인을 구축하려는 중에 오류가 발생했어요.

SSO 인증서를 업데이트할 때 로그인할 때 이 오류가 표시될 수 있어요. 응답에서 상태 코드가 잘못됐어요.

오류가 보이면 ADFS 서버의 이벤트 뷰어 로그를 확인하고 다음 오류를 찾아보세요. 지문으로 식별되는 신뢰 당사자 트러스트 'https://idbroker.webex.com/' 인증서에 대한 인증서 체인을 구축하려고 시도하는 중에 오류가 발생했어요<org-ID>. 754B9208F1F75C5CC122740F3675C5D129471D80 가능한 원인은 인증서가 취소됐거나, 신뢰 당사자 트러스트의 암호화 인증서 취소 설정에 지정된 대로 인증서 체인을 검증하지 못했거나, 인증서가 유효 기간 내에 있지 않았기 때문이에요.

<orgID>이 오류가 발생하면 set-ADFSRelyingPartyTrust - Target Identitifier https://idbroker.webex.com/ - 암호화 인증서 취소 확인 없음 명령을 실행해야 해요.

페더레이션 ID

페더레이션 ID는 대소문자를 구분해요. 조직 이메일 주소인 경우 ADFS에서 보내는 대로 정확히 입력하세요. 그렇지 않으면 Webex에서 일치하는 사용자를 찾을 수 없어요.

보내기 전에는 LDAP 속성을 정규화하는 사용자 지정 클레임 규칙을 작성할 수 없어요.

환경에 설정한 ADFS 서버에서 메타데이터를 가져와요.

필요한 경우 ADFS Management의 서비스 > 엔드포인트 > 메타데이터 > 유형:페더레이션 메타데이터로 이동하여 URL을 확인할 수 있어요.

시간 동기화

ADFS 서버의 시스템 시계가 네트워크 시간 프로토콜 (NTP) 을 사용하는 믿을 수 있는 인터넷 시간 소스와 동기화되었는지 확인하세요. Webex Relying Party Trust 관계에 대해서만 시간을 왜곡하려면 다음 PowerShell 명령을 사용하세요.

SET-ADFS에 의존하는 파티 트러스트 - 타겟 식별자 "https://idbroker.webex.com/$ENTITY_ID_HEX_VALUE" - 스큐 3 이전에는 안 돼요

16진수는 환경에 따라 고유해요. Webex 메타데이터 파일의 SP 엔티티디스크립터 ID 값의 값을 바꿔주세요. 예를 들자면:

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

이 문서가 도움이 되었습니까?
이 문서가 도움이 되었습니까?