documentation/manual/fr/module_specs/Zend_Gdata_ClientLogin.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- EN-Revision: 21826 -->
   3 <!-- Reviewed: no -->
   4 <sect1 id="zend.gdata.clientlogin">
   5     <title>Authentification avec ClientLogin</title>
   6
   7     <para>
   8         Le mécanisme dit "ClientLogin" vous permet d'écrire des applications <acronym>PHP</acronym> qui
   9         récupèrent une authentification vis à vis des services Google, en spécifiant des
  10         identifiants dans le client <acronym>HTTP</acronym>.
  11     </para>
  12
  13     <para>
  14         Voyez <ulink url="http://code.google.com/apis/accounts/AuthForInstalledApps.html">
  15         http://code.google.com/apis/accounts/AuthForInstalledApps.html </ulink> pour plus
  16         d'informations sur l'authentification ClientLogin de Google Data.
  17     </para>
  18
  19     <para>
  20         La documentation Google indique que le mécanisme ClientLogin est approprié dans le cas
  21         d'applications embarquées, à la différence du mécanisme AuthSub, utilisé pour les
  22         applications Web ayant recours à une authentification extérieure. AuthSub récupère des
  23         identifiant d'un utilisateur de l'application Web, et un navigateur réagissant aux
  24         redirections est requis. Le processus ClientLogin, lui, utilise du code <acronym>PHP</acronym> tel qu'écrit
  25         dans l'application elle-même. L'utilisateur de l'application n'entre pas en jeu pour fournir
  26         des identifiants de manière interactive.
  27     </para>
  28
  29     <para>
  30         Les identifiants fournis au mécanisme ClientLogin doivent correspondre à des
  31         identifiants valides pour les services Google, mais il n'est pas nécessaire qu'ils
  32         correspondent à ceux de l'utilisateur de l'application.
  33     </para>
  34
  35     <sect2 id="zend.gdata.clientlogin.login">
  36         <title>Création d'un client HTTP "ClientLogin" authentifié</title>
  37
  38         <para>
  39             La création d'un client <acronym>HTTP</acronym> "ClientLogin" authentifié est un processus servi par
  40             la méthode statique <methodname>Zend_Gdata_ClientLogin::getHttpClient()</methodname>.
  41             Passez lui les identifiants Google services sous forme de texte (plain text). La valeur
  42             de retour de cette méthode est un objet <classname>Zend_Http_Client</classname>.
  43         </para>
  44
  45         <para>
  46             Le troisième paramètre optionnel est le nom du service Google Data. Par exemple,
  47             il peut être "cl" pour Google Calendar. Par défaut il s'agit de "xapi", ce qui
  48             correspond au service générique de Google Data.
  49         </para>
  50
  51         <para>
  52             La quatrième paramètre optionnel est une instance de
  53             <classname>Zend_Http_Client</classname>. Vous pouvez alors configurer votre client à
  54             part (par exemple lui ajouter des options pour la gestion d'un Proxy). Si vous passez
  55             <constant>NULL</constant> à ce paramètre, alors un client
  56             <classname>Zend_Http_Client</classname> générique est crée.
  57         </para>
  58
  59         <para>
  60             Le cinquième paramètre optionnel est le nom du client que les serveurs Google Data
  61             identifieront en interne. Par défaut il s'agit de "Zend-ZendFramework".
  62         </para>
  63
  64         <para>
  65             Le sixième paramètre, toujours optionnel, est l'ID pour le challenge
  66             <trademark>CAPTCHA</trademark> retourné par le serveur. Ce paramètre n'est nécessaire
  67             que si vous avez reçu un challenge lors d'un processus d'authentification passé, et que
  68             vous le renvoyez pour résolution..
  69         </para>
  70
  71         <para>
  72             Le septième paramètre optionnel représente la réponse de l'utilisateur au
  73             challenge <trademark>CAPTCHA</trademark> précédemment reçu. Il n'est donc nécessaire que
  74             si vous avez reçu un challenge <trademark>CAPTCHA</trademark> à résoudre.
  75         </para>
  76
  77         <para>
  78             Ci dessous, un exemple d'une application <acronym>PHP</acronym> qui s'authentifie auprès du service
  79             Google Calendar et crée un objet client <classname>Zend_Gdata</classname> utilisant
  80             l'objet <classname>Zend_Http_Client</classname> fraîchement authentifié :
  81         </para>
  82
  83         <programlisting language="php"><![CDATA[
  84 // identifiants de compte Google
  85 $email = 'johndoe@gmail.com';
  86 $passwd = 'xxxxxxxx';
  87 try {
  88    $client = Zend_Gdata_ClientLogin::getHttpClient($email, $passwd, 'cl');
  89 } catch (Zend_Gdata_App_CaptchaRequiredException $cre) {
  90     echo 'l'URL de l\'image CAPTCHA est: ' . $cre->getCaptchaUrl() . "\n";
  91     echo 'Token ID: ' . $cre->getCaptchaToken() . "\n";
  92 } catch (Zend_Gdata_App_AuthException $ae) {
  93    echo 'Problème d'authentification : ' . $ae->exception() . "\n";
  94 }
  95
  96 $cal = new Zend_Gdata_Calendar($client);
  97 ]]></programlisting>
  98     </sect2>
  99
 100     <sect2 id="zend.gdata.clientlogin.terminating">
 101         <title>Fermer un client HTTP authentifié par ClientLogin</title>
 102
 103         <para>
 104             Il n'y a pas de méthode pour supprimer l'authentification effectuée via un
 105             ClientLogin, comme c'est le cas avec le système de jeton du procédé AuthSub. Les
 106             identifiants dans le ClientLogin étant un identifiant et un mot de passe de compte
 107             Google, ils ne peuvent être invalidés et sont utilisables de manière continue.
 108         </para>
 109     </sect2>
 110 </sect1>