Εισαγωγή στο HTTP Basic Authentication με το Twitter API

Στέλιος Πετράκης, στις 12 November 2008 · Ανάπτυξη ·

Η ύπαρξη μιας πληθώρας από APIs στις μέρες μας (περί τα 1013 κατά το ProgrammableWeb), δίνει την δυνατότητα σε όλους να πειραματιστούν με τα δεδομένα αρκετών web services, είτε έχουν βασικές γνώσεις προγραμματισμού, είτε είναι πιο προχωρημένοι.

Οι λειτουργίες που προσφέρουν τα APIs στους developers παρόλα αυτά, δεν περιορίζονται μόνο στην αποστολή πληροφορίας από τις υπηρεσίες. Αρκετά από αυτά προχωράνε ένα ακόμη βήμα, προσφέροντας δυνατότητα πιστοποίησης των χρηστών της υπηρεσίας με πολλαπλούς τρόπους. Κάποιες υπηρεσίες χρησιμοποιούν συστήματα πιστοποίησης βασισμένα σε tokens (όπως το Flickr), ενώ άλλες έχουν ενστερνιστεί πρότυπα όπως το oAuth. Τα περισσότερα authentication-aware APIs παρόλα αυτά, υποστηρίζουν ένα αρκετά απλό σύστημα πιστοποίησης που ακούει στο όνομα HTTP Basic Authentication.

Μια αρκετά γνωστή υπηρεσία που παρέχει δυνατότητα πιστοποίησης των χρηστών μέσω του HTTP Basic Authentication, είναι το Twitter. Αλλά ας δούμε πρώτα τι ακριβώς είναι το HTTP Basic Authentication.

Τι είναι το HTTP Basic Authentication;

Το HTTP Basic Authentication πρόκειται για ένα σύστημα αποστολής των στοιχείων του χρήστη κατά την αίτηση μιας σελίδας/resouce από το web. Για να γίνει κάτι τέτοιο δυνατό, από πλευράς PHP, ο προγραμματιστής θα πρέπει να δημιουργήσει ένα socket (ένα κανάλι διπλής κατεύθυνσης μεταξύ δύο συνδεδεμένων υπολογιστών) και να γράψει όλη την αίτηση μέσα στο socket αυτό. Το username και το password του χρήστη που πρόκειται να πιστοποιηθεί, αποστέλονται με κωδικοποίηση base-64 με την μορφή base64(username:password).

Βασικός μας στόχος σε αυτό το tutorial, είναι να περιγραφεί ο τρόπος που μπορεί κάποιος να πετύχει την παραπάνω μορφή πιστοποίησης, χρησιμοποιώντας το Twitter API, ώστε τελικά να στείλει ένα tweet από το mashup του.

Βήμα 1: Δημιουργία της σελίδας με την φόρμα

Παρακάτω θα δημιουργήσουμε μια απλή φόρμα με 3 πεδία: username, password και το μήνυμα προς αποστολή.

Δημιουργήστε ένα νέο .php αρχείο (π.χ. twitter.php) και αντιγράψτε τον παρακάτω κώδικα:

Με την προϋπόθεση πως τρέχετε κάποιον web server και έχετε τοποθετήσει το αρχείο αυτό στον σωστό φάκελο (π.χ. htdocs ή ανάλογα τις ρυθμίσεις σας), πληκτρολογώντας το url της σελίδας στον browser, θα πρέπει να δείτε κάτι σαν το παρακάτω:

Βήμα 2: Επιλέξτε τον τρόπο για το HTTP Basic Authentication που σας ταιριάζει

Όπως αναφέραμε, το Twitter χρησιμοποιεί το HTTP Basic Authentication, αυτό όμως δεν σημαίνει απαραίτητα πως πρέπει να γράψετε όλη την αίτηση χειροκίνητα. Στην πραγματικότητα υπάρχουν 2 τρόποι για να αποστείλει κάποιος ένα tweet από το twitter mashup του.

Curl

Οι περισσότεροι web servers έχουν εγκατεστημένη την βιβλιοθήκη libcurl, μια δωρεάν URL transfer library, που κάνει την όλη διαδικασία ευκολότερη.

Έτσι λοιπόν, ο απλός τρόπος είναι η κλήση των κατάλληλων PHP functions, με την curl να χειρίζεται όλα τα υπόλοιπα (credit στον Gareth Rushgrove για την αρχική έμπνευση).

Βουτιά στα δύσκολα: Δημιουργία του socket

Όπως είπαμε και πριν, η curl δεν είναι εγκατεστημένη σε όλους τους web servers. Αν και πάντα υπάρχει η δυνατότητα εγκατάστασης της βιβλιοθήκης από τους administrators, παρόλα αυτά ας εξετάσουμε τι θα έπρεπε να κάνουμε αν προγραμματίζαμε τα πάντα μόνοι μας. Μην φοβάστε, δεν είναι τόσο δύσκολα τα πράγματα!

$username	= $_POST['username'];
$password	= $_POST['password'];
$message	= $_POST['message'];

//encode username and password with the form we described before
$encodedstring = base64_encode($username.":".$password);

//create the socket to twitter using fsockopen
$fp = fsockopen("www.twitter.com", 80, $errno, $errstr, 30);

//some basic error handling
if (!$fp) {
	echo "Oh noes! ".$errstr."!\n";
} else {
	// Your socket message. Every line here has its purpose. 
	
	// Request type (POST) and the page of the service we request
	// as dictated by twitter api documentation
	$socket_message = "POST /statuses/update.json?status=".urlencode($message)." HTTP/1.0\r\n";

// Host service of the request, twitter of course
	$socket_message .= "Host: <a href="http://www.twitter.com\r\n";">http://www.twitter.com\r\n";</a>
	
	// The authentication line
 	$socket_message .= "Authorization:Basic ".$encodedstring."\r\n\r\n";

// After this we write socket message to the created socket
   	fwrite($fp, $socket_message);

// Read the socket in order to catch twitter response
	// to the previous request
	$success = 0;
	
	while (!feof($fp)) {

// Read 1 line at a time
		$line = fgets($fp,128);

// Read Status line from server response
		// to evaluate that request has been processed correctly
		if(strstr($line,"Status")){

// If all goes as planned,
			// twitter will respond with a Status code 200
			if(strstr($line,"200")){
				$success = 1;
			}
		}
	}

// Close the socket
	fclose($fp);
	
	if($success == 1)
		echo "Tweet made!\n";
	else
		echo "Oh noes! Error!\n";
}

Βήμα 3: Ενσωμάτωση του κώδικα στην σελίδα

Όπως μπορείτε να δείτε παραπάνω, οι δύο τρόποι μοιράζονται αρκετά κοινά χαρακτηριστικά και αυτό γιατί υλοποιούν και οι δύο το ίδιο σύστημα πιστοποίησης.

Αφού επιλέξετε τον τρόπο που σας ταιριάζει αντιγράψτε τον κάτω από το σχόλιο της PHP "HTTP Basic Authentication PHP Code to be added here" στην σελίδα που δημιουργήσατε πιο πριν και είστε έτοιμοι.

Δοκιμάστε να στείλετε ένα tweet!

Στέλιος Πετράκης

Ο Στέλιος Πετράκης (stelabouras) δηλώνει φανατικός gamer και web addict. Εργάζεται ως web developer στην Phaistos Networks, ολοκληρώνει το μεταπτυχιακό του, γράφει posts στο Wiggler.gr, αναπτύσσει και συντηρεί το Slideflickr.com και στον ελεύθερό του χρόνο πειραματίζεται με οτιδήποτε έχει σχέση με web, programming, design και games.