DarCas Sandbox

Google Data Protocol è un protocollo che deriva da REST ed il suo scopo è quello di interfacciare applicazioni di terze parti con gli applicativi Google.

Generalmente tutti i servizi Google prevedono la registrazione di un account (sebbene sia unificato). Per cui, va da se che la prima cosa che dobbiamo imparare a fare è utilizzare la API che permette di effettuare l’autenticazione.

Le Google Accounts APIs sono proprio l’oggetto di questo articolo, nello specifico vedremo come implementare in PHP 5 la API ClientLogin for Installed Applications.

Con questa tecnica possiamo effettuare l’autenticazione in maniera trasparente e direttamente da codice con una semplice transazione HTTP POST.

Lo schema che segue spiega visivamente come avviene la transazione:

La transazione è molto semplice, ed in PHP 5 possiamo utilizzare il bouquet di funzione cUrl per poter effettuare la transazione.

I valori da inviare sono la username, la password, il servizio Google al quale si vuole accedere ed il nome del nostro software.

La transazione risponderà in maniera più o meno simile a seconda del servizio al quale stiamo accedendo. Quello che c’è sempre in comune è il token Auth che è una stringa molto lunga e va utilizzata in tutte le transazioni successive: serve a riconoscerci.

La transazione potrebbe anche richiederci di rispondere ad un test Captcha. Praticamente viene inviata nella risposta una url che punta ad una immagine. Quest’ultima va visualizzata e l’utente utilizzatore deve inserire i caratteri che vede. Successivamente va rifatta la procedura di login, con i valori elencati prima più altri due: logintoken e logincaptcha; il primo è una stringa inviata contestualmente all’invio della url dell’immagine del captcha, la seconda altro non è che i caratteri inseriti dall’utilizzatori.

Dopo questa breve spiegazione (sul sito ufficiale c’è tutto!), passiamo al codice:

/** * Google Data API Protocol – ClientLogin * @tutorial http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html * * @param string $username * @param string $password * @param string $service * @param string $source * @param string $logintoken * @param string $logincaptcha * * @return array [return, http_code] */ function ClientLogin ( $action, $username, $password, $service, $source, $logintoken = null, $logincaptcha = null ) { $postFields['accountType'] = 'HOSTED_OR_GOOGLE'; $postFields['Email'] = $username; $postFields['Passwd'] = $password; $postFields['service'] = $service; $postFields['source'] = $source; if (!is_null($logintoken)) $postFields['logintoken'] = $logintoken; if (!is_null($logincaptcha)) $postFields['logincaptcha'] = $logincaptcha; $h_curl = curl_init(); { curl_setopt($h_curl, CURLOPT_URL, $action); curl_setopt($h_curl, CURLOPT_RETURNTRANSFER, 1); curl_setopt($h_curl, CURLOPT_SSL_VERIFYPEER, 0); curl_setopt($h_curl, CURLOPT_POST, 1); curl_setopt($h_curl, CURLOPT_POSTFIELDS, http_build_query($postFields)); $return = curl_exec($h_curl); $http_code = curl_getinfo($h_curl, CURLINFO_HTTP_CODE); } curl_close($h_curl); return array ( 'return' => trim($return), 'http_code' => $http_code ); }

Molto semplice, non credo di dover spendere parole alla spiegazione del codice. Come action (variabile $action) va inserito quello che di volta in volta è la pagine al quale va inviata l’autenticazione. In generale si inviano a “https://www.google.com/accounts/ClientLogin”, tuttavia ci sono delle eccezioni, come ad esempio nel caso di YouTube, che prevede che la transazione venga inviata a “https://www.google.com/youtube/accounts/ClientLogin”.