---
pkg: '@nocobase/plugin-auth-saml'
---

# Аутентификация: SAML 2.0

## Введение

Плагин Аутентификация: SAML 2.0 соответствует стандарту протокола SAML 2.0 (Security Assertion Markup Language 2.0), позволяя пользователям входить в NocoBase, используя учетные записи, предоставленные сторонними поставщиками услуг аутентификации (IdP).

## Активация плагина

![](https://static-docs.nocobase.com/6a12f3d8073c47532a4f8aac900e4296.png)

## Добавление SAML-аутентификации

Перейдите на страницу управления плагинами пользовательской аутентификации.

![](https://static-docs.nocobase.com/202411130004459.png)

Добавить - SAML

![](https://static-docs.nocobase.com/5076fe56086b7799be308bbaf7c4425d.png)

## Конфигурация

![](https://static-docs.nocobase.com/976b66e589973c322d81dcddd22c6146.png)

- SSO URL — предоставляется IdP, используется для единого входа (Single Sign-On).
- Открытый ключ (Public Certificate) — предоставляется IdP.
- ID сущности (IdP Issuer) — необязательно, предоставляется IdP.
- http — если ваше приложение NocoBase использует протокол HTTP, установите этот флажок.
- Использовать это поле для привязки пользователя — поле, используемое для сопоставления и привязки к существующим пользователям. Можно выбрать электронную почту или имя пользователя, по умолчанию — электронная почта. Информация о пользователе, передаваемая IdP, должна содержать поле `email` или `username`.
- Автоматическая регистрация, если пользователь не существует — следует ли автоматически создавать нового пользователя, если не найден соответствующий существующий пользователь.
- Использование — `SP Issuer / EntityID` и `ACS URL` используются для копирования и заполнения соответствующих полей в конфигурации IdP.

## Сопоставление полей

Сопоставление полей необходимо настроить на платформе конфигурации IdP. Вы можете ознакомиться с [примером](./examples/google.md).

В NocoBase доступны следующие поля для сопоставления:

- email (обязательно)
- phone (действительно только для платформ, поддерживающих `phone` в своем scope, например, Alibaba Cloud, Feishu)
- nickname
- username
- firstName
- lastName

`nameID` передается протоколом SAML и не требует сопоставления; он будет сохранен как уникальный идентификатор пользователя.
Приоритет правил для нового ника пользователя: `nickname` > `firstName lastName` > `username` > `nameID`
В настоящее время сопоставление организаций и ролей пользователей не поддерживается.

## Вход в систему

Перейдите на страницу входа и нажмите кнопку под формой входа, чтобы инициировать стороннюю аутентификацию.

![](https://static-docs.nocobase.com/74963865c9d36a294948e6adeb5b24bc.png)