Skip to main content
이 가이드는 Mac 컴퓨터에 적용됩니다

​
Okta를 사용한 Passport 문제 해결 정보

Okta를 사용한 Passport 문제 해결은 Okta를 ID 공급자(IdP)로 하여 Passport를 사용할 때 발생하는 인증 문제를 해결하는 것을 말합니다. 이 가이드는 Okta 통합과 관련된 일반적인 구성 및 인증 문제를 식별하고 해결하는 데 도움이 됩니다.

​
작동 방식

Okta에서 Passport 인증 문제가 발생하면 Okta 애플리케이션 설정 확인, OIDC 구성 검증, 인증 흐름 검토, Passport와 Okta 테넌트 간의 구성 불일치 해결 등을 통해 문제를 해결합니다.

​
로그인, 진단 및 네트워크

전체 이메일 주소로 로그인

Passport 로그인 창에서는 세션이 로컬 인증 대신 IdP를 사용하도록 항상 사용자 이름 필드에 사용자의 전체 이메일 주소를 입력하세요. 로그인 창 및 표시 설정이 Passport와 상호 작용하는 방식은 Passport 호환성을 참조하세요.

Passport 진단 사용

사용자가 로그인할 수 없는 경우 Mac에서 Command-Shift-K-L을 눌러 Iru Endpoint Passport 진단을 여세요. 이 패널에는 IdP에서 반환된 오류 메시지를 포함한 유용한 세부 정보가 표시됩니다.

네트워크 연결 확인

Passport는 자격 증명을 검증하기 위해 Okta에 연결할 수 있어야 합니다. Passport 로그인 창을 사용자화할 때 필요한 경우 사용자가 Wi-Fi에 연결할 수 있도록 네트워크 관리자를 활성화하세요. 이 컨트롤은 macOS의 AirPort 보안 설정을 따릅니다.

Wi-Fi 제한 및 격리 테스트

Passport는 로그인 창 오른쪽 상단에 Wi-Fi 아이콘을 표시하며, 사용자는 이를 선택하여 암호로 보호된 네트워크에 연결할 수 있습니다. Passport는 종속 포털(captive portal), 클릭 동의 페이지 또는 해당 흐름에서 별도의 사용자 이름과 암호가 필요한 엔터프라이즈 802.1X 네트워크를 지원하지 않습니다. 네트워크 문제를 격리하려면 Passport 로그인 창에서 테스트하는 동안 모바일 핫스팟이나 유선 이더넷을 사용해 보세요.

​
일반적인 Okta 오류

Okta API 오류 코드를 조회하려면 Okta 개발자 사이트의 Okta API 오류 코드를 참조하세요.
표시되는 내용:"error":"Unauthorized","error_description":"Authentication Failed: Invalid user credentials"조치 방법:
  • IdP에서 사용자 이름과 암호를 확인하세요. 이 응답은 일반적으로 자격 증명이 Okta에서 예상하는 것과 일치하지 않음을 의미합니다.
  • OIDC well-known openid-configuration URL에 대한 GET 요청이 200을 반환하면 일반적으로 Passport Library Item의 ID 공급자 URL 및 Client ID가 Okta에 올바르게 연결되고 있는 것입니다. Okta에서는 동일한 값이 Application ID로 표시될 수 있습니다.
표시되는 내용:"error":"access_denied","error_description":"End-user does not have access to this application"조치 방법:
  • Okta에서 사용자 또는 그룹이 Passport OIDC 애플리케이션에 할당되어 있는지, 그리고 로그인 규칙이 액세스를 허용하는지 확인하세요.
  • OIDC well-known openid-configuration URL에 대한 GET 요청이 200을 반환하면 일반적으로 Passport Library Item의 ID 공급자 URL 및 Client ID가 Okta에 올바르게 연결되고 있는 것입니다. Okta에서는 동일한 값이 Application ID로 표시될 수 있습니다.