---
title: webRequest.SecurityInfo
slug: Mozilla/Add-ons/WebExtensions/API/webRequest/SecurityInfo
tags:
  - API
  - Add-ons
  - Reference
  - SecurityInfo
  - Type
  - WebExtensions
  - webRequest
translation_of: Mozilla/Add-ons/WebExtensions/API/webRequest/SecurityInfo
---
<div>{{AddonSidebar()}}</div>

<p>Objet décrivant les propriétés de sécurité d'une requête Web particulière. Un objet de ce type est retourné depuis l'API {{WebExtAPIRef("webRequest.getSecurityInfo()")}}.</p>

<p>Si la requête n'est pas sécurisée par <a href="/fr/docs/Glossaire/TLS">TLS</a>, alors cet objet ne contiendra que l'état de la propriété <code>state</code>, dont la valeur sera <code>"insecure"</code>.</p>

<h2 id="Type">Type</h2>

<p>Les valeurs de ce type sont des objets. Ils contiennent les propriétés suivantes :</p>

<dl>
 <dt><code>certificates</code></dt>
 <dd><p><code>Array</code> de {{WebExtAPIRef("webRequest.CertificateInfo", "CertificateInfo")}}. Si {{WebExtAPIRef("webRequest.getSecurityInfo()")}} a été appelé avec l'option <code>certificateChain</code> présente et définie sur <code>true</code>, cela contiendra un objet <code>CertificateInfo</code> pour chaque certificat de la chaîne, depuis le certificat du serveur jusqu'à et y compris la racine de confiance.</p>
 <p>Sinon, il contiendra un seul objet <code>CertificateInfo</code>, pour le certificat du serveur.</p></dd>
 <dt><code>certificateTransparencyStatus</code> {{optional_inline}}</dt>
 <dd>
 <p><code>String</code>. Indique l'état de la <a href="https://www.certificate-transparency.org/">transparence des certificats</a> pour la connexion. Ceci peut prendre l'une des valeurs suivantes :</p>

 <ul>
  <li>"not_applicable"</li>
  <li>"policy_compliant"</li>
  <li>"policy_not_enough_scts"</li>
  <li>"policy_not_diverse_scts"</li>
 </ul>
 </dd>
 <dt><code>cipherSuite</code> {{optional_inline}}</dt>
 <dd><code>String</code>. Suite de chiffrement utilisée pour la connexion, formatée selon la <a href="https://tools.ietf.org/html/rfc5246#appendix-A.5">specification TLS </a>: par exemple, "TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256".</dd>
 <dt><code>errorMessage</code> {{optional_inline}}</dt>
 <dd>
 <p><code>String</code>. S'il y a eu un problème avec le protocole TLS  (for example, the certificate had expired, or a trusted root could not be found, or a certificate was revoked) then <code>status</code> will be "broken" and the <code>errorMessage</code> property will contain a string describing the error, taken from Firefox's internal list of error codes.</p>

 <p>Note though that at present you can only call <code>getSecurityInfo()</code> in the <code>onHeaderReceived</code> listener, and the <code>onHeaderReceived</code> event is not fired when the handshake fails. So in practice this will never be set. </p>
 </dd>
 <dt><code>hpkp</code> {{optional_inline}}</dt>
 <dd><code>Boolean</code>. <code>true</code> si l'hôte utilise <a href="/fr/docs/Web/Security/Public_Key_Pinning">Public Key Pinning</a>, sinon <code>false</code>.</dd>
 <dt><code>hsts</code> {{optional_inline}}</dt>
 <dd><code>Boolean</code>. <code>true</code> si l'hôte utilise <a href="/fr/docs/Sécurité/HTTP_Strict_Transport_Security">Strict Transport Security</a>, sinon <code>false</code>.</dd>
 <dt><code>isDomainMismatch</code> {{optional_inline}}</dt>
 <dd><code>Boolean</code>. <code>true</code> si le nom de domaine du serveur ne correspond pas au nom de domaine dans son certificat, sinon <code>false</code>.</dd>
 <dt><code>isExtendedValidation</code> {{optional_inline}}</dt>
 <dd><code>Boolean</code>. <code>true</code> si le serveur possède un <a href="https://en.wikipedia.org/wiki/Extended_Validation_Certificate">Extended Validation Certificate</a>, sinon <code>false</code>.</dd>
 <dt><code>isNotValidAtThisTime</code> {{optional_inline}}</dt>
 <dd><code>Boolean</code>. <code>true</code> si l'heure actuelle tombe en dehors de la période de validité du certificat de serveur (c'est-à-dire que le certificat a expiré ou n'est pas encore valide), sinon <code>false</code>.</dd>
 <dt><code>isUntrusted</code> {{optional_inline}}</dt>
 <dd><code>Boolean</code>. <code>true</code> si une chaîne de retour à un certificat racine de confiance n'a pas pu être construite, sinon <code>false</code>.</dd>
 <dt><code>keaGroupName</code> {{optional_inline}}</dt>
 <dd><code>String</code>. Si <code>state</code> est "sécurisé" cela décrit l'algorithme d'échange de clé utilisé dans cette requête.</dd>
 <dt><code>protocolVersion</code> {{optional_inline}}</dt>
 <dd>
 <p><code>String</code>. Version du protocole TLS utilisé. L'un des :</p>

 <ul>
  <li>"TLSv1"</li>
  <li>"TLSv1.1"</li>
  <li>"TLSv1.2"</li>
  <li>"TLSv1.3"</li>
  <li>"inconnu" (si la version n'est pas valide)</li>
 </ul>
 </dd>
 <dt><code>signatureSchemeName</code> {{optional_inline}}</dt>
 <dd><code>String</code>. Si <code>state</code> est "sécurisé", cela décrit le schéma de signature utilisé dans cette requête.t.</dd>
 <dt><code>state</code></dt>
 <dd>
 <p><code>String</code>. État de la connexion. L'un des :</p>

 <ul>
  <li>"broken": la poignée de main TLS a échoué (par exemple, le certificat a expiré)</li>
  <li>"insecure": la connexion n'est pas une connexion TLS</li>
  <li>"secure": la connexion est une connexion TLS sécurisée</li>
  <li>"weak": la connexion est une connexion TLS mais est considérée comme faible. Vous pouvez examiner les <code>weaknessReasons</code> pour découvrir le problème.</li>
 </ul>

 <p>Notez cependant qu'actuellement, vous ne pouvez appele <code>getSecurityInfo()</code> que dans l'écouteur <code>onHeaderReceived</code>, et l'événement <code>onHeaderReceived</code> n'est pas déclenché lorsque la poignée de main échoue. Ainsi, dans la pratique, il ne sera jamais réglé sur "cassé".</p>
 </dd>
 <dt><code>weaknessReasons</code> {{optional_inline}}</dt>
 <dd><code>String</code>. Si l'<code>état</code> est "faible", cela indique la raison. Actuellement, il ne peut contenir qu'une seule valeur "chiffre", ce qui indique que la suite de chiffres négociée est considérée comme faible.</dd>
</dl>

<h2 id="Compatibilité_du_navigateur">Compatibilité du navigateur</h2>

<p>{{Compat("webextensions.api.webRequest.SecurityInfo", 10)}}</p>

<p>{{WebExtExamples}}</p>