Gepi

h1. RefDoc serveur de ressources

h2. Gepi dispose d'un mini serveur qui permet :

* de voir le cahier de textes dans un ENT externe

* de récupérer certaines informations de Gepi

* Caractéristiques : accès en lecture seule (ce n'est pas un web-service complet mais plutôt un serveur de ressources)

h2. Mise en place

* Saisir les informations nécessaires (sécurité et autorisations) dans /secure/serveur.cfg

# Une fois renseigné, pensez à renommer ce fichier serveur.cfg en serveur.inc.php

<pre>

$serveur = array(

          'nom_du_compte' => array(

                      'domain'  => 'application_externe',

                      'RNE'     => 'RNE_autorise_sinon_all',

                      'api_key' => 'une_cle_assez_longue_et_complexe',

                      'nonce'   => 'non_utilise_encore',

                      'ip'      => 'adresse_ip_du_client',

                      'auth'    => array(liste_des_demandes_autorisees)

          )

);

</pre>

# Chaque application extérieure doit disposer d'un compte dans ce fichier en respectant la syntaxe du tableau précédent.

# nom_du_compte est le domain_name envoyé par le client

# application est le nom de l'application (un ENT, ...), le client devra préciser ce nom exact

# domain est le nom du domaine du client

# api_key est la clé unique de cette application

# nonce ne doit pas être modifié

# ip est l'adresse IP du client

* Les appels

Le client doit appelé Gepi par cette url : http://www.serveur.fr/path_vers_gepi/class_php/class_serveur_ent.php

Il doit fournir toutes les informations nécessaires en POST dès sa première requête et à chaque requête.

* La sécurité

Utiliser le https peut permettre de limiter les fuites de clés. Limiter les appels au seul réseau interne peut aussi être envisagé en fonction des infrastructures.

h3. Liste des méthodes disponibles (juillet 2011)

# notesEleve() {méthode vide}

# cdtDevoirsEleve()

# cdtCREleve()

# professeursEleve() {Liste des professeurs d'un élève avec les matières associées}

# edtEleve() {méthode vide}

# listeElevesAvecClasse()

# listeProfesseursAvecMatieres()

# listeClassesAvecProfesseurs()

# listeMatieresAvecNomlong()