Настройка Airtable для автоматического предоставления пользователей с использованием Microsoft Entra ID

В этой статье описаны шаги, которые необходимо выполнить как в Airtable, так и в Microsoft Entra ID для настройки автоматической подготовки пользователей. При настройке Microsoft Entra ID автоматически создаёт и удаляет пользователей и группы в Airtable с помощью службы подготовки Microsoft Entra. Важные сведения о том, что делает эта служба, как она работает, и ответы на часто задаваемые вопросы см. в разделе Автоматизация предоставления и удаления пользователей в приложениях SaaS с Microsoft Entra ID.

Поддерживаемые возможности

Необходимые условия

В сценарии, описанном в этой статье, предполагается, что у вас уже есть следующие предварительные требования:

• Клиент Microsoft Entra.
• Одна из следующих ролей: администратор приложения Application, Cloud Application Administrator или Application Owner.
• Клиент Airtable.
• Учетная запись пользователя в Airtable с разрешениями администратора.

Шаг 1. Спланируйте развертывание обеспечения

• Узнайте, как работает служба снабжения.
• Определите, кто находится в круге лиц, подпадающих под обеспечение.
• Определите, какие данные следует сопоставить между Microsoft Entra ID и Airtable.

Шаг 2. Создайте личный токен доступа Airtable для авторизации подготовки с помощью Microsoft Entra ID.

1. Войдите в Центр разработчиков Airtable в качестве администратора, а затем перейдите к разделу https://airtable.com/create/tokens.

2. Выберите "Персональные токены доступа" в левой панели навигации.

   

3. Создайте новый токен с запоминающимся именем, например AzureAdScimProvisioning.

4. Добавьте область действия "enterprise.scim.usersAndGroups:manage".

   

5. Выберите "Создать токен" и скопируйте полученный маркер для использования на шаге 5 ниже.

Шаг 3. Добавление Airtable из коллекции приложений Microsoft Entra

Добавьте Airtable из коллекции приложений Microsoft Entra, чтобы начать управление подготовкой пользователей в Airtable. Если вы ранее настроили Airtable для единого входа, можно использовать то же приложение. Однако рекомендуется создать отдельное приложение при первоначальном тестировании интеграции. Узнайте больше о добавлении приложения из галереи здесь.

Шаг 4. Определите, кто входит в область обеспечения ресурсами.

Служба подготовки Microsoft Entra позволяет определить, кто подготовлен на основе назначения приложению или на основе атрибутов пользователя или группы. Если вы решите настроить, кто будет предоставлен вашему приложению на основе назначения, вы можете использовать шаги для назначения пользователей и групп приложению. Если вы решаете, кого предоставлять доступ, основываясь исключительно на атрибутах пользователя или группы, можно использовать фильтр области охвата.

• Начните с малого. Протестируйте с небольшим набором пользователей и групп перед развертыванием для всех пользователей. Если для профилирования задано назначение пользователей и групп, вы можете управлять этим, назначив одному или двум пользователям или группам доступ к приложению. Если область задана для всех пользователей и групп, можно указать фильтр области на основе атрибутов.

• Если вам нужны дополнительные роли, можно обновить манифест приложения , чтобы добавить новые роли.

Шаг 5. Настройка автоматической подготовки пользователей в Airtable

В этом разделе представлены пошаговые инструкции по настройке службы провизирования Microsoft Entra для создания, обновления или отключения пользователей и/или групп в TestApp на основе назначений пользователей и/или групп в Microsoft Entra ID.

Чтобы настроить автоматическую подготовку пользователей для Airtable в Microsoft Entra ID:

1. Войдите в центр администрирования Microsoft Entra как минимум в роли администратора облачных приложений.

2. Перейдите к Entra ID>приложениям для предприятий

   

3. В списке приложений выберите Airtable.

   

4. Выберите вкладку Подготовка.

   

5. Задать + Новая конфигурация.

   

6. В поле URL арендатора введите URL арендатора Airtable и секретный токен. Выберите Test Connection, чтобы убедиться, что Microsoft Entra ID может подключаться к Airtable. Если подключение завершается ошибкой, убедитесь, что учетная запись Airtable имеет необходимые разрешения администратора и повторите попытку.

   

7. Нажмите кнопку "Создать", чтобы создать конфигурацию.

8. Выберите "Свойства " на странице обзора .

9. Выберите карандаш, чтобы изменить свойства. Включите уведомления и предоставьте сообщение электронной почты для получения сообщений карантина. Включение предотвращения случайных удалений. Выберите Применить, чтобы сохранить изменения.

   

10. Выберите сопоставление атрибутов на левой панели и выберите пользователей.

11. Просмотрите атрибуты пользователя, синхронизированные из Microsoft Entra ID в Airtable, в разделе Attribute-Mapping. Атрибуты, выбранные в качестве свойств сопоставления , используются для сопоставления учетных записей пользователей в Airtable для операций обновления. Если вы решили изменить соответствующий целевой атрибут, необходимо убедиться, что API Airtable поддерживает фильтрацию пользователей на основе этого атрибута. Нажмите кнопку Сохранить, чтобы зафиксировать все изменения.

    Атрибут	Тип	Поддерживается для фильтрации	Требуется для Airtable
    userName	Струна	✓	✓
    активный	Булев
    отображаемоеИмя	Струна
    название	Струна
    emails[тип eq "рабочий"].value	Струна
    предпочитаемый язык	Струна
    имя.личноеИмя	Струна		✓
    name.фамилия	Струна		✓
    форматированное имя	Струна
    адреса[тип == "работа"].отформатирован	Струна
    адреса[тип eq "рабочий"].streetAddress	Струна
    addresses[type eq "работа"].местоположение	Струна
    адреса[тип = "работа"].регион	Струна
    адреса[тип равно "работа"].почтовыйКод	Струна
    адреса[тип равен "работа"].страна	Струна
    Номера телефонов [тип равен "работа"]. значение	Струна
    phoneNumbers[type eq "мобильный"].value	Струна
    phoneNumbers[type eq "факс"].value	Струна
    внешнийИдентификатор	Струна
    прозвище	Струна
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:номерСотрудника	Струна
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:Пользователь:департамент	Струна
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:manager.value	Струна
    адреса[тип eq "дом"].форматированный	Струна
    Неприменимо, поскольку текст, возможно, следует оставить в исходной форме из-за отсутствия контекста, указывающего на необходимость перевода терминов, используемых в коде или программировании.	Струна
    адреса[тип eq "домашний"].местоположение	Струна
    адреса[type eq "home"].регион	Струна
    addresses[type eq "дом"].postalCode	Струна
    addresses[тип равно "домашний"].страна	Струна
    адреса[тип eq "прочее"].форматированный	Струна
    адреса[тип eq "другой"].адресУлицы	Струна
    адреса[тип равен "другое"].местоположение	Струна
    addresses[type eq "other"].регион	Струна
    адреса[тип eq "другой"].почтовыйКод	Струна
    адреса[type eq "other"].страна	Струна
    emails[type eq "домашний"].value	Струна
    emails[type eq "другое"].value	Струна
    место действия	Струна
    имя.почетныйПрефикс	Струна
    имя.почетныйСуффикс	Струна
    имя.второеИмя	Струна
    name.фамилия	Струна
    phoneNumbers[type eq "дом"].value	Струна
    phoneNumbers[тип eq "другое"].значение	Струна
    phoneNumbers[type eq "пейджер"].value	Струна
    часовой пояс	Струна
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:центрЗатрат	Струна
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:подразделение	Струна
    urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:организация	Струна
    тип пользователя	Струна

12. Выберите Группы.

13. Просмотрите атрибуты группы, синхронизированные из Microsoft Entra ID в Airtable, в разделе Attribute-Mapping. Атрибуты, выбранные в качестве свойств сопоставления , используются для сопоставления групп в Airtable для операций обновления. Нажмите кнопку Сохранить, чтобы зафиксировать все изменения.

    Атрибут	Тип	Поддерживается для фильтрации	Требуется для Airtable
    отображаемоеИмя	Струна	✓	✓
    члены	Ссылка

14. Чтобы настроить фильтры области, ознакомьтесь со следующими инструкциями, приведенными в статье о фильтре области.

15. Используйте динамическое предоставление ресурсов для проверки синхронизации с несколькими пользователями, прежде чем внедрить это более широко в вашей организации.

16. Когда вы будете готовы к подготовке, выберите "Начать подготовку " на странице обзора .

Шаг 6. Мониторинг развертывания

После настройки подготовки используйте следующие ресурсы для мониторинга развертывания:

1. Используйте журналы подготовки для определения успешной или неудачной подготовки пользователей.
2. Проверьте индикатор прогресса, чтобы увидеть состояние цикла подготовки и узнать, насколько близко оно к завершению.
3. Если конфигурация развертывания находится в неисправном состоянии, приложение переходит в карантин. Узнайте больше о состоянии карантина из статьи о состоянии карантина подготовки приложений .

Дополнительные ресурсы

• Управление подготовкой учетных записей пользователей для корпоративных приложений
• Что такое доступ к приложению и единый вход с Microsoft Entra ID?

Связанное содержимое

• Узнайте, как просматривать журналы и получать отчеты о деятельности по обеспечению ресурсов