Options de contexte SSL

Options

peer_name string

Nom du pair à utiliser. Si cette valeur n'est pas définie, alors le nom sera deviné en se basant sur le nom d'hôte utilisé lors de l'ouverture du flux.

verify_peer bool

Nécessite une vérification du certificat SSL utilisé.

Par défaut, vaut true.

verify_peer_name bool

Nécessite la vérification du nom du pair.

Par défaut, vaut true.

allow_self_signed bool

Permet les certificats autosignés. Requiert le paramètre verify_peer.

Par défaut, vaut false

cafile string

Endroit où se trouve le fichier de l'autorité du certificat sur le système de fichiers local et qui devra être utilisé avec l'option de contexte verify_peer pour identifier le pair distant.

capath string

Si cafile n'est pas spécifié ou si le certificat n'a pas été trouvé, une recherche dans le dossier pointé par capath sera effectuée afin d'y trouver un certificat valide. capath doit être un dossier de certificats correctement hachés.

local_cert string

Chemin vers le certificat local, sur le système de fichiers. Ce doit être un fichier encodé PEM qui contient le certificat et la clé privée. Il peut, optionnellement, contenir la chaîne de certification de l'émetteur. La clé privée peut également être contenue dans un fichier distinct spécifié par local_pk.

local_pk string

Chemin d'accès au fichier de clé privée locale sur le système de fichiers dans le cas de fichiers distincts pour le certificat (local_cert) et la clé privée.

passphrase string

La phrase de passe avec laquelle le fichier local_cert a été encodé.

verify_depth int

Échoue si la chaîne de certification est trop profonde.

Par défaut, aucune vérification.

ciphers string

Définit la liste des chiffrements. Le format de la chaîne est décrit sur la page » ciphers(1).

Par défaut, vaut DEFAULT.

capture_peer_cert bool

Si défini à true, une option de contexte peer_certificate sera créée, contenant le certificat du pair.

capture_peer_cert_chain bool

Si défini à true, une option de contexte peer_certificate_chain sera créée, contenant la chaîne de certification.

SNI_enabled bool

Si vaut true, l'indication sur le nom du serveur sera activée. Le fait d'activer SNI permet d'utiliser plusieurs certificats sur la même adresse IP.

SNI_server_certs array

Un tableau de noms de serveurs et de leurs certificats correspondants, à utiliser pour SNI. Les clés sont les noms de serveurs et les valeurs sont les chemins vers les fichiers de certificats sur le système de fichiers local. Les fichiers de certificats doivent être encodés PEM et contenir à la fois le certificat et la clé privée.

Disponible à partir de PHP 5.6.0.

alpn_protocols array

Un tableau de noms de protocoles de la couche application à utiliser pour ALPN (Application-Layer Protocol Negotiation). Les valeurs sont les noms de protocoles sous forme de chaînes (par exemple "http/1.1", "h2").

Disponible à partir de PHP 7.0.0 et OpenSSL 1.0.2.

no_ticket bool

Si défini, les tickets de session TLS sont désactivés. Cela peut aider à renforcer la sécurité en fournissant la confidentialité persistante (Perfect Forward Secrecy, PFS).

Disponible à partir de PHP 5.3.6.

disable_compression bool

Si défini, la compression TLS sera désactivée. Cela peut aider à atténuer le vecteur d'attaque CRIME.

peer_fingerprint string | array

Interrompt la connexion lorsque le condensé du certificat distant ne correspond pas au hachage spécifié.

Lorsqu'une chaîne de caractères est utilisée, la longueur va déterminer l'algorithme de hachage utilisé, soit "md5" (32), soit "sha1" (40).

Lorsqu'un tableau est utilisé, la clé indique le nom de l'algorithme de hachage, et chaque valeur correspondante représente le condensé attendu.

security_level int

Définit le niveau de sécurité. Si non spécifié, le niveau de sécurité par défaut de la bibliothèque est utilisé. Les niveaux de sécurité sont décrits dans » SSL_CTX_get_security_level(3).

Disponible à partir de PHP 7.2.0 et OpenSSL 1.1.0.

min_proto_version int

Définit la version minimale du protocole autorisée. Si non spécifiée, la version minimale du protocole par défaut de la bibliothèque est utilisée. Les versions du protocole sont décrites dans » SSL_CTX_set_min_proto_version(3).

Disponible à partir de PHP 7.3.0 et OpenSSL 1.1.0.

max_proto_version int

Définit la version maximale du protocole autorisée. Si non spécifiée, la version maximale du protocole par défaut de la bibliothèque est utilisée. Les versions du protocole sont décrites dans » SSL_CTX_set_max_proto_version(3).

Disponible à partir de PHP 7.3.0 et OpenSSL 1.1.0.