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

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

전체 이메일 주소로 로그인

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

Passport 진단 사용

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

네트워크 연결 확인

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

Wi-Fi 제한 및 격리 테스트

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

​
IdP에 성(familyName)이 있는지 확인

Passport에는 IdP 사용자 속성에 familyName 값이 필요합니다. 테스트에 사용하는 서비스 계정을 포함하여 Passport로 로그인하는 모든 계정에 Last name 또는 이에 상응하는 성 필드를 입력하세요.

​
Passport 지원 IdP

현재 Iru Endpoint Passport에서 지원하는 IdP는 Google Workspace, Microsoft Entra ID, Okta, OneLogin입니다.

​
기타 IdP 사용 시 Passport 요구 사항

Passport 구성이 작동하려면 OIDC 및 ROPG(Resource Owner Password Grant) 워크플로가 필요합니다. IdP에 문의하여 이러한 기능을 지원하는지 확인하세요. Iru에서 Mac 로그인 또는 웹 로그인을 선택할 수 있는 옵션을 제공하지만, 웹 로그인을 구성할 때는 추가 고려 사항이 있을 수 있으므로 먼저 Mac 로그인을 사용하여 Passport를 설정하세요. Google Workspace, Microsoft Entra ID, Okta 또는 OneLogin을 사용하는 지원 구성을 참고 자료로 활용할 수 있습니다. 위의 ID 공급자 중 하나를 사용하지 않는 경우에도 기타 옵션을 사용하여 Passport를 구성할 수 있습니다.

​
기타 IdP 구성

​
인증 구성

  • Google Workspace, Microsoft Entra ID, Okta 또는 OneLogin 이외의 IdP를 구성할 때는 ID 공급자 드롭다운에서 기타 옵션을 선택하세요.

​
인증 모드

  • 다단계 인증(MFA)을 사용하지 않는 경우 Mac 로그인을 선택해야 합니다.
  • 다단계 인증(MFA)을 사용하는 경우 웹 로그인을 선택해야 합니다.

​
Mac 로그인

1

ID 공급자 URL 입력

ID 공급자 URL을 입력합니다.
2

Client ID 입력

IdP에서 생성한 Passport 앱의 Client ID(App ID라고도 함)를 입력합니다.

​
웹 로그인

1

ID 공급자 URL 입력

Identity Provider URL을 입력합니다.
2

Client ID 입력

IdP에서 생성한 Passport 앱의 Client ID(App ID라고도 함)를 입력합니다.
3

PKCE 및 POST 인증 지원 구성

웹 로그인을 사용하는 경우 앱은 PKCE(Proof Key for Code Exchange) 인증과 POST 인증을 모두 지원해야 합니다. 일부 IdP에서는 두 개의 서로 다른 앱을 구성해야 할 수 있습니다.
4

Redirect URI 설정

대부분의 경우 Redirect URI는 IdP의 기본 Redirect URI여야 합니다.

​
문제 해결

Passport IdP로 기타 옵션을 선택한 경우 Passport 문제를 해결할 때 고려해야 할 요소가 많습니다. 이 섹션은 오류를 캡처하고 이해하며 구성을 조정하는 데 도움이 됩니다.
표시되는 내용:"error":"Unauthorized","error_description":"Authentication Failed: Invalid user credentials"조치 방법:
  • IdP에서 사용자 이름과 암호를 확인하세요.
  • OIDC well-known openid-configuration URL에 대한 GET 요청이 200을 반환하면 일반적으로 Passport Library Item의 ID 공급자 URL 및 Client ID가 IdP에 올바르게 연결되고 있는 것입니다. IdP에서는 클라이언트 식별자를 Application ID로 표시할 수 있습니다.
표시되는 내용:"error":"access_denied","error_description":"End-user does not have access to this application"조치 방법:
  • IdP에서 사용자 또는 그룹이 Passport OIDC 애플리케이션에 액세스할 수 있는지, 그리고 로그인 또는 액세스 규칙이 이를 허용하는지 확인하세요.
  • OIDC well-known openid-configuration URL에 대한 GET 요청이 200을 반환하면 일반적으로 Passport Library Item의 ID 공급자 URL 및 Client ID가 IdP에 올바르게 연결되고 있는 것입니다. IdP에서는 클라이언트 식별자를 Application ID로 표시할 수 있습니다.
표시되는 내용:Ticket decode failed. Failed to login with possible error: Unknown조치 방법:
  • Passport Library Item에서 선택 사항인 Client secret을 제거하고, 기기가 체크인하도록 한 다음, 로컬 사용자에서 로그아웃하고 Passport로 다시 로그인하세요.
  • 오류가 계속되면 Passport 로그인 창에서 모바일 핫스팟을 사용하여 네트워크 문제를 배제하세요.
표시되는 내용:An error occurred fetching user info: No key was found matching “familyName”조치 방법:
  • IdP에서 사용자의 Last name 또는 이에 상응하는 성 필드를 입력하세요. Passport에는 해당 속성이 필요합니다.
Passport 문제가 계속되면 지원팀에 문의하세요.

​
오류 코드 조회

많은 IdP가 자체적인 오류 코드를 생성합니다. IdP에서 수신한 특정 오류에 대해 자세히 알아볼 수 있는 조회 페이지가 있는지 IdP에 확인하세요. 예를 들어 Microsoft에는 Microsoft Entra ID 오류를 조회할 수 있는 오류 코드 양식이 있습니다.

​
관련 문서

macOS 및 Iru Endpoint 기능과 Passport의 호환성

macOS 및 Iru 기능과 Passport의 호환성

Passport로 암호 관리

Passport로 암호를 관리하는 방법