إنشاء سمات مخصّصة باستخدام مخطط المستخدم

تتطلب بعض تطبيقات SAML التي تم ضبطها مسبقًا إضافة سمة مخصّصة إلى مستخدم. يمكنك استخدام المخطط لتعديل ملف المستخدم الشخصي باستخدام هذه السمات التي تنشئها. الأمثلة أدناه مخصّصة لتطبيق السحابة الإلكترونية Amazon Web Services. وهي تحتوي على مراجع لرقم ARN للدور ورقم ARN للموفِّر، وهما محددان لخدمات Amazon Web Services.

إنشاء مخطط مخصّص

1. افتح صفحة إدراج المخطط.
2. أدخِل "my_customer" في حقل customerId.

3. في حقل نص الطلب، الصِق النص التالي:

   {
     "fields":
     [
       {
         "fieldName": "role",
         "fieldType": "STRING",
         "readAccessType": "ADMINS_AND_SELF",
         "multiValued": true,
         "displayName": "role"
       }
     ],
     "schemaName": "SSO"
     "displayName": "Amazon"
   }
   

   ملاحظات:

   • على الرغم من أنّ schemaName يمكن أن يكون عادةً أي قيمة نصية، فإنّ القيمة المحدّدة "SSO" مطلوبة عند ضبط مخطط مخصّص للاستخدام مع تطبيق Amazon Web Services السحابي.
   • إذا أردت استخدام أكثر من دور واحد، اضبط multiValued على "صحيح".

4. انقر على تنفيذ.

5. امنح الإذن بالوصول إلى واجهة برمجة التطبيقات Directory API.

   من المفترض أن يظهر لك الردّ 200 OK، ويتم عرض ناتج الطلب.

إضافة بيانات مخصّصة إلى ملف مستخدم شخصي

1. افتح صفحة تعديل بيانات المستخدم.
2. ضمن userKey، أدخِل عنوان البريد الإلكتروني لمستخدم Google الذي تريد تعديل ملفه الشخصي. (يمكنك أيضًا استخدام عنوان بديل للبريد الإلكتروني أو رقم تعريف مستخدم فريد. لمزيد من التفاصيل، يُرجى الاطّلاع على مستندات Directory API.

3. في حقل نص الطلب، الصِق النص التالي، مع استبدال <role ARN> و<provider ARN> بالقيم المناسبة، والمتوفّرة في مقالة تطبيق السحابة الإلكترونية Amazon Web Services.

   ملاحظة: إذا تم ضبط الحقل المخصّص type على custom، يجب أيضًا استخدام المَعلمة customType وضبطها على قيمة لتجنُّب ظهور خطأ.

   {
     "customSchemas":
     {
       "SSO":
       {
         "role": [
         {
          "value": "<role ARN>,<provider ARN>",
          "type": "custom"
          "customType": "SSO"
   
         }
        ]
       }
     }
   }
   

4. (اختياري) لمنح إذن الوصول إلى أكثر من دور واحد، أضِف القيم ضمن {}، مع الفصل بينها بفاصلة ",".

   • يمكنك إعداد أدوار متعددة فقط في حال ضبط multiValued على "صحيح" عند إنشاء المخطط.
   • عند توفّر أدوار متعددة، سيُطلب من المستخدم اختيار الدور الذي يريد استخدامه.

   في هذا المثال، الدوران هما الدخول المُوحَّد (SSO) والمختبِر:

   {
     "customSchemas":
     {
       "SSO":
       {
         "role": [
         {
          "value": "arn:aws:iam::038047464115:role/SSO,arn:aws:iam::038047464115:saml-provider/Google",
          "type": "custom"
          "customType": "SSO"
         },
         {
          "value": "arn:aws:iam::038047464115:role/tester,arn:aws:iam::038047464115:saml-provider/Google",
          "type": "custom"
          "customType": "tester"
         }
        ]
       }
     }
   }
   

5. انقر على تنفيذ.

6. يُرجى السماح بالوصول إلى Directory API.

   من المفترض أن يظهر لك الردّ 200 OK، ويتم تعديل ملف المستخدم الشخصي بالبيانات المخصّصة.