> ## 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.

# 페더레이션 인증 연결

> 사용자가 이미 로그인에 사용하는 ID 공급자에 Iru Identity를 연결하여 Iru를 인증 계층으로 사용하거나 사용자를 Iru로 마이그레이션하는 동안 활용합니다.

**연결**은 Iru Identity를 이미 운영 중인 외부 시스템에 연결합니다. 대시보드에서
ID 공급자 연결은 **Access → Authentication** 아래에 있고,
HR 시스템 연결은 **Directory → Sync** 아래에 있습니다.

기본적으로 Iru Identity가 **ID 공급자**입니다. 사용자는 패스키 또는 Iru Access 앱으로
직접 로그인합니다. **ID 공급자 연결**을 사용하면 사용자가 이미 운영 중인 공급자를 통해
로그인할 수 있으며, 이는 Iru를 Iru 플랫폼에 대한 인증 계층으로 사용하거나 Iru
Identity로 마이그레이션하는 동안 유용합니다.

<Note>
  HR 시스템에서 사용자를 동기화하려고 하십니까? 이는 별도의 디렉터리 측
  기능입니다. **Directory → Sync** 아래의 [Directory Sync](/ko/identity/directory/directory-sync)를
  참조하세요.
</Note>

```mermaid theme={null}
flowchart LR
  people["사용자"]
  idp["기존 공급자<br/>(선택 사항 · 마이그레이션)"]
  subgraph iru["Iru Identity"]
    signin["로그인"]
  end
  people -->|"로그인 (패스키)"| signin
  idp -. "선택적 로그인" .-> signin
```

<Note>
  이러한 연결은 Iru가 이미 운영 중인 시스템에 도달하는 방법입니다. 사용자가 *로그인하는*
  앱을 연결하려면 [애플리케이션](/ko/identity/applications/applications-overview)을 참조하세요.
  Iru가 사용자, 공급자, 앱 사이에서 어떻게 위치하는지는
  [시스템 아키텍처](/ko/identity/getting-started/system-architecture)를 참조하세요.
</Note>

## ID 공급자 연결

기본적으로 사용자는 Iru에 직접 로그인합니다. ID 공급자 연결을 사용하면 이미 운영 중인
공급자를 통해 로그인할 수 있습니다. 다음 두 가지 상황에서 사용하세요.

<Info>
  **ID 공급자를 연결해야 하는 경우**

  * **인증 계층으로서의 Iru Identity.** 모든 Iru 테넌트는 Iru
    Identity를 사용하여 관리자를 관리하고 사용자를 동기화하지만, 모든 조직이
    이를 전체 ID 공급자로 사용하는 것은 아닙니다. 주로 사용자가 Iru 플랫폼에
    로그인하는 방법으로 Iru를 사용하는 경우, 이미 운영 중인 공급자를 연결하여
    사용자가 익숙한 자격 증명으로 로그인할 수 있도록 하세요.
  * **Iru Identity로 마이그레이션.** 기존 공급자에서 Iru Identity를 ID 공급자로
    전환하는 경우, 현재 공급자를 연결하면 전환하는 동안 사용자가 평소와 같은
    방식으로 계속 로그인할 수 있습니다.
</Info>

Iru는 다음 연결 유형을 지원합니다.

| 유형 | 용도 |
| - | - |
| **Google** | Google 계정 기반 로그인. **Google Workspace** 템플릿이 연결을 미리 채웁니다. |
| **Microsoft** | Microsoft 회사 또는 학교 계정 기반 로그인. **Microsoft Entra ID** 템플릿이 연결을 미리 채웁니다. |
| **SAML** | SAML 표준을 지원하는 모든 ID 공급자. |
| **OIDC** | OpenID Connect 표준을 지원하는 모든 ID 공급자. |

Iru에는 자체 기본 제공 로그인 옵션도 있으므로, 일부 사용자에게는 외부 공급자를
연결하고 다른 사용자는 패스키와 같은 [인증기](/ko/identity/authentication/authenticators)로
계속 직접 로그인하도록 할 수 있습니다.

<Tip>
  **Google Workspace** 및 **Microsoft Entra ID** 템플릿은 표준 구성을 미리 채우므로
  테넌트에 특정한 정보만 제공하면 됩니다. 일반 SAML 또는 OIDC 연결을 수동으로
  구성하기 전에 이 템플릿을 먼저 사용하세요.
</Tip>

### 모든 ID 공급자 연결에서 구성하는 항목

<AccordionGroup>
  <Accordion title="사용 사례" icon="list-check">
    각 연결에는 적용 위치를 결정하는 하나 이상의 **사용 사례**가 있습니다.

    * **최종 사용자 로그인:** 사용자가 연결을 사용하여 Iru에 로그인하고
      앱에 액세스합니다.
    * **기기 등록:** 기기를 등록하는 동안 연결이 사용됩니다.

    연결의 용도를 선택할 수 있으며, 하나의 연결이 둘 이상의 사용 사례에
    사용될 수 있습니다.
  </Accordion>

  <Accordion title="도메인 제한" icon="at">
    연결을 하나 이상의 이메일 **도메인**으로 제한하여 해당 도메인에 이메일이 있는
    사용자만 연결을 사용하도록 할 수 있습니다. 이를 통해 조직의 여러 부분을
    서로 다른 공급자로 라우팅할 수 있습니다.
  </Accordion>

  <Accordion title="사용자 매칭" icon="user-check">
    누군가 연결을 통해 로그인하면 Iru는 해당 사용자를
    [디렉터리](/ko/identity/directory/directory-overview)의 사용자와 매칭하여 로그인이
    올바른 사용자로 확인되도록 합니다. Iru가 매칭에 사용할 값을 선택합니다.

    | 매칭 기준 | 설명 |
    | - | - |
    | **UPN** | 공급자가 보내는 사용자 계정 이름(UPN)입니다. |
    | **사용자 이름** | 사용자의 사용자 이름입니다. |
    | **External ID** | 공급자에서 전달되는 식별자입니다. |
    | **Custom attribute** | 선택한 [프로필 속성](/ko/identity/directory/schema)입니다. |

    모든 사용자에 대해 안정적이고 고유한 값을 선택하여 각 로그인이
    정확히 한 명의 사용자에게 연결되도록 하세요.
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="Google Workspace" icon="google" href="/ko/identity/connections/google-workspace">
    템플릿을 사용하여 최종 사용자 로그인용 Google Workspace를 연결합니다.
  </Card>

  <Card title="Microsoft Entra ID" icon="microsoft" href="/ko/identity/connections/microsoft-entra-id">
    템플릿을 사용하여 최종 사용자 로그인용 Microsoft Entra ID를 연결합니다.
  </Card>

  <Card title="사용자 지정 SAML" icon="shield-halved" href="/ko/identity/connections/custom-saml">
    Iru가 서비스 공급자 역할을 하여 모든 SAML ID 공급자를 연결합니다.
  </Card>

  <Card title="사용자 지정 OIDC" icon="key" href="/ko/identity/connections/custom-oidc">
    모든 OpenID Connect ID 공급자를 연결합니다.
  </Card>
</CardGroup>

## Device Trust 신호

기기 상태는 연결이 아닙니다. 기기의 암호화 및 정상 여부와 같은 신호는 각 기기의
**Iru Access** 에이전트가 보고하며,
[인증 정책](/ko/identity/authentication/authentication-policies)에서 액세스를 허용하기 전에
알려진 정상 기기를 요구할 수 있습니다.
[Device Trust](/ko/identity/authentication/device-trust)를 참조하세요.

## 다음 단계

<CardGroup cols={2}>
  <Card title="주요 개념" icon="book" href="/ko/identity/getting-started/key-concepts">
    연결이 사용자, 그룹, 애플리케이션 및 정책과 어떻게 관련되는지 알아봅니다.
  </Card>

  <Card title="로그인 환경" icon="arrow-right-to-bracket" href="/ko/identity/authentication/sign-in-experience">
    연결된 공급자를 통해 로그인할 때 사용자에게 표시되는 화면을 구성합니다.
  </Card>
</CardGroup>