式を使用して属性を変更する
マッピング内の式を使用して、属性をOktaに保存したりアプリに送信したりする前に属性を変更できます。
式を使用すると、属性の連結、文字列の操作、データ型の変換などができます。OktaはSpring Expression Language(SpEL)関数のサブセットをサポートします。サポートされる関数すべての一覧については、「Okta式言語」をご覧ください。すべての関数は、UDマッピングで機能します。
一部の関数(つまり、string
)は製品の他の領域で機能しますが(SAML 2.0テンプレートの属性やカスタムのユーザー名の形式など)、すべてが機能するわけではありません。
式は、アプリ間でデータの整合性と形式を維持するのに便利です。たとえば、メールの接頭辞をユーザー名として使用したり、メールの接尾辞を一括置換したり、既存の属性の組み合わせに基づいて属性を設定したりできます(例:displayName=lastName,firstName)。
- 管理コンソールで、[ディレクトリー] > に移動します [プロファイル・エディター]
- 任意:[フィルター] リストで [Okta]、[アプリ]、[ディレクトリー]または[IDプロバイダー]を選択し、アプリのリストをフィルタリングします。
- アプリケーション、ディレクトリー、またはIDプロバイダーの[マッピング]をクリックし、リストが表示された場合は、[ユーザー・マッピングを設定]を選択します。
- [ユーザー・プロファイル・マッピング]ダイアログ・ボックスで次のいずれかのタブを選択します。
- [アプリからOktaユーザーへ]:属性をアプリからOktaに変更するにはこのタブを選択します。アプリにソース属性が含まれ、Oktaがターゲットです。
- [Oktaユーザーからアプリへ]: Oktaからアプリへ属性を変更するにはこのタブを選択します。 Oktaにソース属性が含まれ、アプリがターゲットです。
- [属性を選択するか、式を入力]フィールドに式を入力します。
- 変数名の前に、対応するオブジェクトまたはプロファイルを付けます。
a. sourceは左側のオブジェクトを参照します。
- Oktaからアプリへ、またはアプリからOktaへのマッピングで使用できます。
- 例:source.firstName
b. userはOktaユーザー・プロファイルを参照します。
- Oktaからアプリへのマッピングでのみ使用できます。
- 例:user.firstName
c. appUser(暗黙の参照)は、コンテキスト内のアプリを参照します(Oktaユーザー・プロファイルではありません)。
- アプリからOktaへのマッピングでのみ使用できます。
- 例:appUser.firstName
d. appUserName(明示的参照)は、名前で特定のアプリを参照します。
- Oktaからアプリへ、またはアプリからOktaへのマッピングで使用できます。
- マッピング外でアプリを参照するために使用されます。
- 例: google.nameGivenName
- アプリの複数のインスタンスが構成されている場合、最初のインスタンスに続く追加のアプリ・ユーザー・プロファイルにアンダースコアとランダムな文字列が追加されます。
- 例: google、google_<random string 1>、google_<random string 2>
- インスタンス名と変数名を見つけるには、プロファイル・エディターを使用します。
a.管理コンソールで、[ディレクトリー] > に移動します [プロファイル・エディター]
b. アプリ、ディレクトリー、またはIdPで[プロファイル]を選択し、インスタンス名と変数名をメモします。
- [マッピングを保存]と[今すぐ更新を適用]をクリックします。