aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/publickeycredential/index.md
blob: 49e032d17a695824ce5cdf3aa992a17ca52548e0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
---
title: PublicKeyCredential
slug: Web/API/PublicKeyCredential
tags:
  - API
  - Interface
  - PublicKeyCredential
  - Reference
  - Web Authentication API
  - WebAuthn
translation_of: Web/API/PublicKeyCredential
---
{{APIRef("Web Authentication API")}}{{securecontext_header}}

L'interface **`PublicKeyCredential`** fournit des informations relative à la paire constituée par une clé publique et une clé privée. Cette paire constitue une information d'authentification qui permet de se connecter à un service en utilisant un paire de clé asymétrique (permettant de prévenir les attaques par _phishing_ ou liées à des fuites de données).

Cette interface hérite de {{domxref("Credential")}} et a été créée pour l'[API Web Authentication](/fr/docs/Web/API/Web_Authentication_API) qui étend [l'API Credential Management](/fr/docs/Web/API/Credential_Management_API).

Les autres interfaces qui héritent de {{domxref("Credential")}} sont :

- {{domxref("PasswordCredential")}}
- {{domxref("FederatedCredential")}}.

## Propriétés

- {{domxref("PublicKeyCredential.type")}} {{ReadOnlyInline()}}
  - : Propriété héritée depuis {{domxref("Credential")}}. Dans le cas de `PublicKeyCredentials`, cette propriété vaut toujours `"public-key"`.
- {{domxref("PublicKeyCredential.id")}} {{ReadOnlyInline()}}
  - : Propriété héritée depuis {{domxref("Credential")}} et surchargée afin de correspondre à l'[encodage en base64url](/fr/docs/Web/API/WindowBase64/Décoder_encoder_en_base64) de `PublicKeyCredential.rawId`.
- {{domxref("PublicKeyCredential.rawId")}} {{ReadOnlyInline()}}
  - : Un objet {{domxref("ArrayBuffer")}} qui contient l'identifiant unique global/universel pour cette instance `PublicKeyCredential`. Cet identifiant peut être utilisé afin de rechercher les informations d'authentification avec les futurs appels à {{domxref("CredentialsContainer.get")}}.
- {{domxref("PublicKeyCredential.response")}} {{ReadOnlyInline()}}

  - : Une instance {{domxref("AuthenticatorResponse")}}. Cette instance est de type :

    - {{domxref("AuthenticatorAttestationResponse")}} si l'objet `PublicKeyCredential` a été créé grâce à un appel à [`create()`](/fr/docs/Web/API/CredentialsContainer/create)
    - {{domxref("AuthenticatorAssertionResponse")}} si l'objet `PublicKeyCredential` a été créé grâce à un appel à [`get()`](/fr/docs/Web/API/CredentialsContainer/get).

## Méthodes

- {{domxref("PublicKeyCredential.getClientExtensionResults()")}}
  - : Si au moins une extension est demandée, cette méthode renverra le résultat du traitement de ces extensions.

## Spécifications

| Spécification                    | État                         | Commentaires         |
| -------------------------------- | ---------------------------- | -------------------- |
| {{SpecName('WebAuthn')}} | {{Spec2('WebAuthn')}} | Définition initiale. |

## Compatibilité des navigateurs

{{Compat("api.PublicKeyCredential")}}