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

# 사용자 지정 SAML

> Iru가 서비스 공급자 역할을 하고 어설션을 사용자 속성에 매핑하여 페더레이션 로그인을 위해 모든 SAML 2.0 ID 공급자를 Iru Identity에 연결합니다.

ID 공급자가 **SAML** 표준을 지원하지만 기본 제공 템플릿이 없는 경우
**사용자 지정 SAML** 연결로 연결하세요. 이 구성에서 Iru는
**서비스 공급자(SP)** 역할을 합니다. 공급자가 사용자를 인증한 다음 Iru가 신뢰하는
서명된 SAML 응답을 Iru에 보내 세션을 시작합니다.

<Info>
  Iru Identity를 ID 공급자로 사용하는 대부분의 조직에서는 사용자가 패스키 또는
  Iru Access 앱으로 직접 로그인합니다. Iru Identity를 기본 ID 공급자가 아닌 Iru
  플랫폼에 대한 인증 계층으로 사용하거나 Iru Identity로의 마이그레이션을 쉽게 하려는
  경우 SAML 공급자를 연결하세요. [페더레이션 인증](/ko/identity/connections/connections-overview)을 참조하세요.
</Info>

<Note>
  이 연결을 완료하려면 Iru 테넌트에 대한 관리자 액세스 권한과 SAML ID 공급자에
  대한 관리자 액세스 권한이 필요합니다. SAML 설정은 양방향으로 몇 가지 값을
  교환하는 것을 의미하며, 이 페이지에서는 양쪽을 모두 안내합니다.
</Note>

## 신뢰가 설정되는 방식

```mermaid theme={null}
sequenceDiagram
  participant Admin as 관리자
  participant Iru as Iru (서비스 공급자)
  participant Idp as SAML 공급자

  Iru-->>Admin: SP 메타데이터, 엔터티 ID, ACS URL 제공
  Admin->>Idp: Iru를 서비스 공급자로 등록
  Idp-->>Admin: 엔터티 ID, 로그인 URL, 서명 인증서 제공
  Admin->>Iru: 공급자 정보 입력 및 인증서 업로드
  Note over Iru,Idp: 신뢰 설정 완료, 로그인 테스트 가능
```

Iru와 공급자는 서로를 신뢰해야 합니다. Iru는 공급자가 Iru를 인식하는 데 필요한
정보를 제공하고, 공급자는 Iru가 응답을 확인하는 데 필요한 정보를 제공합니다.

## 시작하기 전에

<Steps>
  <Step title="Iru의 서비스 공급자 정보 수집">
    Iru의 연결에서 공급자가 요구할 값을 수집합니다.
    Iru의 **SP 메타데이터**, **엔터티 ID**, **ACS URL**(공급자가 SAML 응답을 보내는
    주소)입니다. 많은 공급자가 메타데이터에서 한 번에 가져올 수 있습니다.
  </Step>

  <Step title="공급자 정보 수집">
    SAML 공급자에서 **엔터티 ID**, **Single Sign-On
    URL**, **서명 인증서**(Iru가 공급자의 서명된 응답을 확인하는 데 사용하는
    인증서)를 수집합니다.
  </Step>

  <Step title="사용자가 Iru에 존재하는지 확인">
    연결을 통한 로그인은 기존 Iru 사용자로 확인됩니다. 먼저 사용자를 추가하거나
    가져오세요. [사용자 가져오기](/ko/identity/directory/importing-users) 또는
    [Directory Sync](/ko/identity/directory/directory-sync)를 참조하세요.
  </Step>
</Steps>

## SAML 공급자 연결

<Steps>
  <Step title="연결 추가">
    **Access → Authentication**에서 **인증 방법**을 추가하고 **SAML**을 선택합니다.
    Iru가 이 연결에 대한 서비스 공급자 정보를 생성합니다.
  </Step>

  <Step title="공급자에 Iru 등록">
    SAML 공급자에서 Iru용 새 애플리케이션(신뢰 당사자)을 생성하고 Iru의
    **엔터티 ID**와 **ACS URL**을 입력하거나, 공급자가 지원하는 경우 Iru의
    **SP 메타데이터**를 가져옵니다. 공급자가 **NameID**와 매칭에 사용할
    **속성**을 제공하도록 구성합니다. 정확한 신뢰 당사자 화면은 공급자 콘솔에
    있으므로 공급자의 최신 문서를 따르세요.
  </Step>

  <Step title="Iru에 공급자 정보 입력">
    Iru로 돌아와 공급자의 **엔터티 ID**와 **Single Sign-On URL**을 입력한 다음,
    Iru가 수신하는 SAML 응답을 확인할 수 있도록 공급자의 **서명 인증서**를
    업로드합니다.
  </Step>

  <Step title="사용자 매칭 설정">
    SAML 응답에서 사용자를 식별하는 값(**제목**(NameID) 또는 공급자가 보내는
    이름이 지정된 **속성**)과 이를 매칭할 Iru 사용자 값(UPN, 사용자 이름, 외부 ID
    또는 사용자 지정 속성)을 Iru에 지정합니다.
    [사용자 매칭](/ko/identity/connections/connections-overview#what-you-configure-on-every-identity-provider-connection)을 참조하세요.
  </Step>

  <Step title="연결의 용도 선택">
    연결의 **사용 사례**를 선택합니다: **최종 사용자 로그인**, **기기
    등록** 또는 둘 다.
  </Step>

  <Step title="도메인으로 제한">
    특정 이메일 도메인의 사용자만 이 연결을 사용하도록 하려면
    **도메인 제한**을 활성화하고 해당 도메인을 추가하세요.
  </Step>

  <Step title="저장 및 테스트">
    연결을 저장한 다음 테스트 사용자로 로그인하여 전체 흐름을 확인합니다.
    Iru가 요청을 보내고, 공급자가 사용자를 인증하며, Iru가 사용자를 올바른
    사용자와 매칭해야 합니다.
  </Step>
</Steps>

<Tip>
  Iru는 공급자가 로그인 요청이 실제로 Iru에서 왔는지 확인할 수 있도록
  **요청 서명 인증서**를 제공할 수도 있습니다. 공급자가 서명된 요청을 요구하는 경우
  연결에서 Iru의 요청 서명 인증서를 공유하고 공급자 측에서 서명된 요청을
  활성화하세요.
</Tip>

## 연결 상태 유지

<AccordionGroup>
  <Accordion title="인증서는 만료됩니다" icon="certificate">
    공급자에서 업로드한 서명 인증서에는 만료 날짜가 있습니다.
    공급자가 인증서를 교체하면 로그인이 계속 작동하도록 Iru에 새 인증서를
    업로드하세요. 이전 인증서가 만료되기 전에 교체를 계획하세요.
  </Accordion>

  <Accordion title="로그인이 잘못된 사용자로 연결되거나 아무에게도 연결되지 않음" icon="user-xmark">
    이 문제는 거의 항상 **사용자 매칭**에서 비롯됩니다. 공급자가 보내는 값(Subject
    또는 속성)이 모든 사용자에 대해 존재하고 고유한지, 그리고 선택한 Iru 사용자
    값과 일치하는지 확인하세요.
  </Accordion>
</AccordionGroup>

## 관련 항목

<CardGroup cols={2}>
  <Card title="페더레이션 인증" icon="plug" href="/ko/identity/connections/connections-overview">
    사용 사례, 도메인 제한, 사용자 매칭을 한곳에서 설명합니다.
  </Card>

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

  <Card title="시스템 아키텍처" icon="sitemap" href="/ko/identity/getting-started/system-architecture">
    페더레이션 로그인이 더 넓은 ID 계층에 어떻게 들어맞는지 알아봅니다.
  </Card>

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