> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# OneLogin을 사용한 Passport 문제 해결

> Iru Endpoint에서 OneLogin을 사용한 Passport 문제를 해결합니다. 로그인 실패, 토큰 오류, 암호 동기화 문제 및 앱 구성 충돌을 해결합니다.

<Callout icon="apple" color="#B84A7A" iconType="regular">이 가이드는 Mac 컴퓨터에 적용됩니다</Callout>

### OneLogin을 사용한 Passport 문제 해결 정보

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

### 작동 방식

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

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

<CardGroup cols={2}>
  <Card title="전체 이메일 주소로 로그인" icon="user">
    Passport 로그인 창에서는 세션이 로컬 인증 대신 IdP를 사용하도록 항상 사용자 이름 필드에 사용자의 전체 이메일 주소를 입력하세요. 로그인 창 및 표시 설정이 Passport와 상호 작용하는 방식은 [Passport 호환성](/ko/endpoint/library/passport/passport-compatibility-with-macos-and-iru-endpoint-features#login-window)을 참조하세요.
  </Card>

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

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

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

### 일반적인 OneLogin 오류

<AccordionGroup>
  <Accordion title="도우미 애플리케이션과 통신할 수 없음">
    **표시되는 내용:**

    Error: Couldn't communicate with helper application (OneLogin)

    **조치 방법:**

    * Iru Endpoint의 **Issuer URL**이 OneLogin OIDC well-known 엔드포인트와 일치하는지 확인하세요. 다음 패턴을 따라야 합니다.

    ```
    https://<subdomain>.onelogin.com/oidc/2/.well-known/openid-configuration
    ```
  </Accordion>

  <Accordion title="Unauthorized: MFA 필요">
    **표시되는 내용:**

    Error: Unauthorized, MFA is required for this user (OneLogin)

    **의미:**

    사용자가 **App** 정책이 아닌 **사용자** 정책의 영향을 받고 있을 가능성이 높습니다.

    **조치 방법:**

    * OneLogin에서 할당된 앱에 액세스할 때 사용자에게 메시지가 표시되도록 MFA에 **App** 정책을 사용하고, User 정책에서만 적용되는 MFA에 의존하지 마세요. 이는 OneLogin 포털 액세스와 같은 다른 영역의 MFA에 영향을 줄 수 있습니다. OneLogin에는 OIDC ROPG 흐름에 대해 User 정책 MFA 요구 사항을 분리하는 방법이 없습니다.
    * OneLogin의 [App Policies](https://onelogin.service-now.com/support?id=kb_article\&sys_id=76b83305db04a8143de43e043996192e) 문서를 참조하세요.
  </Accordion>
</AccordionGroup>

설정 단계는 [OneLogin을 사용한 Passport 구성](/ko/endpoint/library/passport/onelogin/passport-configuration-with-onelogin)을 참조하세요.