.\" Automatically generated by Pod::Man 2.28 (Pod::Simple 3.29)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{
.    if \nF \{
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "fr::ssl::SSL_CTX_use_psk_identity_hint 3SSL"
.TH fr::ssl::SSL_CTX_use_psk_identity_hint 3SSL "2015-12-31" "1.0.2a 1.0.2c" "OpenSSL"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NOM"
.IX Header "NOM"
SSL_CTX_use_psk_identity_hint, SSL_use_psk_identity_hint,
SSL_CTX_set_psk_server_callback, SSL_set_psk_server_callback \- Définir un
indice d'identité \s-1PSK\s0 à utiliser
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
\& #include <openssl/ssl.h>
\&
\& int SSL_CTX_use_psk_identity_hint(SSL_CTX *ctx, const char *hint);
\& int SSL_use_psk_identity_hint(SSL *ssl, const char *hint);
\&
\& void SSL_CTX_set_psk_server_callback(SSL_CTX *ctx,
\&        unsigned int (*callback)(SSL *ssl, const char *identity,
\&        unsigned char *psk, int max_psk_len));
\& void SSL_set_psk_server_callback(SSL *ssl,
\&        unsigned int (*callback)(SSL *ssl, const char *identity,
\&        unsigned char *psk, int max_psk_len));
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBSSL_CTX_use_psk_identity_hint\fR() définit l'indice d'identité \s-1PSK \s0\fIhint\fR
terminé par \s-1NULL\s0 à l'objet de contexte \s-1SSL
\&\s0\fIctx\fR. \fBSSL_use_psk_identity_hint\fR() définit l'indice d'identité \s-1PSK
\&\s0\fIhint\fR terminé par \s-1NULL\s0 à l'objet de connexion \s-1SSL \s0\fIssl\fR. Si \fIhint\fR est
\&\s-1NULL,\s0 les indices actuels de \fIctx\fR ou \fIssl\fR sont supprimés.
.PP
Dans le cas où l'indice d'identité \s-1PSK\s0 est \s-1NULL,\s0 le serveur n'envoie pas le
message ServerKeyExchange au client.
.PP
Une application serveur doit fournir une fonction de rappel qui est appelée
quand le serveur reçoit le message ClientKeyExchange du client. Le but de
cette fonction de rappel est de valider l'identité \s-1PSK\s0 reçue et de récupérer
la clef prépartagée utilisée pendant la phase de configuration de
connexion. Le rappel est défini en utilisant les fonctions
\&\fBSSL_CTX_set_psk_server_callback\fR() ou \fBSSL_set_psk_server_callback\fR(). À
la fonction de rappel, sont fournis : la connexion dans le paramètre \fIssl\fR,
l'identité \s-1PSK\s0 terminée par \s-1NULL\s0 envoyée par le client dans le paramètre
\&\fIidentity\fR, et un tampon \fIpsk\fR de taille \fImax_psk_len\fR octets où la clef
prépartagée sera stockée.
.SH "VALEURS DE RETOUR"
.IX Header "VALEURS DE RETOUR"
\&\fBSSL_CTX_use_psk_identity_hint\fR() et \fBSSL_use_psk_identity_hint\fR()
renvoient \fB1\fR en cas de réussite et \fB0\fR sinon.
.PP
Les valeurs de retour du rappel serveur sont interprétées comme suit.
.IP "0" 4
L'identité \s-1PSK\s0 n'a pas été trouvée. Un message d'alerte
« unknown_psk_identity » sera envoyé et la configuration de connexion
échoue.
.IP ">0" 4
.IX Item ">0"
Une identité \s-1PSK\s0 a été trouvée et le rappel serveur a bien fourni le \s-1PSK\s0
dans le paramètre \fIpsk\fR. La valeur de retour est la taille de \fIpsk\fR en
octet. C'est une erreur de renvoyer une valeur plus grande que
\&\fImax_psk_len\fR.
.Sp
Si l'identité \s-1PSK\s0 n'a pas été trouvée mais que le rappel demande tout de
même au protocole de continuer, le rappel doit fournir quelques données
aléatoires à \fIpsk\fR et renvoyer la taille des données aléatoires, de telle
sorte que la connexion échoue avec decryption_error avant de se terminer
complètement.
.SH "TRADUCTION"
.IX Header "TRADUCTION"
La traduction de cette page de manuel est maintenue par
les membres de la liste <debian\-l10n\-french \s-1AT\s0 lists \s-1DOT\s0 debian \s-1DOT\s0 org>.
Veuillez signaler toute erreur de traduction par un rapport de bogue sur
le paquet manpages-fr-extra.