Authentification avec ClientLogin
Le mécanisme dit "ClientLogin" vous permet d'écrire des applications PHP qui
récupèrent une authentification vis à vis des services Google, en spécifiant des
identifiants dans le client HTTP.
Voyez
http://code.google.com/apis/accounts/AuthForInstalledApps.html pour plus
d'informations sur l'authentification ClientLogin de Google Data.
La documentation Google indique que le mécanisme ClientLogin est approprié dans le cas
d'applications embarquées, à la différence du mécanisme AuthSub, utilisé pour les
applications Web ayant recours à une authentification extérieure. AuthSub récupère des
identifiant d'un utilisateur de l'application Web, et un navigateur réagissant aux
redirections est requis. Le processus ClientLogin, lui, utilise du code PHP tel qu'écrit
dans l'application elle-même. L'utilisateur de l'application n'entre pas en jeu pour fournir
des identifiants de manière interactive.
Les identifiants fournis au mécanisme ClientLogin doivent correspondre à des
identifiants valides pour les services Google, mais il n'est pas nécessaire qu'ils
correspondent à ceux de l'utilisateur de l'application.
Création d'un client HTTP "ClientLogin" authentifié
La création d'un client HTTP "ClientLogin" authentifié est un processus servi par
la méthode statique Zend_Gdata_ClientLogin::getHttpClient().
Passez lui les identifiants Google services sous forme de texte (plain text). La valeur
de retour de cette méthode est un objet Zend_Http_Client.
Le troisième paramètre optionnel est le nom du service Google Data. Par exemple,
il peut être "cl" pour Google Calendar. Par défaut il s'agit de "xapi", ce qui
correspond au service générique de Google Data.
La quatrième paramètre optionnel est une instance de
Zend_Http_Client. Vous pouvez alors configurer votre client à
part (par exemple lui ajouter des options pour la gestion d'un Proxy). Si vous passez
NULL à ce paramètre, alors un client
Zend_Http_Client générique est crée.
Le cinquième paramètre optionnel est le nom du client que les serveurs Google Data
identifieront en interne. Par défaut il s'agit de "Zend-ZendFramework".
Le sixième paramètre, toujours optionnel, est l'ID pour le challenge
CAPTCHA retourné par le serveur. Ce paramètre n'est nécessaire
que si vous avez reçu un challenge lors d'un processus d'authentification passé, et que
vous le renvoyez pour résolution..
Le septième paramètre optionnel représente la réponse de l'utilisateur au
challenge CAPTCHA précédemment reçu. Il n'est donc nécessaire que
si vous avez reçu un challenge CAPTCHA à résoudre.
Ci dessous, un exemple d'une application PHP qui s'authentifie auprès du service
Google Calendar et crée un objet client Zend_Gdata utilisant
l'objet Zend_Http_Client fraîchement authentifié :
getCaptchaUrl() . "\n";
echo 'Token ID: ' . $cre->getCaptchaToken() . "\n";
} catch (Zend_Gdata_App_AuthException $ae) {
echo 'Problème d'authentification : ' . $ae->exception() . "\n";
}
$cal = new Zend_Gdata_Calendar($client);
]]>
Fermer un client HTTP authentifié par ClientLogin
Il n'y a pas de méthode pour supprimer l'authentification effectuée via un
ClientLogin, comme c'est le cas avec le système de jeton du procédé AuthSub. Les
identifiants dans le ClientLogin étant un identifiant et un mot de passe de compte
Google, ils ne peuvent être invalidés et sont utilisables de manière continue.