Skip to main content
누군가 Iru를 통해 애플리케이션에 로그인하면, 앱은 사용자가 누구인지 알려주는 서명된 ID 명세(SAML 어설션 또는 OIDC ID 토큰)를 받습니다. 애플리케이션 매핑은 해당 명세에 무엇을 포함할지 결정하는 방법입니다. 앱이 기대하는 각 필드에 대해 사용자의 프로필에서 가져온 값을 매핑합니다.
매핑되는 모든 값은 Directory Sync 속성 매핑 및 Auto Group 규칙에 사용되는 것과 동일한 표현식 언어인 IQL(Iru Query Language)로 작성됩니다. 값은 단일 프로필 필드(user.email)이거나 이를 변환하는 표현식 (user.email.lowerAscii())일 수 있습니다.
SAML 앱의 애플리케이션 Mapping 편집기: 이름 형식이 Unspecified인 IQL 표현식 user.id에서 매핑된 Subject와 이름 형식이 Basic인 user.primaryEmail.email에서 매핑된 Email 속성.

매핑 편집기: IQL 표현식으로 Subject와 각 속성을 설정하며, 사용 가능한 필드와 함수를 위한 IQL 탐색기가 함께 제공됩니다.

매핑에 포함되는 항목

모든 애플리케이션은 전송하는 명세에 두 가지를 매핑합니다.
  • Subject: 로그인한 사용자의 기본 식별자.
  • 속성 또는 클레임: 앱이 기대하는 추가 필드.

Subject

Subject는 로그인한 사용자를 식별합니다. 기본값은 프로토콜에 따라 다릅니다. 값을 가져오는 소스를 변경할 수 있으며, SAML의 경우 NameID 형식을 선택할 수 있습니다. 프로토콜별 옵션은 SAML 애플리케이션 및 OIDC 애플리케이션을 참조하세요.

속성 및 클레임

Subject 외에 앱에 필요한 각 필드를 추가합니다. 각 필드에 대해 이름(앱이 기대하는 것), 값(이를 생성하는 IQL 표현식), 프로토콜 세부 정보(SAML의 경우 속성 이름 형식, OIDC의 경우 스코프), 그리고 활성화 여부를 설정합니다.

매핑 구성 방법

1

앱의 매핑 열기

매핑은 프로토콜 설정과 함께 애플리케이션의 초안에 있습니다.
2

필드별 IQL 표현식 작성

Subject와 각 속성 또는 클레임에 대해 IQL 표현식을 작성합니다. 편집기는 입력하는 동안 사용 가능한 user 필드와 함수를 제안하고 표현식을 검사하므로, 게시하기 전에 오류가 드러납니다.
3

결과 미리 보기

실시간 미리 보기는 Iru가 전송할 정확한 어설션 또는 토큰을 렌더링하므로 적용하기 전에 형태를 확인할 수 있습니다.
4

게시

초안을 current로 설정하여 매핑을 적용합니다. 버전 모델은 애플리케이션 개요를 참조하세요.
앱에 필요한 것만 매핑하세요. 각 앱은 매핑한 속성만 정확히 받으므로, 각 서비스는 사용자 식별에 필요한 프로필 세부 정보만 볼 수 있습니다.

프로비저닝을 위한 매핑

매핑은 로그인 이상의 역할을 합니다. 프로비저닝이 있는 앱의 경우 매핑에는 Iru가 앱에서 계정을 생성하거나 업데이트할 때 전송하는 프로필 속성을 제어하는 프로비저닝 보기도 있습니다.

다음 단계

Iru 쿼리 언어

전체 IQL 참조: 필드, 연산자, 함수 및 예제.

SAML 애플리케이션

SAML 앱의 NameID 형식 및 속성 매핑.

OIDC 애플리케이션

OIDC 앱의 Subject 및 클레임 매핑.

프로비저닝

Iru가 앱에서 계정을 생성하고 업데이트할 때 전송하는 속성을 매핑합니다.