Как создавать настраиваемые атрибуты с помощью схемы пользователя

Для некоторых предварительно настроенных SAML-приложений требуется добавить настраиваемый атрибут пользователя. Вы можете использовать схему, чтобы обновить профиль пользователя с помощью созданных вами атрибутов. Примеры ниже относятся к облачному приложению Amazon Web Services. Они содержат ссылки на ARN роли и 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".
   • Если вы хотите использовать более одной роли, установите значение true в поле multiValued (многозначный).

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, а профиль пользователя должен быть обновлен с учетом специальных данных.