> ## 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는 사용자의 그룹 구성원 자격에 따라
로그인 시 애플리케이션에 역할을 전송할 수 있으며, 역할별로 **세션 길이**를 다르게
설정할 수 있습니다.

역할은 애플리케이션의 **역할** 탭에서 만들고 **할당** 탭에서 그룹에 할당합니다.
다른 앱 설정과 마찬가지로 역할은 초안에서 편집한 다음 게시합니다.
[애플리케이션 개요](/ko/identity/applications/applications-overview)를 참조하세요.

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

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

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

## 역할 어설션 방법

역할 어설션 방법은 Iru가 애플리케이션에 역할을 전송할지 여부와 전송 방식을
결정합니다.

| 방법 | 동작 |
| - | - |
| **없음** | 애플리케이션은 로그인 시 역할을 받지 않습니다. **할당** 탭에서 그룹에 **기본값** 역할만 할당할 수 있습니다. |
| **그룹** | 속성 매핑에서 이미 같은 이름의 클레임 또는 속성을 전송하지 않는 한, Iru는 역할 식별자를 `groups`라는 클레임 또는 속성의 값으로 전송합니다. |
| **사용자 지정 속성** | Iru는 지정한 이름의 클레임 또는 속성에 역할 식별자를 전송합니다. OIDC의 경우 배열로, SAML의 경우 역할당 하나의 값으로 전송합니다. OIDC의 경우 `sub`, `exp`, `scope`처럼 Iru가 이미 전송하는 클레임 이름은 사용하지 마세요. |

## 역할에 포함되는 항목

> **표시 이름 및 식별자**
>
> 대시보드에서의 역할 이름과 Iru가 애플리케이션에 전송하는 **역할 식별자**입니다.
> 식별자는 앱이 이 역할에 대해 받는 값입니다.

> **그룹**
>
> 구성원이 역할을 받는 [그룹](/ko/identity/directory/groups)입니다. 역할은
> **할당** 탭에서 그룹에 할당하므로 역할 할당이 디렉터리 구성원 자격을 따릅니다.

> **세션 길이**
>
> Iru가 애플리케이션에 전송하는 로그인이 유효하게 유지되는 시간(분)입니다. OIDC
> 새로 고침 토큰은 제한하지 않습니다. 사용자가 여러 역할에 해당하는 경우 Iru는
> 해당 역할에 설정된 길이 중 가장 긴 길이를 사용합니다. 이 역할에서 길이를 설정하지
> 않으려면 비워 두세요.
>
> 사용자의 역할 중 길이를 설정한 역할이 없거나 역할 어설션 방법이 **없음**인
> 경우 Iru는 애플리케이션 기본값을 사용합니다. 템플릿 없이 만든 앱의 기본값은
> **60분**에서 시작합니다. SAML 앱의 **Session Length Supported**가
> **Unsupported**로 설정된 경우 Iru는 만료를 전송하지 않습니다.

> **위험 수준**
>
> 역할에 대한 [위험 수준](/ko/identity/authentication/risk-based-access)
> 레이블입니다. 대시보드에서 필수 항목이므로 더 민감한 역할에 일관되게 레이블을
> 지정할 수 있습니다. 앱에 전송되지 않으며 로그인에 영향을 주지 않습니다.

> [!NOTE]
>
> 템플릿 없이 만든 애플리케이션에는 역할이 없으므로, 역할을 추가하고 그룹에
> 할당할 때까지 아무도 로그인할 수 없습니다. 앱에 역할이 필요하지 않으면 **없음**을
> 선택하세요. 그러면 앱에는 그룹을 할당할 수 있는 단일 **기본값** 역할이 생깁니다.

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

**1. 역할 어설션 방법 선택**

앱의 **역할** 탭에서 **그룹** 또는 **사용자 지정 속성**을 선택하여
애플리케이션에 역할을 전송합니다. 앱에 역할이 필요하지 않으면 **없음**을
선택합니다.

**2. 역할 추가**

각 역할에 대해 표시 이름과 위험 수준을 설정하고, 선택적으로 어설션 값(앱에
전송되는 값)과 세션 길이를 설정합니다.

**3. 그룹에 역할 할당**

**할당** 탭에서 그룹과 해당 구성원이 받을 역할을 선택합니다.

**4. 게시**

초안을 current로 설정합니다. 그 이후 Iru는 어떤 역할에도 해당하지 않는 사용자의
로그인을 거부하고, 역할 어설션 방법을 사용하여 각 사용자의 역할을 앱에
전송합니다.

## 다음 단계

> **[액세스 할당](/ko/identity/applications/assigning-access)**
>
> 그룹을 할당하여 앱에 접근할 수 있는 사람을 제어합니다.

> **[그룹](/ko/identity/directory/groups)**
>
> 역할을 할당할 그룹을 만들고 관리합니다.

> **[SAML 애플리케이션](/ko/identity/applications/saml-applications)**
>
> SAML 앱에 전송되는 역할의 속성 이름 형식을 설정합니다.

> **[OIDC 애플리케이션](/ko/identity/applications/oidc-applications)**
>
> 역할을 포함하여 Iru가 OIDC 앱에 전송하는 클레임을 구성합니다.