Verificação de detecção de recursos da API Credential Management

Resumo

A WebAuthn ajuda a aumentar a segurança ao trazer a autenticação baseada em credenciais de chave pública para a Web e, em breve, será compatível com o Chrome, o Firefox e o Edge (com a especificação atualizada). Ele adiciona um novo tipo de objeto Credential, que, no entanto, pode corromper sites que usam a API Credential Management sem detectar os tipos de credenciais específicos que estão usando.

Se você faz isso para detectar recursos,

if (navigator.credentials && navigator.credentials.preventSilentAccess) {
    // use CM API
}

Dicas do que fazer:

if (window.PasswordCredential || window.FederatedCredential) {
    // Call navigator.credentials.get() to retrieve stored
    // PasswordCredentials or FederatedCredentials.
}

if (window.PasswordCredential) {
    // Get/Store PasswordCredential
}

if (window.FederatedCredential) {
    // Get/Store FederatedCredential
}

if (navigator.credentials && navigator.credentials.preventSilentAccess) {
    // Call navigator.credentials.preventSilentAccess()
}

Confira as mudanças feitas no exemplo de código.

Continue lendo para saber mais.

O que é a API Credential Management

A API Credential Management (API CM) dá aos sites acesso programático ao armazenamento de credenciais do user agent para armazenar/recuperar credenciais do usuário para a origem de chamada.

As APIs básicas são:

  • navigator.credentials.get()
  • navigator.credentials.store()
  • navigator.credentials.create()
  • navigator.credentials.preventSilentAccess()

A especificação original da API CM define dois tipos de credenciais:

  • PasswordCredential
  • FederatedCredential

O PasswordCredential é uma credencial que contém o ID e a senha do usuário. O FederatedCredential é uma credencial que contém o ID do usuário e uma string que representa um provedor de identidade.

Com essas duas credenciais, os sites podem:

  • Permitir que o usuário faça login com uma credencial federada ou baseada em senha salva anteriormente assim que ele acessar o site (login automático).
  • Armazene a credencial federada ou baseada em senha com que o usuário fez login,
  • Manter as credenciais de login do usuário atualizadas (por exemplo, após uma mudança de senha)

O que é o WebAuthn

A WebAuthn (Web Authentication) adiciona credenciais de chave pública à API CM. Por exemplo, ela oferece aos sites uma maneira padronizada de implementar a autenticação de dois fatores usando dispositivos de autenticação compatíveis com o FIDO 2.0.

Em um nível técnico, a WebAuthn estende a API CM com a interface PublicKeyCredential.

Qual é o problema?

Anteriormente, orientamos os desenvolvedores a detectar recursos da API CM com o seguinte código:

if (navigator.credentials && navigator.credentials.preventSilentAccess) {
  // Use CM API
}

But as you can see from the descriptions above, the `navigator.credentials` is
now expanded to support public-key credentials in addition to password
credentials and federated credentials.

The problem is that user agents don't necessarily support all kinds of
credentials. If you continue feature detect using `navigator.credentials`, your
website may break when you are using a certain credential type not supported by
the browser.

**Supported credential types by browser<s**
table class="properties with-head><ing-t><in>t<&q><uot>;<tb>odytr
th/th
thPasswordCredential / Feder<ate>d<Cr>edential/th
thPubli<cKe>y<Cre><de><nt>ial/th
</tr><tr>thChrome
/<tht><dA>vailable
/tdtdI<n d><eve><lo><pm>ent
/td/<trt><rt>hFir<efo><x<>/span>
/thtdN/A
/tdtdAiming <to ><shi><p ><on> 60
/<td/><tr>trth<Edg><e<>/span>
/thtdN/A
/tdtdImp<lemented with a href="https://blogs.windows.com/msedgedev/2016/04/12/a-world-without-passwords-windows-hello->in-micros<of>t-edge/"older API/a. New API (navigator.cr<ede><nti><als) c><oming >soon.
/td/tr/tbody/table


## The solution
You can avoid this by modifying feature detection code as follows to explicitly
test for the credential type that you intend to use.

```js
if (window.PasswordCredential || window.FederatedCredential) {
    // Call navigator.credentials.get() to retrieve stored
    // PasswordCredentials or FederatedCredentials.
}

if (window.PasswordCredential) {
    // Get/Store PasswordCredential
}

if (window.FederatedCredential) {
    // Get/Store FederatedCredential
}

if&& (navigator.credentials  navigator.credentials.preventSilentAccess) {
    // Call navigator.credentials.preventSilentAccess()
}

Confira as mudanças reais feitas no exemplo de código.

Como referência, veja como detectar o PublicKeyCredential adicionado no WebAuthn:

if (window.PublicKeyCredential) {
    // use CM API with PublicKeyCredential added in the WebAuthn spec
}

Cronograma

A implementação mais antiga disponível da WebAuthn é o Firefox, e está planejada para ser estável no início de maio de 2018.

Por fim,

Se tiver dúvidas, envie para @agektmr ou agektmr@chromium.org.