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

マッピング内の式を使用して、属性を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. [マッピングを保存]と[今すぐ更新を適用]をクリックします。