PublicKeyCredential

Интерфейс PublicKeyCredential предоставляет информацию об паре открытый ключ / закрытый ключ, которая является идентификатором для входа в службу с использованием неподделываемой и устойчивой к утечке данных асимметричной пары ключей вместо пароля. Он наследует от Credential и является частью расширения API аутентификации веб-сайтов к API управления учетными данными.

PublicKeyCredential.authenticatorAttachment Только для чтения

Строка, которая указывает механизм, с помощью которого реализация WebAuthn подключена к аутентификатору в момент завершения вызова navigator.credentials.create() или navigator.credentials.get().

PublicKeyCredential.id Только для чтения

Наследуется от Credential и переопределяется, чтобы быть кодированием base64url PublicKeyCredential.rawId.

PublicKeyCredential.rawId Только для чтения

ArrayBuffer, содержащий глобально уникальный идентификатор для этого PublicKeyCredential. Этот идентификатор может быть использован для поиска учетных данных для будущих вызовов navigator.credentials.get().

PublicKeyCredential.response Только для чтения

Экземпляр объекта AuthenticatorResponse. Это либо объект типа AuthenticatorAttestationResponse, если PublicKeyCredential был результатом вызова navigator.credentials.create(), либо объекта типа AuthenticatorAssertionResponse, если PublicKeyCredential был результатом вызова navigator.credentials.get().

PublicKeyCredential.type Только для чтения

Наследуется от Credential. Всегда устанавливается в значение public-key для экземпляров PublicKeyCredential.

PublicKeyCredential.isConditionalMediationAvailable()

Возвращает Promise, который разрешается до true если условная медиация доступна.

PublicKeyCredential.isUserVerifyingPlatformAuthenticatorAvailable()

Возвращает Promise, который разрешается до true если аутентификатор, привязанный к платформе, способен к верификации пользователя.

PublicKeyCredential.parseCreationOptionsFromJSON()

Удобный метод для десериализации данных регистрации учетных данных, отправленных сервером, при регистрации пользователя с учетными данными.

PublicKeyCredential.parseRequestOptionsFromJSON()

Удобный метод для десериализации данных запроса учетных данных, отправленных сервером, при аутентификации зарегистрированного пользователя.

PublicKeyCredential.getClientExtensionResults()

Если были запрошены какие-либо расширения, этот метод вернёт результаты обработки этих расширений.

PublicKeyCredential.toJSON()

Удобный метод для создания строкового представления JSON объекта PublicKeyCredential для отправки на сервер при регистрации пользователя с учетными данными и аутентификации зарегистрированного пользователя.

Здесь мы используем navigator.credentials.create() для генерации новой учетной записи.

const createCredentialOptions = {
  publicKey: {
    challenge: new Uint8Array([
      21, 31, 105 /* 29 more random bytes generated by the server */,
    ]),
    rp: {
      name: "Example CORP",
      id: "login.example.com",
    },
    user: {
      id: new Uint8Array(16),
      name: "canand@example.com",
      displayName: "Carina Anand",
    },
    pubKeyCredParams: [
      {
        type: "public-key",
        alg: -7,
      },
    ],
  },
};

navigator.credentials
  .create(createCredentialOptions)
  .then((newCredentialInfo) => {
    const response = newCredentialInfo.response;
    const clientExtensionsResults =
      newCredentialInfo.getClientExtensionResults();
  })
  .catch((err) => {
    console.error(err);
  });

Здесь мы получаем существующую учетную запись из аутентификатора, используя navigator.credentials.get().

const requestCredentialOptions = {
  publicKey: {
    challenge: new Uint8Array([
      /* bytes sent from the server */
    ]),
  },
};

navigator.credentials
  .get(requestCredentialOptions)
  .then((credentialInfoAssertion) => {
    // send assertion response back to the server
    // to proceed with the control of the credential
  })
  .catch((err) => {
    console.error(err);
  });

• Родительский интерфейс Credential