API управления учётными данными
Безопасный контекст: Эта функция доступна только в безопасных контекстах (HTTPS), в некоторых или во всех поддерживающих браузерах.
API управления учётными данными позволяет веб-сайту создавать, хранить и извлекать учётные данные. Учётные данные — это элемент, который позволяет системе принять решение об аутентификации, например, о том, следует ли войти пользователя в учётную запись. Можно рассматривать это как доказательство, которое пользователь предоставляет веб-сайту, чтобы доказать свою личность.
Концепции и использование
Основной интерфейс — CredentialsContainer, к которому обращаются через свойство navigator.credentials и который предоставляет три основные функции:
-
create(): создание нового учётного данных. -
store(): хранение нового учётного данных локально. -
get(): извлечение учётных данных, которые затем могут быть использованы для входа пользователя.
API поддерживает четыре разных типа учётных данных, все из которых представлены как подклассы Credential:
| Тип | Интерфейс |
|---|---|
| Пароль | PasswordCredential |
| Федеративная идентификация |
IdentityCredential, FederatedCredential (устаревший) |
| Одноразовый пароль (OTP) | OTPCredential |
| Веб-аутентификация | PublicKeyCredential |
На странице руководства Типы учётных данных представлен обзор различных типов учётных данных и способов их использования.
Интерфейсы
Credential-
Предоставляет информацию об объекте в качестве предпосылки для принятия решения о доверии.
CredentialsContainer-
Предоставляет методы для запроса учётных данных и уведомления пользователя об интересных событиях, таких как успешный вход или выход из системы. К этому интерфейсу можно получить доступ из
navigator.credentials. FederatedCredential-
Предоставляет информацию об учётных данных от поставщика федеративной идентификации, который является субъектом, которому доверяет веб-сайт для корректной аутентификации пользователя и который предоставляет API для этой цели. OpenID Connect является примером такой платформы.
PasswordCredential-
Предоставляет информацию об имени пользователя и пароле.
Расширения других интерфейсов
-
Возвращает интерфейс
CredentialsContainer, который предоставляет методы для запроса учётных данных и уведомления пользователя об интересных событиях, таких как успешный вход или выход.
Спецификации
| Спецификация |
|---|
| Управление учётными данными уровня 1 |
Совместимость с браузерами
| Рабочий стол | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | WebView Android | |
PasswordCredential |
51 | 79 | Нет | 38 | Нет | 51 | Нет | 41 | Нет | 5.0 | 51 |
Credential_Management_API |
51 | 79 | Нет | 38 | Нет | 51 | Нет | 41 | Нет | 5.0 | 51 |
iconURL |
51 | 79 | Нет | 38 | Нет | 51 | Нет | 41 | Нет | 5.0 | 51 |
name |
51 | 79 | Нет | 38 | Нет | 51 | Нет | 41 | Нет | 5.0 | 51 |
password |
60 | 79 | Нет | 47 | Нет | 60 | Нет | 44 | Нет | 8.0 | 60 |
| Рабочий стол | Мобильные устройства | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | WebView Android | |
FederatedCredential |
51 | 79 | Нет | 38 | Нет | 51 | Нет | 41 | Нет | 5.0 | 51 |
Credential_Management_API |
51 | 79 | Нет | 38 | Нет | 51 | Нет | 41 | Нет | 5.0 | 51 |
iconURL |
51 | 79 | Нет | 38 | Нет | 51 | Нет | 41 | Нет | 6.0 | 51 |
name |
51 | 79 | Нет | 38 | Нет | 51 | Нет | 41 | Нет | 6.0 | 51 |
protocol |
51 | 79 | Нет | 38 | Нет | 51 | Нет | 41 | Нет | 5.0 | 51 |
provider |
51 | 79 | Нет | 38 | Нет | 51 | Нет | 41 | Нет | 5.0 | 51 |
| Рабочий стол | Мобильный телефон | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на IOS | Samsung Internet | WebView Android | |
Credential_Management_API |
51 | 18 | 60 | 38 | 13 | 51 | 60 | 41 | 13 | 5.0 | 51 |
create |
60 | 18 | 60 | 47 | 13 | 60 | 60 | 44 | 13 | 8.0 | 60 |
get |
51 | 18 | 60 | 38 | 13 | 51 | 60 | 41 | 13 | 5.0 | 51 |
preventSilentAccess |
6051–60 | 18 | 60 | 4738–47 | 1713–17Этот метод существует, но всегда отклоняется с исключениемNotSupportedError. |
6051–60 | 60 | 4441–44 | 1713–17Этот метод существует, но всегда отклоняется с исключениемNotSupportedError. |
8.05.0–8.0 | 6051–60 |
store |
51 | 79 | 60 | 38 | 13 | 51 | 60 | 41 | 13 | 5.0 | 51 |
| Рабочий стол | Мобильный телефон | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox для Android | Opera Android | Safari на IOS | Samsung Internet | WebView Android | |
Credential_Management_API |
51 | 18 | 60 | 38 | 13 | 51 | 60 | 41 | 13 | 5.0 | 51 |
id |
51 | 18 | 60 | 38 | 13 | 51 | 60 | 41 | 13 | 5.0 | 51 |
isConditionalMediationAvailable_static |
Нет | Нет | Нет | Нет | 16 | Нет | Нет | Нет | 16 | Нет | Нет |
type |
51 | 18 | 60 | 38 | 13 | 51 | 60 | 41 | 13 | 5.0 | 51 |
api.Credential
Таблицы BCD загружаются только в браузере
api.CredentialsContainer
Таблицы BCD загружаются только в браузере
api.FederatedCredential
Таблицы BCD загружаются только в браузере
api.PasswordCredential
Таблицы BCD загружаются только в браузере
См. также
© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Credential_Management_API