Web/API/Web Authentication API

From Get docs

Secure contextThis feature is available only in secure contexts (HTTPS), in some or all supporting browsers.


The Web Authentication API is an extension of the Credential Management API that enables strong authentication with public key cryptography, enabling passwordless authentication and/or secure second-factor authentication without SMS texts.

Web authentication concepts and usage

The Web Authentication API (also referred to as WebAuthn) uses asymmetric (public-key) cryptography instead of passwords or SMS texts for registering, authenticating, and second-factor authentication with websites. This has some benefits:

  • Protection against phising: An attacker who creates a fake login website can't login as the user because the signature changes with the origin of the website.
  • Reduced impact of data breaches: Developers don't need to hash the public key, and if an attacker gets access to the public key used to verify the authentication, it can't authenticate because it needs the private key.
  • Invulnerable to password attacks: Some users might reuse passwords, and an attacker may obtain the user's password for another website (e.g. via a data breach). Also, text passwords are much easier to brute-force than a digital signature.

Many websites already have pages that allow users to register new accounts or sign in to an existing account, and the Web Authentication API acts as a replacement or supplement to those on those existing webpages. Similar to the other forms of the Credential Management API, the Web Authentication API has two basic methods that correspond to register and login:

  • navigator.credentials.create() - when used with the publicKey option, creates new credentials, either for registering a new account or for associating a new asymmetric key pair credentials with an existing account.
  • navigator.credentials.get() - when used with the publicKey option, uses an existing set of credentials to authenticate to a service, either logging a user in or as a form of second-factor authentication.

Please note: Both create() and get() require a secure context (i.e. the server is connected by HTTPS or is the localhost), and will not be available for use if the browser is not operating in a secure context.


In their most basic forms, both create() and get() receive a very large random number called the "challenge" from the server and they return the challenge signed by the private key back to the server. This proves to the server that a user is in possession of the private key required for authentication without revealing any secrets over the network.

In order to understand how the create() and get() methods fit into the bigger picture, it is important to understand that they sit between two components that are outside the browser:

  1. Server - the Web Authentication API is intended to register new credentials on a server (also referred to as a service or a relying party) and later use those same credentials on that same server to authenticate a user.
  2. Authenticator - the credentials are created and stored in a device called an authenticator. This is a new concept in authentication: when authenticating using passwords, the password is stored in a user's brain and no other device is needed; when authenticating using web authentication, the password is replaced with a key pair that is stored in an authenticator. The authenticator may be embedded into the user agent, into an operating system, such as Windows Hello, or it may be a physical token, such as a USB or Bluetooth Security Key.

Registration

A typical registration process has six steps, as illustrated in Figure 1 and described further below. This is a simplification of the data required for the registration process that is only intended to provide an overview. The full set of required fields, optional fields, and their meanings for creating a registration request can be found in the PublicKeyCredentialCreationOptions dictionary. Likewise, the full set of response fields can be found in the PublicKeyCredential interface (where PublicKeyCredential.response is the AuthenticatorAttestationResponse interface). Note most JavaScript programmers that are creating an application will only really care about steps 1 and 5 where the create() function is called and subsequently returns; however, steps 2, 3, and 4 are essential to understanding the processing that takes place in the browser and authenticator and what the resulting data means.

[[File:../../../../../media.prod.mdn.mozit.cloud/attachments/2018/09/25/16189/2d5b3c88e13b013bd2c29b421d1b7353/WebAuthn_Registration_r4.png|Web Authentication API registration component and dataflow diagram]]

Figure 1 - a diagram showing the sequence of actions for a web authentication registration and the essential data associated with each action.

The registration steps are:

  1. Application Requests Registration - The application makes the initial registration request. The protocol and format of this request is outside of the scope of the Web Authentication API.
  2. Server Sends Challenge, User Info, and Relying Party Info - The server sends a challenge, user information, and relying party information to the JavaScript program. The protocol for communicating with the server is not specified and is outside of the scope of the Web Authentication API. Typically, server communications would be REST over https (probably using [[../../../User_maybe/webidl_mdn/XMLHttpRequest_API|XMLHttpRequest]] or Fetch), but they could also be SOAP, RFC 2549 or nearly any other protocol provided that the protocol is secure. The parameters received from the server will be passed to the create() call, typically with little or no modification and returns a Promise that will resolve to a PublicKeyCredential containing an AuthenticatorAttestationResponse. Note that it is absolutely critical that the challenge be a buffer of random information (at least 16 bytes) and it MUST be generated on the server in order to ensure the security of the registration process.
  3. Browser Calls authenticatorMakeCredential() on Authenticator - Internally, the browser will validate the parameters and fill in any defaults, which become the AuthenticatorResponse.clientDataJSON. One of the most important parameters is the origin, which is recorded as part of the clientData so that the origin can be verified by the server later. The parameters to the create() call are passed to the authenticator, along with a SHA-256 hash of the clientDataJSON (only a hash is sent because the link to the authenticator may be a low-bandwidth NFC or Bluetooth link and the authenticator is just going to sign over the hash to ensure that it isn't tampered with).
  4. Authenticator Creates New Key Pair and Attestation - Before doing anything, the authenticator will typically ask for some form of user verification. This could be entering a PIN, using a fingerprint, doing an iris scan, etc. to prove that the user is present and consenting to the registration. After the user verification, the authenticator will create a new asymmetric key pair and safely store the private key for future reference. The public key will become part of the attestation, which the authenticator will sign over with a private key that was burned into the authenticator during its manufacturing process and that has a certificate chain that can be validated back to a root of trust.
  5. Authenticator Returns Data to Browser - The new public key, a globally unique credential id, and other attestation data are returned to the browser where they become the attestationObject.
  6. Browser Creates Final Data, Application sends response to Server - The create() Promise resolves to an PublicKeyCredential, which has a PublicKeyCredential.rawId that is the globally unique credential id along with a response that is the AuthenticatorAttestationResponse containing the AuthenticatorResponse.clientDataJSON and AuthenticatorAttestationResponse.attestationObject. The PublicKeyCredential is sent back to the server using any desired formatting and protocol (note that the ArrayBuffer properties need to be be base64 encoded or similar).
  7. Server Validates and Finalizes Registration - Finally, the server is required to perform a series of checks to ensure that the registration was complete and not tampered with. These include:
    1. Verifying that the challenge is the same as the challenge that was sent
    2. Ensuring that the origin was the origin expected
    3. Validating that the signature over the clientDataHash and the attestation using the certificate chain for that specific model of the authenticator
    A complete list of validation steps can be found in the Web Authentication API specification. Assuming that the checks pan out, the server will store the new public key associated with the user's account for future use -- that is, whenever the user desires to use the public key for authentication.

Authentication

After a user has registered with web authentication, they can subsequently authenticate (a.k.a. - login or sign-in) with the service. The authentication flow looks similar to the registration flow, and the illustration of actions in Figure 2 may be recognizable as being similar to the illustration of registration actions in Figure 1. The primary differences between registration and authentication are that: 1) authentication doesn't require user or relying party information; and 2) authentication creates an assertion using the previously generated key pair for the service rather than creating an attestation with the key pair that was burned into the authenticator during manufacturing. Again, the description of authentication below is a broad overview rather than getting into all the options and features of the Web Authentication API. The specific options for authenticating can be found in the PublicKeyCredentialRequestOptions dictionary, and the resulting data can be found in the PublicKeyCredential interface (where PublicKeyCredential.response is the AuthenticatorAssertionResponse interface) .

[[File:../../../../../media.prod.mdn.mozit.cloud/attachments/2018/02/10/15802/4da3ac431c758c55db51e7ef0d33836e/MDN%20Webauthn%20Authentication%20(r1).png|WebAuthn authentication component and dataflow diagram]]

Figure 2 - similar to Figure 1, a diagram showing the sequence of actions for a web authentication and the essential data associated with each action.

  1. Application Requests Authentication - The application makes the initial authentication request. The protocol and format of this request is outside of the scope of the Web Authentication API.
  2. Server Sends Challenge - The server sends a challenge to the JavaScript program. The protocol for communicating with the server is not specified and is outside of the scope of the Web Authentication API. Typically, server communications would be REST over https (probably using [[../../../User_maybe/webidl_mdn/XMLHttpRequest_API|XMLHttpRequest]] or Fetch), but they could also be SOAP, RFC 2549 or nearly any other protocol provided that the protocol is secure. The parameters received from the server will be passed to the get() call, typically with little or no modification. Note that it is absolutely critical that the challenge be a buffer of random information (at least 16 bytes) and it MUST be generated on the server in order to ensure the security of the authentication process.
  3. Browser Calls authenticatorGetCredential() on Authenticator - Internally, the browser will validate the parameters and fill in any defaults, which become the AuthenticatorResponse.clientDataJSON. One of the most important parameters is the origin, which recorded as part of the clientData so that the origin can be verified by the server later. The parameters to the get() call are passed to the authenticator, along with a SHA-256 hash of the clientDataJSON (only a hash is sent because the link to the authenticator may be a low-bandwidth NFC or Bluetooth link and the authenticator is just going to sign over the hash to ensure that it isn't tampered with).
  4. Authenticator Creates an Assertion - The authenticator finds a credential for this service that matches the Relying Party ID and prompts a user to consent to the authentication. Assuming both of those steps are successful, the authenticator will create a new assertion by signing over the clientDataHash and authenticatorData with the private key generated for this account during the registration call.
  5. Authenticator Returns Data to Browser - The authenticator returns the authenticatorData and assertion signature back to the browser.
  6. Browser Creates Final Data, Application sends response to Server - The browser resolves the Promise to a PublicKeyCredential with a PublicKeyCredential.response that contains the AuthenticatorAssertionResponse. It is up to the JavaScript application to transmit this data back to the server using any protocol and format of its choice.
  7. Server Validates and Finalizes Authentication - Upon receiving the result of the authentication request, the server performs validation of the response such as:
    1. Using the public key that was stored during the registration request to validate the signature by the authenticator.
    2. Ensuring that the challenge that was signed by the authenticator matches the challenge that was generated by the server.
    3. Checking that the Relying Party ID is the one expected for this service.
    A full list of the steps for validating an assertion can be found in the Web Authentication API specification. Assuming the validation is successful, the server will note that the user is now authenticated. This is outside the scope of the Web Authentication API specification, but one option would be to drop a new cookie for the user session.

Interfaces

Credential  '
Provides information about an entity as a prerequisite to a trust decision.
CredentialsContainer
Exposes methods to request credentials and notify the user agent when events such as successful sign in or sign out happen. This interface is accessible from Navigator.credentials. The Web Authentication specification adds a publicKey member to the create() and get() methods to either create a new public key pair or get an authentication for a key pair, repsectively.
PublicKeyCredential
Provides information about a public key / private key pair, which is a credential for logging in to a service using an un-phishable and data-breach resistant asymmetric key pair instead of a password.
AuthenticatorResponse
The base interface for AuthenticatorAttestationResponse and AuthenticatorAssertionResponse, which provide a cryptographic root of trust for a key pair. Returned by CredentialsContainer.create() and CredentialsContainer.get(), respectively, the child interfaces include information from the browser such as the challenge origin. Either may be returned from PublicKeyCredential.response.
AuthenticatorAttestationResponse
Returned by CredentialsContainer.create() when a PublicKeyCredential is passed, and provides a cryptographic root of trust for the new key pair that has been generated.
AuthenticatorAssertionResponse
Returned by CredentialsContainer.get() when a PublicKeyCredential is passed, and provides proof to a service that it has a key pair and that the authentication request is valid and approved.

Options

PublicKeyCredentialCreationOptions
The options passed to CredentialsContainer.create().
PublicKeyCredentialRequestOptions
The options passed to CredentialsContainer.get().

Examples

 For security reasons, web authentication calls (create() and get()) are cancelled if the browser window loses focus while the call is pending.


// sample arguments for registration
var createCredentialDefaultArgs = {
    publicKey: {
        // Relying Party (a.k.a. - Service):
        rp: {
            name: "Acme"
        },

        // User:
        user: {
            id: new Uint8Array(16),
            name: "[email protected]",
            displayName: "John P. Smith"
        },

        pubKeyCredParams: [{
            type: "public-key",
            alg: -7
        }],

        attestation: "direct",

        timeout: 60000,

        challenge: new Uint8Array([ // must be a cryptographically random number sent from a server
            0x8C, 0x0A, 0x26, 0xFF, 0x22, 0x91, 0xC1, 0xE9, 0xB9, 0x4E, 0x2E, 0x17, 0x1A, 0x98, 0x6A, 0x73,
            0x71, 0x9D, 0x43, 0x48, 0xD5, 0xA7, 0x6A, 0x15, 0x7E, 0x38, 0x94, 0x52, 0x77, 0x97, 0x0F, 0xEF
        ]).buffer
    }
};

// sample arguments for login
var getCredentialDefaultArgs = {
    publicKey: {
        timeout: 60000,
        // allowCredentials: [newCredential] // see below
        challenge: new Uint8Array([ // must be a cryptographically random number sent from a server
            0x79, 0x50, 0x68, 0x71, 0xDA, 0xEE, 0xEE, 0xB9, 0x94, 0xC3, 0xC2, 0x15, 0x67, 0x65, 0x26, 0x22,
            0xE3, 0xF3, 0xAB, 0x3B, 0x78, 0x2E, 0xD5, 0x6F, 0x81, 0x26, 0xE2, 0xA6, 0x01, 0x7D, 0x74, 0x50
        ]).buffer
    },
};

// register / create a new credential
navigator.credentials.create(createCredentialDefaultArgs)
    .then((cred) => {
        console.log("NEW CREDENTIAL", cred);

        // normally the credential IDs available for an account would come from a server
        // but we can just copy them from above...
        var idList = [{
            id: cred.rawId,
            transports: ["usb", "nfc", "ble"],
            type: "public-key"
        }];
        getCredentialDefaultArgs.publicKey.allowCredentials = idList;
        return navigator.credentials.get(getCredentialDefaultArgs);
    })
    .then((assertion) => {
        console.log("ASSERTION", assertion);
    })
    .catch((err) => {
        console.log("ERROR", err);
    });

Specifications

Specification Status Comment
Web Authentication: An API for accessing Public Key Credentials Level 1 Recommendation Initial definition.

Browser compatibility

Credential

Update compatibility data on GitHub

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet

Credential

Experimental'

Chrome

Full support 51

Edge

Full support 18

Firefox

Full support 60

IE

No support No

Opera

Full support 38

Safari

Full support 13

WebView Android

Full support 51

Chrome Android

Full support 51

Firefox Android

Full support 60

Opera Android

Full support 41

Safari iOS

Full support 13.3

Samsung Internet Android

Full support 5.0

id

Experimental'

Chrome

Full support 51

Edge

Full support 18

Firefox

Full support 60

IE

No support No

Opera

Full support 38

Safari

Full support 13

WebView Android

Full support 51

Chrome Android

Full support 51

Firefox Android

Full support 60

Opera Android

Full support 41

Safari iOS

Full support 13.3

Samsung Internet Android

Full support 5.0

name (from CredentialUserData mixin)

Experimental'

Chrome No support 51 — 52

Notes'

No support 51 — 52

Notes'

Notes' See Bug 602980.

Edge

No support No

Firefox

No support No

IE

No support No

Opera No support 38 — 39

Notes'

No support 38 — 39

Notes'

Notes' See Bug 602980.

Safari

No support No

WebView Android No support 51 — 52

Notes'

No support 51 — 52

Notes'

Notes' See Bug 602980.

Chrome Android No support 51 — 52

Notes'

No support 51 — 52

Notes'

Notes' See Bug 602980.

Firefox Android

No support No

Opera Android

No support No

Safari iOS

No support No

Samsung Internet Android No support 5.0 — 6.0

Notes'

No support 5.0 — 6.0

Notes'

Notes' See Bug 602980.

type

Experimental'

Chrome

Full support 51

Edge

Full support 18

Firefox

Full support 60

IE

No support No

Opera

Full support 38

Safari

Full support 13

WebView Android

Full support 51

Chrome Android

Full support 51

Firefox Android

Full support 60

Opera Android

Full support 41

Safari iOS

Full support 13.3

Samsung Internet Android

Full support 5.0

Legend

Full support  
Full support
No support  
No support
Experimental. Expect behavior to change in the future.'
Experimental. Expect behavior to change in the future.
See implementation notes.'
See implementation notes.


CredentialsContainer

Update compatibility data on GitHub

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet

CredentialsContainer

Experimental'

Chrome

Full support 51

Edge

Full support 18

Firefox

Full support 61

IE

No support No

Opera

Full support 38

Safari

Full support 13

WebView Android

Full support 51

Chrome Android

Full support 51

Firefox Android

Full support 61

Opera Android

Full support 41

Safari iOS

Full support 13

Samsung Internet Android

Full support 5.0

create

Experimental'

Chrome

Full support 60

Edge

Full support 18

Firefox

Full support 61

IE

No support No

Opera

Full support 47

Safari

Full support 13

WebView Android

Full support 60

Chrome Android

Full support 60

Firefox Android

Full support 61

Opera Android

Full support 44

Safari iOS

Full support 13

Samsung Internet Android

Full support 8.0

get

Experimental'

Chrome

Full support 51

Edge

Full support 18

Firefox

Full support 61

IE

No support No

Opera

Full support 38

Safari

Full support 13

WebView Android

Full support 51

Chrome Android

Full support 51

Firefox Android

Full support 61

Opera Android

Full support 41

Safari iOS

Full support 13

Samsung Internet Android

Full support 5.0

preventSilentAccess

Experimental'

Chrome Full support 60


Full support 60


No support 51 — 60

Alternate Name'

Alternate Name' Uses the non-standard name: requireUserMediation

Edge

Full support 18

Firefox

Full support 61

IE

No support No

Opera Full support 47


Full support 47


No support 38 — 47

Alternate Name'

Alternate Name' Uses the non-standard name: requireUserMediation

Safari

Full support 13

WebView Android Full support 60


Full support 60


No support 51 — 60

Alternate Name'

Alternate Name' Uses the non-standard name: requireUserMediation

Chrome Android Full support 60


Full support 60


No support 51 — 60

Alternate Name'

Alternate Name' Uses the non-standard name: requireUserMediation

Firefox Android

Full support 61

Opera Android Full support 44


Full support 44


No support 41 — 44

Alternate Name'

Alternate Name' Uses the non-standard name: requireUserMediation

Safari iOS

Full support 13

Samsung Internet Android Full support 8.0


Full support 8.0


No support 5.0 — 8.0

Alternate Name'

Alternate Name' Uses the non-standard name: requireUserMediation

store

Experimental'

Chrome

Full support 51

Edge

Full support 79

Firefox

Full support 61

IE

No support No

Opera

Full support 38

Safari

Full support 13

WebView Android

Full support 51

Chrome Android

Full support 51

Firefox Android

Full support 61

Opera Android

Full support 41

Safari iOS

Full support 13

Samsung Internet Android

Full support 5.0

Legend

Full support  
Full support
No support  
No support
Experimental. Expect behavior to change in the future.'
Experimental. Expect behavior to change in the future.
Uses a non-standard name.'
Uses a non-standard name.


PublicKeyCredential

Update compatibility data on GitHub

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
PublicKeyCredential

Chrome Full support 67


Full support 67


Full support 65

Notes' Disabled'

Notes' Only supports USB U2F tokens. Disabled' From version 65: this feature is behind the Web Authentication API preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags.

Edge

Full support 18

Firefox Full support 60

Notes'

Full support 60

Notes'

Notes' Only supports USB U2F tokens.

IE

No support No

Opera

No support No

Safari

Full support 13

WebView Android

Full support 70

Chrome Android

Full support 70

Firefox Android Full support 60

Notes'

Full support 60

Notes'

Notes' Only supports USB U2F tokens.

Opera Android

No support No

Safari iOS

Full support 13.3

Samsung Internet Android

No support No

getClientExtensionResults

Chrome Full support 67


Full support 67


Full support 65

Notes' Disabled'

Notes' Only supports USB U2F tokens. Disabled' From version 65: this feature is behind the Web Authentication API preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags.

Edge

Full support 18

Firefox Full support 60

Notes'

Full support 60

Notes'

Notes' Only supports USB U2F tokens.

IE

No support No

Opera

No support No

Safari

Full support 13

WebView Android

Full support 70

Chrome Android

Full support 70

Firefox Android Full support 60

Notes'

Full support 60

Notes'

Notes' Only supports USB U2F tokens.

Opera Android

No support No

Safari iOS

Full support 13.3

Samsung Internet Android

No support No

isUserVerifyingPlatformAuthenticatorAvailable

Chrome Full support 67


Full support 67


Full support 65

Notes' Disabled'

Notes' Only supports USB U2F tokens. Disabled' From version 65: this feature is behind the Web Authentication API preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags.

Edge

Full support 18

Firefox Full support 60

Notes'

Full support 60

Notes'

Notes' Only supports USB U2F tokens.

IE

No support No

Opera

No support No

Safari

Full support 13

WebView Android

Full support 70

Chrome Android

Full support 70

Firefox Android Full support 60

Notes'

Full support 60

Notes'

Notes' Only supports USB U2F tokens.

Opera Android

No support No

Safari iOS

Full support 13.3

Samsung Internet Android

No support No

rawId

Chrome Full support 67


Full support 67


Full support 65

Notes' Disabled'

Notes' Only supports USB U2F tokens. Disabled' From version 65: this feature is behind the Web Authentication API preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags.

Edge

Full support 18

Firefox Full support 60

Notes'

Full support 60

Notes'

Notes' Only supports USB U2F tokens.

IE

No support No

Opera

No support No

Safari

Full support 13

WebView Android

Full support 70

Chrome Android

Full support 70

Firefox Android Full support 60

Notes'

Full support 60

Notes'

Notes' Only supports USB U2F tokens.

Opera Android

No support No

Safari iOS

Full support 13.3

Samsung Internet Android

No support No

response

Chrome Full support 67


Full support 67


Full support 65

Notes' Disabled'

Notes' Only supports USB U2F tokens. Disabled' From version 65: this feature is behind the Web Authentication API preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags.

Edge

Full support 18

Firefox Full support 60

Notes'

Full support 60

Notes'

Notes' Only supports USB U2F tokens.

IE

No support No

Opera

No support No

Safari

Full support 13

WebView Android

Full support 70

Chrome Android

Full support 70

Firefox Android Full support 60

Notes'

Full support 60

Notes'

Notes' Only supports USB U2F tokens.

Opera Android

No support No

Safari iOS

Full support 13.3

Samsung Internet Android

No support No

Legend

Full support  
Full support
No support  
No support
See implementation notes.'
See implementation notes.
User must explicitly enable this feature.'
User must explicitly enable this feature.


AuthenticatorResponse

Update compatibility data on GitHub

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
AuthenticatorResponse

Chrome Full support 67


Full support 67


Full support 65

Notes' Disabled'

Notes' Only supports USB U2F tokens. Disabled' From version 65: this feature is behind the Web Authentication API preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags.

Edge

Full support 18

Firefox Full support 60

Notes'

Full support 60

Notes'

Notes' Only supports USB U2F tokens.

IE

No support No

Opera

No support No

Safari

Full support 13

WebView Android

Full support 70

Chrome Android

Full support 70

Firefox Android Full support 60

Notes'

Full support 60

Notes'

Notes' Only supports USB U2F tokens.

Opera Android

No support No

Safari iOS

Full support 13.3

Samsung Internet Android

No support No

clientDataJSON

Chrome Full support 67


Full support 67


Full support 65

Notes' Disabled'

Notes' Only supports USB U2F tokens. Disabled' From version 65: this feature is behind the Web Authentication API preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags.

Edge

Full support 18

Firefox Full support 60

Notes'

Full support 60

Notes'

Notes' Only supports USB U2F tokens.

IE

No support No

Opera

No support No

Safari

Full support 13

WebView Android

Full support 70

Chrome Android

Full support 70

Firefox Android Full support 60

Notes'

Full support 60

Notes'

Notes' Only supports USB U2F tokens.

Opera Android

No support No

Safari iOS

Full support 13.3

Samsung Internet Android

No support No

Legend

Full support  
Full support
No support  
No support
See implementation notes.'
See implementation notes.
User must explicitly enable this feature.'
User must explicitly enable this feature.


AuthenticatorAttestationResponse

Update compatibility data on GitHub

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
AuthenticatorAttestationResponse

Chrome Full support 67


Full support 67


Full support 65

Notes' Disabled'

Notes' Only supports USB U2F tokens. Disabled' From version 65: this feature is behind the Web Authentication API preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags.

Edge

Full support 18

Firefox Full support 60

Notes'

Full support 60

Notes'

Notes' Only supports USB U2F tokens.

IE

No support No

Opera

No support No

Safari

Full support 13

WebView Android

Full support 70

Chrome Android

Full support 70

Firefox Android Full support 60

Notes'

Full support 60

Notes'

Notes' Only supports USB U2F tokens.

Opera Android

No support No

Safari iOS

Full support 13.3

Samsung Internet Android

Full support 10.0

attestationObject

Chrome Full support 67


Full support 67


Full support 65

Notes' Disabled'

Notes' Only supports USB U2F tokens. Disabled' From version 65: this feature is behind the Web Authentication API preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags.

Edge

Full support 18

Firefox Full support 60

Notes'

Full support 60

Notes'

Notes' Only supports USB U2F tokens.

IE

No support No

Opera

No support No

Safari

Full support 13

WebView Android

Full support 70

Chrome Android

Full support 70

Firefox Android Full support 60

Notes'

Full support 60

Notes'

Notes' Only supports USB U2F tokens.

Opera Android

No support No

Safari iOS

Full support 13.3

Samsung Internet Android

Full support 10.0

getTransports

Experimental'

Chrome

No support No

Edge

No support No

Firefox

No support No

IE

No support No

Opera

No support No

Safari

No support No

WebView Android

No support No

Chrome Android

No support No

Firefox Android

No support No

Opera Android

No support No

Safari iOS

No support No

Samsung Internet Android

No support No

Legend

Full support  
Full support
No support  
No support
Experimental. Expect behavior to change in the future.'
Experimental. Expect behavior to change in the future.
See implementation notes.'
See implementation notes.
User must explicitly enable this feature.'
User must explicitly enable this feature.


AuthenticatorAssertionResponse

Update compatibility data on GitHub

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
AuthenticatorAssertionResponse

Chrome Full support 67


Full support 67


Full support 65

Notes' Disabled'

Notes' Only supports USB U2F tokens. Disabled' From version 65: this feature is behind the Web Authentication API preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags.

Edge

Full support 18

Firefox Full support 60

Notes'

Full support 60

Notes'

Notes' Only supports USB U2F tokens.

IE

No support No

Opera

No support No

Safari

Full support 13

WebView Android

Full support 70

Chrome Android

Full support 70

Firefox Android Full support 60

Notes'

Full support 60

Notes'

Notes' Only supports USB U2F tokens.

Opera Android

No support No

Safari iOS

Full support 13.3

Samsung Internet Android

No support No

authenticatorData

Chrome Full support 67


Full support 67


Full support 65

Notes' Disabled'

Notes' Only supports USB U2F tokens. Disabled' From version 65: this feature is behind the Web Authentication API preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags.

Edge

Full support 18

Firefox Full support 60

Notes'

Full support 60

Notes'

Notes' Only supports USB U2F tokens.

IE

No support No

Opera

No support No

Safari

Full support 13

WebView Android

Full support 70

Chrome Android

Full support 70

Firefox Android Full support 60

Notes'

Full support 60

Notes'

Notes' Only supports USB U2F tokens.

Opera Android

No support No

Safari iOS

Full support 13.3

Samsung Internet Android

No support No

signature

Chrome Full support 67


Full support 67


Full support 65

Notes' Disabled'

Notes' Only supports USB U2F tokens. Disabled' From version 65: this feature is behind the Web Authentication API preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags.

Edge

Full support 18

Firefox Full support 60

Notes'

Full support 60

Notes'

Notes' Only supports USB U2F tokens.

IE

No support No

Opera

No support No

Safari

Full support 13

WebView Android

Full support 70

Chrome Android

Full support 70

Firefox Android Full support 60

Notes'

Full support 60

Notes'

Notes' Only supports USB U2F tokens.

Opera Android

No support No

Safari iOS

Full support 13.3

Samsung Internet Android

No support No

userHandle

Chrome Full support 67


Full support 67


Full support 65

Notes' Disabled'

Notes' Only supports USB U2F tokens. Disabled' From version 65: this feature is behind the Web Authentication API preference (needs to be set to Enabled). To change preferences in Chrome, visit chrome://flags.

Edge

Full support 18

Firefox Full support 60

Notes'

Full support 60

Notes'

Notes' Only supports USB U2F tokens.

IE

No support No

Opera

No support No

Safari

Full support 13

WebView Android

Full support 70

Chrome Android

Full support 70

Firefox Android Full support 60

Notes'

Full support 60

Notes'

Notes' Only supports USB U2F tokens.

Opera Android

No support No

Safari iOS

Full support 13.3

Samsung Internet Android

No support No

Legend

Full support  
Full support
No support  
No support
See implementation notes.'
See implementation notes.
User must explicitly enable this feature.'
User must explicitly enable this feature.


PublicKeyCredentialCreationOptions

Update compatibility data on GitHub

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet

PublicKeyCredentialCreationOptions

Experimental'

Chrome

Full support 67

Edge

Full support ≤79

Firefox

Full support 60

IE

No support No

Opera

Full support 54

Safari

Full support 13

WebView Android

No support No

Chrome Android

Full support 67

Firefox Android

?

Opera Android

Full support 48

Safari iOS

Full support 13.3

Samsung Internet Android

No support No

attestation

Experimental'

Chrome

Full support 67

Edge

Full support ≤79

Firefox

Full support 60

IE

No support No

Opera

Full support 54

Safari

Full support 13

WebView Android

No support No

Chrome Android

Full support 67

Firefox Android

?

Opera Android

Full support 48

Safari iOS

Full support 13.3

Samsung Internet Android

No support No

authenticatorSelection

Experimental'

Chrome

Full support 67

Edge

Full support ≤79

Firefox

Full support 60

IE

No support No

Opera

Full support 54

Safari

Full support 13

WebView Android

No support No

Chrome Android

Full support 67

Firefox Android

?

Opera Android

Full support 48

Safari iOS

Full support 13.3

Samsung Internet Android

No support No

challenge

Experimental'

Chrome

Full support 67

Edge

Full support ≤79

Firefox

Full support 60

IE

No support No

Opera

Full support 54

Safari

Full support 13

WebView Android

No support No

Chrome Android

Full support 67

Firefox Android

?

Opera Android

Full support 48

Safari iOS

Full support 13.3

Samsung Internet Android

No support No

excludeCredentials

Experimental'

Chrome

Full support 67

Edge

Full support ≤79

Firefox

Full support 60

IE

No support No

Opera

Full support 54

Safari

Full support 13

WebView Android

No support No

Chrome Android

Full support 67

Firefox Android

?

Opera Android

Full support 48

Safari iOS

Full support 13.3

Samsung Internet Android

No support No

extensions

Experimental'

Chrome

Full support 67

Edge

Full support ≤79

Firefox

Full support 60

IE

No support No

Opera

Full support 54

Safari

Full support 13

WebView Android

No support No

Chrome Android

Full support 67

Firefox Android

?

Opera Android

Full support 48

Safari iOS

Full support 13.3

Samsung Internet Android

No support No

pubKeyCredParams

Experimental'

Chrome

Full support 67

Edge

Full support ≤79

Firefox

Full support 60

IE

No support No

Opera

Full support 54

Safari

Full support 13

WebView Android

No support No

Chrome Android

Full support 67

Firefox Android

?

Opera Android

Full support 48

Safari iOS

Full support 13.3

Samsung Internet Android

No support No

rp

Experimental'

Chrome

Full support 67

Edge

Full support ≤79

Firefox

Full support 60

IE

No support No

Opera

Full support 54

Safari

Full support 13

WebView Android

No support No

Chrome Android

Full support 67

Firefox Android

?

Opera Android

Full support 48

Safari iOS

Full support 13.3

Samsung Internet Android

No support No

timeout

Experimental'

Chrome

Full support 67

Edge

Full support ≤79

Firefox

Full support 60

IE

No support No

Opera

Full support 54

Safari

Full support 13

WebView Android

No support No

Chrome Android

Full support 67

Firefox Android

?

Opera Android

Full support 48

Safari iOS

Full support 13.3

Samsung Internet Android

No support No

user

Experimental'

Chrome

Full support 67

Edge

Full support ≤79

Firefox

Full support 60

IE

No support No

Opera

Full support 54

Safari

Full support 13

WebView Android

No support No

Chrome Android

Full support 67

Firefox Android

?

Opera Android

Full support 48

Safari iOS

Full support 13.3

Samsung Internet Android

No support No

Legend

Full support  
Full support
No support  
No support
Compatibility unknown  
Compatibility unknown
Experimental. Expect behavior to change in the future.'
Experimental. Expect behavior to change in the future.


PublicKeyCredentialRequestOptions

Update compatibility data on GitHub

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet

PublicKeyCredentialRequestOptions

Experimental'

Chrome

Full support 67

Edge

Full support ≤79

Firefox

Full support 60

IE

No support No

Opera

Full support 54

Safari

Full support 13

WebView Android

Full support 67

Chrome Android

Full support 67

Firefox Android

?

Opera Android

Full support 48

Safari iOS

Full support 13.3

Samsung Internet Android

No support No

allowCredentials

Experimental'

Chrome

Full support 67

Edge

Full support ≤79

Firefox

Full support 60

IE

No support No

Opera

Full support 54

Safari

Full support 13

WebView Android

Full support 67

Chrome Android

Full support 67

Firefox Android

?

Opera Android

Full support 48

Safari iOS

Full support 13.3

Samsung Internet Android

No support No

challenge

Experimental'

Chrome

Full support 67

Edge

Full support ≤79

Firefox

Full support 60

IE

No support No

Opera

Full support 54

Safari

Full support 13

WebView Android

Full support 67

Chrome Android

Full support 67

Firefox Android

?

Opera Android

Full support 48

Safari iOS

Full support 13.3

Samsung Internet Android

No support No

extensions

Experimental'

Chrome

Full support 67

Edge

Full support ≤79

Firefox

Full support 60

IE

No support No

Opera

Full support 54

Safari

Full support 13

WebView Android

Full support 67

Chrome Android

Full support 67

Firefox Android

?

Opera Android

Full support 48

Safari iOS

Full support 13.3

Samsung Internet Android

No support No

rpId

Experimental'

Chrome

Full support 67

Edge

Full support ≤79

Firefox

Full support 60

IE

No support No

Opera

Full support 54

Safari

Full support 13

WebView Android

Full support 67

Chrome Android

Full support 67

Firefox Android

?

Opera Android

Full support 48

Safari iOS

Full support 13.3

Samsung Internet Android

No support No

timeout

Experimental'

Chrome

Full support 67

Edge

Full support ≤79

Firefox

Full support 60

IE

No support No

Opera

Full support 54

Safari

Full support 13

WebView Android

Full support 67

Chrome Android

Full support 67

Firefox Android

?

Opera Android

Full support 48

Safari iOS

Full support 13.3

Samsung Internet Android

No support No

userVerification

Experimental'

Chrome

Full support 67

Edge

Full support ≤79

Firefox

Full support 60

IE

No support No

Opera

Full support 54

Safari

Full support 13

WebView Android

Full support 67

Chrome Android

Full support 67

Firefox Android

?

Opera Android

Full support 48

Safari iOS

Full support 13.3

Samsung Internet Android

No support No

Legend

Full support  
Full support
No support  
No support
Compatibility unknown  
Compatibility unknown
Experimental. Expect behavior to change in the future.'
Experimental. Expect behavior to change in the future.


See also