Skip to main content
誰かが Iru を通じてアプリケーションにサインインすると、アプリはその人が誰であるかを示す 署名済みの ID ステートメント(SAML アサーションまたは OIDC ID トークン)を受け取ります。 アプリケーションマッピングは、そのステートメントに何を含めるかを決定する方法です。 アプリが想定する各フィールドに対して、ユーザーのプロファイルから 取得した値をマッピングします。
マッピングされるすべての値は、IQL (Iru Query Language)で記述されます。これは、 Directory Sync の属性マッピングや Auto Group のルールで使用されるのと同じ式言語です。 値は単一のプロファイルフィールド(user.email)にすることも、フィールドを加工する式 (user.email.lowerAscii())にすることもできます。
SAML アプリのアプリケーション Mapping エディタ:名前形式 Unspecified で IQL 式 user.id からマッピングされた Subject と、名前形式 Basic で user.primaryEmail.email からマッピングされた Email 属性。

マッピングエディタ:IQL 式で Subject と各属性を設定し、利用可能なフィールドと関数は IQL エクスプローラーで確認できます。

マッピングの内容

すべてのアプリケーションは、送信するステートメントに次の 2 つをマッピングします。
  • サブジェクト: サインインしたユーザーの主要な識別子。
  • 属性またはクレーム: アプリが想定するその他のフィールド。

サブジェクト

サブジェクトは、サインインしたユーザーを識別します。デフォルトはプロトコルによって異なります。 取得元の値を変更でき、SAML の場合は NameID 形式を選択できます。 プロトコル固有のオプションについては、SAML アプリケーションと OIDC アプリケーションを参照してください。

属性とクレーム

サブジェクト以外に、アプリが必要とする各フィールドを追加します。それぞれについて、 名前(アプリが想定するもの)、値(それを生成する IQL 式)、プロトコルの詳細 (SAML の場合は属性名の形式、OIDC の場合はスコープ)、および有効かどうかを設定します。

マッピングの作成方法

1

アプリのマッピングを開く

マッピングは、プロトコル設定とともにアプリケーションのドラフトにあります。
2

フィールドごとに IQL 式を記述する

サブジェクトと各属性またはクレームについて、 IQL 式を記述します。エディタは入力中に 利用可能な user フィールドと関数を提案し、式をチェックするため、公開前に誤りが明らかになります。
3

結果をプレビューする

ライブプレビューに Iru が送信する正確なアサーションまたはトークンが表示されるため、 本番稼働前にその形式を確認できます。
4

公開する

ドラフトを現在のバージョンとして設定し、マッピングを有効にします。バージョンモデルについては アプリケーションの概要を参照してください。
アプリが必要とするものだけをマッピングしてください。各アプリはマッピングした属性のみを 正確に受け取るため、特定のサービスにはユーザーの識別に必要なプロファイルの詳細のみが表示されます。

プロビジョニングのためのマッピング

マッピングはサインオン以外にも影響します。プロビジョニングを 使用するアプリの場合、マッピングにはプロビジョニングビューもあり、アプリでアカウントを 作成または更新する際に Iru が送信するプロファイル属性を制御します。

次のステップ

Iruクエリ言語

IQL の完全なリファレンス:フィールド、演算子、関数、例。

SAML アプリケーション

SAML アプリの NameID 形式と属性マッピング。

OIDC アプリケーション

OIDC アプリのサブジェクトとクレームのマッピング。

プロビジョニング

アプリでアカウントを作成および更新する際に Iru が送信する属性をマッピングします。