SCIM 属性マッピングの作成

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：4分

    • SCIM 属性マッピングを作成し、それを ServiceNow テーブルのフィールドに対するリソースの単一のソースとして使用します。

    始める前に

    必要なロール：admin

    このタスクについて

    属性マッピングのタイプとその説明は次のとおりです。
    表 : 1. 属性マッピングのタイプ
    属性マッピングのタイプ 説明
    直接 SCIM 属性は、[データベーステーブル名] フィールドと [データベースフィールド名] フィールドを使用して入力されます。
    定数 SCIM 属性は、指定されたデフォルト値を活用して入力されます。
    スクリプト/カスタム SCIM 属性は、スクリプトの戻り値を活用して入力されます。この属性では、[スクリプトを実行] オプションを有効にする必要があります。
    注:
    • パスワード属性はサポートされていません。
    • ユーザーリソースおよびグループリソースのサンプルの属性マッピングは、ベースシステムに入っています。これを使用して自社の要件に基づいてマッピングを設定しても、新しいレコードを作成してもかまいません。

    手順

    1. 移動先 すべて > SCIM クライアント > SCIM プロバイダーリソースマッピング.
    2. 設定用に作成された SCIM リソースマッピングを選択しました。
    3. [SCIM 属性マッピング] 関連リストで [新規] をクリックします。
      SCIM プロバイダーリソースマッピング
    4. フォームのフィールドに入力します。
      表 : 2. [SCIM 属性マッピング] フォーム
      フィールド 説明
      プロバイダーリソースマッピング

      プロバイダーとリソースの組み合わせに対する属性マッピング。

      このフィールドが自動的に入力されない場合は、検索オプションを使用します。プロバイダーリソースマッピングのレコードを選択します。
      スキーマ名

      マッピングを定義する必要のある SCIM 属性のスキーマ名。

      urn:ietf:params:scim:schemas:core:2.0:User など。
      属性

      マッピングを定義する必要のある属性。userName など。
      サブ属性

      マッピングを定義する必要のあるサブ属性 (あれば)。

      たとえば、name.familyName のような複合的なタイプ属性がある場合、属性は name で、サブ属性は familyName となります。
      フィールドタイプ

      SCIM 属性のデータタイプ。このフィールドは、SCIM プロバイダーによって定義されたスキーマから自動的に入力されます。

      boolean など。
      複数値

      属性に割り当てられる複数の値。1 つの属性に、仕事用メール、自宅用メール、その他のメールなど複数の値を設定できます。

      emails など。

      このフィールドは、SCIM プロバイダーによって定義されたスキーマを使用して入力されます。
      フィルター条件

      複数の値を持つ属性には、[フィルター条件]を使用して指定できる追加情報を入力することができます。フィルター条件の選択肢は、SCIM プロバイダーによって定義されたスキーマを使用して入力されます。

      たとえば、phoneNumbers 属性には、職場、モバイル、自宅といった複数のタイプがあります。
      一意

      SCIM クライアントと SCIM プロバイダーのシステム間でリソースを一意に識別するオプション。複数値の属性を一意としてマークすることはできません。

      たとえば、ユーザーリソースでは、username 属性を一意とすることができます。
      データベーステーブル名 このフィールドを使用して、属性テーブル名を ServiceNow テーブル名にマッピングします。直接の属性マッピングを選択した場合は、このフィールドを定義する必要があります。

      たとえば、username SCIM 属性は [データベーステーブル名] フィールドの [ユーザー] フィールドにマッピングできます。
      データベースフィールド名

      [データベースフィールド名] フィールドでは、SCIM 属性を、その SCIM 属性でマッピングされる ServiceNow フィールド名にマッピングします。直接の属性マッピングを選択した場合は、このフィールドを定義する必要があります。

      たとえば、username SCIM 属性は [データベースフィールド名] フィールドの [ユーザー ID] フィールドにマッピングできます。
      デフォルト値

      SCIM プロバイダーに渡されるデフォルト値 の詳細。

      フィールドの直接の属性マッピングが null を返す場合、またはデフォルトを使用してハードコードされた値を返せる場合に使用できます。

      ハードコードされた値の場合は、データベーステーブル名とフィールド名を [なし] にする必要があります。

      たとえば、仕事用メールのプライマリサブ属性の値は trueとしてハードコードできます。
      スクリプトを実行

      スクリプトを介して属性の値をフェッチするオプション。

      このオプションは、フィルター条件を含まない複数値の属性に必要です。複合タイプの属性の場合、スクリプトは属性またはサブ属性レベルで値を指定できます。

      たとえば、グループリソースの [メンバー] 属性にはフィルター条件がありません。したがって、スクリプトオプションは [メンバー] 属性の親属性レベルで定義する必要があります。
      スクリプト

      属性値をフェッチするために使用するスクリプト。

      スクリプトの戻り値のタイプは、文字列、または文字列として変換された JSON である必要があります。

      スクリプトの出力は、その属性に対してプロバイダーが想定する適切な形式である必要があります。
    5. [送信] をクリックします。