aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/publickeycredential/index.html
blob: 48fea0a296d0f33136e5e2add25063531dba6eff (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
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
---
title: PublicKeyCredential
slug: Web/API/PublicKeyCredential
tags:
  - API
  - Interface
  - PublicKeyCredential
  - Reference
  - Web Authentication API
  - WebAuthn
translation_of: Web/API/PublicKeyCredential
---
<p>{{APIRef("Web Authentication API")}}{{securecontext_header}}</p>

<p>L'interface <code><strong>PublicKeyCredential</strong></code> 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 <em>phishing</em> ou liées à des fuites de données).</p>

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

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

<ul>
 <li>{{domxref("PasswordCredential")}}</li>
 <li>{{domxref("FederatedCredential")}}.</li>
</ul>

<h2 id="Propriétés">Propriétés</h2>

<dl>
 <dt>{{domxref("PublicKeyCredential.type")}} {{ReadOnlyInline()}}</dt>
 <dd>Propriété héritée depuis {{domxref("Credential")}}. Dans le cas de <code>PublicKeyCredentials</code>, cette propriété vaut toujours <code>"public-key"</code>.</dd>
 <dt>{{domxref("PublicKeyCredential.id")}} {{ReadOnlyInline()}}</dt>
 <dd>Propriété héritée depuis {{domxref("Credential")}} et surchargée afin de correspondre à l'<a href="/fr/docs/Web/API/WindowBase64/Décoder_encoder_en_base64">encodage en base64url</a> de <code>PublicKeyCredential.rawId</code>.</dd>
 <dt>{{domxref("PublicKeyCredential.rawId")}} {{ReadOnlyInline()}}</dt>
 <dd>Un objet {{domxref("ArrayBuffer")}} qui contient l'identifiant unique global/universel pour cette instance <code>PublicKeyCredential</code>. Cet identifiant peut être utilisé afin de rechercher les informations d'authentification avec les futurs appels à {{domxref("CredentialsContainer.get")}}.</dd>
 <dt>{{domxref("PublicKeyCredential.response")}} {{ReadOnlyInline()}}</dt>
 <dd>Une instance {{domxref("AuthenticatorResponse")}}. Cette instance est de type :
 <ul>
  <li>{{domxref("AuthenticatorAttestationResponse")}} si l'objet <code>PublicKeyCredential</code> a été créé grâce à un appel à <code><a href="/fr/docs/Web/API/CredentialsContainer/create">create()</a></code></li>
  <li>{{domxref("AuthenticatorAssertionResponse")}} si l'objet <code>PublicKeyCredential</code> a été créé grâce à un appel à <code><a href="/fr/docs/Web/API/CredentialsContainer/get">get()</a></code>.</li>
 </ul>
 </dd>
</dl>

<h2 id="Méthodes">Méthodes</h2>

<dl>
 <dt>{{domxref("PublicKeyCredential.getClientExtensionResults()")}}</dt>
 <dd>Si au moins une extension est demandée, cette méthode renverra le résultat du traitement de ces extensions.</dd>
</dl>

<h2 id="Spécifications">Spécifications</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Spécification</th>
   <th scope="col">État</th>
   <th scope="col">Commentaires</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('WebAuthn')}}</td>
   <td>{{Spec2('WebAuthn')}}</td>
   <td>Définition initiale.</td>
  </tr>
 </tbody>
</table>

<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>

<p>{{Compat("api.PublicKeyCredential")}}</p>