式で属性を変更する

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

式を使用すると、属性の連結、文字列の操作、データ型の変換などを行うことができます。OktaはSpring Expression Language（SpEL）関数のサブセットをサポートします。サポートされる関数すべての一覧については、Okta Expression Languageを参照してください。すべての関数はUDマッピングで動作します。

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

式はアプリ間でデータの整合性や形式を維持するのに便利です。たとえば、メールのプレフィックスをユーザー名に使用したり、メールのサフィックスを一括置換したり、既存の属性の組み合わせに基づいて属性を自動入力したりすることができます（例：displayName=lastName,firstName）。

  1. Admin Consoleでディレクトリ（Directory） > プロファイルエディター に進みます。
  2. 任意：フィルター（Filters）リストから Okta 、アプリ（Apps）、ディレクトリ（Directories）、またはIDプロバイダー（Identity Providers）を選択し、アプリのリストをフィルタリングします。
  3. アプリケーション、ディレクトリ、またはIDプロバイダーのマッピング（Mappings）をクリックし、リストが表示されたらユーザーマッピングを構成（Configure User mappings）を選択します。
  4. ユーザープロファイルマッピング（User Profile Mappings）ダイアログボックスから、以下のタブのうち1つを選択します。
    • アプリからOktaユーザー（App to Okta User）：アプリからOktaへ属性を変更する場合はこのタブを選択します。アプリにはソース属性が含まれ、Oktaがターゲットです。
    • Oktaユーザーからアプリへ（Okta User to App）：Oktaからアプリへ属性のフローを変更するには、このタブを選択します。Oktaにはソース属性が含まれ、アプリがターゲットです。
  5. 属性を選択するか、式を入力（Choose an attribute or enter an expression）フィールドに式を入力します。
  6. 変数名の前に、対応するオブジェクトやプロファイルを付けます。

    ソース（source）は左側のオブジェクトを参照します。

    • Oktaからアプリへ、またはアプリからOktaへのマッピングのいずれでも使用できます。
    • 例（Example）：source.firstName

    ユーザー（user）はOktaユーザープロファイルを参照します。

    • Oktaからアプリへのマッピングでのみ使用可能です。
    • 例（Example）：user.firstName

    アプリユーザー（appUser」（暗黙的な参照）は（Oktaユーザープロファイルではなく）コンテキスト内アプリを参照します。

    • アプリからOktaへのマッピングでのみ使用可能です。
    • 例（Example）：appUser.firstName

    アプリユーザー名（appUserName）（明示的な参照）は特定のアプリを名前で参照します。

    • Oktaからアプリへ、またはアプリからOktaへのマッピングのいずれでも使用できます。
    • マッピングの外側でアプリを参照する際に使用されます。
    • 例（Example）： google.nameGivenName
    • アプリの複数のインスタンスが構成されている場合、最初のインスタンスに続く追加のアプリのユーザープロファイルには、アンダースコアとランダム文字列が付加されます。
    • 例（Example）： google, google_<random string 1>, google_<random string 2>
  7. インスタンス名や変数名を検索するには、プロファイルエディターを使用します。
    1. Admin Consoleでディレクトリ（Directory） > プロファイルエディター に進みます。
    2. アプリ、ディレクトリ、またはIdPのプロファイル（Profile）を選択し、インスタンス名と変数名を書き留めます。
  8. マッピングを保存（Save Mappings）と今すぐ更新を適用（Apply updates now）をクリックします。