diff options
Diffstat (limited to 'files/fr/web/api/credentialscontainer')
5 files changed, 361 insertions, 0 deletions
diff --git a/files/fr/web/api/credentialscontainer/create/index.html b/files/fr/web/api/credentialscontainer/create/index.html new file mode 100644 index 0000000000..00de2917a1 --- /dev/null +++ b/files/fr/web/api/credentialscontainer/create/index.html @@ -0,0 +1,90 @@ +--- +title: CredentialsContainer.create() +slug: Web/API/CredentialsContainer/create +tags: + - API + - Credential Management API + - Méthode + - Reference + - Web Authentication API + - WebAuthn +translation_of: Web/API/CredentialsContainer/create +--- +<p>{{APIRef("Credential Management")}}{{SeeCompatTable}}</p> + +<p>La méthode <strong><code>create()</code></strong>, rattachée à l'interface {{domxref("CredentialsContainer")}}, renvoie une promesse ({{jsxref("Promise")}}) qui est résolue en</p> + +<ul> + <li>une nouvelle instance {{domxref("Credential")}} construite avec les options fournies</li> + <li>{{jsxref("null")}} si aucun objet <code>Credential</code> ne peut être créé.</li> +</ul> + +<div class="note"> +<p><strong>Note :</strong> Cette méthode ne peut être utilisé que pour les contextes de navigation les plus hauts. Les appels lancés depuis une {{HTMLElement("iframe")}} résoudront la promesse sans aucun effet.</p> +</div> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre class="syntaxbox">var promise = CredentialsContainer.create([options])</pre> + +<h3 id="Paramètres">Paramètres</h3> + +<dl> + <dt><code>options</code></dt> + <dd>Un objet de type {{domxref("CredentialCreationOptions")}} qui contient des options pour le nouvel objet <code>Credentials</code> demandé. Cet objet doit posséder au moins une des propriétés parmi <code>"password"</code>, <code>"federated"</code> ou <code>"publicKey"</code>. Les options sont : + <ul> + <li><font face="consolas, Liberation Mono, courier, monospace"><span style="background-color: rgba(220, 220, 220, 0.5);">password</span></font>: {{optional_inline}} un objet {{domxref("HTMLFormElement")}} ou un objet {{domxref("PasswordCredentialData")}} + <ul> + <li><code>id</code>: (obligatoire) {{domxref("USVString")}} hérité de {{domxref("CredentialData")}}.</li> + <li><code>name</code>: {{optional_inline}} {{domxref("USVString")}}</li> + <li><code>iconURL</code>: {{optional_inline}} {{domxref("USVString")}}</li> + <li><code>password</code>: (required) {{domxref("USVString")}}</li> + </ul> + </li> + <li><font face="consolas, Liberation Mono, courier, monospace"><span style="background-color: rgba(220, 220, 220, 0.5);">federated</span></font> : {{optional_inline}} un objet {{domxref("FederatedCredentialInit")}}. Cet objet contient le nécessaire pour créer/obtenir des informations d'authentification fédérées. Les propriétés disponibles sont : + <ul> + <li><code>id</code>: (required) {{domxref("USVString")}} hérité de {{domxref("CredentialData")}}.</li> + <li><code>name</code>: {{optional_inline}} {{domxref("USVString")}}</li> + <li><code>iconURL</code>: {{optional_inline}} {{domxref("USVString")}}</li> + <li><code>provider</code>: (required) {{domxref("USVString")}}</li> + <li><code>protocol</code>: {{optional_inline}} {{domxref("USVString")}}</li> + </ul> + </li> + <li><code>publicKey</code> : {{optional_inline}} un objet {{domxref("PublicKeyCredentialCreationOptions")}} qui décrit les options pour créer une information d'authentification <a href="/fr/docs/Web/API/Web_Authentication_API">WebAuthn</a>.</li> + </ul> + </dd> +</dl> + +<h3 id="Valeur_de_retour">Valeur de retour</h3> + +<p>Une promesse ({{jsxref("Promise")}}) dont la valeur de résolution est une instance {{domxref("Credential")}} telle que {{domxref("PasswordCredential")}}, {{domxref("FederatedCredential")}} ou {{domxref("PublicKeyCredential")}}.</p> + +<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('Credential Management','#dom-credentialscontainer-get','get()')}}</td> + <td>{{Spec2('Credential Management')}}</td> + <td>Définition initiale.</td> + </tr> + <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> + +<div class="hidden">Le tableau de compatibilité de cette page a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à consulter <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> et à nous envoyer une <em>pull request</em>.</div> + +<p>{{Compat("api.CredentialsContainer.create")}}</p> diff --git a/files/fr/web/api/credentialscontainer/get/index.html b/files/fr/web/api/credentialscontainer/get/index.html new file mode 100644 index 0000000000..ac86e8223b --- /dev/null +++ b/files/fr/web/api/credentialscontainer/get/index.html @@ -0,0 +1,82 @@ +--- +title: CredentialsContainer.get() +slug: Web/API/CredentialsContainer/get +tags: + - API + - Credential Management API + - CredentialsContainer + - Méthode + - Reference + - Web Authentication API + - WebAuthn +translation_of: Web/API/CredentialsContainer/get +--- +<p>{{APIRef("Credential Management")}}{{SeeCompatTable}}</p> + +<p>La méthode <strong><code>get()</code></strong>, rattachée à l'interface {{domxref("CredentialsContainer")}}, renvoie une promesse ({{jsxref("Promise")}}) qui est résolue en une instance de {{domxref("Credential")}} correspondant aux paramètres fournis. Si aucune correspondance n'est trouvée, la promesse sera résolue avec la valeur {{jsxref("null")}}.</p> + +<p>Cette méthode collecte l'ensemble des informations d'authentification stockées dans l'objet {{domxref("CredentialsContainer")}} et qui respectent les critères indiqués (définis grâce à l'argument <code><strong>options</strong></code>). À partir de cet ensemble, l'agent utilisateur sélectionne la meilleure information d'authentification. Selon les options fournies, l'agent utilisateur pourra afficher une boîte de dialogue et demander à l'utilisateur de sélectionner la bonne information.</p> + +<p>Cette méthode récupère les informations d'authentification en appelant la méthode <code>CollectFromCredentialStore</code> pour chaque type d'authentification permis par l'argument <code><strong>options</strong></code>. Ainsi, si la propriété <code>options.password</code> existe dans l'argument passé, {{domxref("PasswordCredential")}}<code>.[[CollectFromCredentialStore]]</code> sera appelée.</p> + +<div class="note"> +<p><strong>Note :</strong> Cette méthode ne peut être utilisé que pour les contextes de navigation les plus hauts. Les appels lancés depuis une {{HTMLElement("iframe")}} résoudront la promesse sans aucun effet.</p> +</div> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre class="syntaxbox">var promise = CredentialsContainer.get([options])</pre> + +<h3 id="Paramètres">Paramètres</h3> + +<dl> + <dt><code>options</code> {{optional_inline}}</dt> + <dd>Un objet de type {{domxref("CredentialRequestOptions")}} qui contient les critères de la requête. et les options d'interaction avec l'utilisateur. Cet objet peut contenir les propriétés suivantes : + <ul> + <li><code>password</code> : un booléen ({{jsxref("Boolean")}}) qui indique que l'instance {{domxref("Credential")}} renvoyée devrait contenir les informations sur l'utilisateur (contrairement aux informations d'authentification fédérées).</li> + <li><code>federated</code> : un objet {{domxref("FederatedCredentialRequestOptions")}} qui contient les critères que doivent respecter les informations d'authentification fédérées. Les options disponibles sont : + <ul> + <li><code>providers</code> : un tableau de chaînes de caractères {{domxref("DOMString")}} listant les fournisseurs d'identité potentiels</li> + <li><code>protocols</code> : un tableau de chaînes de caractères {{domxref("DOMString")}} listant les protocoles de fédération à rechercher.</li> + </ul> + </li> + <li><code>publicKey</code> : un objet {{domxref("PublicKeyCredentialRequestOptions")}} contenant les conditions que doivent respecter les informations d'authentification <a href="/fr/docs/Web/API/Web_Authentication_API">WebAuthn</a> qui seront renvoyées.</li> + <li><code>mediation</code> : une chaîne de caractères {{jsxref("String")}} qui indique si l'utilisateur devra se reconnecter à chaque visite sur le site. Les valeurs valides sont <code>"silent"</code>, <code>"optional"</code> ou <code>"required"</code>.</li> + <li><code>unmediated</code> : {{deprecated_inline()}} un booléen ({{jsxref("Boolean")}}) qui indique que l'instance {{domxref("Credential")}} renvoyée ne devrait pas nécessiter de médiation avec l'utilisateur.</li> + </ul> + </dd> +</dl> + +<h3 id="Valeur_de_retour">Valeur de retour</h3> + +<p>Une promesse ({{jsxref("Promise")}}) qui est résolue avec une instance {{domxref("Credential")}} correspondant aux paramètres fournis. S'il n'est pas possible d'obtenir une seule instance sans ambiguïté, la promesse sera résolue avec la valeur {{jsxref("null")}}.</p> + +<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('Credential Management','#dom-credentialscontainer-get','get()')}}</td> + <td>{{Spec2('Credential Management')}}</td> + <td>Définition initiale.</td> + </tr> + <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> + +<div class="hidden">Le tableau de compatibilité de cette page a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à consulter <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> et à nous envoyer une <em>pull request</em>.</div> + +<p>{{Compat("api.CredentialsContainer.get")}}</p> diff --git a/files/fr/web/api/credentialscontainer/index.html b/files/fr/web/api/credentialscontainer/index.html new file mode 100644 index 0000000000..e110b4ab03 --- /dev/null +++ b/files/fr/web/api/credentialscontainer/index.html @@ -0,0 +1,72 @@ +--- +title: CredentialsContainer +slug: Web/API/CredentialsContainer +tags: + - API + - Credential Management API + - Interface + - Reference + - Web Authentication API + - WebAuthn +translation_of: Web/API/CredentialsContainer +--- +<p>{{SeeCompatTable}}{{APIRef("Credential Management API")}}{{securecontext_header}}</p> + +<p>L'interface <strong><code>CredentialsContainer</code></strong>, rattachée à l'<a href="/en-US/docs/Web/API/Credential_Management_API">API Credential Management</a>, expose des méthodes pour demander l'accès aux informations d'authentification et informer l'agent utilisateur lorsque des évènements pertinents se produisent (connexion et déconnexion réussies par exemple). On peut accéder à cette interface via {{domxref('Navigator.credentials')}}.</p> + +<h2 id="Propriétés">Propriétés</h2> + +<p>Aucune.</p> + +<h3 id="Gestionnaires_d'évènements">Gestionnaires d'évènements</h3> + +<p>Aucun.</p> + +<h2 id="Methods">Methods</h2> + +<dl> + <dt>{{domxref("CredentialsContainer.create()")}}{{securecontext_inline}}</dt> + <dd>Cette méthode renvoie une promesse ({{jsxref("Promise")}}) qui est résolue avec une nouvelle instance {{domxref("Credential")}} construite selon les options fournies ou <code>null</code> si aucun objet <code>Credential</code> ne peut être créé.</dd> + <dt>{{domxref("CredentialsContainer.get()")}}{{securecontext_inline}}</dt> + <dd>Cette méthode renvoie une promesse ({{jsxref("Promise")}}) qui est résolue avec l'instance de {{domxref("Credential")}} qui correspond aux paramètres fournis.</dd> + <dt>{{domxref("CredentialsContainer.preventSilentAccess()")}}{{securecontext_inline}}</dt> + <dd>Cette méthode active un marqueur qui indique si une connexion automatique est autorisée pour les futures visites sur cette origine et renvoie une promesse ({{jsxref("Promise")}}) vide. <br> + <br> + On pourra par exemple appeler cette méthode après qu'un utilisateur se soit déconnecté d'un site web pour s'assurer qu'il n'est pas reconnecté à la prochaine visite. Dans des versions antérieures de la spécification, cette méthode était intitulée <code>requireUserMediation()</code>. Voir le tableau de compatibilité ci-après pour plus de détails.</dd> + <dt>{{domxref("CredentialsContainer.store()")}}{{securecontext_inline}}</dt> + <dd>Cette méthode enregistre des informations d'authentification pour un utilisateur à partir d'une instance {{domxref("Credential")}} fournie et renvoie cette instance dans une promesse ({{jsxref("Promise")}}).</dd> +</dl> + +<h2 id="Exemples">Exemples</h2> + +<pre class="brush: js">// TBD</pre> + +<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('Credential Management')}}</td> + <td>{{Spec2('Credential Management')}}</td> + <td>Définition initiale.</td> + </tr> + <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> + +<div class="hidden">Le tableau de compatibilité de cette page a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à consulter <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> et à nous envoyer une <em>pull request</em>.</div> + +<p>{{Compat("api.CredentialsContainer")}}</p> diff --git a/files/fr/web/api/credentialscontainer/preventsilentaccess/index.html b/files/fr/web/api/credentialscontainer/preventsilentaccess/index.html new file mode 100644 index 0000000000..6e66f28469 --- /dev/null +++ b/files/fr/web/api/credentialscontainer/preventsilentaccess/index.html @@ -0,0 +1,55 @@ +--- +title: CredentialsContainer.preventSilentAccess() +slug: Web/API/CredentialsContainer/preventSilentAccess +tags: + - API + - Credential Management API + - CredentialsContainer + - Méthode + - Reference +translation_of: Web/API/CredentialsContainer/preventSilentAccess +--- +<p>{{APIRef("")}}{{SeeCompatTable}}</p> + +<p>La méthode <strong><code>preventSilentAccess()</code></strong>, rattachée à l'interface {{domxref("CredentialsContainer")}}, permet de paramétrer une option pour indiquer si les connexions automatiques sont autorisées pour les futures visites à l'origine. Elle renvoie ensuite une promesse ({{jsxref("Promise")}}) vide.</p> + +<p>Cette méthode peut, par exemple, être appelée lorsqu'un utilisateur se déconnecte d'un site web afin de s'assurer qu'il n'est pas reconnecté à la prochaine visite. Cette gestion doit être gérée pour chaque origine.</p> + +<p>Dans des versions antérieures de la spécification, cette méthode était intitulée <code>requireUserMediation()</code>. Voir le tableau ci-après sur la compatibilité des navigateurs pour plus de détails.</p> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre class="syntaxbox">var Promise = CredentialsContainer.preventSilentAccess()</pre> + +<h3 id="Paramètres">Paramètres</h3> + +<p>Aucun.</p> + +<h3 id="Valeur_de_retour">Valeur de retour</h3> + +<p>Une promesse ({{jsxref("Promise")}}) vide.</p> + +<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('Credential Management','#dom-credentialscontainer-preventsilentaccess','preventSilentAccess()')}}</td> + <td>{{Spec2('Credential Management')}}</td> + <td>Définition initiale.</td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + +<div class="hidden">Le tableau de compatibilité de cette page a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à consulter <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> et à nous envoyer une <em>pull request</em>.</div> + +<p>{{Compat("api.CredentialsContainer.preventSilentAccess")}}</p> diff --git a/files/fr/web/api/credentialscontainer/store/index.html b/files/fr/web/api/credentialscontainer/store/index.html new file mode 100644 index 0000000000..f293a27e57 --- /dev/null +++ b/files/fr/web/api/credentialscontainer/store/index.html @@ -0,0 +1,62 @@ +--- +title: CredentialsContainer.store() +slug: Web/API/CredentialsContainer/store +tags: + - API + - Credential Management API + - CredentialsContainer + - Méthode + - Reference +translation_of: Web/API/CredentialsContainer/store +--- +<p>{{APIRef("")}}{{SeeCompatTable}}</p> + +<p>La méthode <strong><code>store()</code></strong>, rattachée à l'interface {{domxref("CredentialsContainer")}}, enregistre un ensemble d'informations d'authentification pour l'utilisateur dans une instance {{domxref("Credential")}} et renvoie cette instance au travers d'une promesse ({{domxref("Promise")}}).</p> + +<div class="note"> +<p><strong>Note :</strong> Cette méthode ne peut être utilisé que pour les contextes de navigation les plus hauts. Les appels lancés depuis une {{HTMLElement("iframe")}} résoudront la promesse sans aucun effet.</p> +</div> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre class="syntaxbox">CredentialsContainer.store(cred).then(function(credRes) { ... } )</pre> + +<h3 id="Paramètres">Paramètres</h3> + +<dl> + <dt><code>cred</code></dt> + <dd>Une instance valide de {{domxref("Credential")}}.</dd> +</dl> + +<h3 id="Valeur_de_retour">Valeur de retour</h3> + +<p>Une promesse ({{domxref("Promise")}}) qui sera résolue avec l'instance de {{domxref("Credential")}} passée en argument.</p> + +<h2 id="Exemples">Exemples</h2> + +<pre class="brush: js">// TBD</pre> + +<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('Credential Management')}}</td> + <td>{{Spec2('Credential Management')}}</td> + <td>Définition initiale.</td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + +<div class="hidden">Le tableau de compatibilité de cette page a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à consulter <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> et à nous envoyer une <em>pull request</em>.</div> + +<p>{{Compat("api.CredentialsContainer.store")}}</p> |