SCIMおよびGenesys Cloudフィールドマッピング

 メモ:   この記事は、Genesys Cloud SCIM(アイデンティティ管理)に適用されます。

この表は、Genesys Cloud SCIM(アイデンティティ管理)がGenesys CloudフィールドにマップするSCIMフィールドを示しています。 これらのSCIMフィールドは、その後、サード内のフィールドにマッピングされている相手のアプリケーション。 

複数値属性フィールド

SCIM と Genesys Cloud フィールド マッピング テーブルには、各マッピングに必要な必須サブ属性のみがリストされます。追加のサブ属性は、 RFC 7643 セクション 2.4表には必須のものだけが記載されています。複数値属性のサブ属性の包括的なリストについては、SCIM 仕様を参照してください。

複数値属性 SCIM フィールドは次の形式に従います。

<attribute>.[].<subattribute>

どこ<attribute>多値属性リスト内の要素を参照し、<subattribute>マッピングに必要な各要素の特定のサブ属性を示します。

この形式の一般的な JSON スキーマは次のとおりです。

{
   "$schema": "http://json-schema.org/draft-04/schema#",
   "type": "object",
   "required": ["<attribute>"],
   "properties": {
     "attribute": {
       "type": "array",
       "items": [
         {
           "type": "object",
           "additionalProperties":true,
           "required": ["<sub_attribute>"],
           "properties": {
             "sub_attribute": {
               "type": "string"
             }
           }
        }
      ]
    }
  }
}

いずれかのオンライン JSON スキーマ バリデーターを使用して、テーブル内のマッピング内の複数値属性参照の JSON スキーマを検証します。例えば、roles.[].valueマッピング、rolesを表す<attribute>そしてvalueを表す<subattribute>

 JSON要素はroles.[].valueしたがって、マッピングは次のように検証されます。

 {
   "roles": [
     {
       "other": "this is allowed but doesn’t contribute to the roles mapping",
       "value": "Role1"
     },
     {
       "value": "Role2"
     }
   ]
 }

複数値属性をフィルタリングする

一部の SCIM 複数値属性では、特定のリスト項目を Genesys Cloud フィールドにマッピングする必要があります。このような場合、リストのフィルター フィールドとして追加のサブ属性が指定されます。このフィルター フィールドは、その要素の必須サブ属性になります。

例えば、phoneNumbers[type eq "home"].value分野、phoneNumbersを表す<attribute>valueを表す<subattribute>、 そしてtype余分な<subattribute>フィルタリングに使用されます。フィルターを必要としない標準マッピングとは異なり、typeサブ属性は、リスト内の正しい電話番号エントリを識別してバインドするために使用されます。追加のサブ属性タイプでは、マッピングに使用される JSON 要素は次のように検証されます。

 {
   "phoneNumbers": [
     {
       "type": "home",
       "value": "+13175551234"
     },
     {
       "type": "mobile",
       "value": "+13175554321" 
     }
   ]
 }