יצירת מאפיינים בהתאמה אישית באמצעות סכימת המשתמשים

בחלק מאפליקציות ה-SAML שהוגדרו מראש צריך להוסיף מאפיין בהתאמה אישית למשתמש. אתם יכולים להשתמש בסכימה כדי לעדכן את פרופיל המשתמש במאפיינים שיצרתם. הדוגמאות הבאות מותאמות לאפליקציית הענן של Amazon Web Services. הם מכילים הפניות ל-Role ARN ול-Provider ARN, שהם ספציפיים ל-Amazon Web Services.

יצירת סכימה בהתאמה אישית

1. פותחים את דף ההוספה של הסכימה.
2. מזינים את הערך "my_customer" בשדה customerId.

3. באזור Request body, מדביקים את הטקסט הבא:

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

   הערות:

   • בדרך כלל, schemaName יכול להיות כל ערך טקסט, אבל כשמגדירים סכימה מותאמת אישית לשימוש עם אפליקציית הענן של Amazon Web Services, צריך להשתמש בערך הספציפי "SSO".
   • אם רוצים להשתמש ביותר מתפקיד אחד, מגדירים את multiValued כ-true.

4. לוחצים על Execute.

5. מאשרים את הגישה ל-Directory API.

   אמורה להופיע התגובה ‎200 OK, ויוצג הפלט של הבקשה.

הוספת נתונים בהתאמה אישית לפרופיל משתמש

1. פותחים את דף עדכון המשתמש.
2. בשדה userKey, מזינים את כתובת האימייל של המשתמש ב-Google שאת הפרופיל שלו רוצים לעדכן. (אפשר גם להשתמש בכתובת אימייל חלופית או במזהה משתמש ייחודי. לפרטים, אפשר לעיין במסמכי התיעוד של Directory API.

3. באזור Request body, מדביקים את הטקסט הבא ומחליפים את הערכים <role ARN> ו-<provider ARN> בערכים המתאימים, שזמינים במאמר על אפליקציית הענן של Amazon Web Services.

   הערה: אם השדה המותאם אישית type מוגדר לערך custom, צריך להשתמש גם בפרמטר customType ולהגדיר לו ערך כדי למנוע החזרת שגיאה.

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

4. (אופציונלי) כדי לתת גישה ליותר מתפקיד אחד, מוסיפים ערכים בתוך {}, ומפרידים ביניהם באמצעות פסיק ",".

   • אפשר להגדיר כמה תפקידים רק אם מגדירים את multiValued כ-true כשיוצרים את הסכימה.
   • אם יש כמה תפקידים זמינים, המשתמש יתבקש לבחור באיזה מהם הוא רוצה להשתמש.

   בדוגמה הזו, שני התפקידים הם SSO ו-tester:

   {
     "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. לוחצים על Execute.

6. מאשרים את הגישה ל-Directory API.

   אמורה להופיע התגובה ‎200 OK, ופרופיל המשתמש מתעדכן בנתונים בהתאמה אישית.