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.