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

# 역할 및 역할 번들

> Iru Identity에서 그룹 구성원 자격에 따라 애플리케이션에 역할을 어설션하고, 역할 번들을 사용하여 역할별 세션 길이와 위험을 제어합니다.

많은 애플리케이션은 사용자가 누구인지뿐만 아니라 **어떤 역할**(관리자, 구성원,
뷰어 등)을 가지고 있는지 알기를 기대합니다. Iru는 사용자의 그룹 구성원 자격에 따라
로그인 시 애플리케이션에 역할을 어설션할 수 있으며, 역할별로 **세션 길이**와
**위험**을 다르게 설정할 수 있습니다.

이는 애플리케이션의 **Roles** 탭에서 구성합니다. 앱의 다른 부분과 마찬가지로
초안에서 편집하고 게시합니다.
[애플리케이션 개요](/ko/identity/applications/applications-overview)를 참조하세요.

## 역할이 애플리케이션에 전달되는 방식

```mermaid theme={null}
flowchart LR
  group["그룹 구성원 자격"] --> role["역할"]
  role -->|"역할 식별자"| method["역할 어설션 방법"]
  method --> app["애플리케이션"]
```

**역할**은 하나 이상의 [그룹](/ko/identity/directory/groups)에 부여됩니다. 해당
그룹의 누군가가 로그인하면 Iru는 선택한 방법을 사용하여 역할의 **식별자**를
애플리케이션에 어설션합니다.

## 역할 어설션 방법

역할이 애플리케이션에 전송되는 방식(또는 전송 여부)을 결정합니다.

| 방법 | 동작 |
| - | - |
| **없음** | 애플리케이션은 Single Sign-On을 통해 역할을 받지 않습니다. 역할 번들이 꺼집니다. **할당** 탭에서 그룹에 **Default** 역할만 할당할 수 있습니다. |
| **그룹** | 역할 식별자가 애플리케이션이 받는 그룹의 값으로 전송됩니다. |
| **Custom attribute** | 역할 식별자가 지정한 사용자 지정 속성 또는 클레임에 단일 값 또는 배열로 전송됩니다. SAML 앱의 경우 속성 이름 형식도 선택합니다. |

## 역할 번들

역할은 관련 역할을 그룹화하고 사용자가 한 번에 둘 이상의 역할을 가질 수 있는지
결정하는 **역할 번들** 안에 있습니다.

| 번들 설정 | 동작 |
| - | - |
| **Display name** | 대시보드에서의 번들 이름. |
| **Bundle identifier** | 관련 역할을 구성하는 데만 사용되는 고유 식별자. 역할 값으로 애플리케이션에 전송되지 **않습니다**. |
| **Exclusivity mode** | **Include all**은 번들에서 사용자가 자격을 갖춘 모든 역할을 어설션합니다. **Priority**는 우선순위가 가장 높은 단일 역할만 어설션하므로 역할이 상호 배타적입니다. |

**Priority** 모드에서는 각 역할에 고유한 **우선순위** 번호가 있으며, 누군가가 둘
이상의 역할에 자격을 갖춘 경우 가장 높은 우선순위의 역할이 적용됩니다.

## 역할에 포함되는 항목

<AccordionGroup>
  <Accordion title="표시 이름 및 식별자" icon="tag">
    대시보드에서의 역할 이름과 애플리케이션에 어설션되는 **역할 식별자**(앱이 이
    역할에 대해 받는 값).
  </Accordion>

  <Accordion title="그룹" icon="users">
    구성원이 역할을 받는 [그룹](/ko/identity/directory/groups). 역할을 그룹 기반으로
    하면 역할 할당이 디렉터리를 따르게 됩니다.
  </Accordion>

  <Accordion title="세션 기간" icon="clock">
    이 역할을 통해 부여된 세션이 지속되는 시간(분)입니다. 역할마다 서로 다른 세션
    길이를 가질 수 있습니다. **0**으로 설정하면 애플리케이션 기본값(앱에서 변경하지
    않는 한 **60분**)을 사용합니다.
  </Accordion>

  <Accordion title="위험 수준" icon="gauge-high">
    역할에 대한 선택적 [위험 수준](/ko/identity/authentication/risk-based-access)
    분류로, 더 민감한 역할에 일관되게 레이블을 지정할 수 있습니다.
  </Accordion>
</AccordionGroup>

<Note>
  모든 애플리케이션은 **Default** 번들과 역할로 시작하므로 별도 설정 없이 액세스가
  작동합니다. 애플리케이션에 역할 기반 액세스가 필요한 경우에만 번들과 역할을
  추가하세요.
</Note>

## 애플리케이션에 대한 역할 구성

<Steps>
  <Step title="역할 어설션 방법 선택">
    앱의 **Roles** 탭에서 역할이 애플리케이션에 전달되는 방식을 설정합니다.
    **그룹** 또는 **Custom attribute**, 또는 앱이 Single Sign-On을 통해 역할을 받지
    않는 경우 **없음**을 선택합니다.
  </Step>

  <Step title="역할 번들 생성">
    번들을 추가하고 이름과 식별자를 지정한 다음 **Include all** 또는 **Priority**
    배타성을 선택합니다.
  </Step>

  <Step title="역할 추가">
    각 역할에 대해 식별자를 설정하고, 역할을 받을 그룹을 할당하고, 세션 기간과
    (선택적으로) 위험 수준을 설정합니다. **Priority** 번들에서는 각 역할에 우선순위
    번호를 지정합니다.
  </Step>

  <Step title="게시">
    초안을 current로 설정합니다. 그 이후 로그인 시 번들에 따라 각 사용자의 역할이
    어설션됩니다.
  </Step>
</Steps>

## 다음 단계

<CardGroup cols={2}>
  <Card title="액세스 할당" icon="user-check" href="/ko/identity/applications/assigning-access">
    애초에 앱에 접근할 수 있는 사람을 부여합니다.
  </Card>

  <Card title="그룹" icon="users" href="/ko/identity/directory/groups">
    역할은 그룹에 부여되므로 그곳에서 구성원 자격을 구성하세요.
  </Card>

  <Card title="SAML 애플리케이션" icon="file-signature" href="/ko/identity/applications/saml-applications">
    SAML 역할 어설션을 위한 사용자 지정 속성 이름 형식을 설정하는 곳.
  </Card>

  <Card title="OIDC 애플리케이션" icon="id-card" href="/ko/identity/applications/oidc-applications">
    OIDC 앱에서 역할이 클레임으로 함께 전달되는 곳.
  </Card>
</CardGroup>