式を使用して属性を変更する

マッピング内の式を使用して、属性をOktaに保存したりアプリに送信したりする前に属性を変更できます。

式を使用すると、属性の連結、文字列の操作、データ型の変換などができます。OktaはSpring Expression Language(SpEL)関数のサブセットをサポートします。サポートされる関数すべての一覧については、「Okta式言語」をご覧ください。すべての関数は、UDマッピングで機能します

一部の関数(つまり、string)は製品の他の領域で機能しますが(SAML 2.0テンプレートの属性やカスタムのユーザー名の形式など)、すべてが機能するわけではありません。

式は、アプリ間でデータの整合性と形式を維持するのに便利です。たとえば、メールの接頭辞をユーザー名として使用したり、メールの接尾辞を一括置換したり、既存の属性の組み合わせに基づいて属性を設定したりできます(例:displayName=lastName,firstName)。

  1. 管理コンソールで、[ディレクトリー] > に移動します [プロファイル・エディター]
  2. 任意:[フィルター] リストで [Okta][アプリ][ディレクトリー]または[IDプロバイダー]を選択し、アプリのリストをフィルタリングします。
  3. アプリケーション、ディレクトリー、またはIDプロバイダーの[マッピング]をクリックし、リストが表示された場合は、[ユーザー・マッピングを設定]を選択します。
  4. [ユーザー・プロファイル・マッピング]ダイアログ・ボックスで次のいずれかのタブを選択します。
    • [アプリからOktaユーザーへ]:属性をアプリからOktaに変更するにはこのタブを選択します。アプリにソース属性が含まれ、Oktaがターゲットです。
    • [Oktaユーザーからアプリへ]: Oktaからアプリへ属性を変更するにはこのタブを選択します。 Oktaにソース属性が含まれ、アプリがターゲットです。
  5. [属性を選択するか、式を入力]フィールドに式を入力します。
  6. 変数名の前に、対応するオブジェクトまたはプロファイルを付けます。

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>
  1. インスタンス名と変数名を見つけるには、プロファイル・エディターを使用します。

a.管理コンソールで、[ディレクトリー] > に移動します [プロファイル・エディター]

b. アプリ、ディレクトリー、またはIdPで[プロファイル]を選択し、インスタンス名と変数名をメモします。

  1. [マッピングを保存][今すぐ更新を適用]をクリックします。