View a markdown version of this page

SSO 및 인증 문제 해결 - AWS Wickr

이 가이드는 2025년 3월 13일에 릴리스된 새로운 AWS Wickr 관리 콘솔을 문서화합니다. AWS Wickr 관리 콘솔의 클래식 버전에 대한 설명서는 Classic 관리 안내서를 참조하세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

SSO 및 인증 문제 해결

이 섹션에서는 관리자가 AWS Wickr에서 Single Sign-On(SSO) 및 인증 문제를 해결하는 데 도움이 됩니다. 이 섹션의 단계에서 문제가 해결되지 않으면 AWS 지원 센터에서 사례를 엽니다.

중요

Wickr는 OpenID Connect(OIDC)만 지원합니다. SAML 기반 자격 증명 공급자는 지원되지 않습니다. 조직에서 SAML 전용 자격 증명 공급자를 사용하는 경우 OIDC 호환 대체를 구성하거나 OIDC 브리지를 구현해야 합니다.

시작하기 전 준비 사항

문제 해결 전에 다음을 확인합니다.

  • Wickr 관리자 콘솔에 대한 관리자 액세스 권한이 있습니다.

  • 조직의 ID 제공업체(IdP) 구성에 액세스할 수 있습니다.

  • Wickr 네트워크 설정에서 SSO가 활성화됩니다.

  • ID 제공업체는 OIDC를 준수합니다. Wickr는 SAML을 지원하지 않습니다.

일반적인 SSO 문제

지원되는 ID 제공업체

Wickr는 다음 OIDC 준수 자격 증명 공급자에 대한 구성 지침을 제공합니다.

  • Microsoft Entra ID(이전 Azure AD)

  • Okta

  • Amazon Cognito

  • AWS Identity and Access Management 자격 증명 센터

모든 OIDC 준수 자격 증명 공급자는 Wickr와 함께 사용할 수 있습니다. 위에 나열되지 않은 공급자의 경우 SSO 구성 설명서의 일반 OIDC 구성 파라미터를 사용합니다.

사용자가 SSO로 로그인할 수 없음

사용자가 SSO를 사용하여 로그인할 수 없다고 보고하면 다음 검사를 수행합니다.

Wickr SSO 구성 확인

  1. Wickr 관리 콘솔에서 네트워크 설정을 선택한 다음 Single Sign-On을 선택합니다.

  2. SSO가 활성화되었는지 확인합니다.

  3. 발급자 URL, 클라이언트 ID클라이언트 보안 암호가 ID 제공업체 구성과 일치하는지 확인합니다.

  4. 자격 증명 공급자의 리디렉션 URI가 Wickr 관리 콘솔에 표시된 값과 일치하는지 확인합니다.

일반적인 SSO 오류

"사용자를 찾을 수 없음"

사용자가 자격 증명 공급자에 없거나 Wickr 애플리케이션에 할당되지 않았습니다. 사용자가 IdP에 존재하고 올바른 그룹 할당이 있는지 확인합니다.

“잘못된 응답” 또는 “구성 오류”

OIDC 메타데이터 또는 엔드포인트가 잘못 구성되었습니다. Wickr와 자격 증명 공급자 간에 발급자 URL, 클라이언트 ID 및 리디렉션 URIs 일치하는지 확인합니다.

"액세스 거부"

사용자에게 자격 증명 공급자에 필요한 그룹 멤버십 또는 애플리케이션 할당이 없습니다. IdP의 애플리케이션 할당 설정을 확인합니다.

회사 ID를 입력하라는 메시지가 사용자에게 표시되지 않음

SSO 등록 중에 사용자에게 회사 ID를 입력하라는 메시지가 표시되지 않으면 Wickr 관리 콘솔의 네트워크 설정, 네트워크 프로필에 회사 ID가 구성되어 있는지 확인합니다.

Wickr 또는 자격 증명 공급자와 관련된 문제인지 확인

다음 질문을 사용하여 문제의 위치를 확인합니다.

  • 사용자가 동일한 IdP를 사용하여 다른 애플리케이션에 인증할 수 있나요? 그렇지 않으면 Wickr가 아닌 자격 증명 공급자에 문제가 발생합니다.

  • 모든 사용자가 영향을 받나요? 아니면 특정 사용자만 영향을 받나요? 특정 사용자만 있는 경우 IdP에서 그룹 할당 및 애플리케이션 액세스를 확인합니다.

  • IdP 구성에 최근 변경 사항이 있었나요? 인증서 교체, 정책 변경 또는 엔드포인트 업데이트로 인해 OIDC 연결이 끊어질 수 있습니다.

  • Wickr 클라이언트 또는 IdP 로그인 페이지에서 오류가 발생하나요? IdP 로그인 페이지에 오류가 표시되면 자격 증명 공급자에 문제가 있는 것입니다.

추가 리소스