Authentification Frankiz

Frankiz permet à des sites externes (binets en particulier) d'utiliser sa base de données pour authentifier les utilisateurs.

Le webmaster du site en question doit auparavant faire une demande de mise en place de ce système en envoyant un mail à l'équipe frankiz (web@eleves.polytechnique.fr). Il doit alors donner :

• l'url complète de la page de login de son site (plus précisément, l'URL de callback)
• les informations auxquelles il souhaite accéder
• une justification de la demande (et oui, on ne partage évidemment pas notre base de données avec n'importe qui !)

Si la demande est acceptée, un admin Frankiz va alors inscrire ton site dans notre base de donnée de sites externes et générer une clé qu'il va te communiquer. Cette opération se déroule via l'interface d'administration de frankiz. Cette clé va te permettre d'authentifier les échanges d'informations entre frankiz et le site externe.

Liste des informations disponibles

Tu peux demander l'accès aux informations

• names : prénom, nom, surnom, identifiant Frankiz
• email : adresse mail
• photo : URL vers la photo TOL
• promo : nom du premier groupe promo
• sport : nom de la section sportive (si applicable)
• rights : droits dans les groupes associés
• binets_admin : liste des binets dont l'utilisateur est administrateur

Code de la page d'identification en PHP

Ci dessous un exemple commenté de script d'authentification, à mettre sur le site externe :

<?php
include 'fkz_auth.php';
if(!isset($_GET['response'])){
  frankiz_do_auth();
}
$auth = frankiz_get_response();
// et voila !
// les données sont stockées dans $auth = array(key => value, ...);

Code des fonctions utilisées dans fkz_auth.php

<?php
/**
 * Clé secrète fournie par l'équipe frankiz lors de l'inscription du site.
 * Cette clé sert à signer les requêtes et à authentifier le site.
 */
$FKZ_KEY = "000";

function frankiz_do_auth(){
   global $FKZ_KEY;
  /**
   * Prendre le timestamp permet d'éviter le rejet de la requête
   */
  $timestamp = time();
  /**
   * url de la page de login, doit correspondre *exactement* à celle entrée dans
   * la base de données de Frankiz (définie lors de l'inscription)
   */
  $site = 'http://monsite/login';
  /**
   * Champ non utile pour l'authentification et retransmis tel quel par frankiz. 
   * Il est prévu pour pouvoir mettre en place un système de redirection après 
   * authentification, vers la page à partir de laquelle le client avait tenté de se connecter.
   */
  $location  = "..." 
  /**
   * Nature de la requête.
   * Fkz renverra ici à la fois les noms de la personne mais aussi ses droits dans différents groupes.
   * Il faut cependant que le site ait les droits sur les informations en question (à définir lors de son inscription).
   */
  $request = json_encode(array('names', 'rights', 'email', 'sport', 'promo', 'photo'));
  
  $hash = md5($timestamp . $site . $FKZ_KEY . $request);
  
  $remote  = 'https://www.frankiz.net/remote?timestamp=' . $timestamp .
      '&site=' . $site .
      '&location=' . $location .
      '&hash=' . $hash .
      '&request=' . $request;
   header("Location:" . $remote);
   exit();
}

function frankiz_get_response(){
   global $FKZ_KEY;
   // Read request
   $timestamp = (isset($_GET['timestamp']) ? $_GET['timestamp'] : 0);
   $response  = (isset($_GET['response'])  ? urldecode($_GET['response'])  : '');
   $hash      = (isset($_GET['hash'])      ? $_GET['hash']      : '');
   $location  = (isset($_GET['location'])  ? $_GET['location']  : '');

   // Frankiz security protocol
   if (abs($timestamp - time()) > 600)
      die("Délai de réponse dépassé. Annulation de la requête");
   if (md5($timestamp . $FKZ_KEY . $response) != $hash)
      die("Session compromise.");
   
   $response = json_decode($response, true);
   $response['location'] = $location;

   // Set empty fields
   $fields = array('hruid',
     'firstname', 'lastname', 'nickname',
     'promo', 'photo', 'location');
   foreach ($fields as $k) {
      if (!isset($response[$k]))
      $response[$k] = '';
   }
   return $response;
}

Avec Django

L'interfaçage avec Django n'est pas trivial, pour le faire proprement il faudrait coder un backend d'authentification. En attendant, le code ci dessous est un peu sale mais marche. Il sauve l'username frankiz dans la session, ce qui est raisonnablement safe normalement.

def logout(request):
    del request.session["username"]
    request.session.modified = True
    return redirect("/") 
 
def fkz_answer(request): 
    if not "timestamp" in request.GET.keys() or not "response" in request.GET.keys() or not "hash" in request.GET.keys(): 
        return redirect("/login_required/")
    response = request.GET.get("response")
    ts = request.GET.get("timestamp")
    h = request.GET.get("hash")

    if abs(int(timestamp()) - int(ts)) > 600:
        return redirect("/login_required/")

    if hashlib.md5(ts + FKZ_KEY + response).hexdigest() != h:
        return redirect("/login_required/")

    data = json.loads(response)
    request.session['username'] = data['hruid']
    return redirect("/")

def fkz_do_login(request):
    ts = timestamp()
    page = "http://***/fkz_answer/"
    r = json.dumps(["names", "email"])
    h = hashlib.md5(ts + page + FKZ_KEY + r).hexdigest()
    return redirect("http://www.frankiz.net/remote?"+urlencode([('timestamp',ts),('site',page),('hash',h),('request',r)]))

Avec Drupal

L'implémentation de l'authentification avec un CMS comme Drupal n'est pas forcément évidente. Si vous avez une question, vous pouvez contacter Antoine Sauvage

Bugs vécus

Si authentification fonctionne sur certains navigateurs, vérifier les variables $_GET car elles sont peut être doublement encodées. Dans ce cas, soit refaire urldecode, soit un

$s = str_replace('%22','"',$s);

Si il y a un problème avec les encodages en \umachinchose pour les caractères accentués, voila une fonction qui peut vous servir (reconversion en UTF-8) :

function jsonClean($s) {
  return preg_replace("/\\\\u([a-f0-9]{4})/e", "iconv('UCS-4LE','UTF-8',pack('V', hexdec('U$1')))",$s);
}