Documentation de la solution web de gestion OpenFlyers version 2 - Contributions de l’utilisateur [fr]

Contrôle d'identification par OpenFlyers pour un logiciel tiers

2016-12-02T16:00:09Z

Bbarbe : /* Présentation */

=Présentation=
Cette page explique comment vérifier qu'un couple identifiant/mot de passe envoyé, par vos propres scripts, est conforme à la base de données d'OpenFlyers.

Le script retourne une valeur indiquant si la connexion, avec des identifiants données, a réussi et son état. Un cookie OpenFlyers est aussi retourné, permettant de gérer une session utilisateur sur votre site, en utilisant le compte utilisateur OpenFlyers de l'utilisateur connecté.

=Comment ça marche=
Si votre plateforme OpenFlyers se situe sur le lien http://openflyers.com/nom-plateforme/, envoyez simplement une requête POST sur le lien http://openflyers.com/nom-plateforme/checkIdent.php avec comme paramètres les variables '''login''' et '''rawPassword'''.

'''Attention:''' Les versions 2 d'OpenFlyers ou plus nécessitent un mot de passe chiffré en MD5 (cf. la ligne $postData commentée ci-dessous, dans le script PHP).

==Valeurs de retour possibles==
Le script retourne un chiffre parmi les suivant :
*0: OK
*1: OK mais plusieurs profils disponibles. OpenFlyers sélectionne automatiquement le meilleur profil.
*2: Expiré mais autorisé
*3: Expiré mais autorisé, avec un profil expiré
*4: Abonnement expiré, refusé
*5: Mauvais identifiants, refusé
*6: IP ou identifiants bloqués, refusé
*7: Aucun identifiant donné, ils sont demandés

Nous vous recommandons de considérer un code de retour entre 0 et 2 comme bon et mauvais entre 3 et 7.

'''Attention:''' Vous devez filtrer les identifiants de connexion libres (sans droits) puisque pour OpenFlyers, ils correspondent à des accès autorisés !!!

=JavaScript=
Si vous utilisez votre propre formulaire d'authentification, utilisez la fonction javascript submit_pwd() située dans \javascript\submitPwd.js .

=Exemple de code PHP=
Voici un exemple de code PHP permettant d'envoyer une requête POST :
<php>function httpPostRequest($host, $path, $postData) {
$result= "";

$request = "POST $path HTTP/1.1\n".
"Host: $host\n".
(isset($referer) ? "Referer: $referer\n" : "").
"Content-type: Application/x-www-form-urlencoded\n".
"Content-length: ".strlen($postData)."\n".
"Connection: close\n\n".
$postData."\n";

// Some debug informations:
// print("<pre>Request:\n".htmlentities($request)."</pre>");

if ($fp = fsockopen($host, 80, $errno, $errstr, 3))
// for PHP release < 5.3.0, use the following syntax:
// if ($fp = fsockopen($host, 80, &$errno, &$errstr, 3))
{
if (fputs($fp, $request))
{
while(! feof($fp))
{
$result.= fgets($fp, 128);
}
fclose($fp);
// print($result);
return $result;
}
}
}

//$postData='login=jbond&rawPassword='.md5('007'); // for OpenFlyers release 2 or higher
$postData='login=jbond&rawPassword=007';
$rawContent = httpPostRequest('openflyers.com','http://openflyers.com/plateform-name/checkIdent.php',$postData); [^]

list($header, $content) = explode("\r\n\r\n", $rawContent, 2);
list($byteQty, $realContent, $dummy) = explode("\r\n", $content, 3);

// the answer is in $realContent</php>

=Plugin d'authentification Joomla=
Si vous avez un site Joomla et que vous désirer de permettre aux utilisateurs OpenFlyers de se connecter à votre espace restreint Joomla, vous devriez ajouter ce plugin de manière à avoir une unique base de données de comptes utilisateurs : celle d'OpenFlyers.

Vous n'avez pas besoin de mettre à jour votre base de données Joomla, ce plugin interroge directement OpenFlyers grâce au script PHP CheckIdent.php.

*[[Media:Joomla_authentication_plugin.zip|Joomla plugin for OpenFlyers]]

FAQ utilisateur

2016-12-02T15:41:04Z

Bbarbe :

=Connexion=
==Impossible de me connecter à la plateforme OpenFlyers de ma structure aéronautique==
Si vous n'arrivez pas à accéder une plateforme OpenFlyers il faut en rechercher la raison. Voici un certain nombre de questions qui peuvent vous permettre de solutionner votre problème :
*Accédez-vous à la page d'identification de la plateforme OpenFlyers ?
**Si non, alors il faut regarder la FAQ [[#Page_indisponible|Page indisponible]]
*Lorsque vous vous identifiez, avez-vous un message de rejet indiquant que votre identifiant et/ou votre mot de passe ne sont pas corrects ?
**Si oui, alors le problème peut venir du mot de passe qui a changé. Dans ce cas là, vous pouvez ré-initialiser votre mot de passe en suivant la procédure [[#J.27ai_oubli.C3.A9_mon_mot_de_passe.2C_comment_le_r.C3.A9cup.C3.A9rer_.3F|de réinitialisation de mot de passe]]. Cela peut également venir de votre identifiant qui n'est pas bon. Dans ce cas, il faut demander à la personne en charge de la gestion d'OpenFlyers au sein de votre structure aéronautique
*Une fois connecté, revenez-vous sur la page d'identification lorsque vous changez de page ?
**Si oui, alors il faut regarder la [[#A_chaque_fois_que_je_change_de_page.2C_je_reviens_sur_la_page_d.27identification_.3F|procédure de gestion des cookies du navigateur]].
Si vous n'êtes dans aucun des cas répertoriés ci-dessus, alors vous pouvez rapporter votre problème en nous envoyant un e-mail et en décrivant le plus précisément possible le problème que vous rencontrez :
*Navigateur utilisé
*Système d'exploitation
*type de PC, smartphone ou tablette
*Nom du fournisseur d'accès internet
*Actions effectuées
*Message d'erreur s'affichant

==Page indisponible==
Si vous n'arrivez pas à accéder à la plateforme OpenFlyers de votre structure aéronautique. Voici une liste d'actions à effectuer :
*Redémarrer votre ordinateur
*Redémarrer la "box" ADSL
*Si cela ne fonctionne toujours pas, il faut [[#Tester_les_r.C3.A9solutions_DNS|tester les résolutions DNS]].
===Tester les résolutions DNS===
Pour effectuer les tests suivants, il faut ouvrir une fenêtre "[[#Ouvrir_une_fen.C3.AAtre_en_ligne_de_commande|en ligne de commandes]]". En cas de problème, il faut nous rapporter les résultats en ouvrant un rapport de bug sur le [http://bts.openflyers.org BTS]. Pour cela, il est pratique de procéder par [[#Copier.2FColler_dans_une_fen.C3.AAtre_en_ligne_de_commande|copier/coller]].
*Dans la fenêtre en ligne de commande taper ce qui suit (en remplaçant '''structure_aéro''' par le sous-domaine correspondant à votre structure aéronautique) :
<bash>ping structure_aéro.openflyers.fr</bash>
La réponse normale est pour OpenFlyers 3.0 :
Envoi d'une requête 'ping' sur serveur6-of3.openflyers.net [87.98.143.237] avec 32 octets de données :
Réponse de 87.98.143.237 : octets=32 temps=37 ms TTL=55
Si vous n'avez pas "serveur6-of3.openflyers.net" ou "Réponse de 87.98.143.237" cela veut dire que vous avez un [[#Vérifier la configuration de résolution des DNS|problème de résolution de DNS]].

La réponse normale est pour OpenFlyers 2.1 :
Envoi d'une requête 'ping' sur serveur6-of21.openflyers.net [91.121.47.179] avec 32 octets de données :
Réponse de 91.121.47.179 : octets=32 temps=37 ms TTL=55
Si vous n'avez pas "serveur5-of21.openflyers.net" ou "Réponse de 91.121.47.179" cela veut dire que vous avez un [[#Vérifier la configuration de résolution des DNS|problème de résolution de DNS]].

La réponse normale est pour OpenFlyers 1.3 :
Envoi d'une requête 'ping' sur serveur6-of1.openflyers.net [178.33.105.217] avec 32 octets de données :
Réponse de 178.33.105.217 : octets=32 temps=41 ms TTL=55
Si vous n'avez pas "serveur6-of1.openflyers.net" ou "Réponse de 178.33.105.217" cela veut dire que vous avez un [[#Vérifier la configuration de résolution des DNS|problème de résolution de DNS]].
====Tests plus poussés====
*Faire un :
<bash>nslookup structure_aéro.openflyers.fr</bash>
*Et un :
<bash>tracert structure_aéro.openflyers.fr</bash>
*Faire le test avec '''dig +trace''' :
<bash>dig +trace structure_aéro.openflyers.fr</bash>
Sous Windows, il faudra au préalable récupérer l'utilitaire (par exemple dans un package [http://www.isc.org./downloads bind]). Une fois téléchargé le package, il faut copier/coller le programme dig ainsi que les fichiers .dll dans un répertoire commun et se positionner dans ce répertoire depuis la fenêtre en ligne de commandes avec la commande dir '''"nom du chemin du répertoire"'''.

====Tester les résolutions DNS sous Mac====
De plus, nous disposons de commandes plus puissantes qui permettent d'avoir d'avantage d'informations :
*cat /etc/resolv.conf

===Vérifier la configuration de résolution des DNS===
====Vérifier la configuration de résolution des DNS sous Windows====
Si vous avez un problème de résolution DNS sous windows, il peut être utile de vérifier que la résolution DNS est dynamique :
#Double-cliquer sur la connexion réseau concernée (par exemple le symbole "WIFI")
#Cliquer sur '''Propriétés''' dans l'onglet '''Général''' de l''''Etat de Connexion réseau sans fil''' (si WIFI))
#Sélectionner '''Protocole internet TCP/IP'''
#Cliquer sur '''Propriétés'''
#Vérifier qu'est sélectionné '''Obtenir les adresses des serveurs DNS automatiquement'''. (si ce n'est pas le cas, modifier).
#En dernier ressort, [[#Changer de serveur DNS|Changer de serveur DNS]] ou [[#Forcer_les_DNS|Forcer les DNS]].

===Nous communiquez les adresses IP des serveurs DNS===
====Nous communiquez les adresses IP des serveurs DNS sous Windows====
#[[#Ouvrir_une_fen.C3.AAtre_en_ligne_de_commande|Ouvrir une fenêtre en ligne de commande]]
#Taper : '''ipconfig /all'''
Les adresses IP des serveurs DNS se trouvent au droit de '''Serveurs DNS'''

===Changer de serveur DNS===
Si vous rencontrez un problème de résolution de DNS avec votre fournisseur d'accès, vous pouvez changer les serveurs qui effectue la résolution des DNS pour votre accès.
====Changer de serveur DNS sous Mac====
*Dans '''Préférences Systèmes''', choisir '''Réseau''', puis une fois la bonne carte réseau sélectionnée, appuyer sur Avancé.
*Dans la fenêtre qui apparaît, aller sur l'onglet '''DNS''' et dans '''Serveurs DNS''' appuyer sur le + pour ajouter '''8.8.8.8''' et une autre fois pour ajouter '''8.8.4.4''' (ce sont les [http://code.google.com/speed/public-dns/|serveurs DNS public Google])
*Il ne reste plus qu'à '''Appliquer''' et à tester.

====Changer de serveur DNS sous Windows XP====
*'''Démarrer > Connexions''' puis cliquer sur la connexion réseau active (par exemple la connexion WIFI)
*Cliquer sur '''Propriétés'''
*Sélectionner '''Protocole Internet (TCP/IP)'''
*Cliquer sur '''Propriétés'''
*En général, en bas de la fenêtre '''Propriétés de Protocole Internet (TCP/IP)''' la configuration active est : '''Obtenir les adresses des serveurs DNS automatiquement'''
*Cocher '''Utiliser l'adresse de serveur DNS suivante :'''
*Pour '''Serveur DNS préféré''', saisir '''8.8.8.8'''
*Pour '''Serveur DNS auxiliaire''', saisir '''8.8.4.4''' (ce sont les [http://code.google.com/speed/public-dns/|serveurs DNS public Google])
*Cliquer sur '''OK'''
*Cliquer sur '''OK'''
*Cliquer sur '''Fermer'''

===Forcer les DNS===
====Forcer les DNS sous Windows====
Attention, avec Vista, il faut appliquer une [[#Particularit.C3.A9_avec_Windows_Vista|procédure préalable]].
*Il est possible de résoudre ce problème de DNS en éditant le fichier C:\WINDOWS\system32\drivers\etc\hosts (avec le bloc-notes) en rajoutant la ligne (il faut remplacer structure_aéro par le sous-domaine de l'espace OpenFlyers de votre structure aéronautique) :
**Pour OF 1.3 :
<pre>178.33.105.217 structure_aéro.openflyers.fr</pre>
**Pour OF 2.1 :
<pre>91.121.47.179 structure_aéro.openflyers.fr</pre>
**Pour OF 3.0alpha :
<pre>87.98.143.237 structure_aéro.openflyers.fr</pre>
*Ensuite, il faut relancer votre PC
*Une fois la connexion correctement effectuée, il est parfois possible de supprimer cette entrée dans le fichier hosts tout en gardant la connexion.

====Particularité avec Windows Vista====
*Il faut être administrateur pour pouvoir modifier le fichier hosts.
*Il faut également copier le fichier hosts sur le bureau pour le modifier puis ensuite le recopier dans le bon répertoire (si on édite directement le fichier hosts depuis (system32\drivers\etc\) on ne peut pas le ré-enregistrer).

====Forcer les DNS sous Mac====
*lancer Terminal (dans Applications/Utilitaires)
*taper "sudo nano /etc/hosts" (il demande le mot de passe de l'utilisateur qui a les droits admin sur la machine)
*Ajouter les entrées sur le modèle de la [[#Forcer_les_DNS_sous_Windows|procédure sous Windows]]
*Faire controle-o pour enregistrer puis controle-x pour quitter
*Eventuellement, faire "dscacheutil -flushcache" si le changement n'est pas encore pris en compte.

==A chaque fois que je change de page, je reviens sur la page d'identification ?==
Si le retour à la page d'identification est systématique, alors il doit s'agir d'un problème de '''cookies'''. Il faut modifier la configuration du navigateur de manière à [[#Autoriser_les_cookies|autoriser les cookies]].

===Variante du problème : la déconnexion n'est pas systématique mais aléatoire===
Dans ce cas, il peut s'agir aussi d'un problème de proxy (si vous êtes sur un réseau d'entreprise par exemple) ou de fournisseurs d'accès (accès depuis un mobile, depuis un hôtel, bref, tout type d'accès qui change régulièrement l'adresse IP et ainsi ne permet de maintenir un accès authentifié dans la durée. La solution est présentée dans la procédure [[#Utiliser_OpenFlyers_sur_un_smartphone|Utiliser OpenFlyers sur un smartPhone]].

==Plusieurs membres peuvent-ils ouvrir des sessions en même temps (sans le savoir) ?==
Oui, c'est même le but premier : permettre à plusieurs personnes de consulter en même temps le cahier de réservation.

Vous pouvez même avoir une personne qui ouvre plusieurs sessions avec son identifiant. Mais pour cela, elle doit utiliser des ordinateurs ou des navigateurs différents.
==Suite à une migration, impossible de naviguer dans la nouvelle version d'OpenFlyers==
Lorsque nous migrons d'une version vers une autre, bien souvent nous le faisons en changeant les "DNS". Cela peut occasionner des problèmes d'accès. Il peut également apparaitre des problèmes de "cache" qui se résolvent d'eux sous 24 à 48 heures. Ces problèmes peuvent survenir lorsque l'ordinateur concerné a été connecté à l'ancienne plateforme OpenFlyers juste avant la migration.

Voici différentes techniques qui permettent d'imposer à votre navigateur d'utiliser des DNS actualisées et d'utiliser un cache à jour :
#Penser à éteindre et rallumer complètement l'ordinateur
#Faites un CTRL+R (ou icône de "rafraichissement"). Bien souvent cela suffit au navigateur pour qu'il vide son cache et le ré-actualise
#Vider le cache dans le navigateur
#Supprimer les cookies dans le navigateur
Plus technique :
#Faites un ipconfig /flushdns en ligne de commande (menu démarrer, puis "Exécutez", taper "cmd")
#Forcer les nouvelles DNS dans le fichier C:\WINDOWS\system32\drivers\etc\hosts en ajoutant une ligne du genre : xxx.xxx.xxx.xxx xxx.openflyers.zz (nous demandez pour connaitre les valeurs à utiliser)

De plus, afin de permettre quand même d'accéder à la nouvelle plateforme, nous mettons en place une deuxième URL temporaire pendant 1 semaine. Ainsi pour l'URL plateforme.openflyers.fr nous mettrons en place une URL temporaire plateforme2.openflyers.fr

=Navigation dans OpenFlyers=
OpenFlyers est un logiciel qui s'utilise grâce à votre navigateur internet. Les plus connus sont Chrome, Firefox, Internet Explorer ou Safari.
Une certaine configuration est nécessaire afin de faire fonctionner OpenFlyers : la configuration des cookies.
Si vous rencontrez des problèmes d'utilisations tels que :

*Impossibilité de se connecter alors que votre identifiant et mot de passe est correct
*Impossibilité d'aller d'un page à l'autre une fois connecté (et retour sur la page de connexion)

Voila comment régler votre navigateur.

==[https://support.google.com/chrome/answer/95647?hl=fr Comment autoriser les cookies sous Chrome]==

==Autoriser les cookies sous Internet Explorer==
*'''Outils > Options internet'''
*Onglet '''Confidentialité'''
*Positionner le niveau de sécurité au maximum à '''Moyenne'''
*Bouton '''OK'''

==Autoriser les cookies sous iPhone / Safari==
*'''Réglages > Safari'''
*Régler '''Accepter les cookies'''
[[Fichier:Accepter-cookies-iPhone-Safari.png]]

==Autoriser les cookies sous Firefox==
*'''Outils > Options'''
*Onglet '''vie privée'''
*Cocher '''Accepter les cookies'''
*Bouton '''OK'''

==Problème de navigation sur un réseau GSM==
OpenFlyers est accessible sur les smartphones par le biais du navigateur embarqué. Cependant, des problèmes de session peuvent survenir du fait du changement dynamique de l'adresse IP du smartphone du fait du réseau GSM. Pour palier à ce problème et éviter des déconnexions intempestives, il faut se connecter en HTTPS.

De plus, et toujours en HTTPS, il est possible de [[#Transmettre_l.27identifiant_et_le_mot_de_passe_dans_l.27URL|rajouter le couple identifiant/mot de passe à la suite de l'URL sécurisée]] et d'enregistrer cette URL en favori. Ainsi, il n'est plus nécessaire de saisir systématiquement son identifiant et son mot de passe.

==Problèmes de navigation sous iPhone==
*Penser à mettre à jour le logiciel de l'iPhone. OpenFlyers fonctionne correctement pour une version au moins 4.02.
*Activer l'[[#Autoriser_les_cookies_sous_iPhone_.2F_Safari|acceptation des cookies]]
*Si la navigation était possible sur une version précédente d'OpenFlyers et qu'elle n'est plus possible sur une nouvelle version d'OpenFlyers, alors il peut être nécessaire de vider le cache du navigateur Safari de l'iPhone :
**'''Réglages > Safari'''
**'''Effacer cookies et données'''

=Transmettre l'identifiant et le mot de passe dans l'URL=
Si vous souhaitez transmettre le couple identifiant/mot de passe dans l'URL dans le but de pouvoir les sauver facilement, vous avez besoin d'un [http://www.openflyers.com/doc/catalogue-tarifaire.pdf abonnement HTTPS] et alors l'URL doit avoir la forme :
https://openflyers.com/mySpaceName?login=myLogin&password=myPassword
où :
*mySpaceName doit être remplacé par le nom du compte openflyers
*myLogin doit être remplacé par votre identifiant
*myPassword doit être remplacé par votre mot de passe

=Cahier de réservation=
==Que se passe t-il en cas de conflit de réservation ?==
Il ne peut y avoir de conflit de réservation. C'est l'un des principes durs d'OpenFlyers : à chaque instant donné, il ne peut y avoir plus d'une réservation pour chaque pilote, chaque avion ou chaque instructeur.

Si vous arrivez à faire des réservations qui se chevauchent (pour un avion, un instructeur ou un pilote), alors vous avez mis en évidence un bug, et il faut nous le signaler pour que nous y remédions.

==Si je suis en train de consulter une page, et que quelqu'un fait une modif sur cette page, vais-je voir la modif sans lancer un rafraichissement ?==
Non vous ne verrez pas la modification. Cependant, ce n'est pas grave car au moment où vous essayerez de faire votre réservation, OpenFlyers vérifiera à ce moment-là que le créneau que vous souhaitez est toujours disponible (pour empêcher les conflits justement).

==Comment saisir une date rapidement dans la gestion des qualifications ?==
En cliquant sur l'icône "calendrier" placé par défaut au mois courant, vous pourrez vous déplacer mois par mois ou année par année en cliquant sur les flèches respectives. Pour des dates plus anciennes, passez le curseur de votre souris sur l'endroit où se trouve le texte correspondant à "Mois Année". Ce texte s'encadre alors d'une bordure. Faites un clic dessus et une nouvelle petite fenêtre va s'ouvrir. Là vous pourrez saisir l'année en tapant les chiffres avec votre clavier.

==A propos des horaires de la nuit aéronautique==

Nous calculons les éphémérides d'après les définitions officielles.

Ainsi, les heures de lever et de coucher du soleil correspondent au passage du centre du soleil sous l'horizon (donc 3 degrés sous l'horizon puisqu'il est considéré, en première approximation que le soleil a un diamètre apparent de 6 degrés).

Les heures du jour et de la nuit aéronautique correspondent au passage du soleil 6 degrés sous l'horizon. Il s'agit de la définition officielle, aussi bien française, qu'internationale (OACI). Le calcul est validé pour les latitudes inférieures à 65 degrés. Sa précision est de l'ordre de la minute sous des latitudes inférieures à 50 degrés. La précision diminue au fur et à mesure que la latitude augmente (c'est à dire que l'on se rapproche des pôles).

Conséquence du calcul : les résultats trouvés ne correspondent pas (forcément) à la simple addition de + ou - 30 minutes. Mais il n'a jamais été écrit dans un texte officiel que la journée aéronautique correspondait au lever du soleil moins trente minutes, et que la nuit aéronautique correspondait au coucher du soleil plus trente minutes. La seule chose que vous trouverez, si vous vous penchez sur les textes, c'est qu'il est admis d'utiliser + ou - 30 minutes pour faire les calculs sous des latitudes comprises entre 30 et 60 degrés et 15 minutes sous les latitudes inférieures à 30 degrés). Voir [http://www.anpi.asso.fr/Reglesair.pdf Règles de l'air - Chapitre 1er - Définitions]
Attention: certains pays n'utilisent pas la nuit aéronautique et ne permettent pas le vol en dehors du lever et du coucher du soleil

Le résultat proposé est donc le bon résultat. Si vous ne souhaitez pas utiliser ce résultat, il vous suffit de retrancher ou d'ajouter 30 minutes au calcul du lever et du coucher du soleil.

Cependant, nous attirons votre attention sur l'intérêt d'utiliser le bon calcul : il vous met du bon côté du point de vue de la sécurité. En effet, si en été vous y gagnez, c'est parce que le soleil met plus de temps à se coucher. Par contre en hiver, notre calcul fait "perdre" une dizaine de minutes : c'est parce que le soleil met moins de temps à se coucher. Calculer l'écart entre la nuit aéronautique et le coucher du soleil (et comparer avec les 30 minutes) vous permettra d'avoir une idée de la "vitesse" avec laquelle se couche le soleil, donc de vous méfier encore plus de l'arrivée de la nuit et de ne pas vous faire surprendre par le crépuscule.

Qui ne s'est jamais retrouvé au sol en ayant voulu "tangenter" avec la nuit et s'est surpris à constater qu'il faisait bien sombre, tout d'un coup ?

Le programme calcule les heures de coucher/lever du soleil à partir des coordonnées géographique du terrain de base. Si vous constatez que vos heures sont erronées, demander à votre administrateur qu'il vérifie le code OACI dans les paramètres de la structure aéronautique.

=Saisie des vols=
==Nos avions ont des compteurs en heures, centièmes, peut-on avoir un affichage en heures, minutes ?==
Chaque utilisateur paramètre son affichage comme il le souhaite dans Données/Affichage et fiche personnelle
[[http://doc-en.openflyers.com/index.php?title=Documentation utilisateur 2.0#Date_and_time_format Patron de date et heure]]

== Comment saisir plusieurs pilotes pour un vol ?==
Saisir les vols dans OF comme dans le carnet de route de l'avion
== Comment partager les coûts d'un vol ?==
Si un pilote veux partager les frais du vol (sans être pilote) il doit faire un transfert de son compte vers le compte du pilote
Menu Comtes/Transférer

=Divers=
==Peut-il y avoir des accès à plusieurs sur la base ?==
Oui, sinon deux membres ne pourraient pas consulter le cahier en même temps.

Par contre, lorsqu'un membre réserve un avion, au moment où OpenFlyers teste la disponibilité du créneau, il empêche toute autre écriture sur la base concernant les réservations. Le but est d'empécher justement les conflits de réservation.

=Actions dynamiques non prises en compte par OpenFlyers=
OpenFlyers met en oeuvre des actions dites "dynamiques" c'est à dire qui ne nécessite pas un rafraîchissement complet de la page pour être prises en comptes. Ces actions sont basées sur le principe "[http://fr.wikipedia.org/wiki/Asynchronous_JavaScript_and_XML AJAX]". Elles nécessitent l'activation du moteur [http://fr.wikipedia.org/wiki/JavaScript JavaScript] du navigateur pour être opérationnelles.

De plus, certaines commandes [http://fr.wikipedia.org/wiki/JavaScript JavaScript] ne sont pas reconnues par tous les navigateurs.

Ainsi, lorsque vous lancez une action dynamique dans OpenFlyers qui reste sans résultat, avant de rapporter l'anomalie sur le [http://bts.openflyers.org BTS] il faut vérifier :
#L'activation de [http://fr.wikipedia.org/wiki/JavaScript JavaScript] dans le navigateur utilisé.
#Tester avec un autre navigateur
#Dans le cas où JavaScript est activé, il faut rapporter l'anomalie sur le [http://bts.openflyers.org BTS] en précisant le navigateur sur lequel l'action est inefficace et le navigateur sur lequel l'action est efficace.
Vous pouvez également nous facilitez la correction de l'anomalie en nous rapportant le message d'erreur [http://fr.wikipedia.org/wiki/JavaScript JavaScript] s'il y a lieu.

=Comment exporter les données ?=
OF affiche une page XHTML ce qui signifie un texte correctement formaté qui peut être récupéré par un simple copier coller. Le tableur Calc de Open Office ou Libre Office interprète correctement ce HTML et le formate en colonne conformément à la présentation de votre page.

Il a cependant un paramétrage à faire pour que les textes soit correctement encodé (affichage des caractères accentués) et que les cellules numériques affichent le format correct

*Allez dans l'onglet Outils/Options/Chargement&Enegistrement/Compatibilité HTML (Tools/Options/Load&Save/HTML Compatibility)
*Cocher "Utiliser l'environnement linguistique Anglais (USA) pour les nombres", ("Use English (USA) locale numbers")
*Par la même occasion vous pouvez aussi changer le Jeu d'encodage (Character set) par Unicode (UTF-8)

Le programme interprète alors le point comme le séparateur décimal et vous avez directement le bon copier/coller Si vous avec choisi l'encodage UTF-8 les caractères accentués seront aussi correctement traduits (A rechanger si vous avez à faire des copier coller depuis des programmes à l'encodage CP1252 "Windows Microsoft")

Pour les exports au format csv voir [[FAQ csv reading with Oo]]

=Paramétrage et données personnelles=

==Peut-on être averti automatiquement des réservations annulées ?==
Dans la version 3 d'OpenFlyers, il est possible pour chaque utilisateur de paramétrer OpenFlyers de sort à être averti par e-mail lorsqu'un créneau se libère. Voici comment configurer cela :
*'''Données > Affichage et fiche personnelle'''
*Dans '''Fiche personnelle''', sélectionner '''Notification des réservations annulées'''
*Cliquer sur le bouton '''Sauver'''

==Peut-on être averti des réservations sur plusieurs adresses e-mail ?==

Il est possible d'utiliser plusieurs adresses e-mails afin d'être averti des réservations.

Voici comment procéder :
*'''Données > Affichage et fiche personnelle'''
*Dans '''Fiche personnelle''' puis au niveau du champ '''E-mail'''
*Rentrer chacune des adresses e-mails en les séparant d'une virgule
'''Attention : il ne faut jamais mettre d'espace : ni dans l'adresse e-mail elle même, ni avant ou après les virgules de séparation des adresses e-mails'''

Exemple valide :
<pre>jesuisuntest@test.fr,jesuisuntest@test.com</pre>

Exemples non valides :
<pre>jesuisuntest@test.fr , jesuisuntest@test.com
jesuisuntest@test.fr , jesuisuntest@test.com
jesuisuntest@test.fr, jesuisuntest@test.com</pre>

Accéder à l'application et aller dans le menu Données > Affichage et fiche personnelle

==Comment changer mes options d'affichage ?==
Aller dans le menu '''Données > Affichage et fiche personnelle''' rubrique '''Option d'affichage'''

Dans les champs choisissez les paramètres selon vos souhaits: langue, heure local ou UTC, format monétaire,...

Sélectionner les avions et instructeurs que sous voulez afficher

==Affichage des dates et des heures==
Chaque utilisateur paramètre son affichage des dates et des heures comme il le souhaite dans '''Données > Affichage et fiche personnelle'''

Ressources sur les [[http://doc-en.openflyers.com/index.php?title=Documentation utilisateur 2.0#Date_and_time_format patrons de date et heure]]

==Comment modifier mes paramétrages ?==
Aller dans le menu '''Données > Affichage et fiche personnelle''' rubrique '''Fiche personnelle'''

Charger une photo pour le trombinoscope

La date de naissance, le sexe et la nationalité sont obligatoire pour que les statistiques DGAC puisse être calculés

Mettez votre email et vos numéros de téléphone pour qu'on puisse vous contacter. Vous pouvez choisir ceux qui sont public ou non.

Dans ce dernier cas seul les personnes avec des droits administrateur pourrons voir ces infos.

==J'ai oublié mon mot de passe, comment le récupérer ?==
Il n'est pas possible de "retrouver" son mot de passe perdu dans OpenFlyers. En effet, ces derniers sont cryptés dans la base de données pour des raisons de confidentialités.

Si vous avez oublié votre mot de passe, vous n'avez pas besoin de demander à votre administrateur une ré-initialisation, OpenFlyers dispose d'une procédure de ré-initialisation automatique :

*Sur la page de connexion d'une plateforme OpenFlyers, cliquer sur le lien "Mot de passe oublié"
*:[[Fichier:FAQ_user_forgottenPassword.png]]
*Sur la page qui s'affiche il y a deux zones de saisie. Saisissez l'email que vous avez indiqué dans votre page personnelle. Il vous sera envoyé un email vous donnant votre identifiant et un code d'activation
*Revenez sur la page de ré-initialisation et mettez ces informations. Un nouvel email vous sera envoyé avec votre mot de passe

Vous pouvez maintenant accéder à l'application. Pour mettre un mot de passe personnalisé voir [[#Comment_changer_de_mot_de_passe|Comment changer son mot de passe]]

==Comment changer de mot de passe==
*Dans '''Données > Affichage et fiche personnelle'''
*Aller en bas de la page, dans le formulaire '''Changer de mot de passe''' et saisissez votre nouveau mot de passe

Un indicateur vous indique le niveau de fiabilité. Mélanger les minuscules/majuscules/chiffres et sigles pour augmenter la difficulté pour des robots de trouver votre mot de passe. La sécurité de l'application de votre club sera ainsi accrue.

=Trucs et astuces=
==Fenêtre en ligne de commande==
===Ouvrir une fenêtre en ligne de commande===
====Ouvrir une fenêtre en ligne de commande sous Windows====
*Aller dans le menu "Démarrer"
*Puis Tous les programmes/Accessoires
*Lancer l'"invite de commandes"
====Ouvrir une fenêtre en ligne de commande sous Mac====
Sous OSX (mac) il faut lancer un Terminal. Pour cela 2 solutions :
*Taper "terminal" dans spotlight
ou
*lancer l'application qui est dans Applications > Utilitaires.

===Copier/Coller dans une fenêtre en ligne de commande===
====Copier/Coller dans une fenêtre en ligne de commande sous Windows====
Vous pouvez faire un copier/coller en utilisant le bouton droit de la souris dans la fenêtre de l'invite de commandes puis en choisissant '''sélectionner''' et ensuite en appuyant sur le bouton gauche et en le laissant appuyer tout en sélectionnant la zone souhaitée)

====Copier/Coller dans une fenêtre en ligne de commande sous Mac====
Pour faire un copier/coller de ces informations et nous les communiquer, il suffit d'utiliser commande-C dans le terminal.

=Comment imprimer la doc ?=
Si vous souhaitez imprimer la doc, il vous suffit de :
*cliquer sur le lien "version imprimable" de la "boîte à outils" présente sur le côté gauche des pages du wiki. Vous obtiendrez ainsi une version des pages destinée à être imprimer.
*ou bien, utiliser la fonction imprimer de votre navigateur. Une mise en page spécifique est générée pour obtenir un format papier

Si vous imprimer avec une Imprimante pdf ([http://www.pdfforge.org/pdfcreator pdfCreator] par exemple) vous générerez alors un format pdf pour archivage

=Problèmes=
==Signaler un problème==
Si vous rencontrer une anomalie ou un bug dans l'application OpenFlyers, il faut le rapporter sur le [http://bts.openflyers.org BTS] pour une prise en compte la plus rapide possible et pour permettre un meilleur traitement et suivi.

Pour rapporter une anomalie il faut :
*Aller sur la page http://bts.openflyers.org
*S'inscrire sur le BTS en cliquant sur '''Signup for a new account''' : il faut choisir un identifiant, une adresse e-mail puis cliquer sur '''Signup'''.
Un e-mail est envoyé par le BTS permettant de valider votre adresse e-mail. Cliquer sur le lien présent sur cet e-mail.
*Sur le formulaire qui apparait, Choisir :
**Un mot de passe dans les champs '''Password''' et '''Confirm Password'''
**Compléter éventuellement le champ '''Real Name'''
*Cliquer sur le bouton '''Update account'''
Votre compte pour rapporter un problème sur le BTS est ainsi créé. Un nouveau formulaire d'identification s'affiche automatiquement :
*Renseigner les champs '''Username''' et '''Password'''
*Sélectionner éventuellement sur '''Remember my login in this browser''' afin de ne plus avoir à s'identifier lors d'une nouvelle connexion depuis le même navigateur internet.
*Dé-sélectionner éventuellement le champ '''Only allow your session to be used from this IP address.''' qui limite les possibilités de connexion
*Cliquer sur '''Login'''
*Aller dans l'onglet '''Preferences'''
*En bas du formulaire, modifier le champ '''Language''' pour choisir '''french'''.
*Cliquer sur '''Update Prefs'''
Vous pouvez alors tranquillement rapporter un bug depuis le formulaire '''Rapporter un bogue'''

==Problème d'auto-complétion des terrains==
*Si les terrains d'arrivée et de départ ne s'affichent pas, vérifier la [[Compatibilité des navigateurs#Versions_support.C3.A9es|compatibilité de votre navigateur]].
*La version 2.1 d'OpenFlyers n'est pas supportée par Internet Explorer 10.
*En revanche, la version 3.0.3 d'OpenFlyers est supportée par les versions d'Internet Explorer supérieures à 8.
Si vous êtes sous la version 2.1 d'OpenFlyers avec comme navigateur Internet Explorer alors vous avez 2 solutions :
*Changer de navigateur
*[[FAQ_client#Comment_se_fait_la_migration_vers_une_version_sup.C3.A9rieure_.3F|Demander à migrer]] sous la version 3.0.3 d'OpenFlyers.

Kiosque PC

2016-12-02T15:37:37Z

Bbarbe :

=Présentation=
Le but de cette page est de référencer et de proposer des solutions de configuration pour les ordinateurs en accès public.

Les objectifs d'un mode kiosque sont multiples et peuvent recouvrir les besoins suivants :
*Empêcher l'utilisateur de fermer le navigateur
*Empêcher l'utilisateur de changer les pages affichées
*Empêcher l'utilisateur de surfer sur d'autres sites que ceux autorisés
*Empêcher l'utilisateur de basculer sur d'autres programmes que le navigateur souhaité
*Empêcher l'utilisateur de lancer d'autres programmes
*Empêcher l'utilisateur d'accéder au "Bureau".
*Empêcher l'utilisateur de pouvoir éteindre l'ordinateur
*Permettre à l'utilisateur d'allumer l'ordinateur dans le cas où ce dernier a eu par exemple une coupure d'alimentation mais empêcher ce dernier d'accéder au BIOS.

Un prérequis pour la mise en place d'un ordinateur en mode kiosque consiste à ne proposer que les interfaces nécessaires à l'utilisateur :
*Souris
*Clavier
*Écran
Les autres éléments attachés à l'unité centrale ne doivent pas être accessibles (ports, lecteurs)

Pour un PC sous Windows, les opérations suivantes permettent de mettre en place un PC kiosque avec le navigateur souhaité :
*[[#Lancer_un_programme_au_d.C3.A9marrage_de_Windows|Lancer automatiquement un programme au démarrage de Windows]]
*[[#Configurer_un_navigateur_en_mode_kiosque|Modifier l'icône du raccourci pour que le navigateur soit lancé en mode kiosque]] (à effectuer avec l'icône du navigateur placée dans le répertoire de démarrage
*[[#Bloquer_.5BAlt.2BF4.5D_avec_Deskman|Paramétrer deskman pour qu'il désactive le raccourci [Alt+F4]]]
Il pourra être utile d'utiliser également [[Kiosque PC#deskman|Deskman]] pour mettre en place des restrictions d'accès sur certains site internet ou de bloquer l'exécution de programmes ou des fonctionnalités liées à Windows.

=Créer un compte utilisateur "visiteur"=
Il est possible de créer un compte utilisateur "visiteur" permettant de ne pas avoir de déconnexion automatique et permettant également d'avoir un retour automatique sur la page du planning du jour au bout de 5 minutes d'inactivité. Pour cela il faut effectuer les actions suivantes :
*Créer un profil "visiteur" ne disposant d'aucun droit.
*Créer un compte visiteur/visiteur par exemple disposant de ce profil.
*[[#D.C3.A9finir_la_page_par_d.C3.A9faut_.C3.A0_l.27ouverture_du_navigateur|Mettre en place une page par défaut]] sur le navigateur du PC en accès public permettant une connexion automatique avec le compte visiteur.

=Définir la page par défaut à l'ouverture du navigateur=
En l'absence d'un mode kiosque, il est toujours possible de mettre OpenFlyers en page par défaut du navigateur.

Pour pousser la personnalisation, il est possible de mettre dans l'adresse l'identifiant et le mot de passe de l'utilisateur sans droit ([[#Cr.C3.A9er_un_compte_utilisateur_.22visiteur.22|type visiteur]]) afin de garder la page de cahier journalier affichée en permanence et dès le lancement du navigateur. Pour cela, il faut mettre en lien par défaut du navigateur le lien suivant :

<nowiki>https://</nowiki>openflyers.com/'''plateforme'''/?login='''identifiant'''&password='''motdepasse'''

En remplaçant :
*'''plateforme''' par le nom de la plateforme de sorte à obtenir l'URL de la plateforme à la place de <nowiki>https://</nowiki>openflyers.com/'''plateforme'''/
*'''identifiant''' par l'identifiant de l'utilisateur ayant un [[#Cr.C3.A9er_un_compte_utilisateur_.22visiteur.22|profil visiteur]] et '''motdepasse''' par son mot de passe

Attention, ceci ne fonctionne que pour les comptes qui n'ont uniquement un profil type "visiteur", c'est à dire sans aucun droit.

==Page par défaut dans Firefox==
*Aller dans '''Outils > Options'''
*Dans l'onglet '''Général''', renseigner le champ '''Page d'accueil''' avec l'URL souhaitée.
*Cliquer sur le bouton '''Fermer'''

==Page par défaut dans Internet Explorer==
*Aller dans '''Outils > Options internet'''
**Dans l'onglet '''Général''', renseigner le champ '''page de démarrage''' avec l'adresse du site.
*Sélectionner le radio-bouton '''Démarrer avec la page d'accueil'''
*Cliquer sur le bouton '''OK'''

=Solutions Mac=
==[http://www.icab.de/ iCab]==
iCab possède un mode kiosque contenant des fonctionnalités "Outils", "Mode public", une protection par mot de passe, et dans lequel ni le Dock de Mac Os X, ni la barre de menu n'apparaissent.

Il faut mettre dans les ouvertures au démarrage un script en applescript, qui démarre automatiquement iCab en ouverture de session, en mode kiosque.

<bash>tell application "iCab"
Activate
enter kiosk mode with password "password"
-- ''le mot de passe qui permettra de sortir du mode kiosque avec le raccourci [Commande-k]''
OpenURL "http://monsite.org/?login=monidentifiant&password=monmotdepasse" toWindow -1
-- ''ouvre la page en question dans iCab et au premier plan, en introduisant identifiant et MdP de l'utilisateur invité''
end tell</bash>

Il faut supprimer toutes les barres d'affichage : Adresse, Barre d'état, Signets, Liens standards, dans les Préférences du mode Kiosque PC, et mettre la page d'OF en page d'accueil du navigateur.

Il est néanmoins nécessaire dans le mode kiosque de garder la barre de navigation, pour relancer le navigateur lors des pertes de connexion.

Comme il est possible de n'autoriser la connexion qu'à un ou plusieurs sites nommément désignés par un système de filtres, il est possible de de bloquer le navigateur sur OpenFlyers.

Le mode kiosque doit être lancé depuis une session d'un utilisateur sans mot de passe (permet les ouvertures et extinctions automatiques la nuit), utilisateur qui n'a aucun droit de gestion sur l'ordinateur et qui travaille sur un Finder restreint.

Une version Free existe, une version Pro sans limitations est disponible pour 15 €.

==wKiosque PC Browser==
Il existe également [http://www.app4mac.com/wkioskbrowser.html wKiosque PC Browser], créé spécifiquement pour cet usage, mais payant ($69 pour un seul poste, la version d'essai quitte après une heure ). Il a des paramétrages très complets et en particulier relance la connexion lors du boot jusqu'à la connexion au site.
=Solutions Windows=
==Configurer un navigateur en mode kiosque==
===Configurer Firefox en mode kiosque===
Il existe des thèmes et extensions permettant de transformer Firefox en kiosque.
Par exemple R-kiosk.

===Configurer Chrome en mode kiosque===
*Créer un raccourci de Chrome
*Survoler avec le pointeur de la souris l'icône du raccourci
*Sélectionner '''Propriétés'''
*Dans l'onglet '''Raccourci''', champ '''Cible''', rajouter à la fin de la ligne : ''--kiosk http://openflyers.com/plateforme/'' en remplaçant ''plateforme'' par le nom de votre plateforme OpenFlyers
<pre>"C:\Program Files (x86)\Google\Chrome\Application\chrome.exe" --kiosk http://openflyers.com/plateforme/</pre>
*Cliquer sur le bouton '''OK'''
Une fois Chrome lancé, pour le fermer, il faut utiliser la combinaison de touches [Alt+F4]

===Configurer Internet Explorer en mode kiosque===
*Créer un raccourci d'Internet Explorer
*Survoler avec le pointeur de la souris l'icône du raccourci
*Sélectionner '''Propriétés'''
*Dans l'onglet '''Raccourci''', champ '''Cible''', rajouter à la fin de la ligne : ''-k http://openflyers.com/plateforme/'' en remplaçant ''plateforme'' par le nom de votre plateforme OpenFlyers
<pre>""C:\Program Files (x86)\Internet Explorer\iexplore.exe" -k http://openflyers.com/plateforme/</pre>
*Cliquer sur le bouton '''OK'''
Une fois Internet Explorer lancé, pour le fermer, il faut utiliser la combinaison de touches [Alt+F4]

==Lancer un programme au démarrage de Windows==
===Lancer un programme au démarrage de Windows XP===
Mettre un raccourci vers le navigateur dans le menu '''Démarrer > Programmes > Démarrage'''

===Lancer un programme au démarrage de Windows 8===
*Ouvrir la fenêtre '''Exécuter''' par la combinaison de touches [Win+R]
*Saisir ''shell:startup''
*Dans ce répertoire démarrage, mettre un raccourci vers le navigateur

==Sécuriser Windows==
===[http://www.anfibia-soft.com/products/deskman/index.html deskman]===
Deskman permet de contrôler l'accessibilité des fonctionnalités de Windows. Il est disponible pour Windows XP, Vista 7 et 8 en 32 et 64 bits. Il est disponible pour essai gratuitement et son prix est de 35 € pour un poste.

====Installation de Deskman====
'''Attention''' : ce programme permet de limiter totalement l'accès à un ordinateur notamment en empêchant l'exécution de programmes. S'il est mal configuré, il peut devenir [[#Impossible_de_saisir_le_mot_de_passe_dans_deskman|impossible d'en retrouver le contrôle]].
*[http://www.anfibia-soft.com/products/deskman/index.html#getdeskman Télécharger deskman] en cliquant sur le bouton '''Donwnload Deskman'''.
*Exécuter ''deskmansetup.exe'', accepter les conditions générales et lancer Deskman.
*Cliquer sur l'icône '''Settings'''
*Dans l'onglet '''Basic''', formulaire '''Deskman Authentication'', renseigner dans '''Main password''' et '''Confirm password''', le mot de passe permettant d'accéder à deskman.
*Noter le raccourci par défaut permettant d'afficher affiché dans le formulaire '''Open Deskman''', champ '''Primary Hotkey''' : [CTRL + MAJ + F12]
*Cliquer sur le bouton '''Save'''.

====Activer le contrôle avec Deskman====
Il faut avoir [[#Installation_de_Deskman|installé]] Deskman et mis en place un mot de passe d'accès
*Lancer Deskman
*Cliquer sur l'icône '''Secure'''

====Bloquer [Alt+F4] avec Deskman====
Il faut avoir [[#Installation_de_Deskman|installé]] Deskman
*Lancer Deskman
*Dans l'onglet '''Keys''', cocher '''Key Options > Program Closing Disable Alt-F4'''
*[[#Activer_le_contr.C3.B4le_avec_Deskman|Activer le contrôle avec Deskman]]

====deskman troubleshooting====
=====Impossible de saisir le mot de passe dans deskman=====
Lors de nos essais sur un PC portable avec écran tactile sous Windows 8, il nous a été impossible de saisir le mot de passe permettant de reprendre l'accès car la plupart des touches du clavier étaient reconnues commes des raccourcis pour lancer des programmes au lieu d'afficher le caractères correspondant dans le champ de saisie du mot de passe.

Procédure pour retrouver le contrôle total et les paramètres d'origine :

*Eteindre l'ordinateur
*Déconnecter le disque dur contenant Windows
*Déconnecter le disque dur et le connecter depuis un autre ordinateur
*Renommer les fichiers exécutables correspondants au programme deskman présents dans "Program Files (x86)\anfibia deskman" en rajoutant par exemple un caractère pour en empêcher l'exécution au démarrage.
*Reconnecter le disque dur le PC d'origine
*Lancer Windows : vous retrouver l'accès à l'ordinateur
*Remettre les noms de fichiers initiaux de deskman
*Désinstaller deskman
*Ré-installer deskman
*Activer deskman sans rien restreindre : cela permet de rétablir l'intégralité des accès à Windows notamment au répertoire racine "Ce PC" qui peut ne pas être réapparu.
*Désactiver deskman

FAQ client

2016-12-02T15:30:48Z

Bbarbe :

=Fonctionnement d'OpenFlyers=
==[[Modèle_commercial_et_compte_client_OpenFlyers#Fonctionnement_.C3.A9conomique|Fonctionnement économique]]==

==Fonctionnement applicatif==
Les composants logiciels utilisés pour développer notre applicatif sont tous open source (notamment PHP et MySQL).

La version 2.0 du logiciel OpenFlyers, propriété de la S.A.R.L. OpenFlyers, est sous licence semi-libre : il peut être installé et utilisé pour les besoins propres d'une structure aéronautique mais il ne peut être commercialisé par une société tiers sans licence spécifique (même à la demande d'un seul client) ou déployé pour des filiales d'une structure commerciale ou non.

Les versions ultérieures à la version 2.0 du logiciel OpenFlyers, sont commercialisées uniquement par le biais d'un abonnement auprès de la S.A.R.L. OpenFlyers qui en garde l'hébergement exclusif.

==[[Modèle_commercial_et_compte_client_OpenFlyers#Arbitrage_des_demandes_de_d.C3.A9veloppements#Financement_des_d.C3.A9veloppements|Nouveaux développements]]==

==De quoi avons-nous besoin pour faire fonctionner OpenFlyers ?==
Il suffit de disposer d'un ordinateur avec un accès internet et d'un navigateur moderne tel que Google Chrome, Firefox, Internet Explorer, Opera ou Safari. Aucune installation particulière n'est nécessaire sur l'ordinateur.

=Les bases de données=
==Les données stockées sont-elles bien protégées ?==
Nous tâchons de mettre en œuvre les différentes recommandations concernant la gestion des serveurs afin d'empêcher toute intrusion.

De plus, nous disposons de plusieurs serveurs répartis en plusieurs endroits de la planète.

Chaque nuit, tous les serveurs sauvegardent leurs bases de données et les envoient à tous les autres serveurs.

Ces sauvegardes sont stockées par roulement sur une quinzaine de jours.
==Comment récupérer notre base de données ?==
Vous pouvez à tout moment récupérer le contenu de votre base de données :
*[[AdminDoc3#Configuration_.3E_Export_SQL_.3E_Complet|Procédure version 3]]

==Peut-on avoir un accès de type "phpMyAdmin" à notre base de données ?==
Vous avez un accès en lecture à la base de données via l'export mais également via la génération des rapports.

La structure de la base de données est documentée ici : http://doc-en.openflyers.com/index.php?title=Database_specification

Par contre, nous nous interdisons de vous fournir un accès en écriture à la base de données. Car nous devons pouvoir garantir l'intégrité de cette base de données vis-à-vis de vous-même, vis-à-vis de vos utilisateurs mais également vis-à-vis de tierces personnes ou encore vis-à-vis des autorités.

Cependant, si vous avez besoin de modifier une saisie en base de données, nous pouvons intervenir sur votre demande par e-mail ou courrier. Cette opération est facturée en fonction de sa complexité (voir [http://www.openflyers.com/pricing/catalog-price le catalogue tarifaire]).

==Peut-on importer notre ancienne base de données externe OF 1.3.x lors du passage en production sur la solution hébergée OpenFlyers ?==
Oui, il est tout a fait possible de reprendre votre ancienne base de données OF 1.3.x.

Le coût est à partir de 50 € HT/heure, le temps effectif étant déterminé lors de l'import. Il faut nous faire parvenir un export complet de la base SQL de votre plateforme.

Il faut au préalable que vous ayez créé une [https://client.openflyers.com/newSubscription.php?lang=francais plateforme client ], puis nous signaler l'identifiant de votre plateforme.

Il faut ensuite vous créer la ou les factures, selon l'abonnement choisi, à partir de votre [http://client.openflyers.com/ clientmanager]

Vous acquittez les factures correspondant à la migration de votre base de données, de votre abonnement et éventuellement de la migration de votre plateforme de la version 2.1 en 3.0

Puis, l'idéal est de fixer un rendez-vous, par exemple, le XX-XX-2012 à 9 h. Puis, à cette même date :
*vous bloquez votre accès sur votre plateforme OF le jour J à 9h00 ;
*vous nous envoyez la base de données en suivant ;
*nous migrons, dès réception, votre base de données vers la version 2.1 (ou la version 3.0) sur nos serveurs ;
*une fois cela fait, on vous envoie un e-mail ;
*vous mettez en place de votre côté une redirection vers la nouvelle URL OF.

Il faut compter environ 2 heures maximum pour procéder à la migration (suivant les difficultés que nous rencontrerons avec votre base de données).

Les opérations d'export/import sont ainsi synchronisées et l'interruption de service est la plus courte possible.

=Compte client OpenFlyers=

==[[Modèle_commercial_et_compte_client_OpenFlyers#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|Comment accéder à mon compte client ?]]==

==Comment modifier des éléments de la fiche client ?==
Il vous suffit de vous [[Modèle_commercial_et_compte_client_OpenFlyers#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|connecter à votre plateforme]] OpenFlyers.

Puis d'éditer la fiche en allant dans Données/Affichage et fiche personnelle.

==[[Modèle_commercial_et_compte_client_OpenFlyers#Changer_de_responsable_en_charge_d.27OpenFlyers|Comment changer de responsable OpenFlyers ?]]==

==[[Modèle_commercial_et_compte_client_OpenFlyers#Renouveler_son_abonnement_OpenFlyers|Comment renouveler l'abonnement ?]]==

==Nous avons renouvelé notre abonnement et nous avons quand même un message d'alerte concernant la cotisation==
Le message d'alerte '''votre cotisation n'est pas à jour''' correspond à un message lié à la configuration de la plateforme OpenFlyers et non pas à l'abonnement OpenFlyers de cette plateforme. Il signifie que l'utilisateur qui se connecte n'est pas à jour de sa qualification/validité cotisation au sein de la structure.

Dans tous les cas, l'administrateur référent (celui dont l'adresse e-mail doit apparaitre sur la page d'accueil d'OpenFlyers) conserve néanmoins tous ses droits.

Cf. Gestion des validités des utilisateurs dans OpenFlyers [[Validity-management3#Gestion_des_validit.C3.A9s_des_utilisateurs| la version 3]] et la [[Validity-management4#Gestion_des_validit.C3.A9s_des_utilisateurs| la version 4]].

==Changement du nombre de ressources en cours d'année et mise à jour de l'abonnement==
*[[Modèle_commercial_et_compte_client_OpenFlyers#Ajouter_une_ressource_.C3.A0_son_abonnement_OpenFlyers|Ajouter une ressource à son abonnement OpenFlyers]]
*[[Modèle_commercial_et_compte_client_OpenFlyers#Enlever_une_ressource_.C3.A0_son_abonnement_OpenFlyers|Enlever une ressource à son abonnement OpenFlyers]]
*[[Modèle_commercial_et_compte_client_OpenFlyers#Remplacer_une_ressource_par_une_autre_dans_son_abonnement_OpenFlyers|Remplacer une ressource dans son abonnement OpenFlyers]]

==[[Modèle-commercial-et-compte-client-OpenFlyers#Remplacer-une-ressource-par-une-autre-dans-son-abonnement-OpenFlyers|Comment remplacer une ressource par une autre ?]]==

==Facturation des ressources réelles et virtuelles==
A partir de la version 2.1 d'OpenFlyers, seules les ressources qui génèrent du chiffre d'affaires pour la structure cliente sont intégrées dans l'abonnement. Ainsi, les salles de cours ne sont pas retenues dans le calcul de l'abonnement. Pour qu'OpenFlyers fasse la différence entre une ressource "réelle" et une ressource "virtuelle", il suffit de décocher "Aéronef réel" au niveau de la ligne associée à l'aéronef ('''Admin > Flotte > Aéronefs''' colonne Aéronefs réels).

==[[Créer_une_plateforme_OpenFlyers_pour_sa_structure#Prise_d.27abonnement|Nous avons créé une plateforme, comment passer en production ?]]==

==J'ai souscrit un abonnement First Price - Peut-on souscrire à tout moment un forfait paramétrage ?==
Oui, effectivement. Il se peut que le paramétrage de votre plateforme se révèle complexe, ou bien que vous manquiez de temps pour le configurer. Vous pouvez à tout moment opter pour notre forfait paramétrage, dont vous pouvez retrouver le tarif dans notre [http://www.openflyers.com/doc/catalogue-tarifaire.pdf catalogue tarifaire].

Cependant, dans le cas là, nous repartons d'une base de données vierge pour ne pas perdre de temps dans la correction (et la compréhension) du paramétrage initialement effectué.

==J'ai souscrit un abonnement First Price - Peut-on basculer en cours d'année vers un abonnement Business ?==
Oui, vous pouvez à tout moment basculer vers un abonnement Business. Il faut pour cela nous en faire la demande. Nous vous créons alors la facture correspondant à la différence de tarif. Vous pouvez ensuite régler cette facture depuis votre Client Manager.

==Je m'abonne en cours d'année - Combien vais-je devoir payer ?==
Pour la première année d'abonnement, le prix est calculé au prorata du nombre de jours civils entre la date de la commande et le trente-et-un (31) décembre de l’année civile en cours cf nos [http://www.openflyers.com/license/conditionsgenerales1_3.pdf conditions générales].

==L'accès First Price dispose-t-il d'une connexion sécurisée ?==
Non, l'accès First Price ne dispose pas d'une connexion sécurisée. Il peut être pris en option (renouvelable chaque année) selon le tarif en vigueur dans notre [http://www.openflyers.com/doc/catalogue-tarifaire.pdf catalogue tarifaire]. L'accès First Price plus l'option HTTPS est de même niveau que le Business avec HTTPS inclus (256 bits).

=Plateforme OpenFlyers=
==[[Créer_une_plateforme_OpenFlyers_pour_sa_structure|Comment créer une plateforme ?]]==

==Impossible d'accéder à la plateforme de notre structure après création==
Attention ! Il ne faut pas confondre le couple identifiant/mot de passe qui permet d'accéder au compte client OpenFlyers de votre structure, depuis [https://client.openflyers.com Client Manager], avec le couple identifiant/mot de passe qui permet d'accéder à la plateforme OpenFlyers.

*Le couple identifiant/mot de passe pour accéder au compte client OpenFlyers de votre structure vous a été communiqué par e-mail.
*Le couple identifiant/mot de passe pour accéder à votre plateforme OpenFlyers, immédiatement après création, est admin/admin. Vous êtes invité à le modifier des que possible

==Nous avons déjà une plateforme OpenFlyers version X et nous voudrions tester la version Y==
===Quelles alternatives ?===
====soit vous migrez directement de la version X vers la version Y====
'''Nous recommandons cette solution (c'est même un prérequis dans le cadre du [[#Comment_fonctionne_le_forfait_param.C3.A9trage_.3F|forfait paramétrage]])'''

*avantages :
:*Vous habituez vos utilisateurs à la nouvelle interface sans pour autant leur activer les nouvelles fonctionnalités
:*Vous paramétrez tranquillement depuis une base de données à jour les éléments
*inconvénients :
:*vous payez de suite la tarification de la version Y
:*vous êtes moins libre car vous travaillez sur une base de données en production (mais vous pouvez supprimer cet inconvénient en travaillant en parallèle sur une autre base de données en test)
Pour procéder à cette migration, il suffit d'envoyer un e-mail à l'équipe OpenFlyers. A noter, qu'il faudra acquitter une nouvelle facture d'hébergement correspondant à la différence de tarification entre la version X et la version Y.

====soit vous créez une nouvelle plateforme qui vous servira de plateforme de test====
*avantages :
:*vous avez toute latitude pour paramétrer sans risque
:*vous ne payez pas la différence de coût entre la version X et la version Y pendant que vous testez
*inconvénients :
:*lors de votre migration de votre plateforme en production, vous devrez reprendre tout le paramétrage

Pour cela, il vous suffit de suivre [[#Comment_cr.C3.A9er_une_plateforme_.3F|la procédure de création de plateforme]].

Ensuite, lorsque vous souhaiterez migrer de la version X à la version Y (passage en production sur la version Y), voici ce qu'il faudra faire :
*nous envoyer un e-mail de demande de migration (ou passer par le forum)
Alors nous effectuerons les actions suivantes :
*migration de la base de données X vers la Y
*changement du pointage de votre adresse openflyers.com/nom_de_la_plateforme par exemple de la X vers la version Y
Ensuite vous devrez modifier les paramétrages de la nouvelle Y (en reprenant par exemple ceux de votre version de test)

Une fois que cela sera fait, vous nous le direz et nous supprimerons la base de données de la version Y

Ensuite nous facturons chaque demande de migration de base de données (cf. le [http://www.openflyers.com/doc/catalogue-tarifaire.pdf catalogue tarifaire]).

====Forfait paramétrage====
N'oubliez-pas que nous proposons [[#Comment_fonctionne_le_forfait_param.C3.A9trage_.3F|le forfait paramétrage]] pour la configuration d'OpenFlyers.

===Quel est le délai pour migrer une base de données ?===
Il faut compter 1 semaine

==[[Modèle_commercial_et_compte_client_OpenFlyers#D.C3.A9roulement_d.27une_migration|Comment se fait la migration vers une version supérieure ?]]==

==[[Modèle_commercial_et_compte_client_OpenFlyers#Cons.C3.A9quences_d.27une_migration|Quelles sont les conséquences d'une migration ?]]==

==La configuration nous laisse perplexe (paramétrage de la facturation, de la comptabilité, du décompte des temps de vols), comment faire ?==
Si vous souhaitez utiliser en production rapidement votre plateforme OpenFlyers (par exemple idéalement à l'occasion d'un nouvel exercice comptable, c'est à dire au 1er janvier), et que vous souhaitez avoir un paramétrage fonctionnel rapidement sans avoir à y consacrer des heures pour comprendre, tester et sans doute passer à côté de certaines "subtilités", alors sachez que nous avons mis en place un "[[#Comment_fonctionne_le_forfait_param.C3.A9trage_.3F|forfait paramétrage]]".

Ce forfait est également valable pour un client utilisateur de la version 1.3.x et qui souhaite migrer sans attendre à la version 3.0.3 en utilisant toutes ses fonctionnalités (comptes pilotes et heures de vols).

==Nous avons une version 3 en test==
===mais nous souhaiterions reprendre tout à zéro, comment faire ?===
Vous vous inscrivez à nouveau avec un nouveau nom ici : http://client.openflyers.com

===Peut-on garder la configuration de la version 3 et migrer uniquement les réservations de la 1.3.x ?===
Non, ce n'est pas possible car les contenus auront évolués différemment.

Voila ce qu'il faut faire :
*demander la migration par e-mail de la 1.3.x vers la 3 avec passage en prod sur la 3 (c'est transparent pour les utilisateurs : seule l'interface changera pour eux tant que l'administrateur ne leur aura pas donné de droits supplémentaires)
*reprendre la configuration faite sur la 3 en test sur la nouvelle 3
*envoyer un nouveau e-mail pour dire que l'on peut supprimer l'ancienne 3 en test

==Comment passer à la gestion des comptes et la comptabilité dans OpenFlyers ?==
Pour activer la gestion des comptes et de la comptabilité dans OpenFlyers, vous pouvez suivre les FAQ dédiées à la comptabilité ainsi que les documentations qui présentent les modules de comptabilité :
*[[FAQ comptabilité|FAQ comptabilité version 2.1]]
*[[FAQ_accounting3|FAQ comptabilité version 3.0]]
*[[FAQ_accounting4|FAQ comptabilité version 4]]
*[[Accueil#Comptabilit.C3.A9|Documentations sur la comptabilité]]
dont [[Comptabilité#Mise_en_place_de_la_comptabilit.C3.A9_dans_OpenFlyers|Quelques conseils sur la mise en place de la comptabilité dans OpenFlyers]]

=Support=
==Quels sont les supports techniques ?==
Il existe à ce jour 3 types de support :
*le support-forum accessible depuis notre site internet http://www.openflyers.com à l'onglet "Support"
*le support par e-mail réservé aux abonnements "Business" et plus.
*le [http://www.openflyers.com/support support ponctuel par téléphone] qui peut vous permettre de vous dépanner si nous pouvons vous fournir la réponse en temps réel.

==[[How_to_communicate_with_OpenFlyers#Cr.C3.A9er_un_compte_d.27acc.C3.A8s_au_support-forum|Comment créer son accès au support-forum ?]]==

==Les e-mails envoyés à OpenFlyers sont retournés en erreur==
Lors de l'envoi de vos messages, vous avez avez eu un message d'erreur en retour.

Le problème peut venir de l'[[Wikipedia-fr:Sender_Policy_Framework|authentification SPF]] que nous avons mis en place.

Ainsi, si le serveur OpenFlyers refuse les e-mails non authentifiés qui parviennent depuis un nom de domaine comme smtp.nom-de-domaine.com pour défaut de SPF, il faut rajouter un enregistrmenet TXT dans le gestionnaire du serveur concerné avec la ligne de commande : v=spf1 include:_spf.nom-de-domaine.com ~all.

Modèle commercial et compte client OpenFlyers

2016-12-02T15:27:42Z

Bbarbe :

__TOC__
=Définitions=
==Plateforme de démonstration==
Les plateformes de démonstration sont accessibles au public et servent de bac à sable.

Le sous-domaine de l'URL des plateformes de démonstration est ''demo'' ou commence par ''demo-''. Il existe également des plateformes de démonstration spécifiques dont le sous-domaine est différent.

Elles sont réinitialisées toutes les heures à la minute 44.
==Plateforme en production==
Une plateforme est considérée en production lorsque l'abonnement pour l'année en cours a été payé.

La phase de paramétrage qui précède le "passage en production" effectif s'effectue toujours sur une "plateforme en production".

==Plateforme en test==
Les plateformes en test sont de 2 natures :
*Les plateformes créées par un utilisateur et qui ne sont pas [[#Plateforme_en_production|en production]];
*[[#Plateforme_suppl.C3.A9mentaire_de_test|Les plateformes supplémentaires de test]];

=Le modèle commercial de la SARL OpenFlyers=
==Fonctionnement économique==
OpenFlyers fonctionne sur le modèle économique d'une ASP (=Application Service Provider) ou SaaS (= Software as a Service). On parle également de "cloud computing" (informatique dans les nuages). C'est-à-dire que nous fournissons un service applicatif par le biais d'internet pour lequel nous facturons un abonnement annuel.

Les avantages de ce système pour les clients finaux sont les suivants :
*la maintenance logiciel est déportée et ne nécessite plus le déplacement d'un technicien. Cela permet également de mettre en œuvre plus rapidement des correctifs à la demande ;
*le coût des développements est mutualisé entre les différents clients ;
*nous assurons nous-mêmes la pérennité des données par sauvegardes journalières sur plusieurs serveurs en plusieurs lieux et cela sur 20 jours glissants.

De plus, OpenFlyers existe en plusieurs versions dont certaines sont disponibles en téléchargement. Vous pouvez retrouver [http://wiki.openflyers.org/index.php?title=FAQ#May_I_install_OpenFlyers_on_my_own_server.3F plus d'infos sur notre support libre].

==Arbitrage des demandes de développements==
Les demandes de développements pour avoir de nouvelles fonctionnalités sont infinies. Au début de son existence OpenFlyers devait arbitrer entre les demandes des différents clients. Pour cela, l'équipe de développement OpenFlyers tenait compte de la taille d'un client ou d'un prospect pour arbitrer les différentes demandes et du potentiel impact qui pouvait en résulter sur le chiffre d'affaire au travers des nouveaux clients qui pouvaient se décider à passer à OpenFlyers du fait de l'existence de telle ou telle fonctionnalité. Ces demandes étant nombreuses, les demandes non retenues étaient nombreuses et cela pouvait conduire à "vexer" un client qui pouvait considérer que sa demande non retenue ou mise en attente était plus pertinente qu'une autre demande retenue.

Afin de ne plus être juge et parti, OpenFlyers a remis au goût du jour le [[Wikipedia-fr:Suffrage_censitaire|vote censitaire]] au travers des heures de bonus développement. Ainsi, les conditions générales d'OpenFlyers donne la possibilité aux clients de choisir eux-mêmes les développements qui leur seront le plus profitable. Le fonctionnement est le suivant :
*Tout client désireux de voir développer une nouvelle fonctionnalité peut faire '''une unique demande''' de devis développement '''par an'''. Cette demande doit être effectuée par e-mail en précisant le nom de la structure aéronautique cliente.
*En fonction du coût en heures de développement, ce développement peut être financé par les heures de bonus développement dont bénéficie chaque client. Plusieurs clients peuvent mutualiser leurs heures de bonus de développement. Les développements peuvent être également financés en partie ou en totalité par une facturation spécifique dans le cas où le bonus développement ne permet pas de couvrir l'intégralité du coût en heures.
*A l'issue d'une demande de devis, un client peut demander un nouveau devis à condition qu'il ait accepté le 1er devis. Le but est de limiter le temps consacré par l'équipe OpenFlyers à effectuer des devis.
Nous mutualisons les développements : tous nos développements sont intégrés au sein de l'unique version en cours de développement. Ainsi, tous les clients bénéficient des demandes de chacun d'entre-eux.
*Les développements "votés" sont triés par ordre d'arrivé sauf pour ceux dont une partie est financée en somme "sonnante et trébuchante" qui passent en priorité.

Enfin, les clients peuvent, avant d'effectuer une demande de devis par e-mail, faire part de leur demande sur le [http://support-fr.openflyers.com/ forum] dans la partie '''Evolutions et Adaptations''' en vérifiant qu'elle n'existe pas déjà. C'est aussi un moyen pour le demandeur d'inviter d'autres clients à s'associer à leur demande en mutualisant leurs heures de bonus développement.

==Bonus assistance/développement==
Chaque client dispose en fonction de son abonnement d'un quota d'heures de bonus qui peuvent être utilisées comme assistance ou comme développement (cf. [[#Arbitrage_des_demandes_de_d.C3.A9veloppements|Arbitrage des demandes de développements]]).

L'assistance permet de couvrir une demande de support téléphonique ou une demande d'intervention sur la plateforme.

Pour utiliser les heures de bonus, il faut :
*Faire une demande par e-mail d'intervention ou de support.
''Nous répondons en indiquant le temps à prévoir/déduire des heures de bonus''
*Confirmer sa demande par retour d'e-mail

Les demandes sont triées par ordre d'arrivé sauf pour celles dont une partie est financée en somme "sonnante et trébuchante" qui passent en priorité.

A noter que les heures non utilisées dans l'année sont perdues (cf. les [https://openflyers.com/fr/entreprise/conditions-generales conditions générales de vente]).

Il n'existe pas à ce jour d'interface permettant de suivre les heures déjà utilisées. Il est néanmoins possible d'en obtenir le suivi sur simple demande par e-mail.

=Compte client OpenFlyers=
Attention, il ne faut pas confondre son compte client OpenFlyers qui permet d'accéder à sa fiche client OpenFlyers et qui permet de renouveler son abonnement OpenFlyers avec son identifiant personnel permettant d'accéder à sa plateforme OpenFlyers.

==Accéder à son compte client OpenFlyers==
Aller sur [https://client.openflyers.com l'espace client] OpenFlyers.

L'identifiant permettant d'accéder à votre compte client correspond au nom de votre plateforme.

Par exemple, si votre plateforme est référencée par l'adresse :
http://openflyers.com/mermoz/

Alors le nom de votre plateforme est '''mermoz'''.

C'est donc '''mermoz''' qu'il faut utiliser comme identifiant pour vous connecter au .

Si vous n'avez pas le mot de passe, vous pouvez le réactiver avec la fonction '''Mot de passe oublié ?''' qui est sur la page d'identification.

Une adresse e-mail vous sera demandée. Vous pourrez saisir l'adresse e-mail de la structure aéronautique ou celle du contact qui ont été saisies dans la fiche client (il s'agit des adresses e-mails sur lesquelles sont envoyées nos e-mails d'alerte de renouvellement ou d'information).

Dans le but de ne pas être submergés par les demandes, nous facturons la ré-initialisation manuelle, par nos soins, du mot de passe ou la mise à jour des adresses e-mails présentes sur la fiche client pour les abonnement First Price (cf. le [http://www.openflyers.com/doc/catalogue-tarifaire.pdf catalogue tarifaire]).

==Changer de responsable en charge d'OpenFlyers==
Lorsqu'il y a un changement de responsable en charge d'OpenFlyers, pour que la passation se passe dans les meilleures conditions, il faut penser à effectuer les 3 changements suivants :
*Attribuer un profil d'administrateur de la plateforme OpenFlyers au niveau de la plateforme (procédure pour intervenir sur la fiche utilisateur pour la [[User-management3#Modifier_un_utilisateur|version 3]] ou la [[User-management4#Acc.C3.A9der_.C3.A0_l.27interface_de_gestion_des_utilisateurs|version 4]])
*Mettre à jour le champ du responsable OpenFlyers au niveau de la plateforme (procédure pour la [[AdminDoc3#Responsable_OpenFlyers|version 3]] et la [[AdminDoc4#Responsable_OpenFlyers|version 4]]).
*Mettre à jour le nom du responsable OpenFlyers au niveau de la fiche client en effectuant la procédure suivante :
**[[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|Se connecter à l'espace client OpenFlyers]]
**Aller dans '''Fiche contact'''
**Mettre à jour la fiche
**Cliquer sur le bouton '''Valider'''

Dans le cas où la passation ne peut pas se faire ainsi car l'ancien responsable OpenFlyers ne peut pas effectuer ces opérations ou transmettre les couples (identifiants, mots de passe) au nouveau responsable pour qu'il effectue ces opérations, vous pouvez nous demandez, uniquement par e-mail, d'effectuer ces changements de responsable OpenFlyers, en joignant à l'e-mail :
*Un courrier signé du responsable de la structure (gérant, président, etc.) contenant la demande de mise à jour du responsable OpenFlyers désigné et indiquant explicitement le nom du nouveau responsable avec son adresse e-mail
*Une copie d'un document officiel (extrait K-BIS, procès-verbal d'assemblée générale, etc.) permettant de prouver la qualité du responsable de la structure.
Le courrier scanné n'est pas nécessaire dans le cas où le nouveau responsable OpenFlyers apparait sur l'extrait K-BIS.

'''Attention :''' dans le cas d'une société, le responsable de la structure doit détenir plus de la moitié des parts dans la société. Dans le cas où il y a cogérance, alors il faut que le courrier soit signé de l'ensemble des responsables de sorte à représenter plus de la moitié des parts de la société.

==Mettre à jour sa fiche client==
*[[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|Se connecter à l'espace client]]
*Cliquer sur le menu '''Fiche contact'''
*Mettre à jour le contenu des champs concernés
*Cliquer sur le bouton valider
''Conseil OpenFlyers :'' Il est fortement recommandé d'avoir 2 adresses e-mails différentes pour les champs '''E-mail client''' et '''E-mail contact'''

==Migrer vers une nouvelle version OpenFlyers==
Chez OpenFlyers, nous parlons de migration vers une nouvelle version lorsqu'il s'agit de mettre à jour une plateforme d'une version X vers une version Y incluant des changements majeurs.

Par contre, il existe les mises à jours. Les mises à jour ne changent pas le numéro de version principal (exemple : 3.2 ou 3.5 correspondent à la même version principale). OpenFlyers effectue ces mises à jour automatiquement. Leur objectif est de corriger des bugs ou de rajouter de nouvelles fonctionnalités.

Hormis pour les abonnements Première, qui disposent d'une plateforme avec une version gelée et indépendante d'OpenFlyers, toutes les autres plateformes OpenFlyers sont sur un moteur commun qui est mis à jour de façon transparente plusieurs fois par semaine, voir même par jour.

Nous ne présentons ci-dessous que les migrations "majeurs" qui peuvent impliquer des opérations de nettoyage manuel post-migration.

===Coût d'une migration===
Lorsque vous êtes en production sur une version X d'OpenFlyers, vous pouvez demander à migrer vers la dernière version stable proposée aux nouveaux clients ou même vers la dernière version en développement dénommée "alpha" ou "beta" (par exemple "version 3.0alpha").

Les migrations sont incluses dans le support des abonnement Business, Première et Corporate.

Dans le cas d'un abonnement First Price, la migration est facturée 50 € HT sauf dans le cas d'une migration vers une version alpha ou beta ou depuis vers une version alpha ou beta vers la version stable suivante. Exemple de migrations offertes en abonnement First Price :
*Migration depuis la version 3.0alpha vers la version 3
*Migration depuis la version 3.5 vers la version 4.0alpha
*Migration depuis la version 4.0alpha vers la version 4

Enfin, dans le cas où la plateforme bénéficiait d'un ancien tarif, le fait de migrer implique le passage au tarif en vigueur au moment de la migration et à l'acquittement de la différence de tarif par rapport à l'ancien tarif.

===Déroulement d'une migration===
#Il faut avoir pris connaissance des [[#Cons.C3.A9quences_d.27une_migration|conséquences d'une migration]] et accepter le fait qu'elle est irréversible
#Il faut éventuellement créer la ou les factures selon l'abonnement déjà souscrit et l'abonnement souhaité (cf. [[#Co.C3.BBt_d.27une_migration|Coût d'une migration]] en [[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|se connectant sur l'espace client]].
#Il faut payer les factures correspondantes ainsi créées.
#Il faut en faire la demande par e-mail et précisant la date avant laquelle vous ne souhaitez pas qu'on effectue de migration. Il n'est pas possible de programmer une date pour une migration : cela se fait en fonction de la synchronisation des disponibilités des différents collaborateurs d'OpenFlyers qui doivent intervenir à tour de rôle.
#Nous créons alors les factures liées à la migration, à la différence de tarif et au forfait paramétrage selon votre abonnement et les options souscrites (cf. le [http://www.openflyers.com/doc/catalogue-tarifaire.pdf catalogue tarifaire]).
#Vous payez.
#Nous procédons alors à cette migration et nous fournissons une URL de substitution pendant une semaine pour palier les problèmes de cache DNS. Lors de la migration l'interruption de service est seulement de quelques minutes. Elle est donc transparente pour la quasi totalité des utilisateurs.
#Selon ce qui a été convenu nous effectuons ou le client effectue [[Upgrade3|le nettoyage lié au passage à la version 3]].
#Si vous avez souscrit au forfait paramétrage ou qu'il est inclut dans votre abonnement, nous vous envoyons un questionnaire pour le paramétrage. Cf. [[#Comment_fonctionne_le_forfait_param.C3.A9trage_.3F|Forfait paramétrage]]

===Conséquences d'une migration===
*Toute migration est irréversible : nous ne créons pas de script permettant de revenir vers une version antérieure. En effet, nous effectuons des migrations "cachées" plusieurs fois par semaine qui constituent des corrections de bugs ou l'ajout de nouvelles fonctionnalités. De ce fait, notre exploitation est organisée pour pouvoir palier à un défaut apparaissant à l'issue d'une migration tout comme elle est organisée pour faire face à l'apparition d'un nouveau bug lors d'une mise à jour transparente.
*Attention notamment à une migration vers une version "alpha" ou "beta" : en effet, une migration vers cette version implique que vous acceptiez de fonctionner sur une version qui évolue sans cesse. Outre les corrections de bugs, nous rajoutons sur la version beta régulièrement des fonctionnalités qui peuvent créer de nouvelles anomalies. Bien entendu, nous faisons le nécessaire dès que nous avons connaissance d'un problème (notamment par le [http://bts.openflyers.org BTS] pour résoudre les défauts. C'est d'ailleurs grâce aux clients volontaires pour fonctionner sur la version beta que nous pouvons faire évoluer le produit.

==Ajouter une ressource à son abonnement OpenFlyers==
L'abonnement OpenFlyers est calculé en fonction du nombre de ressources. Le nombre est déterminé pour l'année civile complète.

Si vous voulez rajouter une ressource en cours d'année, alors vous devez [[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|vous connecter sur l'espace client OpenFlyers]] et créer une facture d'ajout de ressource en indiquant le nombre de ressources supplémentaires. Le tarif appliqué sera alors celui de l'année complète.

Une fois le paiement de la facture correspondante acquitté, il sera possible d'intervenir sur la plateforme concernée pour rajouter la ressource. Il y alors 2 cas possible :
*C'est une ressource dont les tarifs correspondent à un type de ressource déjà présent sur la plateforme concernée. Dans ce cas, l'opération est relativement simple et nous conseillons de suivre soi-même la [[#Cr.C3.A9er_une_ressource_sur_sa_plateforme_OpenFlyers|procédure de création ci-dessous]].
*C'est une ressource qui nécessite la création d'un nouveau type de ressource avec de nouveaux tarifs : dans ce cas, l'opération est plus complexe. Elle peut être effectuée de façon autonome en suivant la [[#Cr.C3.A9er_une_ressource_sur_sa_plateforme_OpenFlyers|procédure de création ci-dessous]] et en procédant par comparaison avec les types de ressources existantes. Cependant, si vous souhaitez éviter tout risque d'erreur, nous recommandons de nous confier cette tâche en nous communiquant les éléments comme lors de la mise en place du paramétrage par nos soins à l'aide du questionnaire. Nous décomptons notre intervention des heures de bonus assistance/développement à hauteur d'une heure.

===Créer une ressource sur sa plateforme OpenFlyers===
*[[AdminDoc1.2#Ajouter_un_avion|Ajouter un avion avec la version 1.3 d'OpenFlyers]]
*[[Documentation administrateur#Ajouter_un_a.C3.A9ronef|Ajouter un aéronef avec la version 2.1 d'OpenFlyers]]
*[[Resource-management3#Ajouter_une_ressource|Ajouter une ressource avec la version 3 d'OpenFlyers]]
*[[Resource-management4#Ajouter_une_ressource|Ajouter une ressource avec la version 4 d'OpenFlyers]]

==Enlever une ressource à son abonnement OpenFlyers==
Si vous enlevez une ressource en cours d'année, il n'y a aucun changement d'abonnement puisque les ressources sont souscrites pour toute l'année.

===Désactiver une ressource sur sa plateforme OpenFlyers===
*[[AdminDoc1.2#D.C3.A9sactiver_un_avion|Désactiver un avion avec la version 1.3 d'OpenFlyers]]
*[[Documentation administrateur#D.C3.A9sactiver_un_a.C3.A9ronef|Désactiver un aéronef avec la version 2.1 d'OpenFlyers]]
*[[Resource-management3#D.C3.A9sactiver_une_ressource|Désactiver une ressource avec la version 3 d'OpenFlyers]]
*[[Resource-management4#D.C3.A9sactiver_une_ressource|Désactiver une ressource avec la version 4 d'OpenFlyers]]

==Remplacer une ressource par une autre dans son abonnement OpenFlyers==
S'il y a un remplacement de ressource, alors il n'y a pas besoin d'acquitter un nouvel abonnement pour la nouvelle ressource. Le remplacement doit se faire en 2 étapes :
#[[#Désactiver-une-ressource-sur-sa-plateforme-OpenFlyers|désactiver l'ancienne ressource]]
#[[#Créer-une-ressource-sur-sa-plateforme-OpenFlyers|activer la nouvelle ressource]]

Dans le cas d'un remplacement temporaire, il peut être aussi simple de simplement renommer la ressource concernée (immatriculation par exemple). A noter que dans ce cas, les statistiques totaliseront l'activité des 2 ressources en 1 seule.

Si vous ne souhaitez pas désactiver cette ressource, alors vous pouvez [[#Ajouter_une_ressource_.C3.A0_son_abonnement_OpenFlyers|créer une facture complémentaire d'abonnement pour une ressource supplémentaire]].

==Renouveler son abonnement OpenFlyers==
Pour renouveler l'abonnement, il faut :
#[[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|Se connecter]] sur le compte client OpenFlyers
#Créer la facture en fonction du choix d'abonnement (vous trouverez plus d'informations dans notre [http://www.openflyers.com/doc/catalogue-tarifaire.pdf catalogue tarifaire])
#Ensuite, payer soit :
#*par carte bancaire en cliquant sur le lien "paiement par carte bancaire" (le choix le plus pratique pour une prise en compte immédiate)
#*par transfert bancaire (dans ce cas, vous devez prendre en charge tous les frais liés à la transaction). Les coordonnées bancaires sont indiquées sur la facture.
#*par chèque (attention au délai d'acheminement du courrier)

===Variation du nombre de ressources lors du renouvellement===
Lors du renouvellement, le nombre minimum de ressources proposées, dans l'interface de renouvellement de l'abonnement, correspond au nombre de ressources activées dans la plateforme OpenFlyers.

Si vous souhaitez augmenter le nombre de ressources pour l'année suivante, il suffit de modifier la valeur proposée par défaut.

Si vous souhaitez diminuer le nombre de ressources pour l'année suivante, il faut [[#D.C3.A9sactiver_une_ressource_sur_sa_plateforme_OpenFlyers|désactiver des ressources dans la plateforme OpenFlyers]] afin que le nombre proposé par défaut diminue avant de créer la facture de renouvellement d'abonnement.

==Plateforme supplémentaire de test==
Cette fonctionnalité, disponible pour les clients étant au moins sous la version 3.5 d'OpenFlyers, est utile dans le cas où vous souhaitez :
*effectuer des tests sur une recopie de la plateforme de démonstration.
*effectuer des tests sur une recopie de votre propre plateforme et ainsi modifier son paramétrage sur une version [[Wikipedia-fr:Sandbox_(sécurité_informatique)|sandbox]] sans impacter la version de production.
*essayer la version 4 d'OpenFlyers

[[File:Sandbox.png]]

Pour cela, il faut :
*Se connecter sur son [[#Acc.C3.A9der_.C3.A0_son_compte_client_OpenFlyers|compte client]]
*Aller dans le menu '''Plateforme'''
* Plusieurs choix sont proposés :
** Si vous êtes sous la version 3.5 :
*** '''De openflyers.com/demo-fr vers openflyers.com/acbd.test''' : Permet de créer une plateforme de test en effectuant une recopie de la plateforme démo avec suppression du message d'accueil "La base de données cette plateforme de démonstration est réinitialisée toutes les heures, vers XX:45".
*** '''De openflyers.com/acbd vers openflyers.com/acbd.of4''' : Permet de créer une plateforme d'essai sous la version 4 d'OpenFlyers en effectuant une recopie de votre plateforme existante puis en faisant une montée de version sur cette recopie
** Si vous êtes sous la version 3.5 ou supérieure :
*** '''De openflyers.com/acbd vers openflyers.com/acbd.test''' : Permet de créer une plateforme de test en effectuant une recopie de votre plateforme existante
* Cliquer sur '''Valider'''

Si votre plateforme est référencée par l'adresse :
<pre>http://openflyers.com/acbd/</pre>
L'accès à la plateforme de test se fait par l'adresse :
<pre>http://openflyers.com/acbd.test/</pre>
L'accès à la plateforme d'essai de la version 4 d'OpenFlyers se fait par l'adresse :
<pre>http://openflyers.com/acbd.of4/</pre>

Interfaçage OpenFlyers et armoire à clé

2016-12-02T15:22:25Z

Bbarbe :

__TOC__

=Présentation=
L'objet de cette page est de décrire le protocole d'interfaçage avec toute solution d'armoire à clés tiers. Pour les armoires à clés commercialisées par OpenFlyers, il faut se référer à la [[Contrôle d'accès|documentation sur le contrôle d'accès]].

Le protocole repose sur le principe que l'interfaçage est réalisé par un logiciel de contrôle de l'armoire à clé sur un PC ou une solution embarquée et qui dispose d'un accès à internet lui permettant de communiquer avec OpenFlyers. La communication est synchrone.

=Interface utilisateur OpenFlyers=
L'utilisateur ouvre un vol dans OpenFlyers :

[[Fichier:Menu-contextuel-ouverture-de-vol.png]]

Il se retrouve sur le formulaire de saisie du vol en mode Départ en vol:

[[Fichier:Formulaire-ouverture-de-vol.png]]

Lorsqu'il clique sur le bouton de validation, 3 cas peuvent se présenter :
*Une alerte ou plusieurs alertes rouges (bloquantes), s'affichent : l'utilisateur n'a pas la possibilité de surpasser ses alertes, il ne peut alors récupérer la clé :

[[Fichier:Alertes-bloquantes-en-ouverture-vol.png]]

*Une alerte ou plusieurs alertes oranges (non-bloquantes), s'affichent : l'utilisateur a la possibilité de surpasser ses alertes, et ainsi de récupérer la clé :

[[Fichier:Alertes-non-bloquantes-en-ouverture-vol.png]]

*Aucune alerte ne s'affiche, l'utilisateur se retrouve alors directement sur la page lui indiquant :

[[Fichier:Message autorisation libération clé.png]]

Une fois qu'il a cliqué sur '''LIBÉRER LA CLÉ''', il dispose de X secondes. Cette durée est paramétrable par OpenFlyers.

*Lorsqu'il rentre de vol, l'utilisateur n'a plus qu'a retourner sur le formulaire de saisie de vol et à fermer son vol. La clé doit etre remise en place sur l'armoire pour fermer le vol.

=Interface administrateur OpenFlyers=
==Activation et configuration de la gestion des armoires à clé==
*'''Admin'''
*'''Configuration > Paramétrage'''
*Dans le formulaire '''Gestion des vols''', sélectionner '''Activé(e)''' pour le champ '''Gestion armoire à clé'''
*Cliquer sur le bouton '''Valider''' lié au formulaire
*Dans le formulaire '''Gestion des vols''', sélectionner '''Activé(e)''' pour le champ '''Gestion des clés'''
*Cliquer à nouveau sur le bouton '''Valider''' lié au formulaire
*Le formulaire apparait alors comme suit :

[[Fichier:Paramétrage armoire à clé.png]]

*Signification des paramètres :
**'''Gestion des clés''' : Gestion par OpenFlyers des clés de l'armoire ('''Désactivé(e)''' ou '''Activé(e)''')
**'''Nombre de clés''' : nombre de clés possibles dans l'armoire
**'''Temporisation''' : temps en secondes pendant lequel la clé peut être retirée après autorisation.
**'''Logiciel de contrôle de l'armoire à clé''' : Il s'agit du nom du logiciel de contrôle de l'armoire à clé. PyOpenKey (protocole open), OpenKey (protocole Openflyers, version 1), pyOpenkey2 (protocole Openflyers version 2) .
**'''IP du PC contenant le logiciel de contrôle''' : adresse IP du PC sur lequel se trouve le logiciel de contrôle de l'armoire à clé.
**'''Port du PC contenant le logiciel de contrôle''' : port sur lequel écoute le logiciel de contrôle de l'armoire à clé.
**'''Fermeture automatique des vols au retour de la clé''' : permet de programmer la fermeture automatique des vols au retour de la clé.
**'''Phrase mot de passe''' : phrase permettant d'authentifier la source de la transmission dans le cas d'une requête XML-RPC.
'''Attention :''' dans le cas où le logiciel de contrôle de l'armoire à clé se trouve sur le même PC que pour la saisie des vols dans OpenFlyers, il peut y avoir des problèmes de loopback au niveau du routeur.

==Attribution des clés aux ressources/aéronefs==
''Dans le cas où c'est le logiciel OpenFlyers qui gère les clés.''
*'''Admin'''
*'''Ressources > Ressources > Actives''' ou '''Flotte > Aéronefs > Aéronefs actifs''' sous version OF 2.1

[[Fichier:Liste des aéronefs.png]]

Pour chaque aéronef concerné, il suffit d'attribuer un numéro et un nom de clé dans les champs correspondants. La validation de la saisie se fait automatiquement en cliquant hors du champ de saisie.

=Protocole de dialogue XML-RPC entre OpenFlyers et le logiciel de gestion de l'armoire à clé=
Le dialogue avec le serveur XML-RPC d'OpenFlyers doit s'effectuer en '''HTTPS'''.

==Demande de libération d'une clé==

===Cas avec gestion des clés par OpenFlyers===

*Lorsque qu'une clé doit être libérée, le navigateur envoie un message au logiciel de contrôle de l'armoire à clé par le protocole HTTP sous la forme suivante :
http://127.0.0.1:4080/?sessid=e5f01p2oqh2vb36arisr8k5j87&timeOut=10000&key=1&resource=2&person=12;action='releaseKey'

:*L'adresse IP (ici 127.0.0.1) et le port (ici 4080) sont fonction de la [[#Activation_et_configuration_de_la_gestion_des_armoires_.C3.A0_cl.C3.A9|configuration de l'armoire à clé dans OpenFlyers]].
:*sessid contient le numéro de session en cours
:*timeout correspond au temps d'attente pour la prise d'une clé en millisecondes
:*key contient le numéro de la clé concernée
:*resource contient le numéro de la ressource concernée
:*person contient le numéro de l'utilisateur qui fait la demande
:*action est un mot clé désignant l'objet de la commande
:**release_key: ordre de libérer la clé
:**open_door: ordre d'ouvrir la porte
:**init_tags: ordre de lire les tags des clés
*Le logiciel de contrôle de l'armoire à clé doit alors envoyer une demande d'ordre au serveur OpenFlyers à l'adresse suivante https://openflyers.com/structure/actionOnDemand.php où il faut remplacer openflyers.com/structure par l'adresse de la plateforme OpenFlyers concernée, avec comme commande XML_RPC '''checkCommand ("e5f01p2oqh2vb36arisr8k5j87",int(key))'''.

*Le serveur OpenFlyers vérifie alors l'action demandée :
Pour release_key, il est vérifié :
#Que la clé est au bon format et existe. Lorsque la clé est validée, on passe à l'étape suivante sinon on retourne 0
#Que l'utilisateur faisant la demande est bien celui qui est connecté. Lorsque c'est le cas, on passe à l'étape suivante sinon on retourne 0
#Ensuite si l'utilisateur qui a passé la demande :
#*A le droit '''Gestion des clés''' (administrateur) alors on libère la clé sans condition (cela permet de libérer la clé sans contrôle) et on retourne 1
#*N'a pas le droit '''Gestion des clés''' (pilote) alors on vérifie s'il existe un vol ouvert qui remplit la double condition :
#**Vol attribué à l'utilisateur
#**Aéronef du vol associé à la demande de libération de la clé
#**Lorsque la double condition est remplie, on retourne 1 sinon 0

*Le serveur retourne ensuite la réponse :
**1 dans le cas d'autorisation de libération de clé
**0 dans le cas contraire

====Exemple de script en Python d'utilisation de la commande checkCommand avec gestion des clés====
<python># load library
from twisted.web.xmlrpc import Proxy
from twisted.internet import reactor, ssl

def printValue(value):
print repr(value)
reactor.stop()

def printError(error):
print 'error', error
reactor.stop()

# URL of the XML-RPC server
proxy = Proxy('https://yourURL.xx/actionOnDemand.php')

# init array to send
sessid = ""
key_num = 1

# send to the XML-RPC server
proxy.callRemote('checkCommand', sessid, key_num).addCallbacks(printValue, printError)
reactor.run()</python>

Ce test peut être complété (pour obtenir une réponse "1") en simulant une armoire à clé à l'aide d'un script PHP de la façon suivante :
*Installer un serveur local (par exemple [http://www.wampserver.com/ wampserver] sous Windows) de façon à avoir le port 127.0.0.1 qui lui est attribué
*Configurer la plateforme OpenFlyers de manière à gérer l'armoire à clé avec les éléments suivants :
**'''IP du PC contenant le logiciel de contrôle''' : 127.0.0.1
**'''Port du PC contenant le logiciel de contrôle''' : 80
*Configurer la plateforme OpenFlyers de manière à gérer les clés
*A la racine du répertoire www, mettre le script index.php suivant (on suppose que ce script est appelé par défaut lorsqu'on utilise l'URL http://127.0.0.1 ) :
<php><?php
file_put_contents('test.txt', 'TEST', FILE_APPEND );
file_put_contents('test.txt', print_r($_REQUEST, true), FILE_APPEND );
?></php>
*Toujours à la racine du répertoire www, créer un fichier test.txt
Le script PHP écrira dans le fichier test.txt les variables transmises lors de la demande d'ouverture de l'armoire à clé :
<pre>TESTArray
(
[sessid] => j2eo92215nbef09borb74jftm1
[key] => 1
[resource] => 1
[person] => 1
)</pre>
*Il suffit alors de recopier la valeur de '''sessid''' et de '''key''' dans le script python de ce début de paragraphe et de le tester : il devrait renvoyer 1.

===Cas sans gestion des clés par OpenFlyers===

*Lorsque qu'une demande de vérification doit être réalisée, le navigateur envoie un message au logiciel de contrôle de l'armoire à clé par le protocole HTTP sous la forme suivante :
http://127.0.0.1:4080/?sessid=e5f01p2oqh2vb36arisr8k5j87&resource=2&person=12

:*L'adresse IP (ici 127.0.0.1) et le port (ici 4080) sont fonction de la [[#Activation_et_configuration_de_la_gestion_des_armoires_.C3.A0_cl.C3.A9|configuration de l'armoire à clé dans OpenFlyers]].
:*sessid contient le numéro de session en cours
:*resource contient le numéro de la ressource concernée
:*person contient le numéro de l'utilisateur qui fait la demande
*Le logiciel de contrôle de l'armoire à clé doit alors envoyer une demande d'ordre au serveur OpenFlyers à l'adresse suivante https://openflyers.com/structure/actionOnDemand.php où il faut remplacer openflyers.com/structure par l'adresse de la plateforme OpenFlyers concernée, avec comme commande XML_RPC '''checkCommand ("e5f01p2oqh2vb36arisr8k5j87")'''.

*Le serveur OpenFlyers vérifie alors :
#Que l'utilisateur faisant la demande est bien celui qui est connecté. Lorsque c'est le cas, on passe à l'étape suivante sinon on retourne 0
#On vérifie s'il existe un vol ouvert qui remplit la double condition :
#*Vol attribué à l'utilisateur
#*Aéronef du vol associé à la demande de libération de la clé
#*Lorsque la double condition est remplie, on retourne 1 sinon 0

*Le serveur retourne ensuite la réponse :
**1 dans le cas d'autorisation
**0 dans le cas contraire

====Exemple de script en Python d'utilisation de la commande checkCommand sans gestion des clés====

<python># load library
from twisted.web.xmlrpc import Proxy
from twisted.internet import reactor, ssl

def printValue(value):
print repr(value)
reactor.stop()

def printError(error):
print 'error', error
reactor.stop()

# URL of the XML-RPC server
proxy = Proxy('https://yourURL.xx/actionOnDemand.php')

# init array to send
sessid = ""

# send to the XML-RPC server
proxy.callRemote('checkCommand', sessid).addCallbacks(printValue, printError)
reactor.run()</python>

Ce test peut être complété (pour obtenir une réponse "1") en simulant une armoire à clé à l'aide d'un script PHP de la façon suivante :
*Installer un serveur local (par exemple [http://www.wampserver.com/ wampserver] sous Windows) de façon à avoir le port 127.0.0.1 qui lui est attribué
*Configurer la plateforme OpenFlyers de manière à gérer l'armoire à clé avec les éléments suivants :
**'''IP du PC contenant le logiciel de contrôle''' : 127.0.0.1
**'''Port du PC contenant le logiciel de contrôle''' : 80
*Configurer la plateforme OpenFlyers de manière à ne pas gérer les clés
*A la racine du répertoire www, mettre le script index.php suivant (on suppose que ce script est appelé par défaut lorsqu'on utilise l'URL http://127.0.0.1 ) :
<php><?php
file_put_contents('test.txt', 'TEST', FILE_APPEND );
file_put_contents('test.txt', print_r($_REQUEST, true), FILE_APPEND );
?></php>
*Toujours à la racine du répertoire www, créer un fichier test.txt
Le script PHP écrira dans le fichier test.txt les variables transmises lors de la demande d'ouverture de l'armoire à clé :
<pre>TESTArray
(
[sessid] => j2eo92215nbef09borb74jftm1
[resource] => 1
[person] => 1
)</pre>
*Il suffit alors de recopier la valeur de '''sessid''' dans le script python de ce début de paragraphe et de le tester : il devrait renvoyer 1.

==Modification de l'état d'une clé==
''Applicable uniquement dans le cas où le logiciel OpenFlyers gère les clés.''
*Le logiciel de contrôle de l'armoire à clé doit envoyer un ordre '''notify([1,0,1,1,1,1,0,0], "passphrase")''' avec comme paramètre un tableau chronologique des clés ayant pour valeur leur état (1 = interrupteur de présence de clé fermé = clé absente de l'armoire, 0 = interrupteur de présence de clé ouvert = clé présente dans l'armoire)

===Exemple de script en Python pour la commande notify===
Nécessite les librairies Twisted et pyOpenSSL

<python># load library
from twisted.web.xmlrpc import Proxy
from twisted.internet import reactor, ssl
import random

def printValue(value):
print repr(value)
reactor.stop()

def printError(error):
print 'error', error
reactor.stop()

# URL of the XML-RPC server
proxy = Proxy('https://yourURL.xx/actionOnDemand.php')

# init passphrase
passphrase = 'SDjklsdiuQSIPO23879ZERK2098ZL2908DFZLK'

# init array to send
status = []
state = random.randint(0,1)
# Alternate 0 and 1 for test
for i in range(0,10):
status.append(state)
state = 0 if state == 1 else 1
#print status

# send to the XML-RPC server
proxy.callRemote('notify', status, passphrase).addCallbacks(printValue, printError)
reactor.run()</python>

Ces scripts nécessitent les librairies Twisted et pyOpenSSL.

Ils recevront (et afficheront) comme réponse 0 du fait que le numéro de session transmis n'est pas correct (et laissé à une chaine vide).

==Fermeture automatique d'un vol==

Le logiciel de contrôle de l'armoire à clé doit envoyer un ordre '''closeFlight("passphrase", "id de ressource")''' avec comme paramètre un passphrase et l'id qui va entraîner la fermeture du vol effectué sur cette ressource si un vol avait été ouvert et que la "Fermeture automatique des
vols au retour de la clé" soit activée. La commande retournera comme réponse une structure JSON pour déterminer si la fermeture du vol s'est bien réalisée ou non et qu'il n'y a pas eu d'erreur.

Réponse quand la vérification du passphrase est incorrecte, ce qui a entraîné la non-fermeture du vol :
<javascript>{[
ack : 0
]}</javascript>

Réponse quand la vérification du passphrase est correcte et que la demande de fermeture du vol s'est bien réalisée :
<javascript>{[
ack : 1
]}</javascript>

Réponse quand la vérification du passphrase est correcte et que la demande de fermeture du vol ne s'est pas bien réalisée suite à une erreur :
<javascript>{[
ack : 1,
error : 'Message d\'erreur ...'
]}</javascript>

===Script d'exemple pour closeFlight===
<python># load library
from twisted.web.xmlrpc import Proxy
from twisted.internet import reactor, ssl
import random

def printValue(value):
print repr(value)
reactor.stop()

def printError(error):
print 'error', error
reactor.stop()

# URL of the XML-RPC server
proxy = Proxy('https://yourURL.xx/actionOnDemand.php')

# Id of resource which needs a flight closing
resource_id = 1

# init passphrase
passphrase = 'SDjklsdiuQSIPO23879ZERK2098ZL2908DFZLK'

# send to the XML-RPC server
proxy.callRemote('closeFlight', resource_id, passphrase).addCallbacks(printValue, printError)
reactor.run()</python>

==Exemple de script en Python de logiciel de contrôle d'une armoire==
<python>#!/usr/bin/python
import xmlrpclib, time, dummy_proto, hashlib
from twisted.internet import reactor, task, threads, ssl
from twisted.application import internet, service
from twisted.internet.protocol import Protocol, ClientCreator, ReconnectingClientFactory
from twisted.web import resource, server

# Port from which the OF client contact OpenKeys service
SERVICE_PORT=4080
# IP address of the OpenKeys service
SERVICE_HOST="192.168.0.200"

# IP address of the key cabinet
KEYS_ADDR='192.168.0.201'
# Port from which OpenKeys service contacts the key cabinet
KEYS_PORT=6002
#Time to release the key
KEY_RELEASE_DURATION=15

# sha224 passwords
PASSWORDS=('847bed9bc354e7e47bc5350a3b3aaf6124f5748224a3c7ad79586c3c')

# init passphrase
passphrase = 'SDjklsdiuQSIPO23879ZERK2098ZL2908DFZLK'

OF_XMLRPC_URL="https://openflyers.com/structure/actionOnDemand.php"

DEBUG=False

class dummyProtocol(Protocol):
def __init__(self, rpc_server):
self.rpc_server=rpc_server
self.lc = None

def connectionMade(self):
if not self.lc:
# update status every 10 minutes
self.lc = task.LoopingCall(self.updateStatus)
self.lc.start(600)

def dataReceived(self, data):
msg=dummy_proto.dummy_message.newFromData(data)
if DEBUG: msg.display()
try:
if type(msg)==dummyproto.dummy_ONOFF_Control_Response:
response = self.rpc_server.notify(msg.getKeysStatus(),passphrase)
except Exception, err:
if DEBUG: print "error: ", err
pass # ignore

def updateStatus(self):
msg = dummy_proto.dummy_State_Request()
self.transport.write(msg.build_message())

def send(self, dummy_data):
self.transport.write(dummy_data.build_message())

class dummyClientFactory(ReconnectingClientFactory):
def __init__(self, rpc_server):
self.rpc_server = rpc_server

def buildProtocol(self, addr):
self.resetDelay()
self.protocol = dummyProtocol(self.rpc_server)
return self.protocol

def clientConnectionLost(self, connector, reason):
ReconnectingClientFactory.clientConnectionLost(self, connector, reason)
connector.connect()

def clientConnectionFailed(self, connector, reason):
if DEBUG: print 'Connection failed. Reason:', reason
ReconnectingClientFactory.clientConnectionFailed(self, connector, reason)

# blocking method ! must be run in a new thread
def release_key(self, key_num, timeOur):
m = dummy_proto.dummy_ONOFF_Control()
m.setON(key_num)
self.protocol.send(m)
time.sleep(timeOut)
m.setOFF(key_num)
self.protocol.send(m)
return key_num

class WebResource(resource.Resource):
def __init__(self, rpc_server, dummy_client_factory):
self.rpc_server = rpc_server
self.dummy_client_factory = dummy_client_factory
resource.Resource.__init__(self)
self.keys_webcontrol_state = [0,0,0,0,0,0,0,0,0,0]

def getChild(self, name, request):
return self

def render(self, request):
reponse = 0 # NOK par defaut
key_num = 0
try:
sessid = request.args.get('sessid', [""])[0]
password = request.args.get('password', [""])[0]
key_num = int(request.args.get('key', ["0"])[0])
response = 0
if password:
if hashlib.sha224(password).hexdigest() in PASSWORDS:
timeOut = KEY_RELEASE_DURATION
response_XMLRPC = 1
else:
timeOut = int(request.args.get('timeout', ["0"])[0])
response = self.rpc_server.checkCommand(sessid, key_num)
except Exception, err:
if DEBUG: print "error: ", err
return "NOK:bad request"

if response == 1:
# Don't try to release a key that is being released
if self.keys_webcontrol_state[key_num-1]: return "OK:already released"
self.keys_webcontrol_state[key_num-1] = 1
d = threads.deferToThread(self.dummy_client_factory.release_key, key_num, timeOut)
d.addCallback(self.unset_webcontrol_state)
return "OK:releasing key..."
else:
return "NOK:permission refused"

def unset_webcontrol_state(self, key_num):
self.keys_webcontrol_state[key_num-1] = 0

class OpenKeysService(service.Service):
def __init__(self):
rpc_server=xmlrpclib.Server(OF_XMLRPC_URL);
self.dummy_client_factory = dummyClientFactory(rpc_server)
self.web_resource = WebResource(rpc_server, self.dummy_client_factory)

def getdummyClientFactory(self):
return self.dummy_client_factory

def getWebResource(self):
return self.web_resource

application = service.Application('openkeys')
f = OpenKeysService()
serviceCollection = service.IServiceCollection(application)
internet.TCPClient(KEYS_ADDR, KEYS_PORT, f.getdummyClientFactory()
).setServiceParent(serviceCollection)
internet.TCPServer(SERVICE_PORT, server.Site(f.getWebResource())
).setServiceParent(serviceCollection)</python>

==Maquette de script actionOnDemand.php côté serveur recevant les appels du logiciel de contrôle de l'armoire==
Ce script nécessite la bibliothèque PEAR [http://pear.php.net/package/XML_RPC2 XML_RPC2].

Pour les tests, il suffit de modifier la valeur de la variable $weDontWant.

<php><?php
include 'XML/RPC2/Server.php';

class OpenKeysGateway {
/**
* Update the status of the keys
*
* @param array $status Status of keys
* @return integer 1 if ok, 0 else
*/
public static function notify($status) {
$logmsg = "";
foreach ($status as $key_num_from_zero => $key_pres) {
if (!is_numeric($key_pres) || intval($key_pres)!=$key_pres || $key_pres < 0 || $key_pres > 1) continue;
if (!is_numeric($key_num_from_zero) || intval($key_num_from_zero)!=$key_num_from_zero
|| $key_num_from_zero < 0 || $key_num_from_zero > 9) continue;
$logmsg .= "".($key_num_from_zero+1).":".$key_pres.",";
}
file_put_contents('test.txt', "key notify :".$logmsg, FILE_APPEND );
return 1;
}

/**
* Check if user is able to release the key 'key_num'
*
* @param string $sessid PHPSESSID of a connected user
* @param integer $key_num number of the key to release
* @return integer 0:NOK, 1:OK
*/
public static function checkCommand($sessid, $key_num) {
/* sanitize input */
if (!is_numeric($key_num) || intval($key_num)!=$key_num || $key_num < 1 || $key_num > 10) {
return 0;
}

$weDontWant = 1;

if ($weDontWant) {
file_put_contents('test.txt', "$key_num has no associated airborne aircraft", FILE_APPEND );
return 0;
}
else {
file_put_contents('test.txt', "granted key: ".$key_num.":permission granted", FILE_APPEND );
return 1;
}
}
}

$options = array(
'autoDocument' => true,
);

// dirty hack to get things work !
$GLOBALS['HTTP_RAW_POST_DATA'] = file_get_contents('php://input');

$server = XML_RPC2_Server::create('OpenKeysGateway', $options);
$server->handleCall();

?></php>

Contrôle d'identification par OpenFlyers pour un logiciel tiers

2016-12-02T14:50:09Z

Bbarbe :

=Présentation=
Cette page explique comment vérifier qu'un couple identifiant/mot de passe envoyé, par vos propres scripts, est conforme à la base de données d'OpenFlyers.

=Comment ça marche=
Si votre plateforme OpenFlyers se situe sur le lien http://openflyers.com/nom-plateforme/, envoyez simplement une requête POST sur le lien http://openflyers.com/nom-plateforme/checkIdent.php avec comme paramètres les variables '''login''' et '''rawPassword'''.

'''Attention:''' Les versions 2 d'OpenFlyers ou plus nécessitent un mot de passe chiffré en MD5 (cf. la ligne $postData commentée ci-dessous, dans le script PHP).

==Valeurs de retour possibles==
Le script retourne un chiffre parmi les suivant :
*0: OK
*1: OK mais plusieurs profils disponibles. OpenFlyers sélectionne automatiquement le meilleur profil.
*2: Expiré mais autorisé
*3: Expiré mais autorisé, avec un profil expiré
*4: Abonnement expiré, refusé
*5: Mauvais identifiants, refusé
*6: IP ou identifiants bloqués, refusé
*7: Aucun identifiant donné, ils sont demandés

Nous vous recommandons de considérer un code de retour entre 0 et 2 comme bon et mauvais entre 3 et 7.

'''Attention:''' Vous devez filtrer les identifiants de connexion libres (sans droits) puisque pour OpenFlyers, ils correspondent à des accès autorisés !!!

=JavaScript=
Si vous utilisez votre propre formulaire d'authentification, utilisez la fonction javascript submit_pwd() située dans \javascript\submitPwd.js .

=Exemple de code PHP=
Voici un exemple de code PHP permettant d'envoyer une requête POST :
<php>function httpPostRequest($host, $path, $postData) {
$result= "";

$request = "POST $path HTTP/1.1\n".
"Host: $host\n".
(isset($referer) ? "Referer: $referer\n" : "").
"Content-type: Application/x-www-form-urlencoded\n".
"Content-length: ".strlen($postData)."\n".
"Connection: close\n\n".
$postData."\n";

// Some debug informations:
// print("<pre>Request:\n".htmlentities($request)."</pre>");

if ($fp = fsockopen($host, 80, $errno, $errstr, 3))
// for PHP release < 5.3.0, use the following syntax:
// if ($fp = fsockopen($host, 80, &$errno, &$errstr, 3))
{
if (fputs($fp, $request))
{
while(! feof($fp))
{
$result.= fgets($fp, 128);
}
fclose($fp);
// print($result);
return $result;
}
}
}

//$postData='login=jbond&rawPassword='.md5('007'); // for OpenFlyers release 2 or higher
$postData='login=jbond&rawPassword=007';
$rawContent = httpPostRequest('openflyers.com','http://openflyers.com/plateform-name/checkIdent.php',$postData); [^]

list($header, $content) = explode("\r\n\r\n", $rawContent, 2);
list($byteQty, $realContent, $dummy) = explode("\r\n", $content, 3);

// the answer is in $realContent</php>

=Plugin d'authentification Joomla=
Si vous avez un site Joomla et que vous désirer de permettre aux utilisateurs OpenFlyers de se connecter à votre espace restreint Joomla, vous devriez ajouter ce plugin de manière à avoir une unique base de données de comptes utilisateurs : celle d'OpenFlyers.

Vous n'avez pas besoin de mettre à jour votre base de données Joomla, ce plugin interroge directement OpenFlyers grâce au script PHP CheckIdent.php.

*[[Media:Joomla_authentication_plugin.zip|Joomla plugin for OpenFlyers]]