WikiBR - Contributions [fr]

Authentification Frankiz

2012-05-01T15:50:34Z

Olivier.charvin : Bugs vécus...

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 (frankiz@frankiz.polytechnique.fr).
Il doit alors donner :
* l'url complète de la page de login de son site
* 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, l'équipe frankiz renvoie alors une clé permettant d'authentifier les échanges d'informations entre frankiz et le site externe.
Le site est alors inscrit dans notre base de données, et peut utiliser le système d'authentification externe.

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

==Code de la page d'identification==

<code php>
<?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>

==Code des fonctions utilisées dans ''fkz_auth.php''==
<code 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 rejeu 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;
}
?>
</code>

==Bugs vécu==
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 \u''machinchose'' 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);
}

Frankiz

2012-04-28T19:18:25Z

Olivier.charvin : /* Authentification sur des sites externes */ séparation dans un autre article

Frankiz est le portail interne des élèves.

La version actuelle (3) a été lancée par le BR2k8 juste avant son départ du plateau. Elle est principalement destinée à pouvoir ouvrir l'utilisation de Frankiz aux écoles arrivant progressivement sur le plateau, et à devenir ainsi un portail de la vie associative du campus.

Le code de Frankiz3 est libre, et utilise git comme système de versionnement.
Il est intégralement disponible à l'adresse suivante : http://git.frankiz.net/frankiz/

= Développement =

Les principaux projets de développement sont actuellement (juillet 2011) :
* l'élargissement effectif aux autres écoles, en travaillant notamment sur :
** la simplicité de création de nouveaux comptes, avec nomination de modérateurs dans chaque école
** le cloisonnement des données et la possibilité de définir des champs de visibilité
* la création de mini-forums qui remplaceraient à la fois les annonces et les newsgroups

== Outils pour les développeurs ==
=== Authentification sur des sites externes ===

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 (frankiz@frankiz.polytechnique.fr).
Il doit alors donner :
* l'url complète de la page de login de son site
* 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, l'équipe frankiz renvoie alors une clé permettant d'authentifier les échanges d'informations entre frankiz et le site externe.
Le site est alors inscrit dans notre base de données, et peut utiliser le système d'authentification externe.

Vous pouvez voir [[Authentification_Frankiz|un exemple de code]].

Authentification Frankiz

2012-04-28T19:15:10Z

Olivier.charvin :

Authentification Frankiz

2012-04-28T19:03:20Z

Olivier.charvin : Page créée avec « Pour utiliser l'authentification via frankiz il faut faire une demande au BR en précisant les données souhaitées et l'url de la page sur laquelle retournera l'utilisateur ... »

Pour utiliser l'authentification via frankiz il faut faire une demande au BR en précisant les données souhaitées et l'url de la page sur laquelle retournera l'utilisateur une fois authentifié.

'''Code de la page d'identification'''

<nowiki><?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, ...);</nowiki>

'''Code des fonctions utilisées dans la page précédente'''
<nowiki><?php
$FKZ_KEY = "000";//</nowiki>'''clé donnée par le BR-man contacté'''<nowiki>

function frankiz_do_auth(){
global $FKZ_KEY;
$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://example.com/login.php';
/**
* 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 = '';

$request = json_encode(array('names', 'rights', 'email', 'sport', 'promo', 'photo'));//données voulues

$hash = md5($timestamp . $site . $FKZ_KEY . $request);

$remote = 'https://www.frankiz.net/remote?timestamp=' . $timestamp .
'&site=' . $site .
'&location=' . urlencode(urlencode($location)) . // il faut le faire deux fois !? à mon avis il y a un bug côté BR
'&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;
}
?></nowiki>

Platalpad

2012-03-28T21:58:29Z

Olivier.charvin : une ligne de contenu, pour la forme....

Disponible pour les groupes frankiz (exemple d'URL : https://www.polytechnique.fr/eleves/platalpad/frankiz/).