Skip to main content
이 가이드는 Mac 컴퓨터에 적용됩니다
Microsoft Entra ID는 Azure AD(Azure Active Directory)의 새 이름입니다

​
이 문서 정보

Microsoft Entra ID(이전 Azure AD)로 Passport 로그인에 실패할 때 이 문서를 사용하세요. 로그인 확인, 진단, 네트워크 요구 사항 및 일반적인 Entra ID 오류 코드를 다룹니다. 설정은 Microsoft Entra ID로 Passport 구성 - Mac 로그인 또는 Microsoft Entra ID로 Passport 구성 - 웹 로그인을 사용한 다음 Passport Library Item 구성을 사용하세요.

중요한 Entra ID Passport 업데이트

2026년 6월 15일부터 Microsoft Entra ID는 Passport 로그인에 대한 조건부 액세스를 다르게 처리합니다.
  • Mac 로그인: Entra ID Passport Mac 로그인을 참조하여 테넌트가 영향을 받는지, 그리고 해당 날짜 이전에 무엇을 업데이트해야 하는지 확인하세요.
  • 웹 로그인: 웹 로그인을 사용하고 조건부 액세스에서 Passport를 MFA에서 제외하려는 경우에만 업데이트가 필요합니다. Entra ID Passport 웹 로그인을 참조하세요.
Microsoft는 이 문서에서 변경 사항을 설명합니다.

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

전체 이메일 주소로 로그인

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

Passport 진단 사용

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

네트워크 연결 확인

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

Wi-Fi 제한 및 격리 테스트

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

​
일반적인 Microsoft Entra ID 오류

Microsoft Entra ID 로그인 오류 코드(대개 AADSTS 접두사가 붙음)를 조회하려면 login.microsoftonline.com/error를 사용하세요.
표시되는 내용:Microsoft Entra ID 메시지: Due to a configuration change made by your administrator, or because you moved to a new location, you must use multifactor authentication to access the resource named in the error.조치 방법:
  • 사용자가 다단계 인증을 완료해야 합니다. 여러 정책이나 설정이 MFA를 요구할 수 있습니다(예: 조건부 액세스, 사용자별 적용 또는 클라이언트가 요청한 MFA).
표시되는 내용:Microsoft Entra ID 메시지: User account <user principal name> from identity provider <your Microsoft Entra ID Active Directory Tenant ID> does not exist in tenant <your tenant name> and cannot access the application <your Passport Application (client) ID> in that tenant. The account needs to be added as an external user in the tenant first.조치 방법:
  • Microsoft Entra 관리 센터에서 사용자 > 모든 사용자를 열고 사용자가 존재하는지 확인하세요.
표시되는 내용:Microsoft Entra ID 메시지: The user account <user principal name without the @ symbol and domain> does not exist in <your tenant name> directory.조치 방법:
  • MFA를 사용하는 Passport의 경우 Microsoft Entra ID의 각 사용자에게 이메일 값이 필요합니다. 이 값이 없으면 사용자가 웹 보기에서 MFA를 완료하더라도 Enter your Microsoft Entra ID password 확인 단계에서 실패할 수 있습니다. Microsoft Entra 관리 센터에서 사용자 > 모든 사용자를 열고 사용자를 선택한 다음 Edit properties를 선택하고 이메일에 주소를 입력한 후 저장을 선택하세요. 이 값은 실제로 작동하는 메일함일 필요는 없으며, 대개 User principal name과 일치합니다.
표시되는 내용:Microsoft Entra ID 메시지: InvalidUserNameOrPassword: error validating credentials due to invalid username or password. 사용자가 올바른 자격 증명을 입력하지 않았습니다. 사용자가 자격 증명을 잘못 입력하면 로그에 이러한 오류 중 일부가 기록되는 것은 정상입니다.조치 방법:
  • IdP에서 사용자 이름과 암호를 확인하세요.
  • Microsoft Entra ID가 AD FS 또는 다른 ID 공급자와 페더레이션되어 있을 수 있으며, 이로 인해 Passport에 이 오류가 표시될 수 있습니다. 페더레이션된 Microsoft Entra ID 환경에서 Passport 사용의 페더레이션 환경의 인증 흐름을 참조하세요.
표시되는 내용:Microsoft Entra ID 메시지: Client is public so neither ‘client_assertion’ nor ‘client_secret’ should be presented.조치 방법:
  • Microsoft Entra 관리 센터에서 애플리케이션 > App registrations > All applications > [Passport 앱] > 인증 > Platform configurations를 열고, 플랫폼과 리디렉션 URI를 Passport 인증 모드 및 Microsoft Entra ID로 Passport 구성 - Mac 로그인 또는 Microsoft Entra ID로 Passport 구성 - 웹 로그인과 일치시키세요.
  • 앱이 공용 클라이언트 전용이어야 하는 경우 Certificates & secrets를 열고 앱의 Client secret을 모두 제거하세요.
  • Iru Endpoint에서 Passport Library Item의 Client secret (optional) 필드가 비어 있는지 확인하세요.
표시되는 내용:Microsoft Entra ID 메시지: Invalid client secret provided. Ensure the secret being sent in the request is the client secret value.조치 방법:
  • Microsoft Entra 관리 센터에서 애플리케이션 > App registrations > All applications > [Passport 앱] > 인증 > Platform configurations를 열고, 플랫폼과 리디렉션 URI를 Passport 인증 모드 및 Microsoft Entra ID로 Passport 구성 - Mac 로그인 또는 Microsoft Entra ID로 Passport 구성 - 웹 로그인과 일치시키세요.
  • 앱이 Passport용 공용 클라이언트로 구성된 경우 Certificates & secrets를 열고 Client secret을 제거하세요.
  • Iru Endpoint에서 Passport Library Item의 Client secret (optional) 필드가 비어 있는지 확인하세요.
표시되는 내용:Microsoft Entra ID 메시지: Due to a configuration change made by your administrator, or because you moved to a new location, you must enroll in multifactor authentication to access the identifier shown in the error.조치 방법:
  • Mac 로그인을 사용하는 경우 사용자에게 레거시 사용자별 MFA가 활성화되어 있을 수 있습니다. 관리되는 사용자는 보안 정보를 등록해야 하거나, 페더레이션된 사용자는 페더레이션된 IdP의 MFA 클레임이 필요할 수 있습니다.
  • 조건부 액세스, 사용자별 적용 및 기타 정책도 MFA 등록을 요구할 수 있습니다.
표시되는 내용:
  • Ticket decode failed
  • Failed to login with possible error: Unknown
조치 방법:
  • Passport Library Item에서 선택 사항인 클라이언트 암호를 제거하고, 기기가 체크인하도록 한 다음, 로컬 사용자에서 로그아웃하고 Passport로 다시 로그인하세요.
  • 문제가 계속되면 네트워크 문제를 배제하세요(예: 모바일 핫스팟 사용).
표시되는 내용:An error occurred fetching user info: No key was found matching “givenName”.조치 방법:
  • Microsoft Entra 관리 센터에서 Identity > 사용자 > 모든 사용자를 열고 로그인하는 사용자를 연 다음 First name이 입력되어 있는지 확인하세요.
Mac 로그인 또는 웹 로그인 설정은 Microsoft Entra ID로 Passport 구성 - Mac 로그인 또는 Microsoft Entra ID로 Passport 구성 - 웹 로그인을 참조하세요.