QAuthenticator

La classe QAuthenticator fournit un objet pour l'authentification. Plus d'informations...

#include <QAuthenticator>

Voir la position dans l'arbre des classes.

Note : toutes les fonctions de cette classe sont réentrantes.

Cette classe a été introduite dans Qt 4.3.

Description détaillée

La classe QAuthenticator fournit un objet pour l'authentification.

La classe QAuthenticator est habituellement utilisée dans les signaux authenticationRequired() et proxyAuthenticationRequired() de QNetworkAccessManager et QAbstractSocket. La classe fournit une méthode pour renvoyer au socket les informations d'authentification requises lors de l'accès à des services nécessitant une authentification.

QAuthenticator gère les méthodes d'authentification suivantes :

• Basic ;
• NTLM version 1 ;
• Digest-MD5.

Notez que, en particulier, NTLM version 2 n'est pas géré.

Options

En plus du nom d'utilisateur et du mot de passe nécessaires à l'authentification, un objet QAuthenticator peut aussi contenir des options supplémentaires. La fonction options() peut être utilisée pour accéder aux options entrantes envoyées par le serveur ; la fonction setOption() peut être utilisée pour définir les options sortantes devant être prises en compte dans le traitement d?authentification. Les options acceptées et fournies dépendent du type d?authentification (voir method()).

Les tables suivantes listent les options entrantes ainsi que les options sortantes acceptées. La liste des options entrantes n'est pas exhaustive, car les serveurs peuvent inclure des informations supplémentaires à tout moment. Par contre, la liste des options sortantes est exhaustive, et aucune option inconnue ne sera traitée ou renvoyée au serveur.

Basique

Le mécanisme d'authentification basique ne gère pas d'option sortante.

NTLM version 1

Le mécanisme d'authentification NTLM ne gère actuellement pas d'option entrante ni sortante.

Digest-MD5

Le mécanisme d'authentification Digest-MD5 ne gère pas d'option sortante.

Voir aussi QSslSocket.

Fonctions membres

QAuthenticator::QAuthenticator ()

Construit un objet d'authentification vide.

QAuthenticator::QAuthenticator ( const QAuthenticator & other )

Construit une copie de l'objet other.

QAuthenticator::~QAuthenticator ()

Détruit l'objet.

bool QAuthenticator::isNull () const

Retourne true si l'authentification est nulle.

QVariant QAuthenticator::option ( const QString & opt ) const

Retourne la valeur liée à l'option opt si elle a été définie par le serveur. Voir QAuthenticator::Options pour plus d'informations sur les options entrantes. Si l'option opt n'est pas trouvée, un QVariant invalide sera retourné.

Cette fonction a été introduite dans Qt 4.7.

Voir aussi setOption(), options() et QAuthenticator::Options.

QVariantHash QAuthenticator::options () const

Retourne toutes les options entrantes définies dans cet objet QAuthenticator en analysant la réponse du serveur. Voir QAuthenticator::Options pour plus d'information sur les options entrantes.

Cette fonction a été introduite dans Qt 4.7.

Voir aussi option() et QAuthenticator::Options.

QString QAuthenticator::password () const

Retourne le mot de passe utilisé pour l'authentification.

Voir aussi setPassword().

QString QAuthenticator::realm () const

Retourne le domaine nécessitant l'authentification.

void QAuthenticator::setOption ( const QString & opt, const QVariant & value )

Définit l'option opt sortante à la valeur value. Voir QAuthenticator::Options pour plus d'informations sur les options sortantes.

Cette fonction a été introduite dans Qt 4.7.

Voir aussi options(), option() et QAuthenticator::Options.

void QAuthenticator::setPassword ( const QString & password )

Définit le mot de passe utilisé pour l'authentification.

Voir aussi password().

void QAuthenticator::setUser ( const QString & user )

Définit le nom d'utilisateur utilisé pour l'authentification.

Voir aussi user().

QString QAuthenticator::user () const

Retourne le nom d'utilisateur utilisé pour l'authentification.

Voir aussi setUser().

bool QAuthenticator::operator!= ( const QAuthenticator & other ) const

Retourne true si le QAuthenticator est différent de other ; sinon retourne false.

QAuthenticator & QAuthenticator::operator= ( const QAuthenticator & other )

Affecte le contenu de other à cet objet.

bool QAuthenticator::operator== ( const QAuthenticator & other ) const

Retourne true si le QAuthenticator est identique à other ; sinon retourne false.

Remerciements

Merci à Alexandre Laurent pour la traduction et Ilya Diallo, Dimitry Ernot ainsi que Claude Leloup pour leur relecture !