IdentityCredentialRequestOptions

Словарь IdentityCredentialRequestOptions представляет собой объект, переданный в CredentialsContainer.get() в качестве значения параметра identity.

Он используется для запроса IdentityCredential, предоставленного федеративным поставщиком удостоверений, который поддерживает API федерального управления удостоверениями (FedCM).

context Необязательно

Строка, определяющая контекст, в котором пользователь проходит аутентификацию с помощью FedCM. Браузер использует это значение для изменения текста в своём пользовательском интерфейсе FedCM, чтобы лучше соответствовать контексту. Возможные значения:

"continue"

Подходит для ситуаций, когда пользователь выбирает идентификатор для продолжения на следующей странице потока, требующего входа в систему. Браузеры предоставят строку текста, похожую на:

Продолжить на <page-origin> с <IdP>

"signin"

Подходит для общих ситуаций, когда пользователь входит в систему с учетной записью IdP, которую он уже использовал на этом источнике. Браузеры предоставят строку текста, похожую на:

Войти в систему на <page-origin> с <IdP>

"signup"

Вариант для ситуаций, когда пользователь входит в систему на источник с новой учетной записью IdP, которую он раньше не использовал здесь. Браузеры предоставят строку текста, похожую на:

Зарегистрироваться на <page-origin> с <IdP>

"use"

Подходит для ситуаций, когда выполняется другое действие, например, проверка платежа. Браузеры предоставят строку текста, похожую на:

Использовать <page-origin> с <IdP>

Значение по умолчанию — "signin".

providers

Массив, содержащий единственный объект, определяющий детали IdP, который будет использоваться для входа в систему. Этот объект может содержать следующие свойства:

configURL

Строка, определяющая URL-адрес файла конфигурации IdP. Подробнее см. Предоставление файла конфигурации.

clientId

Строка, определяющая идентификатор клиента RP. Эта информация выдаётся IdP RP в отдельном процессе, специфичном для IdP.

loginHint Необязательно

Строка, предоставляющая подсказку о вариантах учетной записи, которые браузер должен предоставить пользователю для входа в систему. Это полезно в тех случаях, когда пользователь уже вошел в систему, а сайт просит его повторно пройти аутентификацию. В противном случае процесс повторной аутентификации может быть запутан, когда у пользователя несколько учетных записей, и он не может вспомнить, какую из них использовал для входа в систему ранее. Значение свойства loginHint можно получить из предыдущего входа пользователя, и оно сопоставляется со значениями login_hints, предоставленными IdP в массиве информации о пользователе, возвращённой из конечной точки списка учетных записей IdP.

nonce Необязательно

Случайная строка, которая может быть включена для обеспечения того, что ответ выдан конкретно для этого запроса и предотвращения атак с повторным использованием.

Примечание: В настоящее время FedCM позволяет вызывать API только с одним IdP, т. е. длина массива providers должна быть равна 1. Несколько IdP должны поддерживаться с помощью разных вызовов get().