Подготовка SCIM синхронизирует членство и группы вашей организации Enterprise с вашим поставщиком идентификации. В этой статье рассматривается, что синхронизируется, как запускаются синхронизации, как просмотреть синхронизацию перед применением и на что обратить внимание при повторной синхронизации.
Доступно в плане Enterprise. Инструкции по настройке см. в разделе Настройка подготовки JIT или SCIM.
Что синхронизируется
Когда вы подключаете своего поставщика идентификации (IdP) к организации Enterprise через интеграцию WorkOS, синхронизируются две вещи из вашего IdP:
Члены из вашего каталога SCIM
Группы SCIM, которые вы отправили из своего IdP в WorkOS
Членство в группе в вашей организации определяет, какие возможности могут использовать члены с пользовательскими ролями, а также лимиты расходов группы.
Автоматическая синхронизация
Ваша организация Enterprise автоматически получает изменения от вашего IdP всякий раз, когда ваш IdP отправляет обновления членов или групп (добавления, удаления или редактирования) в WorkOS.
За кулисами ваша организация опрашивает WorkOS на предмет событий обновления каждую минуту и обрабатывает их в очереди. Этот метод обеспечивает итоговую согласованность — синхронизации обычно завершаются в течение нескольких минут, но могут занять несколько часов в периоды высокой нагрузки на систему.
Ручная синхронизация
Некоторые действия запускают ручную синхронизацию немедленно, и вы также можете запустить её по требованию.
Действия, которые запускают ручную синхронизацию
Изменение режима подготовки на SCIM. Любой член, отсутствующий в каталоге вашего IdP, удаляется, и любой член в каталоге вашего IdP добавляется. Вам нужно дождаться этой начальной повторной синхронизации перед настройкой сопоставлений групп.
Включение сопоставлений групп. Обновляется полный список членов и групп. Роли и уровни мест новых и существующих членов применяются сопоставлением групп и не могут быть переопределены вручную. После сохранения нового сопоставления нажмите «Синхронизировать».
Синхронизировать сейчас, чтобы пересчитать роли и уровни мест для существующих членов.
Используя кнопку «Проверить обновления» в разделе Параметры организации > Группы.
Используя кнопку «Синхронизировать» в разделе Параметры организации > Организация и доступ в разделе Подготовка пользователей.
Примечание: Когда вы обновляете подготовку мест или роли мест через сопоставления групп, существующие члены не синхронизируются автоматически. Запустите ручную синхронизацию, чтобы применить изменения.
Когда вы отключаете сопоставления групп, вы восстанавливаете возможность вручную назначать роли членов и уровни мест. Существующие члены сохраняют свои текущие роли. Новым членам назначается роль User — измените их роль на «Custom», если вы хотите включить разрешения пользовательской роли.
Как вручную запустить синхронизацию
Вы можете запустить ручную синхронизацию из двух мест в параметрах администратора.
Со страницы групп
Перейдите в раздел Параметры организации > Группы.
Нажмите «Проверить обновления» в разделе Синхронизация SCIM:
Выберите, синхронизировать членов, группы или оба варианта.
Со страницы управления SCIM
Перейдите в раздел Параметры организации > Организация и доступ и прокрутите до раздела Подготовка пользователей.
Нажмите «Синхронизировать».
Выберите, синхронизировать членов, группы или оба варианта:
Примечание: Если вы запустите ручную синхронизацию во время обработки фоновых изменений, ваша организация примет самое последнее изменение для каждого члена или группы. Если для одного члена или группы поставлены в очередь несколько изменений, вам может потребоваться повторная синхронизация, чтобы убедиться, что всё применяется правильно.
Просмотрите синхронизацию перед её применением
Когда вы запускаете синхронизацию — путём повторной синхронизации вручную или сохранения изменения сопоставления — консоль администратора показывает предпросмотр того, что будет делать синхронизация, прежде чем что-либо применяется. Предпросмотр появляется автоматически в потоке синхронизации и показывает, сколько членов синхронизация добавит, удалит или изменит, а также насколько свежи данные каталога.
Просмотрите предпросмотр перед подтверждением. Если числа не совпадают с тем, что вы ожидаете (например, намного больше удалений, чем людей, которые фактически ушли), отмените синхронизацию и проверьте каталог вашего IdP и сопоставления групп перед продолжением.
Если синхронизация удалит необычно большую долю ваших членов, предпросмотр показывает предупреждение. Это помогает вам поймать неправильно настроенное сопоставление перед тем, как оно удалит людей, которые должны сохранить доступ. Когда вы видите это предупреждение, остановитесь и подтвердите, что изменение преднамеренно, перед продолжением.
Синхронизация членов и синхронизация групп
Когда вы запускаете ручную синхронизацию, вы можете выбрать синхронизацию членов, групп или обоих. Вот что делает каждый:
Синхронизация членов обновляет запись вашей организации о том, какие члены сопоставлены с местами, уровнями мест и ролями мест (Custom, User, Admin, Owner). Это может повлиять на доступ членов для входа в Claude.
Синхронизация групп обновляет запись вашей организации о том, какие группы SCIM существуют и кто в них входит. Членство в группе определяет, какие возможности могут использовать члены с пользовательскими ролями, а также лимиты расходов группы.
Как долго занимают ручные синхронизации
Ручные синхронизации повторно сканируют WorkOS для получения полного списка членов и групп, чтобы установить актуальную базовую линию. Ожидайте примерно одну минуту на 100 членов в вашей организации — так что организация с 1000 членами займёт около 10 минут для полной повторной синхронизации.
Проверка статуса синхронизации
Чтобы проверить, являются ли членство и группы вашей организации актуальными, у вас есть два варианта:
Экспортируйте список членов. Перейдите в раздел Параметры организации > Члены и нажмите «Экспортировать CSV», чтобы загрузить текущее представление вашего членства.
Просмотрите запись интеграции WorkOS. Перейдите в раздел Параметры организации > Организация и доступ и нажмите «Управление SCIM», чтобы увидеть, что WorkOS в настоящее время содержит для вашей организации.
Риски, на которые следует обратить внимание при повторной синхронизации
Перед запуском ручной повторной синхронизации помните об этом:
Изменение режима подготовки на SCIM удаляет членов, отсутствующих в каталоге вашего IdP. Подтвердите, что все существующие члены находятся в каталоге вашего IdP перед изменением режима подготовки.
Обновление адреса электронной почты члена создаёт новую запись члена. Член со старым адресом электронной почты удаляется, и создаётся новый член с новым адресом электронной почты.
Повторная синхронизация каскадирует на дочерние организации. Если у вас есть несколько организаций с подготовкой SCIM под одной и той же родительской организацией, повторная синхронизация одной запускает повторную синхронизацию в других. Это включает организации-песочницы, использующие одну и ту же родительскую организацию.
Неполные сопоставления групп удаляют членов из организации. При включении сопоставления групп для SCIM завершите назначение всех групп перед сохранением. Любой член, не включённый в сопоставление группы ролей, удаляется из организации. Если вы включите сопоставление уровня мест, любой член, не входящий в сопоставление группы уровня мест, также удаляется.