Skip to main content
すべてのユーザープロファイルは、スキーマ (プロファイルが保持できる属性のセット) によって形作られます。スキーマは全員に存在する組み込みフィールドから始まり、組織に合わせたカスタム属性で拡張します。スキーマは Directory → Users → Schema から編集します (Users ページのスキーマコントロールは、テキストラベルではなくアイコンボタンです)。 属性は単なるストレージではありません。属性は Auto Groups がメンバーシップを計算する元となり、アプリケーションが受け取る ID 情報にマッピングされる素材です。そのため、ここで設計するスキーマは Iru Identity 全体のアクセスと自動化を形作ります。
Default カテゴリに Domain、Username、Iru Role、Name、Email などの属性が表示された User Schema ページ。各属性にスラッグ、タイプ、および Unique、Required、Auto Group 列があります。

User Schema エディター: スラッグ、タイプ、フラグを持つ組み込み属性とカスタム属性が、カテゴリにグループ化されています。

組み込みフィールド

すべてのプロファイルには、定義する必要のない組み込みファセットのセットが含まれています。
  • 名前。ユーザーの表示名を構築するために使用されます。
  • メールアドレス、電話番号、住所。各エントリには勤務先や個人などのラベルが付きます。
  • ユーザー名とドメイン。組み合わせてサインイン識別子を形成します。
  • ロール、ステータス、ソース。ロールは Identity だけでなく、Iru 製品全体に適用されます。
これらについては、プロファイルの他の部分とともにユーザーで説明しています。
複数のメールドメインのサポート。 ユーザーが持つことができるドメインは、組み込みのドメインフィールドの許可された値の固定リストから取得されます。組織が複数のドメイン (例: example.com と example.io) を使用する場合は、スキーマでそれぞれをそのリストに追加してください。ユーザーを作成またはインポートするときに選択できるのは、そこで定義されたドメインのみです。

カスタム属性

カスタム属性は、すべてのユーザープロファイルにフィールドを追加します。作成時に次を指定します。
Display Name、Slug、Description フィールド、Category と Type のセレクター、および Unique と Required のトグルを含む Add Attribute ダイアログ。

カスタム属性の追加。

required と unique は慎重に選択してください。必須属性は、インポートや HR 同期によって作成されたユーザーを含むすべてのユーザーに存在する必要があるため、それがないレコードは保存に失敗します。一意の属性は、従業員番号などの識別子に適しています。

属性タイプ

カスタム属性を追加するときは、保持する値に次のいずれかのタイプを選択します。
タイプは属性の作成時に選択され、後から変更することはできません。Unique は、値がユーザー間で繰り返されることを想定した Boolean または Enumeration 属性では使用できません。Binary 値は base64 として保存され、サイズ制限がないため、大きなファイルではなく、トークンやキーなどの小さな値に使用してください。

固定の選択肢を持つ属性

一部の属性は、既知のリストからの値のみを受け入れるべきです (部署、所在地、雇用形態など)。このような場合は、属性に許可された値 (列挙オプション) の固定リストを指定します。各オプションには独自の表示名と識別子があります。 固定選択属性は、Auto Groups と自然に組み合わせられるため特に便利です。許可された各値が独自のグループになり、メンバーシップは自動的に計算されます。

カテゴリ

属性はカテゴリ (「Employment」や「Contact」など、プロファイルがグループ化される名前付きセクション) に整理されます。各カテゴリには、表示名、アイコン、およびプロファイル上の順序を制御する位置があります。関連する属性をグループ化すると、長いプロファイルが読みやすくなり、スキーマの管理が容易になります。
Display Name、Slug、Icon、Description フィールドを含む Add Category ダイアログ。

カテゴリの追加。

属性の使用方法

Auto Groups を駆動する

属性にフラグを設定して Auto Groups を駆動すると、Iru はその値を、プロファイルの変更に応じてメンバーシップが更新されるグループに変換します。

アプリケーションにマッピングする

アプリケーションはプロファイル属性を受け取るアサーションまたはトークンにマッピングするため、各アプリは期待する ID 情報を取得できます。
ユーザーを大規模に取り込む前にスキーマを設計してください。どの属性を必須、一意、固定選択にするかを事前に決定しておくと、インポートと HR 同期が問題なく完了し、Auto Groups が期待どおりに動作します。

次のステップ

Auto Groups を構築する

属性を自己管理するグループに変換します。

ユーザーを管理する

個々のプロファイルで属性の動作を確認します。