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

Trucs et astuces

2015-05-30T08:29:33Z

Joel : /* Sous Linux */

__TOC__
=Présentation=
L'objet de cette page est de présenter des trucs et astuces généraux et indépendants de l'utilisation d'OpenFlyers.

=Administration réseau=
==Trouver l'adresse IP du routeur==
Pour connaître l'adresse IP d'une passerelle (box ou routeur).
===Trouver l'adresse IP du routeur freebox à distance===
*Aller sur le site de [http://www.free.fr free].
*Cliquer sur '''Mon compte'''
*Saisir l'identifiant et le mot de passe du compte pour lequel on souhaite connaitre l'adresse IP
*Aller sur '''Ma Freebox > Afficher mon adresse IP'''
*L'adresse IP est indiquée dans le champ '''Votre adresse IP :'''
Cette adresse IP dite "fixe" est présente avec le message '''Ceci est votre adresse IP, pour les abonnés dégroupés ainsi que les abonnés IPADSL ayant demandé une IP Fixe'''

===Trouver l'adresse IP du routeur sous Windows===
*[[#Ouvrir_une_console_sous_Windows|Ouvrir une console]]
*Taper ''ipconfig /all'' pour afficher la structure de la connexion au réseau.
*L'adresse du routeur est indiquée à la ligne '''passerelle par défaut''' de la '''carte Ethernet''' du PC pour une connexion par câble RJ45 ou sous la '''carte WLAN''' pour une connexion sans fil (par exemple wifi).

===Trouver l'adresse IP du routeur par l'interface graphique de Windows 7===
*Cliquer sur le bouton '''Démarrer'''
*cliquer sur '''Panneau de configuration'''
*Cliquer sur '''Réseau et Internet'''
*Cliquer sur '''Centre de réseau et partage'''
*Cliquer sur '''Afficher l'intégralité du réseau''' dan
*Survoler l’icône Passerelle : l'adresse IP du matériel apparait dans le popup

[[Fichier:Reseau_W7.jpg]]

===Sous Linux===
*Ouvrir une console
*Taper « netstat -r -n »
*L'adresse IP est dans la colonne Passerelle (Gateway en Anglais)

[[Fichier:Reseau_Linux.jpg]]

==Monitoring d'une freebox==
*http://mafreebox.freebox.fr/pub/fbx_info.txt

=Connexion à un routeur=
==Connexion à distance à une livebox==
Prérequis :
*la livebox doit avoir été configurée pour permettre une contrôle à distance
*Il faut connaitre l'adresse IP externe de la livebox, soit parce qu'elle est fixe, soit parce qu'un service Dynamic DNS a été mis en place

*Dans un navigateur saisir l'URL pour accéder à la livebox. Cette URL doit être écrite avec "https://" suivie de l'adresse IP externe de la livebox suivie de ":10000" qui correspond au port par défaut proposée par la livebox lors de la mise en place d'une connexion à distance. Cela donne une URL sous la forme : https://X.X.X.X:10000
*Dans le champ '''identifiant''', saisir l'identifiant créé pour la connexion à distance
*Dans le champ '''mot de passe''', saisir le mot de passe créé pour la connexion à distance
*Cliquer sur le bouton '''s'identifier'''

=Editer un fichier texte=
Nous recommandons l'utilisation de l'outil [[Wikipedia-en:Notepad%2B%2B|Notepad++]] pour visualiser ou modifier un fichier texte depuis un ordinateur sous système d'exploitation Windows.

=Effectuer une copie d'écran=
Nous recommandons l'utilisation de l'outil [[Wikipedia-en:Greenshot|Greenshot]] pour effectuer une copie d'écran depuis un ordinateur sous système d'exploitation Windows.

Une fois le logiciel installé et lancé, il suffit d'appuyer sur la touche "Imp. écr" du clavier pour lancer la copie d'écran. Greenshot vous permettra alors de sélectionner la zone à copier puis vous proposera de sauvegarder le fichier.

Lorsque la copie d'écran doit être envoyée par e-mail ou ajouter dans un rapport de bug, il est indispensable de la communiquer sous son format d'origine c'est à dire au format png ou jpg. Surtout, ne mettez pas vos copies d'écran dans un document texte : cela rend son exploitation difficile.

=LibreOffice=
Les procédures suivantes sont normalement identiques sous OpenOffice et existent également sous Word ou Excel mais avec des commandes différentes.

==Afficher uniquement un certain type de lignes==
Cas pratique : lors de l'import des à nouveaux, lorsqu'il existe plusieurs types de comptes par utilisateur, il peut être intéressant de n'afficher que les lignes d'un seul type de compte à la fois

Dans LibreOffice, une fois que le document à traiter est ouvert :
*"Données > Filtre > AutoFiltre"
Cela fait apparaitre à droite de chaque cellule de la première colonne une flèche
*Cliquer sur la flèche correspondante à la cellule dont on souhaite restreindre les types de données visibles (exemple : cellule "account_type_name" pour ne faire apparaitre qu'un seul type de compte)
*Sélectionner/désélectionner les types de données à faire apparaitre/disparaitre

==Changer le format d'affichage des dates dans une colonne==
*Positionner le pointeur de la souris sur la lettre de la colonne concernée
*Effectuer un clic droit pour faire apparaitre le menu contextuel
*Sélectionner '''Formater les cellules...''' pour faire apparaitre une boite de dialogue intitulée '''Formatage des cellules'''
*Laisser sélectionné le premier onglet '''Nombres'''
*Dans le champ '''Catégorie''', sélectionner "Date"
*Dans le champ '''Format''', sélectionner le format souhaité si existant (penser à utiliser l'ascenseur du champ pour faire défiler l'intégralité des formats proposés)
*Si le format souhaité est inexistant, dans le champ '''Description de format''', renseigner le format souhaité
Pour construire le format souhaité, il suffit en général de s'inspirer des formats existants. Exemple de format pour les dates tel que demandé pour l'import des utilisateurs dans OpenFlyers : "YYYY-MM-DD"
*Cliquer sur le bouton '''OK'''

==Exporter au format csv pour OpenFlyers==
Dans OpenFlyers, l'encodage de caractère par défaut utilisé est l'UTF-8 et la séparation entre les champs est le point-virgule. Voici comment effectuer un export de fichier .csv respectant ces éléments :
*Sélectionner '''Fichier > Enregistrer sous...'''
*Choisir le répertoire et le nom de fichier
*Dans le champ '''Type''' sélectionner '''Texte CSV (.csv) (*.csv)'''
*Cocher '''Éditer les paramètres du filtre'''
*Cliquer sur le bouton '''Enregistrer'''
Dans la fenêtre '''Export de fichiers texte''' :
*Dans le champ '''Jeu de caractères''' taper la lettre "U" puis sélectionner '''Unicode (UTF-8)'''
*Appuyer sur la touche TAB pour éditer le champ suivant, cela permet non seulement de mettre le focus dans le champ mais également de sélectionner tout le contenu de la cellule
*Dans le champ '''Séparateur de champ''', taper ";"
*Appuyer sur la touche TAB
*Taper sur la touche "Supprimer" du clavier de sorte à vider le contenu du champ '''Séparateur de texte'''
*Cliquer sur le bouton '''OK'''

=Modifier le comportement la souris=
Voici les procédures pour modifier le comportement de la souris, et notamment le "clic molette" dont nous recommandons l'usage dans la [[UserDoc3#Clic_droit_et_clic_molette|version 3]] d'OpenFlyers :
*Sur Windows : http://windows.microsoft.com/fr-fr/windows/change-mouse-settings#1TC=windows-7
*Sur Mac OS : http://support.apple.com/fr-fr/HT2490

=Navigateurs=
==Imprimer avec un navigateur==
===Imprimer avec Chrome===
*Cliquer sur le bouton en haut à droite de la barre de navigation symbolisant un menu (trois traits horizontaux)
*'''Imprimer...'''

===Imprimer avec Firefox===
*'''Fichier > Imprimer...'''
Alternative si le menu n'est pas disponible :
*Cliquer sur le bouton en haut à droite de la barre de navigation symbolisant un menu (trois traits horizontaux)
*Cliquer sur le bouton symbolisant une imprimante

==Supprimer une saisie automatique==
Si le navigateur est paramétré pour enregistrer les champs dans un formulaire, il peut être nécessaire de pouvoir supprimer une entrée. C'est par exemple le cas lorsque l'on saisit par erreur son mot de passe dans le champ identifiant et qu'il se retrouve ainsi mémoriser en clair.

Dans le cas d'un ordinateur en accès public, il est déconseillé de paramétrer les navigateurs pour permettre cet enregistrement automatique.

Pour supprimer cette entrée il faut :
*Saisir le début du texte jusqu'à ce que l'entrée à supprimer apparait dans la liste des propositions en auto-complétion.
*Positionner le curseur de la souris sur l'entrée à supprimer.
*Appuyer sur la touche ''Suppr'' du clavier.

=Ouvrir une console sous Windows=
==Ouvrir une console sous Windows 7==
*Cliquer sur le bouton '''Démarrer'''
*Dans le champs '''Rechercher''' taper ''cmd'' puis sélectionner le fichier '''cmd.exe'''.
*Taper sur la touche "Entrer" pour ouvrir la console DOS.

==Ouvrir une console sous Windows 8==
*Aller avec le pointeur de la souris dans le coin inférieur gauche de l'écran
*Le petit rectangle '''Accueil''' doit s'afficher : cliquer sur le bouton droit de la souris
*Un menu contextuel doit s'afficher : cliquer sur l'item '''Exécuter'''
*Une fenêtre '''Exécuter''' doit s'ouvrir. Taper ''cmd'' dans le champ '''Ouvrir''' et valider avec la touche "Entrer" pour ouvrir la console DOS.

KeyPanel installation1

2014-02-20T23:46:44Z

Joel : /* Enregistrer la position souhaitée des clés */

=Présentation=
L'objet de cette page est de décrire la procédure d'installation d'une [[Access-Control#Armoires_.C3.A0_cl.C3.A9s_Deister_commerciali.C3.A9es_par_OpenFlyers|armoire à clés Deister vendue par OpenFlyers]] et équipée du mini-serveur OpenFlyers.

=Préparation du réseau avant réception de l'armoire=
''La procédure décrite dans ce paragraphe peut être effectuée avant la réception de l'armoire. A défaut, de préparation anticipée, elle doit être effectuée '''avant''' tout branchement de l'armoire à clés sauf dans le cas d'une Livebox d'orange où il est nécessaire d'effectuer d'abord le branchement du matériel pour pouvoir ensuite effectuer la configuration du routeur. Dans ce cas, il faut d'abord suivre la procédure [[#Connexions_de_l.27armoire|connexion de l'armoire et ensuite revenir sur ce paragraphe]]''

L'utilisation de l'armoire à clés Deister, nécessite 2 connexions RJ45 au réseau local via un routeur, en général une "box" :
*une pour le mini-serveur OpenFlyers
*une pour l'armoire à clés.

Le réseau doit être configuré en DHCP ce qui signifie que toute connexion au réseau est automatiquement reconnue et qu'une adresse IP est automatiquement affectée à cette connexion. Par défaut, les "box" des fournisseurs d'accès sont configurées selon ce mode là, c'est à dire en DHCP.

Cependant pour que le mini-serveur OpenFlyers et l'armoire à clé puissent communiquer entre-eux et avec le logiciel OpenFlyers, les adresses IP attribuées par le routeur doivent être figées. Pour forcer le routeur à attribuer toujours la même adresse IP à un équipement il faut le configurer en créant l'association d'une [[Wikipedia-fr:Adresse_IP|adresse IP]] à l'[[Wikipedia-fr:Adresse_MAC|adresse MAC]] du matériel.

Les adresses IP et MAC à configurer vous sont communiquées dans un e-mail qu'OpenFlyers envoie après la commande de l'armoire à clés et qui sont également indiquées le bordereau de livraison.

Ce paramétrage se fait soit directement dans l'interface de gestion du routeur ou par l'intermédiaire de l'interface de gestion de la "box" de votre fournisseur d'accès et dépend du matériel que vous disposez.
==Configuration du routeur==
Le routeur d'un fournisseur d'accès internet correspond à la "box".

===Configuration d'une Livebox Orange===
Pour se connecter à l'interface d'une Livebox Orange, il faut :
*[[Tips-and-tricks#Trouver_l.27adresse_IP_du_routeur|Trouver l'adresse IP du routeur]].
*Taper cette adresse dans la barre d'adresse du navigateur.
*Saisir le couple identifiant mot de passe du routeur. C'est par défaut (admin, admin). ''Il est recommandé de modifier ce mot passe.''
Ensuite, la procédure dépend du [http://assistance.orange.fr/livebox-tous-les-modeles-524.php modèle de Livebox]. Nous mettons ci-dessous les procédures en fonction des demandes et des difficultés rencontrées par les administrateurs.

''Attention, pour configurer correctement le routeur, il faut mettre les couples (adresses IP, adresses MAC) au niveau de la configuration des adresses IP statiques et non pas au niveau du filtrage du réseau Wifi (WAN).''

====Livebox 2 de Sagem====
La procédure ci-dessous permet d'associer les couples (adresse IP, adresse MAC) uniquement lorsque l'armoire à clé est connectée.
* '''Configuration'''
* Menu de gauche '''Réseaux & Services > Équipements > Visualiser'''
* Deux nouvelles icônes doivent apparaitre
* Cliquer dessus chaque icône, vérifier à quel matériel l'adresse MAC correspond (inscrit sur le bordereau de livraison de l'armoire à clés) et renommer chaque icône en "Armoire à clés" et "Daemon RPi" pour une identification plus aisée.
Attention : orange rajoute ses propres noms qui ne simplifient pas la reconnaissance du matériel.
*Retourner dans l'onglet '''Configuration'''
*Menu de gauche '''Réseaux & Services > Livebox > Paramètres avancés'''
*Onglet '''DHCP'''
*Section '''Adresse IP statique'''
*Cliquer sur '''Ajouter'''
[[Fichier:LiveBox.JPG]]
*Sélectionner dans le menu déroulant '''Armoire à clés'''
*Saisir l'adresse "192.168.1.201"
*Cliquer sur '''Ajouter'''
*Sélectionner dans le menu déroulant '''Daemon RPi'''
*Saisir l'adresse "192.168.1.200"
*Cliquer sur le bouton '''Sauver'''
*Réinitialiser la Livebox
Il faut maintenant vérifier la bonne attribution des couples (adresse IP, adresse MAC) :
*[[Tips-and-tricks#Ouvrir_une_console_sous_Windows|Ouvrir une console]]
*Taper :
<bash>ping 192.168.1.200</bash>
Le résultat doit être sous la forme suivante :
<bash>ping 192.168.1.200 (192.168.1.200) 56(84) bytes of data.
64 bytes from 192.168.1.5: icmp_req=1 ttl=64 time=0.241 ms
64 bytes from 192.168.1.5: icmp_req=2 ttl=64 time=0.143 ms
64 bytes from 192.168.1.5: icmp_req=3 ttl=64 time=0.144 ms
64 bytes from 192.168.1.5: icmp_req=4 ttl=64 time=0.145 ms</bash>
*Taper :
<bash>ping 192.168.1.201</bash>
Le résultat doit être sous la forme suivante :
<bash>ping 192.168.1.201 (192.168.1.201) 56(84) bytes of data.
64 bytes from 192.168.1.5: icmp_req=1 ttl=64 time=0.241 ms
64 bytes from 192.168.1.5: icmp_req=2 ttl=64 time=0.143 ms
64 bytes from 192.168.1.5: icmp_req=3 ttl=64 time=0.144 ms
64 bytes from 192.168.1.5: icmp_req=4 ttl=64 time=0.145 ms</bash>
Si la réponse est "Unreachable" ou "Impossible de joindre l'hôte de destination" :
<bash>ping 192.168.1.201
ping 192.168.1.201 (192.168.1.201) 56(84) bytes of data.
From 192.168.1.5 icmp_seq=1 Destination Host Unreachable</bash>
<bash>Envoi d'une requête 'Ping' 192.168.1.201 avec 32 octets de données :
Réponse de 192.168.1.201 : Impossible de joindre l'hôte de destination.</bash>
alors les adresses ne sont pas correctement affectées ou un câble est défectueux.

===Configuration d'une freebox Free===
*Aller sur [https://subscribe.free.fr/login/ l'espace client]
*Saisir l'identifiant et le mot de passe
*Aller '''Ma Freebox > Configurer mon routeur Freebox'''
*Dans '''Configuration > Configuration du routeur''', vérifier que l''''Adresse IP Freebox''' est 192.168.0.254
*Cliquer sur '''Redirections / Baux DHCP''' pour faire dérouler le contenu
*Dans le paragraphe '''Redirections de ports''', à côté de l’icône symbolisant un "plus" :
**Dans le champ de la colonne '''PORT EXTERNE''' saisir ''8000''
**Dans les champs de la colonne '''IP DE DESTINATION''' saisir ''192.168.0.200''
**Dans le champ de la colonne '''PORT INTERNE''' saisir ''8000''
**Cliquer sur l'icône symbolisant un "plus" de sorte à ce que la ligne vienne s'ajouter en-dessous
*Répéter cette opération de sorte à obtenir le tableau suivant :

[[Fichier:Keypanel2012-redirection-de-ports-freebox.png|center]]

*Dans le paragraphe '''Baux DHCP permanents''', saisir sur la ligne avec l'icône symbolisant un "plus" les couples (adresse IP, adresse MAC) communiqués dans le bordereau de livraison de sorte à obtenir le tableau suivant :

[[Fichier:Keypanel2012-Baux-DHCP-permanents-freebox.png|center]]

*En bas du formulaire, cliquer sur le bouton '''Sauvegarder les paramètres'''
*Débrancher 5 secondes la freebox puis la rebrancher.
*Une fois l'armoire à clés livrée, passer à l'étape de [[KeyPanel_installation1#Connexion_de_l.27armoire|connexion de l'armoire]].

===Box SFR===
Il faut au préalable connecter l'armoire afin que la Box SFR lui affecte par défaut une adresse IP.
*Connecter vous sur votre Box SFR en tapant son IP et mettre l'identifiant et mot de passe

''A renseigner''

===BBox ===
Il faut au préalable connecter l'armoire afin que la BBox lui affecte par défaut une adresse IP.
*Connecter vous sur votre BBox en tapant son IP et mettre l'identifiant et mot de passe

''A renseigner''

=Connexion de l'armoire=
Prendre la clé dans la pochette rouge fixée sur l'armoire et ouvrir la porte de service située à l'arrière de l'armoire en insérant la clé dans la serrure présente en partie inférieure de l'un des 2 côtés de l'armoire.
Les câbles suivants doivent être passés avant la fixation définitive au mur :
*Câble d'alimentation 220v
*Câble Ethernet entre le routeur et l'armoire
*Câble Ethernet entre le routeur et le mini-serveur OpenFlyers
Fixer l'armoire au mur par 4 chevilles et vis en ayant au préalable retiré l’adhésif de maintien de l’interrupteur qui sert à détecter une tentative de vandalisme
*Identifier le mini-serveur OpenFlyers situé juste à côté de la trappe permettant de faire passer les câbles :
[[Fichier:Connexion rj45 OF.jpg]]
*Vérifier que la carte SD est correctement enfichée dans le logement du mini-serveur OpenFlyers.
*Brancher un câble Ethernet sur le mini-serveur OpenFlyers
*Identifier la prise RJ45 de l'armoire et y brancher un câble Ethernet :
[[Fichier:Connexion rj45masterplane.jpg]]
*Brancher le câble d'alimentation 220V en y joignant le câble de l'armoire correspondant à la "terre" (câble jaune et vert) :
[[Fichier:Alim.JPG]]
*Refermer la porte de service
*Brancher la prise d'alimentation sur le secteur
A l'initialisation de l'armoire le voyant jaune de la face avant clignote puis passe au jaune fixe

=Configuration OpenFlyers=

==Navigateur==
'''Attention''' : le navigateur Internet Explorer ne permet pas la communication avec l'armoire. Ce navigateur ne possède pas les fonctions avancées du standard W3C que nous utilisons pour sécuriser les accès.

Firefox ou Chrome sont des navigateurs qui fonctionnent pour déclencher la libération des clés.

Le ou les PC de la structure doivent être paramétrés pour que ce soient un de ces navigateurs qui soit en service.

Les navigateurs récents implémentent désormais des règles de filtrage pour bloquer le contenu non sécurisé provenant d'une page HTTP chargé depuis une page HTTPS. C'est le cas avec le serveur OF ou l'URL est en HTTPS et celles de l'armoire en HTTP. Il faut donc configurer les navigateurs pour ne pas réagir à ce mixte d'adresse URL

===Firefox===
Dans la barre d'adresse, taper about:config
*Valider le message d'avertissement comme quoi vous devez faire Attention
*Rechercher le paramètre security.mixed_content
*Double cliquer sur le paramètre security.mixed_content.block_active_content pour qu'il passe à '''false'''.
*La ligne s'affiche en gras

===Chrome===
*Clique droit sur l’icône de Chrome
*Cliquer sur Propriétés
*Ajouter dans le champs Cible à la fin --allow-running-insecure-content
*Le champs cible resemblera donc à <BASH>"C:\Program Files (x86)\Google\Chrome\Application\chrome.exe" --allow-running-insecure-content</BASH>

==Paramétrage OpenFlyers==

*Aller dans '''Admin > Configuration > Paramétrage'''
*Dans la section '''Gestion des vols''' et cliquer sur l'option '''Activé(e)''' de la rubrique '''Gestion armoire à clés'''.
[[Fichier:Config OF0.JPG|center]]
*Cliquer sur le bouton '''Valider'''
*De nouveaux champs sont alors visibles :
[[Fichier:Config OF1.jpg|center]]
*Cliquer sur '''Activé(e)''' dans la rubrique '''Gestion des clés'''
*Choisissez la durée de '''temporisation''' pour prendre la clé, elle dépend de la distance entre votre PC et l'armoire. 10 à 20 secondes sont des valeurs usuelles
*Dans la rubrique '''Logiciel de contrôle de l'armoire à clés''' choisissez '''PyOpenKey2'''
*Dans la rubrique '''IP du PC contenant le logiciel de contrôle''' indiquer l'adresse IP du mini-serveur OpenFlyers '''192.168.0.200''' ou '''192.168.1.200'''
*Dans la rubrique '''Port du PC contenant le logiciel de contrôle''' indiquer le port '''4080''' (ou autre si spécifié sur le bordereau de livraison)
*Cliquer sur le bouton '''Valider'''
*Deux nouveaux champs sont alors visibles :
[[Fichier:Keypanel-2012-OpenFlyers-config-additionnals-fields.png|center]]
*Dans la rubrique '''Fermeture automatique des vols au retour de la clé''' cocher '''Désactivé(e)'''
*Dans la rubrique '''Phrase mot de passe''', saisissez la même phrase que celle indiquée sur le bordereau de livraison
*Cliquer sur le bouton '''Valider'''
*Aller dans '''Admin > Utilisateurs > Profils''' et vérifier que le profil sous lequel vous êtes connecté possède le droit '''Gestion des clés''' dans l'onglet '''Généralité admin'''

=Première connexion=
Brancher l'alimentation de l'armoire à clés
*Le voyant vert de l'armoire doit s'allumer après quelques minutes
*Le voyant orange reste allumé durant la phase de connexion au serveur OpenFlyers et la vérification de la concordande de la position des clés dans l'armoire
*A la fin de l'initialisation, si toutes les clés sont bien positionnées, le voyant orange s’éteint

Si le voyant orange ne s'éteint pas, vérifier si le problème ne vient pas de la position d'une ou plusieurs clés. En effet, le paramétrage des clés dans OpenFlyers permet de choisir la position que doit avoir chaque clé. Lorsqu'une clé est mal positionnée dans l'armoire elle est entourée d'un cercle rouge et elle est déverrouillée :

[[Fichier:Clé rouge.JPG|center]]

De plus, la porte de l'armoire est également déverrouillée. Dans ce cas, il faut effectuer la procédure suivante :
*Ouvrir la porte
*Enlever toutes les clés qui sont détectées comme mal positionnées
*Effectuer une réinitialisation de l'armoire en débranchant l'alimentation puis en la reconnectant après 5 secondes
Si à la fin de cette nouvelle réinitialisation, il y a d'autres clés qui sont détectées comme mal positionnées, il faut répéter cette opération d'enlèvement/réinitialisation jusqu'à ce qu'il n'y ait ne plus de clé détectée comme mal positionnée. Au pire, toutes les clés seront enlevées de l'armoire.

Une fois qu'il n'y a plus de clé détectée comme mal positionnée, on doit se retrouver avec une ou plusieurs clés hors de l'armoire : ces clés seront remises à leur emplacement ultérieurement dans la procédure [[#Enregistrer_la_position_souhait.C3.A9e_des_cl.C3.A9s|d'enregistrement de la position souhaitée des clés]] après avoir effectué la procédure [[#Appariement_des_cl.C3.A9s_aux_ressources|d’appariement des clés aux ressources]].

=Appariement des clés aux ressources=
*Pour attribuer les clés aux ressources dans OpenFlyers il faut aller dans la page '''Admin > Ressources > Ressources > Actives'''
*Sélectionner un numéro de clé pour chaque ressource.
[[Fichier:Page Ressource.jpg|center]]

=Enregistrer la position souhaitée des clés=
*Aller dans '''Admin > Ressources > Ressources > Actives'''
*Cliquer sur l'une des icônes symbolisant une clé dans la colonne '''Armoire à clé > Statut''' afin de pouvoir déverrouiller la porte.
*Mettre toutes les clés au tableau dans l'ordre souhaité y compris les clés qui avaient été retirées lors de la [[#Premi.C3.A8re_connexion|première connexion]]. Il ne faut pas tenir compte des lumières rouges autour des clés.
*Cliquer sur l'icône '''Activer les tags des clés'''
Les identifiants de chaque clé doivent apparaître après rafraîchissement de la page :

[[Fichier:Ressources activees.jpg|center]]

Si ce n'est pas le cas, rafraichir manuellement la page en allant dans '''Admin > Ressources > Ressources > Actives'''.

Débranchez de nouveau l'armoire pour refaire l'initialisation

=Prise de clé à l'ouverture d'un vol=
Pour un contrôle de la prise de clé par un utilisateur il faut que le logiciel soit paramétré avec l'option '''Ouverture et fermeture des vols.''' Aller dans '''Admin > Configuration > Paramètres''' et dans la rubrique '''Gestion des vols''' activer l'option '''Ouverture et fermeture de vol'''

[[Fichier:Gestion des vols.JPG]]

Pour une prise de clé il faut cliquer droit sur une réservation et choisir l'option Saisir un vol
La page de saisie d'un vol s'ouvre avec l'option Départ en vol
Renseigner les champs et cliquer sur Valider
Une page de prise de clé s'ouvrira

[[Fichier:Prise de cle.JPG]]

Cliquer sur le bouton Libérer la clé pour l'aéronef F-XXXX
La porte doit se déverrouiller (voyant orange) et la clé être libérer durant la temporisation prévue (clé entourée d'un halo lumineux rouge)
Refermer la porte sinon un buzzer intermittent retenti

Déconnectez-vous de OpenFlyers pour l'utilisateur suivant

=Retour de vol=

Pour remettre la clé, se connecter sur OpenFlyers
Cliquer sur l'icône Ouvrir la porte en haut à gauche de la page du cahier de réservation

[[Fichier:Ouvrir porte.JPG]]

La porte sera déverrouillé durant la durée de la temporisation
*Remettre la clé à son emplacement
*Si la clé est incorrectement placée, l'armoire déverrouille la clé (halo rouge de la clé reposée) et signale l'emplacement correct en allumant le halo rouge de l'emplacement prévu.
*Sur le planning l'avion en vol est indiquer par une couleur bleu. Survoler ce vol avec la souris
*Un menu apparait avec l'option '''Fermer le vol'''
*Cliquer et enregistré le vol

'''Note:''' Ne pas aller directement sur le menu '''Vols > Saisir un vol''' pour fermer le vol. Dans ce cas il ne pourra être établi de corrélation entre l'affichage du planning et le vol que vous fermez. Le vol restera ouvert (en bleu sur le planning) et l'avion sera bloqué pour repartir en vol. Néanmoins si un pilote faire l'erreur alors il faut, dans le menu surgissant, cliquer sur '''Annuler'''

=Finalisation=
*Ouvrir la porte de service
*Brancher le connecteur de la batterie de sauvegarde (Déconnecté pour le transport)

[[Fichier:Connecteur Batterie.JPG]]
*Refermer la porte de service

L'ouverture de la porte de service enclenche une alarme qui est mise en mémoire dans OpenFlyers. Pour supprimer l'alarme il faut aller sur l'interface [[#Connexion_interface_Web|Web admin]] et cliquer sur '''RESET'''

=Connexion interface Web de secours=
Dans votre navigateur mettre l'URL du mini-serveur OpenFlyers suivi du port 8000.
<bash>192.168.1.200:8000</bash>
Vous arrivez sur une page permettant de libérer les clés indépendamment d'une connexion avec le serveur
Le mot de passe administrateur sera celui qui vous aura été confirmez avec le bordereau de livraison
*Cliquer sur RESET pour supprimer l'alarme de défaut
*Pour libérer une clé, sélectionner le numéro et cliquer sur le bouton « Libérer la clé »

[[Fichier:WebAdmin.jpg]]

KeyPanel installation1

2014-01-18T22:24:17Z

Joel : /* Box SFR */

L'armoire à clé [[Media:Deister_ProxSafe_Smart3U.pdf|ProxSafe Smart3U]]? de Deister permet la gestion de 8, 16 ou 32 clés avec l'application openFlyers

Existe aussi en version [[Media:Deister_ProxSafe_Mini3U.pdf|ProxSafe_Mini 3U]]? avec 8 à 16 clés de format plus réduit

Le modèle fournis via OpenFlyers ne comporte pas le Lecteur Deister mais un Module OF permettant le dialogue avec nos serveurs
= Connexions de l'armoire=
Rendre la clé dans la pochette fixée sur l'armoire et ouvrir la porte de service. Les câbles suivants doivent être passés avant la fixation définitive au mur.
*Alimentation
*Câble Ethernet en provenance de votre routeur pour l'armoire
*Câble Ethernet en provenance de votre routeur pour le module OF
Fixer l'armoire au mur par 4 chevilles et vis en ayant au préalable retirer l’adhésif de maintien de l’interrupteur qui détectera une tentative de vandalisme
*Vérifier que la carte SD est correctement enfichée dans son logement
*Brancher un câble Ethernet sur le Module OF

[[Fichier:Connexion rj45 OF.jpg]]
*Brancher un câble Ethernet sur l'armoire

[[Fichier:Connexion rj45masterplane.jpg]]
*Brancher le câble d'alimentation 220V

[[Fichier:Alim.JPG]]
*Refermer la porte de service
*Brancher la prise d'alimentation sur le secteur
A l'initialisation de l'armoire le voyant jaune de la face avant clignote puis passe au jaune fixe

= Préparation du réseau=
L'armoire à clés demande 2 connexions au réseau local, une pour le Module OF et une pour l'armoire à clés. Ils sont configurés en DHCP ce qui signifie qu'ils seront automatiquement reconnus par le réseau à chaque connexion et qu'une adresse IP leur sera affecté.

Cependant pour qu'ils puissent communiquer avec le logiciel OpenFlyers les équipements doivent avoir une adresse IP identique à chaque mise en route du routeur. Pour forcer le routeur à attribuer toujours la même adresse IP à un équipement il faut le configurer en créant l'association d'une [http://fr.wikipedia.org/wiki/Adresse_IP IP] à l'adresse [http://fr.wikipedia.org/wiki/Adresse_MAC MAC] du materiel.

Les adresses IP et MAC à configurer vous sont communiquées dans l'email confirmant l'envoi de l'armoire à clés et sur le bordereau de livraison, Ceci ce fait dans votre routeur ou la box de votre provider et dépend du matériel que vous disposez
==Idendification de l'adresse IP==
Pour connaître l'adresse IP de sa passerelle (box ou routeur).
===Sous Windows 7===
Pour les inconditionnels de l'interface graphique
*Cliquer sur le bouton '''Démarrer'''
*cliquer sur '''Panneau de configuration'''
*Cliquer sur '''Réseau et Internet'''
*Cliquer sur '''Centre de réseau et partage'''
*Cliquer sur '''Afficher l'intégralité du réseau''' dan
Survoler l’icône Passerelle et vous aurez l'adresse IP de votre matériel dans le message

[[Fichier:Reseau_W7.jpg]]

Pour les fans de l'efficacité
*Cliquer sur le bouton '''Démarrer'''
*Dans le champs Rechercher taper '''cmd''' puis faite "Entrer" pour ouvrir la console DOS.
*Taper « netstat -r -n » qui affrichera la table de routage
L'adresse de votre routeur est indiquée à la colonne "Adr. passerelle" de la table de routage

[[Fichier:Table_routage_windows.jpg]]

===Sous Linux===
*Ouvrir votre console
*Taper « netstat -r -n »
*L'adresse Ip est dans la colonne Gateway

[[Fichier:Reseau_Linux.jpg]]

==Configuration du routeur==
===Livebox Orange===
Il y a de nombreux modèle de Livebox, voici un lien ou vous pouvez identifier votre [http://assistance.orange.fr/livebox-tous-les-modeles-524.php Modèle de Livebox]

Il y a généralement deux endroits pour configurer les IP en fonction des adresses MAC:
*celle pour le filtrage du réseau Wifi (WAN). Ceci ne fonctionnera pas pour le réseau filaire (LAN)
*celle permettant de mettre une IP statique (valide pour le wifi et le LAN). C'est cette configuration qu'il faut faire

====Livebox 2 de Sagem====
Il faut au préalable connecter l'armoire afin que la Livebox lui affecte par défaut une adresse IP.
*Connecter vous sur votre Livebox en tapant son IP et mettre l'identifiant et mot de passe (par défaut admin/admin qu'il est fortement conseillé de le changer)
*Aller dans
** Onglet Configuration
** Menu de gauche Réseaux & Services > Équipements > Visualiser
** Deux nouveaux icônes doivent apparaitre
** Cliquer dessus un des icône et vérifier à qu'elle matériel cette adresse MAC correspond (inscrit sur votre bordereau de livraison)
** Renommer les en "Armoire à clés" et "Module OF" pour une identification plus aisée. Orange a rajouté ses propres noms qui ne simplifient pas la reconnaissance du matériel !!!

*Ensuite aller dans:
** Onglet Configuration
** Menu de gauche Réseaux & Services > Livebox > Paramètres avancés
** Onglet DHCP
** Section Adresse IP statique
** Cliquer sur ajouter
[[Fichier:LiveBox.JPG]]
** Sélectionner dans le menu déroulant: Armoire à clés
** Mettre l'adresse 192.168.1.201
** Cliquer sur ajouter
** Sélectionner dans le menu déroulant: Daemon RPi
** Mettre l'adresse 192.168.1.200
** Sauver

Ensuite réinitialiser votre LiveBox

Vérifier la prise en compte de ces paramètres en allant dans
*Onglet Configuration
*Menu de gauche Réseaux & Services > Équipements > Visualiser
*Cliquer sur les icônes Daemon RPi et Armoire à cles. Vous devez avoir les adresses IP en 192.168.1.200 et 192.168.1.201

Note: L'interface d'Orange est faillible, nous avons constaté que leur interface indique que l'armoire n'était pas connecté alors qu'elle l'était. Vous pouvez vérifier cela indépendament de leur interface en allant avec un interface de ligne de commande et en faisant in ping des adresses
<BASH>ping 192.168.1.200
PING 192.168.1.200 (192.168.1.200) 56(84) bytes of data.
64 bytes from 192.168.1.5: icmp_req=1 ttl=64 time=0.241 ms
64 bytes from 192.168.1.5: icmp_req=2 ttl=64 time=0.143 ms
64 bytes from 192.168.1.5: icmp_req=3 ttl=64 time=0.144 ms
64 bytes from 192.168.1.5: icmp_req=4 ttl=64 time=0.145 ms

ping 192.168.1.201
PING 192.168.1.201 (192.168.1.201) 56(84) bytes of data.
64 bytes from 192.168.1.5: icmp_req=1 ttl=64 time=0.241 ms
64 bytes from 192.168.1.5: icmp_req=2 ttl=64 time=0.143 ms
64 bytes from 192.168.1.5: icmp_req=3 ttl=64 time=0.144 ms
64 bytes from 192.168.1.5: icmp_req=4 ttl=64 time=0.145 ms</BASH>

Si la réponse est "Unreachable" alors les adresses ne sont pas correctement affectées ou un câble est défectueux
<BASH>ping 192.168.1.201
PING 192.168.1.201 (192.168.1.201) 56(84) bytes of data.
From 192.168.1.5 icmp_seq=1 Destination Host Unreachable</BASH>

===Freebox===
Connectez-vous sur votre compte à l'adresse http://portail.free.fr/

A renseigner

===Box SFR===
Il faut au préalable connecter l'armoire afin que la Box SFR lui affecte par défaut une adresse IP.
*Connecter vous sur votre Box SFR en tapant son IP et mettre l'identifiant et mot de passe

A renseigner

===BBox ===
Il faut au préalable connecter l'armoire afin que la BBox lui affecte par défaut une adresse IP.
*Connecter vous sur votre BBox en tapant son IP et mettre l'identifiant et mot de passe

A renseigner

=Configuration OpenFlyers=

==Navigateur==
Un point '''important''': le navigateur Internet Explorer ne permet pas la communication avec l'armoire. Ce navigateur ne possède pas les fonctions avancées du standard W3C que nous utilisons pour sécuriser les accès.

Firefox ou Chrome sont des navigateurs qui fonctionnent pour déclencher la libération des clés.

Le ou les PC du club devront être paramétrés pour que ce soient un de ces navigateur qui soit en service.

Comme il est difficile de bloquer Internet Explorer sous Windows il faudra clairement informer les utilisateurs du club
Les navigateurs récents implémentent désormais des règles de filtrage pour bloquer le contenu non sécurisé provenant d'une page HTTP chargé depuis une page HTTPS. C'est le cas avec le serveur OF ou l'URL est en HTTPS et celles de l'armoire en HTTP. Il faut donc configurer les navigateurs pour ne pas réagir à ce mixte d'adresse URL

===Firefox===
Dans la barre d'adresse, taper about:config
*Valider le message d'avertissement comme quoi vous devez faire Attention
*Rechercher le paramètre security.mixed_content
*Double cliquer sur le paramètre security.mixed_content.block_active_content pour qu'il passe à '''false'''.
*La ligne s'affiche en gras

===Chrome===
*Clique droit sur l’icône de Chrome
*Cliquer sur Propriétés
*Ajouter dans le champs Cible à la fin --allow-running-insecure-content
*Le champs cible resemblera donc à <BASH>"C:\Program Files (x86)\Google\Chrome\Application\chrome.exe" --allow-running-insecure-content</BASH>

==Paramétrage OF==

*Aller dans '''Admin > Configuration > Paramétrage'''
**Dans la section '''Gestion des vols''' et cliquer sur l'option '''Activé(e)''' de la rubrique '''Gestion armoire à clés'''.
[[Fichier:Config OF0.JPG]]
**Cliquer dans Valider, de nouveaux champs seront alors de nouveau visibles
[[Fichier:Config OF1.jpg]]
**Cliquer sur '''Activé(e)''' dans la rubrique '''Gestion des clés'''
**Choisissez la durée de temporisation pour prendre la clé, elle dépend de la distance entre votre PC et l'armoire. 10 à 20 secondes sont des valeurs usuelles
**Dans la rubrique '''Logiciel de contrôle de l'armoire à clés''' choisissez '''PyOpenKey2'''
**Dans la rubrique '''IP du PC contenant le logiciel de contrôle''' indiquer l'adresse IP du Module OF ''' 192.168.1.200''' (A adapter en fonction de votre réseaux)
**Dans la rubrique '''Port du PC contenant le logiciel de contrôle''' indiquer le port '''4080''' (ou autre si spécifié sur le bordereau de livraison)
**Cliquer dans ''''Valider''', 2 nouveaux champs seront alors de nouveau visibles
[[Fichier:Config OF.jpg]]
**Dans la rubrique '''Fermeture automatique des vols au retour de la clé''' cocher '''Désactivé(e)'''
**Dans la rubrique '''Phrase mot de passe''', saisissez la même phrase que celle qui vous aura été indiquée sur le bordereau de livraison
**Cliquer sur Valider
*Aller dans '''Admin > Utilisateurs > Profils''' et vérifier que le profil sous lequel vous êtes connecté possède le droit '''Gestion des clés''' dans l'onglet '''Généralité admin'''
*Pour initialiser les clés dans OpenFlyers il faut aller dans la page '''Admin > Ressources > Ressources > Actives'''
*Sélectionner un numéro de clé pour chaque avion
[[Fichier:Page Ressource.jpg]]

=Première connexion=
Faite une réinitialisation en débranchant l'alimentation puis en la reconnectant après 5 secondes
*Le voyant vert de l'armoire doit s'allumer après quelques minutes
*Le voyant orange reste allumé durant la phase de connexion au serveur OF et à la reconnaissance des tag RFID des clés
*A la fin de l'initialisation le voyant orange s’éteint

Si l'initialisation des Tags n'est pas reconnu les clés se déclencheront successivement

==Connexion interface Web==
Dans votre navigateur mettre l'URL du Module OF suivi du port 8000.
<BASH> 192.168.1.200:8000</BASH>
Vous arrivez sur une page permettant de libérer les clés indépendamment d'une connexion avec le serveur
Le mot de passe administrateur sera celui qui vous aura été confirmez avec le bordereau de livraison
*Cliquer sur RESET pour supprimer l'alarme de défaut
*Pour libérer une clé, sélectionner le numéro et cliquer sur le bouton « Libérer la clé »

[[Fichier:WebAdmin.jpg]]

==Initialisation des clès==
La position des tags sont enregistrées dans openflyers si un tag est reposé à un emplacement incorrect, un halo rouge autour de la clé s'allume ainsi qu'un le halo à l'emplacement normalement identifié. La clé incorrecte est automatiquement déverrouillée

[[Fichier:Clé rouge.JPG]]

Si vous voulez modifier cette ordre il faut réinitialiser le serveur avec votre nouvelle configuration. Vous devez mettre toutes les clés au tableau tel que vous le souhaitez. Ne vous pré-occupez pas des lumières rouges autour des tags

Pour refaire l'initialisation allez dans '''Admin > Ressources > Ressources > Actives'''
*Cliquez sur l'icône '''Activer les tags des clés'''

Les identifiants de chaque clé doivent apparaître après rafraîchissement de la page.

[[Fichier:Ressources activees.jpg]]

Débranchez de nouveau l'armoire pour refaire l'initialisation

=Prise de clé à l'ouverture d'un vol=
Pour un contrôle de la prise de clé par un utilisateur il faut que le logiciel soit paramétré avec l'option '''Ouverture et fermeture des vols.''' Aller dans '''Admin > Configuration > Paramètres''' et dans la rubrique '''Gestion des vols''' activer l'option '''Ouverture et fermeture de vol'''

[[Fichier:Gestion des vols.JPG]]

Pour une prise de clé il faut cliquer droit sur une réservation et choisir l'option Saisir un vol
La page de saisie d'un vol s'ouvre avec l'option Départ en vol
Renseigner les champs et cliquer sur Valider
Une page de prise de clé s'ouvrira

[[Fichier:Prise de cle.JPG]]

Cliquer sur le bouton Libérer la clé pour l'aéronef F-XXXX
La porte doit se déverrouiller (voyant orange) et la clé être libérer durant la temporisation prévue (clé entourée d'un halo lumineux rouge)
Refermer la porte sinon un buzzer intermittent retenti

Déconnectez-vous de OpenFlyers pour l'utilisateur suivant

=Retour de vol=

Pour remettre la clé, se connecter sur OpenFlyers
Cliquer sur l'icône Ouvrir la porte en haut à gauche de la page du cahier de réservation

[[Fichier:Ouvrir porte.JPG]]

La porte sera déverrouillé durant la durée de la temporisation
*Remettre la clé à son emplacement
*Si la clé est incorrectement placée, l'armoire déverrouille la clé (halo rouge de la clé reposée) et signale l'emplacement correct en allumant le halo rouge de l'emplacement prévu.
*Sur le planning l'avion en vol est indiquer par une couleur bleu. Survoler ce vol avec la souris
*Un menu apparait avec l'option '''Fermer le vol'''
*Cliquer et enregistré le vol

'''Note:''' Ne pas aller directement sur le menu '''Vols > Saisir un vol''' pour fermer le vol. Dans ce cas il ne pourra être établi de corrélation entre l'affichage du planning et le vol que vous fermez. Le vol restera ouvert (en bleu sur le planning) et l'avion sera bloqué pour repartir en vol. Néanmoins si un pilote faire l'erreur alors il faut, dans le menu surgissant, cliquer sur '''Annuler'''

=Finalisation=
*Ouvrir la porte de service
*Brancher le connecteur de la batterie de sauvegarde (Déconnecté pour le transport)

[[Fichier:Connecteur Batterie.JPG]]
*Refermer la porte de service

L'ouverture de la porte de service enclenche une alarme qui est mise en mémoire dans OF. Pour supprimer l'alarme il faut aller sur l'interface [[Installation_armoire_à_clés_Deister_ProxSafe#Connexion_interface_Web|Web admin]] et cliquer sur '''RESET'''

KeyPanel installation1

2014-01-18T22:21:10Z

Joel : /* Sous Linux */

L'armoire à clé [[Media:Deister_ProxSafe_Smart3U.pdf|ProxSafe Smart3U]]? de Deister permet la gestion de 8, 16 ou 32 clés avec l'application openFlyers

Existe aussi en version [[Media:Deister_ProxSafe_Mini3U.pdf|ProxSafe_Mini 3U]]? avec 8 à 16 clés de format plus réduit

Le modèle fournis via OpenFlyers ne comporte pas le Lecteur Deister mais un Module OF permettant le dialogue avec nos serveurs
= Connexions de l'armoire=
Rendre la clé dans la pochette fixée sur l'armoire et ouvrir la porte de service. Les câbles suivants doivent être passés avant la fixation définitive au mur.
*Alimentation
*Câble Ethernet en provenance de votre routeur pour l'armoire
*Câble Ethernet en provenance de votre routeur pour le module OF
Fixer l'armoire au mur par 4 chevilles et vis en ayant au préalable retirer l’adhésif de maintien de l’interrupteur qui détectera une tentative de vandalisme
*Vérifier que la carte SD est correctement enfichée dans son logement
*Brancher un câble Ethernet sur le Module OF

[[Fichier:Connexion rj45 OF.jpg]]
*Brancher un câble Ethernet sur l'armoire

[[Fichier:Connexion rj45masterplane.jpg]]
*Brancher le câble d'alimentation 220V

[[Fichier:Alim.JPG]]
*Refermer la porte de service
*Brancher la prise d'alimentation sur le secteur
A l'initialisation de l'armoire le voyant jaune de la face avant clignote puis passe au jaune fixe

= Préparation du réseau=
L'armoire à clés demande 2 connexions au réseau local, une pour le Module OF et une pour l'armoire à clés. Ils sont configurés en DHCP ce qui signifie qu'ils seront automatiquement reconnus par le réseau à chaque connexion et qu'une adresse IP leur sera affecté.

Cependant pour qu'ils puissent communiquer avec le logiciel OpenFlyers les équipements doivent avoir une adresse IP identique à chaque mise en route du routeur. Pour forcer le routeur à attribuer toujours la même adresse IP à un équipement il faut le configurer en créant l'association d'une [http://fr.wikipedia.org/wiki/Adresse_IP IP] à l'adresse [http://fr.wikipedia.org/wiki/Adresse_MAC MAC] du materiel.

Les adresses IP et MAC à configurer vous sont communiquées dans l'email confirmant l'envoi de l'armoire à clés et sur le bordereau de livraison, Ceci ce fait dans votre routeur ou la box de votre provider et dépend du matériel que vous disposez
==Idendification de l'adresse IP==
Pour connaître l'adresse IP de sa passerelle (box ou routeur).
===Sous Windows 7===
Pour les inconditionnels de l'interface graphique
*Cliquer sur le bouton '''Démarrer'''
*cliquer sur '''Panneau de configuration'''
*Cliquer sur '''Réseau et Internet'''
*Cliquer sur '''Centre de réseau et partage'''
*Cliquer sur '''Afficher l'intégralité du réseau''' dan
Survoler l’icône Passerelle et vous aurez l'adresse IP de votre matériel dans le message

[[Fichier:Reseau_W7.jpg]]

Pour les fans de l'efficacité
*Cliquer sur le bouton '''Démarrer'''
*Dans le champs Rechercher taper '''cmd''' puis faite "Entrer" pour ouvrir la console DOS.
*Taper « netstat -r -n » qui affrichera la table de routage
L'adresse de votre routeur est indiquée à la colonne "Adr. passerelle" de la table de routage

[[Fichier:Table_routage_windows.jpg]]

===Sous Linux===
*Ouvrir votre console
*Taper « netstat -r -n »
*L'adresse Ip est dans la colonne Gateway

[[Fichier:Reseau_Linux.jpg]]

==Configuration du routeur==
===Livebox Orange===
Il y a de nombreux modèle de Livebox, voici un lien ou vous pouvez identifier votre [http://assistance.orange.fr/livebox-tous-les-modeles-524.php Modèle de Livebox]

Il y a généralement deux endroits pour configurer les IP en fonction des adresses MAC:
*celle pour le filtrage du réseau Wifi (WAN). Ceci ne fonctionnera pas pour le réseau filaire (LAN)
*celle permettant de mettre une IP statique (valide pour le wifi et le LAN). C'est cette configuration qu'il faut faire

====Livebox 2 de Sagem====
Il faut au préalable connecter l'armoire afin que la Livebox lui affecte par défaut une adresse IP.
*Connecter vous sur votre Livebox en tapant son IP et mettre l'identifiant et mot de passe (par défaut admin/admin qu'il est fortement conseillé de le changer)
*Aller dans
** Onglet Configuration
** Menu de gauche Réseaux & Services > Équipements > Visualiser
** Deux nouveaux icônes doivent apparaitre
** Cliquer dessus un des icône et vérifier à qu'elle matériel cette adresse MAC correspond (inscrit sur votre bordereau de livraison)
** Renommer les en "Armoire à clés" et "Module OF" pour une identification plus aisée. Orange a rajouté ses propres noms qui ne simplifient pas la reconnaissance du matériel !!!

*Ensuite aller dans:
** Onglet Configuration
** Menu de gauche Réseaux & Services > Livebox > Paramètres avancés
** Onglet DHCP
** Section Adresse IP statique
** Cliquer sur ajouter
[[Fichier:LiveBox.JPG]]
** Sélectionner dans le menu déroulant: Armoire à clés
** Mettre l'adresse 192.168.1.201
** Cliquer sur ajouter
** Sélectionner dans le menu déroulant: Daemon RPi
** Mettre l'adresse 192.168.1.200
** Sauver

Ensuite réinitialiser votre LiveBox

Vérifier la prise en compte de ces paramètres en allant dans
*Onglet Configuration
*Menu de gauche Réseaux & Services > Équipements > Visualiser
*Cliquer sur les icônes Daemon RPi et Armoire à cles. Vous devez avoir les adresses IP en 192.168.1.200 et 192.168.1.201

Note: L'interface d'Orange est faillible, nous avons constaté que leur interface indique que l'armoire n'était pas connecté alors qu'elle l'était. Vous pouvez vérifier cela indépendament de leur interface en allant avec un interface de ligne de commande et en faisant in ping des adresses
<BASH>ping 192.168.1.200
PING 192.168.1.200 (192.168.1.200) 56(84) bytes of data.
64 bytes from 192.168.1.5: icmp_req=1 ttl=64 time=0.241 ms
64 bytes from 192.168.1.5: icmp_req=2 ttl=64 time=0.143 ms
64 bytes from 192.168.1.5: icmp_req=3 ttl=64 time=0.144 ms
64 bytes from 192.168.1.5: icmp_req=4 ttl=64 time=0.145 ms

ping 192.168.1.201
PING 192.168.1.201 (192.168.1.201) 56(84) bytes of data.
64 bytes from 192.168.1.5: icmp_req=1 ttl=64 time=0.241 ms
64 bytes from 192.168.1.5: icmp_req=2 ttl=64 time=0.143 ms
64 bytes from 192.168.1.5: icmp_req=3 ttl=64 time=0.144 ms
64 bytes from 192.168.1.5: icmp_req=4 ttl=64 time=0.145 ms</BASH>

Si la réponse est "Unreachable" alors les adresses ne sont pas correctement affectées ou un câble est défectueux
<BASH>ping 192.168.1.201
PING 192.168.1.201 (192.168.1.201) 56(84) bytes of data.
From 192.168.1.5 icmp_seq=1 Destination Host Unreachable</BASH>

===Freebox===
Connectez-vous sur votre compte à l'adresse http://portail.free.fr/

A renseigner

===Box SFR===
Il faut au préalable connecter l'armoire afin que la Box SFR lui affecte par défaut une adresse IP.
*Connecter vous sur votre Box SFR en tapant son IP et mettre l'identifiant et mot de passe (par défaut admin/admin qu'il est fortement conseillé de le changer)

A renseigner
=Configuration OpenFlyers=

==Navigateur==
Un point '''important''': le navigateur Internet Explorer ne permet pas la communication avec l'armoire. Ce navigateur ne possède pas les fonctions avancées du standard W3C que nous utilisons pour sécuriser les accès.

Firefox ou Chrome sont des navigateurs qui fonctionnent pour déclencher la libération des clés.

Le ou les PC du club devront être paramétrés pour que ce soient un de ces navigateur qui soit en service.

Comme il est difficile de bloquer Internet Explorer sous Windows il faudra clairement informer les utilisateurs du club
Les navigateurs récents implémentent désormais des règles de filtrage pour bloquer le contenu non sécurisé provenant d'une page HTTP chargé depuis une page HTTPS. C'est le cas avec le serveur OF ou l'URL est en HTTPS et celles de l'armoire en HTTP. Il faut donc configurer les navigateurs pour ne pas réagir à ce mixte d'adresse URL

===Firefox===
Dans la barre d'adresse, taper about:config
*Valider le message d'avertissement comme quoi vous devez faire Attention
*Rechercher le paramètre security.mixed_content
*Double cliquer sur le paramètre security.mixed_content.block_active_content pour qu'il passe à '''false'''.
*La ligne s'affiche en gras

===Chrome===
*Clique droit sur l’icône de Chrome
*Cliquer sur Propriétés
*Ajouter dans le champs Cible à la fin --allow-running-insecure-content
*Le champs cible resemblera donc à <BASH>"C:\Program Files (x86)\Google\Chrome\Application\chrome.exe" --allow-running-insecure-content</BASH>

==Paramétrage OF==

*Aller dans '''Admin > Configuration > Paramétrage'''
**Dans la section '''Gestion des vols''' et cliquer sur l'option '''Activé(e)''' de la rubrique '''Gestion armoire à clés'''.
[[Fichier:Config OF0.JPG]]
**Cliquer dans Valider, de nouveaux champs seront alors de nouveau visibles
[[Fichier:Config OF1.jpg]]
**Cliquer sur '''Activé(e)''' dans la rubrique '''Gestion des clés'''
**Choisissez la durée de temporisation pour prendre la clé, elle dépend de la distance entre votre PC et l'armoire. 10 à 20 secondes sont des valeurs usuelles
**Dans la rubrique '''Logiciel de contrôle de l'armoire à clés''' choisissez '''PyOpenKey2'''
**Dans la rubrique '''IP du PC contenant le logiciel de contrôle''' indiquer l'adresse IP du Module OF ''' 192.168.1.200''' (A adapter en fonction de votre réseaux)
**Dans la rubrique '''Port du PC contenant le logiciel de contrôle''' indiquer le port '''4080''' (ou autre si spécifié sur le bordereau de livraison)
**Cliquer dans ''''Valider''', 2 nouveaux champs seront alors de nouveau visibles
[[Fichier:Config OF.jpg]]
**Dans la rubrique '''Fermeture automatique des vols au retour de la clé''' cocher '''Désactivé(e)'''
**Dans la rubrique '''Phrase mot de passe''', saisissez la même phrase que celle qui vous aura été indiquée sur le bordereau de livraison
**Cliquer sur Valider
*Aller dans '''Admin > Utilisateurs > Profils''' et vérifier que le profil sous lequel vous êtes connecté possède le droit '''Gestion des clés''' dans l'onglet '''Généralité admin'''
*Pour initialiser les clés dans OpenFlyers il faut aller dans la page '''Admin > Ressources > Ressources > Actives'''
*Sélectionner un numéro de clé pour chaque avion
[[Fichier:Page Ressource.jpg]]

=Première connexion=
Faite une réinitialisation en débranchant l'alimentation puis en la reconnectant après 5 secondes
*Le voyant vert de l'armoire doit s'allumer après quelques minutes
*Le voyant orange reste allumé durant la phase de connexion au serveur OF et à la reconnaissance des tag RFID des clés
*A la fin de l'initialisation le voyant orange s’éteint

Si l'initialisation des Tags n'est pas reconnu les clés se déclencheront successivement

==Connexion interface Web==
Dans votre navigateur mettre l'URL du Module OF suivi du port 8000.
<BASH> 192.168.1.200:8000</BASH>
Vous arrivez sur une page permettant de libérer les clés indépendamment d'une connexion avec le serveur
Le mot de passe administrateur sera celui qui vous aura été confirmez avec le bordereau de livraison
*Cliquer sur RESET pour supprimer l'alarme de défaut
*Pour libérer une clé, sélectionner le numéro et cliquer sur le bouton « Libérer la clé »

[[Fichier:WebAdmin.jpg]]

==Initialisation des clès==
La position des tags sont enregistrées dans openflyers si un tag est reposé à un emplacement incorrect, un halo rouge autour de la clé s'allume ainsi qu'un le halo à l'emplacement normalement identifié. La clé incorrecte est automatiquement déverrouillée

[[Fichier:Clé rouge.JPG]]

Si vous voulez modifier cette ordre il faut réinitialiser le serveur avec votre nouvelle configuration. Vous devez mettre toutes les clés au tableau tel que vous le souhaitez. Ne vous pré-occupez pas des lumières rouges autour des tags

Pour refaire l'initialisation allez dans '''Admin > Ressources > Ressources > Actives'''
*Cliquez sur l'icône '''Activer les tags des clés'''

Les identifiants de chaque clé doivent apparaître après rafraîchissement de la page.

[[Fichier:Ressources activees.jpg]]

Débranchez de nouveau l'armoire pour refaire l'initialisation

=Prise de clé à l'ouverture d'un vol=
Pour un contrôle de la prise de clé par un utilisateur il faut que le logiciel soit paramétré avec l'option '''Ouverture et fermeture des vols.''' Aller dans '''Admin > Configuration > Paramètres''' et dans la rubrique '''Gestion des vols''' activer l'option '''Ouverture et fermeture de vol'''

[[Fichier:Gestion des vols.JPG]]

Pour une prise de clé il faut cliquer droit sur une réservation et choisir l'option Saisir un vol
La page de saisie d'un vol s'ouvre avec l'option Départ en vol
Renseigner les champs et cliquer sur Valider
Une page de prise de clé s'ouvrira

[[Fichier:Prise de cle.JPG]]

Cliquer sur le bouton Libérer la clé pour l'aéronef F-XXXX
La porte doit se déverrouiller (voyant orange) et la clé être libérer durant la temporisation prévue (clé entourée d'un halo lumineux rouge)
Refermer la porte sinon un buzzer intermittent retenti

Déconnectez-vous de OpenFlyers pour l'utilisateur suivant

=Retour de vol=

Pour remettre la clé, se connecter sur OpenFlyers
Cliquer sur l'icône Ouvrir la porte en haut à gauche de la page du cahier de réservation

[[Fichier:Ouvrir porte.JPG]]

La porte sera déverrouillé durant la durée de la temporisation
*Remettre la clé à son emplacement
*Si la clé est incorrectement placée, l'armoire déverrouille la clé (halo rouge de la clé reposée) et signale l'emplacement correct en allumant le halo rouge de l'emplacement prévu.
*Sur le planning l'avion en vol est indiquer par une couleur bleu. Survoler ce vol avec la souris
*Un menu apparait avec l'option '''Fermer le vol'''
*Cliquer et enregistré le vol

'''Note:''' Ne pas aller directement sur le menu '''Vols > Saisir un vol''' pour fermer le vol. Dans ce cas il ne pourra être établi de corrélation entre l'affichage du planning et le vol que vous fermez. Le vol restera ouvert (en bleu sur le planning) et l'avion sera bloqué pour repartir en vol. Néanmoins si un pilote faire l'erreur alors il faut, dans le menu surgissant, cliquer sur '''Annuler'''

=Finalisation=
*Ouvrir la porte de service
*Brancher le connecteur de la batterie de sauvegarde (Déconnecté pour le transport)

[[Fichier:Connecteur Batterie.JPG]]
*Refermer la porte de service

L'ouverture de la porte de service enclenche une alarme qui est mise en mémoire dans OF. Pour supprimer l'alarme il faut aller sur l'interface [[Installation_armoire_à_clés_Deister_ProxSafe#Connexion_interface_Web|Web admin]] et cliquer sur '''RESET'''

KeyPanel installation1

2014-01-18T22:20:53Z

Joel : /* Sous Windows 7 */

L'armoire à clé [[Media:Deister_ProxSafe_Smart3U.pdf|ProxSafe Smart3U]]? de Deister permet la gestion de 8, 16 ou 32 clés avec l'application openFlyers

Existe aussi en version [[Media:Deister_ProxSafe_Mini3U.pdf|ProxSafe_Mini 3U]]? avec 8 à 16 clés de format plus réduit

Le modèle fournis via OpenFlyers ne comporte pas le Lecteur Deister mais un Module OF permettant le dialogue avec nos serveurs
= Connexions de l'armoire=
Rendre la clé dans la pochette fixée sur l'armoire et ouvrir la porte de service. Les câbles suivants doivent être passés avant la fixation définitive au mur.
*Alimentation
*Câble Ethernet en provenance de votre routeur pour l'armoire
*Câble Ethernet en provenance de votre routeur pour le module OF
Fixer l'armoire au mur par 4 chevilles et vis en ayant au préalable retirer l’adhésif de maintien de l’interrupteur qui détectera une tentative de vandalisme
*Vérifier que la carte SD est correctement enfichée dans son logement
*Brancher un câble Ethernet sur le Module OF

[[Fichier:Connexion rj45 OF.jpg]]
*Brancher un câble Ethernet sur l'armoire

[[Fichier:Connexion rj45masterplane.jpg]]
*Brancher le câble d'alimentation 220V

[[Fichier:Alim.JPG]]
*Refermer la porte de service
*Brancher la prise d'alimentation sur le secteur
A l'initialisation de l'armoire le voyant jaune de la face avant clignote puis passe au jaune fixe

= Préparation du réseau=
L'armoire à clés demande 2 connexions au réseau local, une pour le Module OF et une pour l'armoire à clés. Ils sont configurés en DHCP ce qui signifie qu'ils seront automatiquement reconnus par le réseau à chaque connexion et qu'une adresse IP leur sera affecté.

Cependant pour qu'ils puissent communiquer avec le logiciel OpenFlyers les équipements doivent avoir une adresse IP identique à chaque mise en route du routeur. Pour forcer le routeur à attribuer toujours la même adresse IP à un équipement il faut le configurer en créant l'association d'une [http://fr.wikipedia.org/wiki/Adresse_IP IP] à l'adresse [http://fr.wikipedia.org/wiki/Adresse_MAC MAC] du materiel.

Les adresses IP et MAC à configurer vous sont communiquées dans l'email confirmant l'envoi de l'armoire à clés et sur le bordereau de livraison, Ceci ce fait dans votre routeur ou la box de votre provider et dépend du matériel que vous disposez
==Idendification de l'adresse IP==
Pour connaître l'adresse IP de sa passerelle (box ou routeur).
===Sous Windows 7===
Pour les inconditionnels de l'interface graphique
*Cliquer sur le bouton '''Démarrer'''
*cliquer sur '''Panneau de configuration'''
*Cliquer sur '''Réseau et Internet'''
*Cliquer sur '''Centre de réseau et partage'''
*Cliquer sur '''Afficher l'intégralité du réseau''' dan
Survoler l’icône Passerelle et vous aurez l'adresse IP de votre matériel dans le message

[[Fichier:Reseau_W7.jpg]]

Pour les fans de l'efficacité
*Cliquer sur le bouton '''Démarrer'''
*Dans le champs Rechercher taper '''cmd''' puis faite "Entrer" pour ouvrir la console DOS.
*Taper « netstat -r -n » qui affrichera la table de routage
L'adresse de votre routeur est indiquée à la colonne "Adr. passerelle" de la table de routage

[[Fichier:Table_routage_windows.jpg]]

===Sous Linux===
*Ouvrir votre console
*Taper « netstat -r -n »
*L'adresse Ip est dans la colonne Gateway

[[Image:Reseau_Linux.jpg?]]
==Configuration du routeur==
===Livebox Orange===
Il y a de nombreux modèle de Livebox, voici un lien ou vous pouvez identifier votre [http://assistance.orange.fr/livebox-tous-les-modeles-524.php Modèle de Livebox]

Il y a généralement deux endroits pour configurer les IP en fonction des adresses MAC:
*celle pour le filtrage du réseau Wifi (WAN). Ceci ne fonctionnera pas pour le réseau filaire (LAN)
*celle permettant de mettre une IP statique (valide pour le wifi et le LAN). C'est cette configuration qu'il faut faire

====Livebox 2 de Sagem====
Il faut au préalable connecter l'armoire afin que la Livebox lui affecte par défaut une adresse IP.
*Connecter vous sur votre Livebox en tapant son IP et mettre l'identifiant et mot de passe (par défaut admin/admin qu'il est fortement conseillé de le changer)
*Aller dans
** Onglet Configuration
** Menu de gauche Réseaux & Services > Équipements > Visualiser
** Deux nouveaux icônes doivent apparaitre
** Cliquer dessus un des icône et vérifier à qu'elle matériel cette adresse MAC correspond (inscrit sur votre bordereau de livraison)
** Renommer les en "Armoire à clés" et "Module OF" pour une identification plus aisée. Orange a rajouté ses propres noms qui ne simplifient pas la reconnaissance du matériel !!!

*Ensuite aller dans:
** Onglet Configuration
** Menu de gauche Réseaux & Services > Livebox > Paramètres avancés
** Onglet DHCP
** Section Adresse IP statique
** Cliquer sur ajouter
[[Fichier:LiveBox.JPG]]
** Sélectionner dans le menu déroulant: Armoire à clés
** Mettre l'adresse 192.168.1.201
** Cliquer sur ajouter
** Sélectionner dans le menu déroulant: Daemon RPi
** Mettre l'adresse 192.168.1.200
** Sauver

Ensuite réinitialiser votre LiveBox

Vérifier la prise en compte de ces paramètres en allant dans
*Onglet Configuration
*Menu de gauche Réseaux & Services > Équipements > Visualiser
*Cliquer sur les icônes Daemon RPi et Armoire à cles. Vous devez avoir les adresses IP en 192.168.1.200 et 192.168.1.201

Note: L'interface d'Orange est faillible, nous avons constaté que leur interface indique que l'armoire n'était pas connecté alors qu'elle l'était. Vous pouvez vérifier cela indépendament de leur interface en allant avec un interface de ligne de commande et en faisant in ping des adresses
<BASH>ping 192.168.1.200
PING 192.168.1.200 (192.168.1.200) 56(84) bytes of data.
64 bytes from 192.168.1.5: icmp_req=1 ttl=64 time=0.241 ms
64 bytes from 192.168.1.5: icmp_req=2 ttl=64 time=0.143 ms
64 bytes from 192.168.1.5: icmp_req=3 ttl=64 time=0.144 ms
64 bytes from 192.168.1.5: icmp_req=4 ttl=64 time=0.145 ms

ping 192.168.1.201
PING 192.168.1.201 (192.168.1.201) 56(84) bytes of data.
64 bytes from 192.168.1.5: icmp_req=1 ttl=64 time=0.241 ms
64 bytes from 192.168.1.5: icmp_req=2 ttl=64 time=0.143 ms
64 bytes from 192.168.1.5: icmp_req=3 ttl=64 time=0.144 ms
64 bytes from 192.168.1.5: icmp_req=4 ttl=64 time=0.145 ms</BASH>

Si la réponse est "Unreachable" alors les adresses ne sont pas correctement affectées ou un câble est défectueux
<BASH>ping 192.168.1.201
PING 192.168.1.201 (192.168.1.201) 56(84) bytes of data.
From 192.168.1.5 icmp_seq=1 Destination Host Unreachable</BASH>

===Freebox===
Connectez-vous sur votre compte à l'adresse http://portail.free.fr/

A renseigner

===Box SFR===
Il faut au préalable connecter l'armoire afin que la Box SFR lui affecte par défaut une adresse IP.
*Connecter vous sur votre Box SFR en tapant son IP et mettre l'identifiant et mot de passe (par défaut admin/admin qu'il est fortement conseillé de le changer)

A renseigner
=Configuration OpenFlyers=

==Navigateur==
Un point '''important''': le navigateur Internet Explorer ne permet pas la communication avec l'armoire. Ce navigateur ne possède pas les fonctions avancées du standard W3C que nous utilisons pour sécuriser les accès.

Firefox ou Chrome sont des navigateurs qui fonctionnent pour déclencher la libération des clés.

Le ou les PC du club devront être paramétrés pour que ce soient un de ces navigateur qui soit en service.

Comme il est difficile de bloquer Internet Explorer sous Windows il faudra clairement informer les utilisateurs du club
Les navigateurs récents implémentent désormais des règles de filtrage pour bloquer le contenu non sécurisé provenant d'une page HTTP chargé depuis une page HTTPS. C'est le cas avec le serveur OF ou l'URL est en HTTPS et celles de l'armoire en HTTP. Il faut donc configurer les navigateurs pour ne pas réagir à ce mixte d'adresse URL

===Firefox===
Dans la barre d'adresse, taper about:config
*Valider le message d'avertissement comme quoi vous devez faire Attention
*Rechercher le paramètre security.mixed_content
*Double cliquer sur le paramètre security.mixed_content.block_active_content pour qu'il passe à '''false'''.
*La ligne s'affiche en gras

===Chrome===
*Clique droit sur l’icône de Chrome
*Cliquer sur Propriétés
*Ajouter dans le champs Cible à la fin --allow-running-insecure-content
*Le champs cible resemblera donc à <BASH>"C:\Program Files (x86)\Google\Chrome\Application\chrome.exe" --allow-running-insecure-content</BASH>

==Paramétrage OF==

*Aller dans '''Admin > Configuration > Paramétrage'''
**Dans la section '''Gestion des vols''' et cliquer sur l'option '''Activé(e)''' de la rubrique '''Gestion armoire à clés'''.
[[Fichier:Config OF0.JPG]]
**Cliquer dans Valider, de nouveaux champs seront alors de nouveau visibles
[[Fichier:Config OF1.jpg]]
**Cliquer sur '''Activé(e)''' dans la rubrique '''Gestion des clés'''
**Choisissez la durée de temporisation pour prendre la clé, elle dépend de la distance entre votre PC et l'armoire. 10 à 20 secondes sont des valeurs usuelles
**Dans la rubrique '''Logiciel de contrôle de l'armoire à clés''' choisissez '''PyOpenKey2'''
**Dans la rubrique '''IP du PC contenant le logiciel de contrôle''' indiquer l'adresse IP du Module OF ''' 192.168.1.200''' (A adapter en fonction de votre réseaux)
**Dans la rubrique '''Port du PC contenant le logiciel de contrôle''' indiquer le port '''4080''' (ou autre si spécifié sur le bordereau de livraison)
**Cliquer dans ''''Valider''', 2 nouveaux champs seront alors de nouveau visibles
[[Fichier:Config OF.jpg]]
**Dans la rubrique '''Fermeture automatique des vols au retour de la clé''' cocher '''Désactivé(e)'''
**Dans la rubrique '''Phrase mot de passe''', saisissez la même phrase que celle qui vous aura été indiquée sur le bordereau de livraison
**Cliquer sur Valider
*Aller dans '''Admin > Utilisateurs > Profils''' et vérifier que le profil sous lequel vous êtes connecté possède le droit '''Gestion des clés''' dans l'onglet '''Généralité admin'''
*Pour initialiser les clés dans OpenFlyers il faut aller dans la page '''Admin > Ressources > Ressources > Actives'''
*Sélectionner un numéro de clé pour chaque avion
[[Fichier:Page Ressource.jpg]]

=Première connexion=
Faite une réinitialisation en débranchant l'alimentation puis en la reconnectant après 5 secondes
*Le voyant vert de l'armoire doit s'allumer après quelques minutes
*Le voyant orange reste allumé durant la phase de connexion au serveur OF et à la reconnaissance des tag RFID des clés
*A la fin de l'initialisation le voyant orange s’éteint

Si l'initialisation des Tags n'est pas reconnu les clés se déclencheront successivement

==Connexion interface Web==
Dans votre navigateur mettre l'URL du Module OF suivi du port 8000.
<BASH> 192.168.1.200:8000</BASH>
Vous arrivez sur une page permettant de libérer les clés indépendamment d'une connexion avec le serveur
Le mot de passe administrateur sera celui qui vous aura été confirmez avec le bordereau de livraison
*Cliquer sur RESET pour supprimer l'alarme de défaut
*Pour libérer une clé, sélectionner le numéro et cliquer sur le bouton « Libérer la clé »

[[Fichier:WebAdmin.jpg]]

==Initialisation des clès==
La position des tags sont enregistrées dans openflyers si un tag est reposé à un emplacement incorrect, un halo rouge autour de la clé s'allume ainsi qu'un le halo à l'emplacement normalement identifié. La clé incorrecte est automatiquement déverrouillée

[[Fichier:Clé rouge.JPG]]

Si vous voulez modifier cette ordre il faut réinitialiser le serveur avec votre nouvelle configuration. Vous devez mettre toutes les clés au tableau tel que vous le souhaitez. Ne vous pré-occupez pas des lumières rouges autour des tags

Pour refaire l'initialisation allez dans '''Admin > Ressources > Ressources > Actives'''
*Cliquez sur l'icône '''Activer les tags des clés'''

Les identifiants de chaque clé doivent apparaître après rafraîchissement de la page.

[[Fichier:Ressources activees.jpg]]

Débranchez de nouveau l'armoire pour refaire l'initialisation

=Prise de clé à l'ouverture d'un vol=
Pour un contrôle de la prise de clé par un utilisateur il faut que le logiciel soit paramétré avec l'option '''Ouverture et fermeture des vols.''' Aller dans '''Admin > Configuration > Paramètres''' et dans la rubrique '''Gestion des vols''' activer l'option '''Ouverture et fermeture de vol'''

[[Fichier:Gestion des vols.JPG]]

Pour une prise de clé il faut cliquer droit sur une réservation et choisir l'option Saisir un vol
La page de saisie d'un vol s'ouvre avec l'option Départ en vol
Renseigner les champs et cliquer sur Valider
Une page de prise de clé s'ouvrira

[[Fichier:Prise de cle.JPG]]

Cliquer sur le bouton Libérer la clé pour l'aéronef F-XXXX
La porte doit se déverrouiller (voyant orange) et la clé être libérer durant la temporisation prévue (clé entourée d'un halo lumineux rouge)
Refermer la porte sinon un buzzer intermittent retenti

Déconnectez-vous de OpenFlyers pour l'utilisateur suivant

=Retour de vol=

Pour remettre la clé, se connecter sur OpenFlyers
Cliquer sur l'icône Ouvrir la porte en haut à gauche de la page du cahier de réservation

[[Fichier:Ouvrir porte.JPG]]

La porte sera déverrouillé durant la durée de la temporisation
*Remettre la clé à son emplacement
*Si la clé est incorrectement placée, l'armoire déverrouille la clé (halo rouge de la clé reposée) et signale l'emplacement correct en allumant le halo rouge de l'emplacement prévu.
*Sur le planning l'avion en vol est indiquer par une couleur bleu. Survoler ce vol avec la souris
*Un menu apparait avec l'option '''Fermer le vol'''
*Cliquer et enregistré le vol

'''Note:''' Ne pas aller directement sur le menu '''Vols > Saisir un vol''' pour fermer le vol. Dans ce cas il ne pourra être établi de corrélation entre l'affichage du planning et le vol que vous fermez. Le vol restera ouvert (en bleu sur le planning) et l'avion sera bloqué pour repartir en vol. Néanmoins si un pilote faire l'erreur alors il faut, dans le menu surgissant, cliquer sur '''Annuler'''

=Finalisation=
*Ouvrir la porte de service
*Brancher le connecteur de la batterie de sauvegarde (Déconnecté pour le transport)

[[Fichier:Connecteur Batterie.JPG]]
*Refermer la porte de service

L'ouverture de la porte de service enclenche une alarme qui est mise en mémoire dans OF. Pour supprimer l'alarme il faut aller sur l'interface [[Installation_armoire_à_clés_Deister_ProxSafe#Connexion_interface_Web|Web admin]] et cliquer sur '''RESET'''

Fichier:Reseau W7.jpg

2014-01-18T22:19:19Z

Joel : a téléversé une nouvelle version de « Fichier:Reseau W7.jpg »

KeyPanel installation1

2014-01-18T22:18:24Z

Joel : /* Finalisation */

L'armoire à clé [[Media:Deister_ProxSafe_Smart3U.pdf|ProxSafe Smart3U]]? de Deister permet la gestion de 8, 16 ou 32 clés avec l'application openFlyers

Existe aussi en version [[Media:Deister_ProxSafe_Mini3U.pdf|ProxSafe_Mini 3U]]? avec 8 à 16 clés de format plus réduit

Le modèle fournis via OpenFlyers ne comporte pas le Lecteur Deister mais un Module OF permettant le dialogue avec nos serveurs
= Connexions de l'armoire=
Rendre la clé dans la pochette fixée sur l'armoire et ouvrir la porte de service. Les câbles suivants doivent être passés avant la fixation définitive au mur.
*Alimentation
*Câble Ethernet en provenance de votre routeur pour l'armoire
*Câble Ethernet en provenance de votre routeur pour le module OF
Fixer l'armoire au mur par 4 chevilles et vis en ayant au préalable retirer l’adhésif de maintien de l’interrupteur qui détectera une tentative de vandalisme
*Vérifier que la carte SD est correctement enfichée dans son logement
*Brancher un câble Ethernet sur le Module OF

[[Fichier:Connexion rj45 OF.jpg]]
*Brancher un câble Ethernet sur l'armoire

[[Fichier:Connexion rj45masterplane.jpg]]
*Brancher le câble d'alimentation 220V

[[Fichier:Alim.JPG]]
*Refermer la porte de service
*Brancher la prise d'alimentation sur le secteur
A l'initialisation de l'armoire le voyant jaune de la face avant clignote puis passe au jaune fixe

= Préparation du réseau=
L'armoire à clés demande 2 connexions au réseau local, une pour le Module OF et une pour l'armoire à clés. Ils sont configurés en DHCP ce qui signifie qu'ils seront automatiquement reconnus par le réseau à chaque connexion et qu'une adresse IP leur sera affecté.

Cependant pour qu'ils puissent communiquer avec le logiciel OpenFlyers les équipements doivent avoir une adresse IP identique à chaque mise en route du routeur. Pour forcer le routeur à attribuer toujours la même adresse IP à un équipement il faut le configurer en créant l'association d'une [http://fr.wikipedia.org/wiki/Adresse_IP IP] à l'adresse [http://fr.wikipedia.org/wiki/Adresse_MAC MAC] du materiel.

Les adresses IP et MAC à configurer vous sont communiquées dans l'email confirmant l'envoi de l'armoire à clés et sur le bordereau de livraison, Ceci ce fait dans votre routeur ou la box de votre provider et dépend du matériel que vous disposez
==Idendification de l'adresse IP==
Pour connaître l'adresse IP de sa passerelle (box ou routeur).
===Sous Windows 7===
Pour les inconditionnels de l'interface graphique
*Cliquer sur le bouton '''Démarrer'''
*cliquer sur '''Panneau de configuration'''
*Cliquer sur '''Réseau et Internet'''
*Cliquer sur '''Centre de réseau et partage'''
*Cliquer sur '''Afficher l'intégralité du réseau''' dan
Survoler l’icône Passerelle et vous aurez l'adresse IP de votre matériel dans le message

[[Image:Reseau_W7.jpg?]]

Pour les fans de l'efficacité
*Cliquer sur le bouton '''Démarrer'''
*Dans le champs Rechercher taper '''cmd''' puis faite "Entrer" pour ouvrir la console DOS.
*Taper « netstat -r -n » qui affrichera la table de routage
L'adresse de votre routeur est indiquée à la colonne "Adr. passerelle" de la table de routage

[[Image:Table_routage_windows.jpg? ?]]
===Sous Linux===
*Ouvrir votre console
*Taper « netstat -r -n »
*L'adresse Ip est dans la colonne Gateway

[[Image:Reseau_Linux.jpg?]]
==Configuration du routeur==
===Livebox Orange===
Il y a de nombreux modèle de Livebox, voici un lien ou vous pouvez identifier votre [http://assistance.orange.fr/livebox-tous-les-modeles-524.php Modèle de Livebox]

Il y a généralement deux endroits pour configurer les IP en fonction des adresses MAC:
*celle pour le filtrage du réseau Wifi (WAN). Ceci ne fonctionnera pas pour le réseau filaire (LAN)
*celle permettant de mettre une IP statique (valide pour le wifi et le LAN). C'est cette configuration qu'il faut faire

====Livebox 2 de Sagem====
Il faut au préalable connecter l'armoire afin que la Livebox lui affecte par défaut une adresse IP.
*Connecter vous sur votre Livebox en tapant son IP et mettre l'identifiant et mot de passe (par défaut admin/admin qu'il est fortement conseillé de le changer)
*Aller dans
** Onglet Configuration
** Menu de gauche Réseaux & Services > Équipements > Visualiser
** Deux nouveaux icônes doivent apparaitre
** Cliquer dessus un des icône et vérifier à qu'elle matériel cette adresse MAC correspond (inscrit sur votre bordereau de livraison)
** Renommer les en "Armoire à clés" et "Module OF" pour une identification plus aisée. Orange a rajouté ses propres noms qui ne simplifient pas la reconnaissance du matériel !!!

*Ensuite aller dans:
** Onglet Configuration
** Menu de gauche Réseaux & Services > Livebox > Paramètres avancés
** Onglet DHCP
** Section Adresse IP statique
** Cliquer sur ajouter
[[Fichier:LiveBox.JPG]]
** Sélectionner dans le menu déroulant: Armoire à clés
** Mettre l'adresse 192.168.1.201
** Cliquer sur ajouter
** Sélectionner dans le menu déroulant: Daemon RPi
** Mettre l'adresse 192.168.1.200
** Sauver

Ensuite réinitialiser votre LiveBox

Vérifier la prise en compte de ces paramètres en allant dans
*Onglet Configuration
*Menu de gauche Réseaux & Services > Équipements > Visualiser
*Cliquer sur les icônes Daemon RPi et Armoire à cles. Vous devez avoir les adresses IP en 192.168.1.200 et 192.168.1.201

Note: L'interface d'Orange est faillible, nous avons constaté que leur interface indique que l'armoire n'était pas connecté alors qu'elle l'était. Vous pouvez vérifier cela indépendament de leur interface en allant avec un interface de ligne de commande et en faisant in ping des adresses
<BASH>ping 192.168.1.200
PING 192.168.1.200 (192.168.1.200) 56(84) bytes of data.
64 bytes from 192.168.1.5: icmp_req=1 ttl=64 time=0.241 ms
64 bytes from 192.168.1.5: icmp_req=2 ttl=64 time=0.143 ms
64 bytes from 192.168.1.5: icmp_req=3 ttl=64 time=0.144 ms
64 bytes from 192.168.1.5: icmp_req=4 ttl=64 time=0.145 ms

ping 192.168.1.201
PING 192.168.1.201 (192.168.1.201) 56(84) bytes of data.
64 bytes from 192.168.1.5: icmp_req=1 ttl=64 time=0.241 ms
64 bytes from 192.168.1.5: icmp_req=2 ttl=64 time=0.143 ms
64 bytes from 192.168.1.5: icmp_req=3 ttl=64 time=0.144 ms
64 bytes from 192.168.1.5: icmp_req=4 ttl=64 time=0.145 ms</BASH>

Si la réponse est "Unreachable" alors les adresses ne sont pas correctement affectées ou un câble est défectueux
<BASH>ping 192.168.1.201
PING 192.168.1.201 (192.168.1.201) 56(84) bytes of data.
From 192.168.1.5 icmp_seq=1 Destination Host Unreachable</BASH>

===Freebox===
Connectez-vous sur votre compte à l'adresse http://portail.free.fr/

A renseigner

===Box SFR===
Il faut au préalable connecter l'armoire afin que la Box SFR lui affecte par défaut une adresse IP.
*Connecter vous sur votre Box SFR en tapant son IP et mettre l'identifiant et mot de passe (par défaut admin/admin qu'il est fortement conseillé de le changer)

A renseigner
=Configuration OpenFlyers=

==Navigateur==
Un point '''important''': le navigateur Internet Explorer ne permet pas la communication avec l'armoire. Ce navigateur ne possède pas les fonctions avancées du standard W3C que nous utilisons pour sécuriser les accès.

Firefox ou Chrome sont des navigateurs qui fonctionnent pour déclencher la libération des clés.

Le ou les PC du club devront être paramétrés pour que ce soient un de ces navigateur qui soit en service.

Comme il est difficile de bloquer Internet Explorer sous Windows il faudra clairement informer les utilisateurs du club
Les navigateurs récents implémentent désormais des règles de filtrage pour bloquer le contenu non sécurisé provenant d'une page HTTP chargé depuis une page HTTPS. C'est le cas avec le serveur OF ou l'URL est en HTTPS et celles de l'armoire en HTTP. Il faut donc configurer les navigateurs pour ne pas réagir à ce mixte d'adresse URL

===Firefox===
Dans la barre d'adresse, taper about:config
*Valider le message d'avertissement comme quoi vous devez faire Attention
*Rechercher le paramètre security.mixed_content
*Double cliquer sur le paramètre security.mixed_content.block_active_content pour qu'il passe à '''false'''.
*La ligne s'affiche en gras

===Chrome===
*Clique droit sur l’icône de Chrome
*Cliquer sur Propriétés
*Ajouter dans le champs Cible à la fin --allow-running-insecure-content
*Le champs cible resemblera donc à <BASH>"C:\Program Files (x86)\Google\Chrome\Application\chrome.exe" --allow-running-insecure-content</BASH>

==Paramétrage OF==

*Aller dans '''Admin > Configuration > Paramétrage'''
**Dans la section '''Gestion des vols''' et cliquer sur l'option '''Activé(e)''' de la rubrique '''Gestion armoire à clés'''.
[[Fichier:Config OF0.JPG]]
**Cliquer dans Valider, de nouveaux champs seront alors de nouveau visibles
[[Fichier:Config OF1.jpg]]
**Cliquer sur '''Activé(e)''' dans la rubrique '''Gestion des clés'''
**Choisissez la durée de temporisation pour prendre la clé, elle dépend de la distance entre votre PC et l'armoire. 10 à 20 secondes sont des valeurs usuelles
**Dans la rubrique '''Logiciel de contrôle de l'armoire à clés''' choisissez '''PyOpenKey2'''
**Dans la rubrique '''IP du PC contenant le logiciel de contrôle''' indiquer l'adresse IP du Module OF ''' 192.168.1.200''' (A adapter en fonction de votre réseaux)
**Dans la rubrique '''Port du PC contenant le logiciel de contrôle''' indiquer le port '''4080''' (ou autre si spécifié sur le bordereau de livraison)
**Cliquer dans ''''Valider''', 2 nouveaux champs seront alors de nouveau visibles
[[Fichier:Config OF.jpg]]
**Dans la rubrique '''Fermeture automatique des vols au retour de la clé''' cocher '''Désactivé(e)'''
**Dans la rubrique '''Phrase mot de passe''', saisissez la même phrase que celle qui vous aura été indiquée sur le bordereau de livraison
**Cliquer sur Valider
*Aller dans '''Admin > Utilisateurs > Profils''' et vérifier que le profil sous lequel vous êtes connecté possède le droit '''Gestion des clés''' dans l'onglet '''Généralité admin'''
*Pour initialiser les clés dans OpenFlyers il faut aller dans la page '''Admin > Ressources > Ressources > Actives'''
*Sélectionner un numéro de clé pour chaque avion
[[Fichier:Page Ressource.jpg]]

=Première connexion=
Faite une réinitialisation en débranchant l'alimentation puis en la reconnectant après 5 secondes
*Le voyant vert de l'armoire doit s'allumer après quelques minutes
*Le voyant orange reste allumé durant la phase de connexion au serveur OF et à la reconnaissance des tag RFID des clés
*A la fin de l'initialisation le voyant orange s’éteint

Si l'initialisation des Tags n'est pas reconnu les clés se déclencheront successivement

==Connexion interface Web==
Dans votre navigateur mettre l'URL du Module OF suivi du port 8000.
<BASH> 192.168.1.200:8000</BASH>
Vous arrivez sur une page permettant de libérer les clés indépendamment d'une connexion avec le serveur
Le mot de passe administrateur sera celui qui vous aura été confirmez avec le bordereau de livraison
*Cliquer sur RESET pour supprimer l'alarme de défaut
*Pour libérer une clé, sélectionner le numéro et cliquer sur le bouton « Libérer la clé »

[[Fichier:WebAdmin.jpg]]

==Initialisation des clès==
La position des tags sont enregistrées dans openflyers si un tag est reposé à un emplacement incorrect, un halo rouge autour de la clé s'allume ainsi qu'un le halo à l'emplacement normalement identifié. La clé incorrecte est automatiquement déverrouillée

[[Fichier:Clé rouge.JPG]]

Si vous voulez modifier cette ordre il faut réinitialiser le serveur avec votre nouvelle configuration. Vous devez mettre toutes les clés au tableau tel que vous le souhaitez. Ne vous pré-occupez pas des lumières rouges autour des tags

Pour refaire l'initialisation allez dans '''Admin > Ressources > Ressources > Actives'''
*Cliquez sur l'icône '''Activer les tags des clés'''

Les identifiants de chaque clé doivent apparaître après rafraîchissement de la page.

[[Fichier:Ressources activees.jpg]]

Débranchez de nouveau l'armoire pour refaire l'initialisation

=Prise de clé à l'ouverture d'un vol=
Pour un contrôle de la prise de clé par un utilisateur il faut que le logiciel soit paramétré avec l'option '''Ouverture et fermeture des vols.''' Aller dans '''Admin > Configuration > Paramètres''' et dans la rubrique '''Gestion des vols''' activer l'option '''Ouverture et fermeture de vol'''

[[Fichier:Gestion des vols.JPG]]

Pour une prise de clé il faut cliquer droit sur une réservation et choisir l'option Saisir un vol
La page de saisie d'un vol s'ouvre avec l'option Départ en vol
Renseigner les champs et cliquer sur Valider
Une page de prise de clé s'ouvrira

[[Fichier:Prise de cle.JPG]]

Cliquer sur le bouton Libérer la clé pour l'aéronef F-XXXX
La porte doit se déverrouiller (voyant orange) et la clé être libérer durant la temporisation prévue (clé entourée d'un halo lumineux rouge)
Refermer la porte sinon un buzzer intermittent retenti

Déconnectez-vous de OpenFlyers pour l'utilisateur suivant

=Retour de vol=

Pour remettre la clé, se connecter sur OpenFlyers
Cliquer sur l'icône Ouvrir la porte en haut à gauche de la page du cahier de réservation

[[Fichier:Ouvrir porte.JPG]]

La porte sera déverrouillé durant la durée de la temporisation
*Remettre la clé à son emplacement
*Si la clé est incorrectement placée, l'armoire déverrouille la clé (halo rouge de la clé reposée) et signale l'emplacement correct en allumant le halo rouge de l'emplacement prévu.
*Sur le planning l'avion en vol est indiquer par une couleur bleu. Survoler ce vol avec la souris
*Un menu apparait avec l'option '''Fermer le vol'''
*Cliquer et enregistré le vol

'''Note:''' Ne pas aller directement sur le menu '''Vols > Saisir un vol''' pour fermer le vol. Dans ce cas il ne pourra être établi de corrélation entre l'affichage du planning et le vol que vous fermez. Le vol restera ouvert (en bleu sur le planning) et l'avion sera bloqué pour repartir en vol. Néanmoins si un pilote faire l'erreur alors il faut, dans le menu surgissant, cliquer sur '''Annuler'''

=Finalisation=
*Ouvrir la porte de service
*Brancher le connecteur de la batterie de sauvegarde (Déconnecté pour le transport)

[[Fichier:Connecteur Batterie.JPG]]
*Refermer la porte de service

L'ouverture de la porte de service enclenche une alarme qui est mise en mémoire dans OF. Pour supprimer l'alarme il faut aller sur l'interface [[Installation_armoire_à_clés_Deister_ProxSafe#Connexion_interface_Web|Web admin]] et cliquer sur '''RESET'''

KeyPanel installation1

2014-01-18T22:17:12Z

Joel : /* Finalisation */

L'armoire à clé [[Media:Deister_ProxSafe_Smart3U.pdf|ProxSafe Smart3U]]? de Deister permet la gestion de 8, 16 ou 32 clés avec l'application openFlyers

Existe aussi en version [[Media:Deister_ProxSafe_Mini3U.pdf|ProxSafe_Mini 3U]]? avec 8 à 16 clés de format plus réduit

Le modèle fournis via OpenFlyers ne comporte pas le Lecteur Deister mais un Module OF permettant le dialogue avec nos serveurs
= Connexions de l'armoire=
Rendre la clé dans la pochette fixée sur l'armoire et ouvrir la porte de service. Les câbles suivants doivent être passés avant la fixation définitive au mur.
*Alimentation
*Câble Ethernet en provenance de votre routeur pour l'armoire
*Câble Ethernet en provenance de votre routeur pour le module OF
Fixer l'armoire au mur par 4 chevilles et vis en ayant au préalable retirer l’adhésif de maintien de l’interrupteur qui détectera une tentative de vandalisme
*Vérifier que la carte SD est correctement enfichée dans son logement
*Brancher un câble Ethernet sur le Module OF

[[Fichier:Connexion rj45 OF.jpg]]
*Brancher un câble Ethernet sur l'armoire

[[Fichier:Connexion rj45masterplane.jpg]]
*Brancher le câble d'alimentation 220V

[[Fichier:Alim.JPG]]
*Refermer la porte de service
*Brancher la prise d'alimentation sur le secteur
A l'initialisation de l'armoire le voyant jaune de la face avant clignote puis passe au jaune fixe

= Préparation du réseau=
L'armoire à clés demande 2 connexions au réseau local, une pour le Module OF et une pour l'armoire à clés. Ils sont configurés en DHCP ce qui signifie qu'ils seront automatiquement reconnus par le réseau à chaque connexion et qu'une adresse IP leur sera affecté.

Cependant pour qu'ils puissent communiquer avec le logiciel OpenFlyers les équipements doivent avoir une adresse IP identique à chaque mise en route du routeur. Pour forcer le routeur à attribuer toujours la même adresse IP à un équipement il faut le configurer en créant l'association d'une [http://fr.wikipedia.org/wiki/Adresse_IP IP] à l'adresse [http://fr.wikipedia.org/wiki/Adresse_MAC MAC] du materiel.

Les adresses IP et MAC à configurer vous sont communiquées dans l'email confirmant l'envoi de l'armoire à clés et sur le bordereau de livraison, Ceci ce fait dans votre routeur ou la box de votre provider et dépend du matériel que vous disposez
==Idendification de l'adresse IP==
Pour connaître l'adresse IP de sa passerelle (box ou routeur).
===Sous Windows 7===
Pour les inconditionnels de l'interface graphique
*Cliquer sur le bouton '''Démarrer'''
*cliquer sur '''Panneau de configuration'''
*Cliquer sur '''Réseau et Internet'''
*Cliquer sur '''Centre de réseau et partage'''
*Cliquer sur '''Afficher l'intégralité du réseau''' dan
Survoler l’icône Passerelle et vous aurez l'adresse IP de votre matériel dans le message

[[Image:Reseau_W7.jpg?]]

Pour les fans de l'efficacité
*Cliquer sur le bouton '''Démarrer'''
*Dans le champs Rechercher taper '''cmd''' puis faite "Entrer" pour ouvrir la console DOS.
*Taper « netstat -r -n » qui affrichera la table de routage
L'adresse de votre routeur est indiquée à la colonne "Adr. passerelle" de la table de routage

[[Image:Table_routage_windows.jpg? ?]]
===Sous Linux===
*Ouvrir votre console
*Taper « netstat -r -n »
*L'adresse Ip est dans la colonne Gateway

[[Image:Reseau_Linux.jpg?]]
==Configuration du routeur==
===Livebox Orange===
Il y a de nombreux modèle de Livebox, voici un lien ou vous pouvez identifier votre [http://assistance.orange.fr/livebox-tous-les-modeles-524.php Modèle de Livebox]

Il y a généralement deux endroits pour configurer les IP en fonction des adresses MAC:
*celle pour le filtrage du réseau Wifi (WAN). Ceci ne fonctionnera pas pour le réseau filaire (LAN)
*celle permettant de mettre une IP statique (valide pour le wifi et le LAN). C'est cette configuration qu'il faut faire

====Livebox 2 de Sagem====
Il faut au préalable connecter l'armoire afin que la Livebox lui affecte par défaut une adresse IP.
*Connecter vous sur votre Livebox en tapant son IP et mettre l'identifiant et mot de passe (par défaut admin/admin qu'il est fortement conseillé de le changer)
*Aller dans
** Onglet Configuration
** Menu de gauche Réseaux & Services > Équipements > Visualiser
** Deux nouveaux icônes doivent apparaitre
** Cliquer dessus un des icône et vérifier à qu'elle matériel cette adresse MAC correspond (inscrit sur votre bordereau de livraison)
** Renommer les en "Armoire à clés" et "Module OF" pour une identification plus aisée. Orange a rajouté ses propres noms qui ne simplifient pas la reconnaissance du matériel !!!

*Ensuite aller dans:
** Onglet Configuration
** Menu de gauche Réseaux & Services > Livebox > Paramètres avancés
** Onglet DHCP
** Section Adresse IP statique
** Cliquer sur ajouter
[[Fichier:LiveBox.JPG]]
** Sélectionner dans le menu déroulant: Armoire à clés
** Mettre l'adresse 192.168.1.201
** Cliquer sur ajouter
** Sélectionner dans le menu déroulant: Daemon RPi
** Mettre l'adresse 192.168.1.200
** Sauver

Ensuite réinitialiser votre LiveBox

Vérifier la prise en compte de ces paramètres en allant dans
*Onglet Configuration
*Menu de gauche Réseaux & Services > Équipements > Visualiser
*Cliquer sur les icônes Daemon RPi et Armoire à cles. Vous devez avoir les adresses IP en 192.168.1.200 et 192.168.1.201

Note: L'interface d'Orange est faillible, nous avons constaté que leur interface indique que l'armoire n'était pas connecté alors qu'elle l'était. Vous pouvez vérifier cela indépendament de leur interface en allant avec un interface de ligne de commande et en faisant in ping des adresses
<BASH>ping 192.168.1.200
PING 192.168.1.200 (192.168.1.200) 56(84) bytes of data.
64 bytes from 192.168.1.5: icmp_req=1 ttl=64 time=0.241 ms
64 bytes from 192.168.1.5: icmp_req=2 ttl=64 time=0.143 ms
64 bytes from 192.168.1.5: icmp_req=3 ttl=64 time=0.144 ms
64 bytes from 192.168.1.5: icmp_req=4 ttl=64 time=0.145 ms

ping 192.168.1.201
PING 192.168.1.201 (192.168.1.201) 56(84) bytes of data.
64 bytes from 192.168.1.5: icmp_req=1 ttl=64 time=0.241 ms
64 bytes from 192.168.1.5: icmp_req=2 ttl=64 time=0.143 ms
64 bytes from 192.168.1.5: icmp_req=3 ttl=64 time=0.144 ms
64 bytes from 192.168.1.5: icmp_req=4 ttl=64 time=0.145 ms</BASH>

Si la réponse est "Unreachable" alors les adresses ne sont pas correctement affectées ou un câble est défectueux
<BASH>ping 192.168.1.201
PING 192.168.1.201 (192.168.1.201) 56(84) bytes of data.
From 192.168.1.5 icmp_seq=1 Destination Host Unreachable</BASH>

===Freebox===
Connectez-vous sur votre compte à l'adresse http://portail.free.fr/

A renseigner

===Box SFR===
Il faut au préalable connecter l'armoire afin que la Box SFR lui affecte par défaut une adresse IP.
*Connecter vous sur votre Box SFR en tapant son IP et mettre l'identifiant et mot de passe (par défaut admin/admin qu'il est fortement conseillé de le changer)

A renseigner
=Configuration OpenFlyers=

==Navigateur==
Un point '''important''': le navigateur Internet Explorer ne permet pas la communication avec l'armoire. Ce navigateur ne possède pas les fonctions avancées du standard W3C que nous utilisons pour sécuriser les accès.

Firefox ou Chrome sont des navigateurs qui fonctionnent pour déclencher la libération des clés.

Le ou les PC du club devront être paramétrés pour que ce soient un de ces navigateur qui soit en service.

Comme il est difficile de bloquer Internet Explorer sous Windows il faudra clairement informer les utilisateurs du club
Les navigateurs récents implémentent désormais des règles de filtrage pour bloquer le contenu non sécurisé provenant d'une page HTTP chargé depuis une page HTTPS. C'est le cas avec le serveur OF ou l'URL est en HTTPS et celles de l'armoire en HTTP. Il faut donc configurer les navigateurs pour ne pas réagir à ce mixte d'adresse URL

===Firefox===
Dans la barre d'adresse, taper about:config
*Valider le message d'avertissement comme quoi vous devez faire Attention
*Rechercher le paramètre security.mixed_content
*Double cliquer sur le paramètre security.mixed_content.block_active_content pour qu'il passe à '''false'''.
*La ligne s'affiche en gras

===Chrome===
*Clique droit sur l’icône de Chrome
*Cliquer sur Propriétés
*Ajouter dans le champs Cible à la fin --allow-running-insecure-content
*Le champs cible resemblera donc à <BASH>"C:\Program Files (x86)\Google\Chrome\Application\chrome.exe" --allow-running-insecure-content</BASH>

==Paramétrage OF==

*Aller dans '''Admin > Configuration > Paramétrage'''
**Dans la section '''Gestion des vols''' et cliquer sur l'option '''Activé(e)''' de la rubrique '''Gestion armoire à clés'''.
[[Fichier:Config OF0.JPG]]
**Cliquer dans Valider, de nouveaux champs seront alors de nouveau visibles
[[Fichier:Config OF1.jpg]]
**Cliquer sur '''Activé(e)''' dans la rubrique '''Gestion des clés'''
**Choisissez la durée de temporisation pour prendre la clé, elle dépend de la distance entre votre PC et l'armoire. 10 à 20 secondes sont des valeurs usuelles
**Dans la rubrique '''Logiciel de contrôle de l'armoire à clés''' choisissez '''PyOpenKey2'''
**Dans la rubrique '''IP du PC contenant le logiciel de contrôle''' indiquer l'adresse IP du Module OF ''' 192.168.1.200''' (A adapter en fonction de votre réseaux)
**Dans la rubrique '''Port du PC contenant le logiciel de contrôle''' indiquer le port '''4080''' (ou autre si spécifié sur le bordereau de livraison)
**Cliquer dans ''''Valider''', 2 nouveaux champs seront alors de nouveau visibles
[[Fichier:Config OF.jpg]]
**Dans la rubrique '''Fermeture automatique des vols au retour de la clé''' cocher '''Désactivé(e)'''
**Dans la rubrique '''Phrase mot de passe''', saisissez la même phrase que celle qui vous aura été indiquée sur le bordereau de livraison
**Cliquer sur Valider
*Aller dans '''Admin > Utilisateurs > Profils''' et vérifier que le profil sous lequel vous êtes connecté possède le droit '''Gestion des clés''' dans l'onglet '''Généralité admin'''
*Pour initialiser les clés dans OpenFlyers il faut aller dans la page '''Admin > Ressources > Ressources > Actives'''
*Sélectionner un numéro de clé pour chaque avion
[[Fichier:Page Ressource.jpg]]

=Première connexion=
Faite une réinitialisation en débranchant l'alimentation puis en la reconnectant après 5 secondes
*Le voyant vert de l'armoire doit s'allumer après quelques minutes
*Le voyant orange reste allumé durant la phase de connexion au serveur OF et à la reconnaissance des tag RFID des clés
*A la fin de l'initialisation le voyant orange s’éteint

Si l'initialisation des Tags n'est pas reconnu les clés se déclencheront successivement

==Connexion interface Web==
Dans votre navigateur mettre l'URL du Module OF suivi du port 8000.
<BASH> 192.168.1.200:8000</BASH>
Vous arrivez sur une page permettant de libérer les clés indépendamment d'une connexion avec le serveur
Le mot de passe administrateur sera celui qui vous aura été confirmez avec le bordereau de livraison
*Cliquer sur RESET pour supprimer l'alarme de défaut
*Pour libérer une clé, sélectionner le numéro et cliquer sur le bouton « Libérer la clé »

[[Fichier:WebAdmin.jpg]]

==Initialisation des clès==
La position des tags sont enregistrées dans openflyers si un tag est reposé à un emplacement incorrect, un halo rouge autour de la clé s'allume ainsi qu'un le halo à l'emplacement normalement identifié. La clé incorrecte est automatiquement déverrouillée

[[Fichier:Clé rouge.JPG]]

Si vous voulez modifier cette ordre il faut réinitialiser le serveur avec votre nouvelle configuration. Vous devez mettre toutes les clés au tableau tel que vous le souhaitez. Ne vous pré-occupez pas des lumières rouges autour des tags

Pour refaire l'initialisation allez dans '''Admin > Ressources > Ressources > Actives'''
*Cliquez sur l'icône '''Activer les tags des clés'''

Les identifiants de chaque clé doivent apparaître après rafraîchissement de la page.

[[Fichier:Ressources activees.jpg]]

Débranchez de nouveau l'armoire pour refaire l'initialisation

=Prise de clé à l'ouverture d'un vol=
Pour un contrôle de la prise de clé par un utilisateur il faut que le logiciel soit paramétré avec l'option '''Ouverture et fermeture des vols.''' Aller dans '''Admin > Configuration > Paramètres''' et dans la rubrique '''Gestion des vols''' activer l'option '''Ouverture et fermeture de vol'''

[[Fichier:Gestion des vols.JPG]]

Pour une prise de clé il faut cliquer droit sur une réservation et choisir l'option Saisir un vol
La page de saisie d'un vol s'ouvre avec l'option Départ en vol
Renseigner les champs et cliquer sur Valider
Une page de prise de clé s'ouvrira

[[Fichier:Prise de cle.JPG]]

Cliquer sur le bouton Libérer la clé pour l'aéronef F-XXXX
La porte doit se déverrouiller (voyant orange) et la clé être libérer durant la temporisation prévue (clé entourée d'un halo lumineux rouge)
Refermer la porte sinon un buzzer intermittent retenti

Déconnectez-vous de OpenFlyers pour l'utilisateur suivant

=Retour de vol=

Pour remettre la clé, se connecter sur OpenFlyers
Cliquer sur l'icône Ouvrir la porte en haut à gauche de la page du cahier de réservation

[[Fichier:Ouvrir porte.JPG]]

La porte sera déverrouillé durant la durée de la temporisation
*Remettre la clé à son emplacement
*Si la clé est incorrectement placée, l'armoire déverrouille la clé (halo rouge de la clé reposée) et signale l'emplacement correct en allumant le halo rouge de l'emplacement prévu.
*Sur le planning l'avion en vol est indiquer par une couleur bleu. Survoler ce vol avec la souris
*Un menu apparait avec l'option '''Fermer le vol'''
*Cliquer et enregistré le vol

'''Note:''' Ne pas aller directement sur le menu '''Vols > Saisir un vol''' pour fermer le vol. Dans ce cas il ne pourra être établi de corrélation entre l'affichage du planning et le vol que vous fermez. Le vol restera ouvert (en bleu sur le planning) et l'avion sera bloqué pour repartir en vol. Néanmoins si un pilote faire l'erreur alors il faut, dans le menu surgissant, cliquer sur '''Annuler'''

=Finalisation=
*Ouvrir la porte de service
*Brancher le connecteur de la batterie de sauvegarde (Déconnecté pour le transport)

[[Fichier:Connecteur Batterie.JPG]]
*Refermer la porte de service

L'ouverture de la porte de service enclenche une alarme qui est mise en mémoire dans OF. Pour supprimer l'alarme il faut aller sur l'interface [[Installation_armoire_à_clés_Deister_ProxSafe#Connexion_interface_Web|Web admin]] et cliquer sur '''Reset'''

KeyPanel installation1

2014-01-18T22:14:34Z

Joel : /* Finalisation */

L'armoire à clé [[Media:Deister_ProxSafe_Smart3U.pdf|ProxSafe Smart3U]]? de Deister permet la gestion de 8, 16 ou 32 clés avec l'application openFlyers

Existe aussi en version [[Media:Deister_ProxSafe_Mini3U.pdf|ProxSafe_Mini 3U]]? avec 8 à 16 clés de format plus réduit

Le modèle fournis via OpenFlyers ne comporte pas le Lecteur Deister mais un Module OF permettant le dialogue avec nos serveurs
= Connexions de l'armoire=
Rendre la clé dans la pochette fixée sur l'armoire et ouvrir la porte de service. Les câbles suivants doivent être passés avant la fixation définitive au mur.
*Alimentation
*Câble Ethernet en provenance de votre routeur pour l'armoire
*Câble Ethernet en provenance de votre routeur pour le module OF
Fixer l'armoire au mur par 4 chevilles et vis en ayant au préalable retirer l’adhésif de maintien de l’interrupteur qui détectera une tentative de vandalisme
*Vérifier que la carte SD est correctement enfichée dans son logement
*Brancher un câble Ethernet sur le Module OF

[[Fichier:Connexion rj45 OF.jpg]]
*Brancher un câble Ethernet sur l'armoire

[[Fichier:Connexion rj45masterplane.jpg]]
*Brancher le câble d'alimentation 220V

[[Fichier:Alim.JPG]]
*Refermer la porte de service
*Brancher la prise d'alimentation sur le secteur
A l'initialisation de l'armoire le voyant jaune de la face avant clignote puis passe au jaune fixe

= Préparation du réseau=
L'armoire à clés demande 2 connexions au réseau local, une pour le Module OF et une pour l'armoire à clés. Ils sont configurés en DHCP ce qui signifie qu'ils seront automatiquement reconnus par le réseau à chaque connexion et qu'une adresse IP leur sera affecté.

Cependant pour qu'ils puissent communiquer avec le logiciel OpenFlyers les équipements doivent avoir une adresse IP identique à chaque mise en route du routeur. Pour forcer le routeur à attribuer toujours la même adresse IP à un équipement il faut le configurer en créant l'association d'une [http://fr.wikipedia.org/wiki/Adresse_IP IP] à l'adresse [http://fr.wikipedia.org/wiki/Adresse_MAC MAC] du materiel.

Les adresses IP et MAC à configurer vous sont communiquées dans l'email confirmant l'envoi de l'armoire à clés et sur le bordereau de livraison, Ceci ce fait dans votre routeur ou la box de votre provider et dépend du matériel que vous disposez
==Idendification de l'adresse IP==
Pour connaître l'adresse IP de sa passerelle (box ou routeur).
===Sous Windows 7===
Pour les inconditionnels de l'interface graphique
*Cliquer sur le bouton '''Démarrer'''
*cliquer sur '''Panneau de configuration'''
*Cliquer sur '''Réseau et Internet'''
*Cliquer sur '''Centre de réseau et partage'''
*Cliquer sur '''Afficher l'intégralité du réseau''' dan
Survoler l’icône Passerelle et vous aurez l'adresse IP de votre matériel dans le message

[[Image:Reseau_W7.jpg?]]

Pour les fans de l'efficacité
*Cliquer sur le bouton '''Démarrer'''
*Dans le champs Rechercher taper '''cmd''' puis faite "Entrer" pour ouvrir la console DOS.
*Taper « netstat -r -n » qui affrichera la table de routage
L'adresse de votre routeur est indiquée à la colonne "Adr. passerelle" de la table de routage

[[Image:Table_routage_windows.jpg? ?]]
===Sous Linux===
*Ouvrir votre console
*Taper « netstat -r -n »
*L'adresse Ip est dans la colonne Gateway

[[Image:Reseau_Linux.jpg?]]
==Configuration du routeur==
===Livebox Orange===
Il y a de nombreux modèle de Livebox, voici un lien ou vous pouvez identifier votre [http://assistance.orange.fr/livebox-tous-les-modeles-524.php Modèle de Livebox]

Il y a généralement deux endroits pour configurer les IP en fonction des adresses MAC:
*celle pour le filtrage du réseau Wifi (WAN). Ceci ne fonctionnera pas pour le réseau filaire (LAN)
*celle permettant de mettre une IP statique (valide pour le wifi et le LAN). C'est cette configuration qu'il faut faire

====Livebox 2 de Sagem====
Il faut au préalable connecter l'armoire afin que la Livebox lui affecte par défaut une adresse IP.
*Connecter vous sur votre Livebox en tapant son IP et mettre l'identifiant et mot de passe (par défaut admin/admin qu'il est fortement conseillé de le changer)
*Aller dans
** Onglet Configuration
** Menu de gauche Réseaux & Services > Équipements > Visualiser
** Deux nouveaux icônes doivent apparaitre
** Cliquer dessus un des icône et vérifier à qu'elle matériel cette adresse MAC correspond (inscrit sur votre bordereau de livraison)
** Renommer les en "Armoire à clés" et "Module OF" pour une identification plus aisée. Orange a rajouté ses propres noms qui ne simplifient pas la reconnaissance du matériel !!!

*Ensuite aller dans:
** Onglet Configuration
** Menu de gauche Réseaux & Services > Livebox > Paramètres avancés
** Onglet DHCP
** Section Adresse IP statique
** Cliquer sur ajouter
[[Fichier:LiveBox.JPG]]
** Sélectionner dans le menu déroulant: Armoire à clés
** Mettre l'adresse 192.168.1.201
** Cliquer sur ajouter
** Sélectionner dans le menu déroulant: Daemon RPi
** Mettre l'adresse 192.168.1.200
** Sauver

Ensuite réinitialiser votre LiveBox

Vérifier la prise en compte de ces paramètres en allant dans
*Onglet Configuration
*Menu de gauche Réseaux & Services > Équipements > Visualiser
*Cliquer sur les icônes Daemon RPi et Armoire à cles. Vous devez avoir les adresses IP en 192.168.1.200 et 192.168.1.201

Note: L'interface d'Orange est faillible, nous avons constaté que leur interface indique que l'armoire n'était pas connecté alors qu'elle l'était. Vous pouvez vérifier cela indépendament de leur interface en allant avec un interface de ligne de commande et en faisant in ping des adresses
<BASH>ping 192.168.1.200
PING 192.168.1.200 (192.168.1.200) 56(84) bytes of data.
64 bytes from 192.168.1.5: icmp_req=1 ttl=64 time=0.241 ms
64 bytes from 192.168.1.5: icmp_req=2 ttl=64 time=0.143 ms
64 bytes from 192.168.1.5: icmp_req=3 ttl=64 time=0.144 ms
64 bytes from 192.168.1.5: icmp_req=4 ttl=64 time=0.145 ms

ping 192.168.1.201
PING 192.168.1.201 (192.168.1.201) 56(84) bytes of data.
64 bytes from 192.168.1.5: icmp_req=1 ttl=64 time=0.241 ms
64 bytes from 192.168.1.5: icmp_req=2 ttl=64 time=0.143 ms
64 bytes from 192.168.1.5: icmp_req=3 ttl=64 time=0.144 ms
64 bytes from 192.168.1.5: icmp_req=4 ttl=64 time=0.145 ms</BASH>

Si la réponse est "Unreachable" alors les adresses ne sont pas correctement affectées ou un câble est défectueux
<BASH>ping 192.168.1.201
PING 192.168.1.201 (192.168.1.201) 56(84) bytes of data.
From 192.168.1.5 icmp_seq=1 Destination Host Unreachable</BASH>

===Freebox===
Connectez-vous sur votre compte à l'adresse http://portail.free.fr/

A renseigner

===Box SFR===
Il faut au préalable connecter l'armoire afin que la Box SFR lui affecte par défaut une adresse IP.
*Connecter vous sur votre Box SFR en tapant son IP et mettre l'identifiant et mot de passe (par défaut admin/admin qu'il est fortement conseillé de le changer)

A renseigner
=Configuration OpenFlyers=

==Navigateur==
Un point '''important''': le navigateur Internet Explorer ne permet pas la communication avec l'armoire. Ce navigateur ne possède pas les fonctions avancées du standard W3C que nous utilisons pour sécuriser les accès.

Firefox ou Chrome sont des navigateurs qui fonctionnent pour déclencher la libération des clés.

Le ou les PC du club devront être paramétrés pour que ce soient un de ces navigateur qui soit en service.

Comme il est difficile de bloquer Internet Explorer sous Windows il faudra clairement informer les utilisateurs du club
Les navigateurs récents implémentent désormais des règles de filtrage pour bloquer le contenu non sécurisé provenant d'une page HTTP chargé depuis une page HTTPS. C'est le cas avec le serveur OF ou l'URL est en HTTPS et celles de l'armoire en HTTP. Il faut donc configurer les navigateurs pour ne pas réagir à ce mixte d'adresse URL

===Firefox===
Dans la barre d'adresse, taper about:config
*Valider le message d'avertissement comme quoi vous devez faire Attention
*Rechercher le paramètre security.mixed_content
*Double cliquer sur le paramètre security.mixed_content.block_active_content pour qu'il passe à '''false'''.
*La ligne s'affiche en gras

===Chrome===
*Clique droit sur l’icône de Chrome
*Cliquer sur Propriétés
*Ajouter dans le champs Cible à la fin --allow-running-insecure-content
*Le champs cible resemblera donc à <BASH>"C:\Program Files (x86)\Google\Chrome\Application\chrome.exe" --allow-running-insecure-content</BASH>

==Paramétrage OF==

*Aller dans '''Admin > Configuration > Paramétrage'''
**Dans la section '''Gestion des vols''' et cliquer sur l'option '''Activé(e)''' de la rubrique '''Gestion armoire à clés'''.
[[Fichier:Config OF0.JPG]]
**Cliquer dans Valider, de nouveaux champs seront alors de nouveau visibles
[[Fichier:Config OF1.jpg]]
**Cliquer sur '''Activé(e)''' dans la rubrique '''Gestion des clés'''
**Choisissez la durée de temporisation pour prendre la clé, elle dépend de la distance entre votre PC et l'armoire. 10 à 20 secondes sont des valeurs usuelles
**Dans la rubrique '''Logiciel de contrôle de l'armoire à clés''' choisissez '''PyOpenKey2'''
**Dans la rubrique '''IP du PC contenant le logiciel de contrôle''' indiquer l'adresse IP du Module OF ''' 192.168.1.200''' (A adapter en fonction de votre réseaux)
**Dans la rubrique '''Port du PC contenant le logiciel de contrôle''' indiquer le port '''4080''' (ou autre si spécifié sur le bordereau de livraison)
**Cliquer dans ''''Valider''', 2 nouveaux champs seront alors de nouveau visibles
[[Fichier:Config OF.jpg]]
**Dans la rubrique '''Fermeture automatique des vols au retour de la clé''' cocher '''Désactivé(e)'''
**Dans la rubrique '''Phrase mot de passe''', saisissez la même phrase que celle qui vous aura été indiquée sur le bordereau de livraison
**Cliquer sur Valider
*Aller dans '''Admin > Utilisateurs > Profils''' et vérifier que le profil sous lequel vous êtes connecté possède le droit '''Gestion des clés''' dans l'onglet '''Généralité admin'''
*Pour initialiser les clés dans OpenFlyers il faut aller dans la page '''Admin > Ressources > Ressources > Actives'''
*Sélectionner un numéro de clé pour chaque avion
[[Fichier:Page Ressource.jpg]]

=Première connexion=
Faite une réinitialisation en débranchant l'alimentation puis en la reconnectant après 5 secondes
*Le voyant vert de l'armoire doit s'allumer après quelques minutes
*Le voyant orange reste allumé durant la phase de connexion au serveur OF et à la reconnaissance des tag RFID des clés
*A la fin de l'initialisation le voyant orange s’éteint

Si l'initialisation des Tags n'est pas reconnu les clés se déclencheront successivement

==Connexion interface Web==
Dans votre navigateur mettre l'URL du Module OF suivi du port 8000.
<BASH> 192.168.1.200:8000</BASH>
Vous arrivez sur une page permettant de libérer les clés indépendamment d'une connexion avec le serveur
Le mot de passe administrateur sera celui qui vous aura été confirmez avec le bordereau de livraison
*Cliquer sur RESET pour supprimer l'alarme de défaut
*Pour libérer une clé, sélectionner le numéro et cliquer sur le bouton « Libérer la clé »

[[Fichier:WebAdmin.jpg]]

==Initialisation des clès==
La position des tags sont enregistrées dans openflyers si un tag est reposé à un emplacement incorrect, un halo rouge autour de la clé s'allume ainsi qu'un le halo à l'emplacement normalement identifié. La clé incorrecte est automatiquement déverrouillée

[[Fichier:Clé rouge.JPG]]

Si vous voulez modifier cette ordre il faut réinitialiser le serveur avec votre nouvelle configuration. Vous devez mettre toutes les clés au tableau tel que vous le souhaitez. Ne vous pré-occupez pas des lumières rouges autour des tags

Pour refaire l'initialisation allez dans '''Admin > Ressources > Ressources > Actives'''
*Cliquez sur l'icône '''Activer les tags des clés'''

Les identifiants de chaque clé doivent apparaître après rafraîchissement de la page.

[[Fichier:Ressources activees.jpg]]

Débranchez de nouveau l'armoire pour refaire l'initialisation

=Prise de clé à l'ouverture d'un vol=
Pour un contrôle de la prise de clé par un utilisateur il faut que le logiciel soit paramétré avec l'option '''Ouverture et fermeture des vols.''' Aller dans '''Admin > Configuration > Paramètres''' et dans la rubrique '''Gestion des vols''' activer l'option '''Ouverture et fermeture de vol'''

[[Fichier:Gestion des vols.JPG]]

Pour une prise de clé il faut cliquer droit sur une réservation et choisir l'option Saisir un vol
La page de saisie d'un vol s'ouvre avec l'option Départ en vol
Renseigner les champs et cliquer sur Valider
Une page de prise de clé s'ouvrira

[[Fichier:Prise de cle.JPG]]

Cliquer sur le bouton Libérer la clé pour l'aéronef F-XXXX
La porte doit se déverrouiller (voyant orange) et la clé être libérer durant la temporisation prévue (clé entourée d'un halo lumineux rouge)
Refermer la porte sinon un buzzer intermittent retenti

Déconnectez-vous de OpenFlyers pour l'utilisateur suivant

=Retour de vol=

Pour remettre la clé, se connecter sur OpenFlyers
Cliquer sur l'icône Ouvrir la porte en haut à gauche de la page du cahier de réservation

[[Fichier:Ouvrir porte.JPG]]

La porte sera déverrouillé durant la durée de la temporisation
*Remettre la clé à son emplacement
*Si la clé est incorrectement placée, l'armoire déverrouille la clé (halo rouge de la clé reposée) et signale l'emplacement correct en allumant le halo rouge de l'emplacement prévu.
*Sur le planning l'avion en vol est indiquer par une couleur bleu. Survoler ce vol avec la souris
*Un menu apparait avec l'option '''Fermer le vol'''
*Cliquer et enregistré le vol

'''Note:''' Ne pas aller directement sur le menu '''Vols > Saisir un vol''' pour fermer le vol. Dans ce cas il ne pourra être établi de corrélation entre l'affichage du planning et le vol que vous fermez. Le vol restera ouvert (en bleu sur le planning) et l'avion sera bloqué pour repartir en vol. Néanmoins si un pilote faire l'erreur alors il faut, dans le menu surgissant, cliquer sur '''Annuler'''

=Finalisation=
*Ouvrir la porte de service
*Brancher le connecteur de la batterie de sauvegarde (Déconnecté pour le transport)

[[Fichier:Connecteur Batterie.JPG]]
*Refermer la porte de service

L'ouverture de la porte de service enclenche une alarme qui est mise en mémoire dans OF. Pour supprimer l'alarme il faut aller [[Titre du lien]] et cliquer sur Reset

KeyPanel installation1

2014-01-18T22:11:40Z

Joel : /* Première connexion */

L'armoire à clé [[Media:Deister_ProxSafe_Smart3U.pdf|ProxSafe Smart3U]]? de Deister permet la gestion de 8, 16 ou 32 clés avec l'application openFlyers

Existe aussi en version [[Media:Deister_ProxSafe_Mini3U.pdf|ProxSafe_Mini 3U]]? avec 8 à 16 clés de format plus réduit

Le modèle fournis via OpenFlyers ne comporte pas le Lecteur Deister mais un Module OF permettant le dialogue avec nos serveurs
= Connexions de l'armoire=
Rendre la clé dans la pochette fixée sur l'armoire et ouvrir la porte de service. Les câbles suivants doivent être passés avant la fixation définitive au mur.
*Alimentation
*Câble Ethernet en provenance de votre routeur pour l'armoire
*Câble Ethernet en provenance de votre routeur pour le module OF
Fixer l'armoire au mur par 4 chevilles et vis en ayant au préalable retirer l’adhésif de maintien de l’interrupteur qui détectera une tentative de vandalisme
*Vérifier que la carte SD est correctement enfichée dans son logement
*Brancher un câble Ethernet sur le Module OF

[[Fichier:Connexion rj45 OF.jpg]]
*Brancher un câble Ethernet sur l'armoire

[[Fichier:Connexion rj45masterplane.jpg]]
*Brancher le câble d'alimentation 220V

[[Fichier:Alim.JPG]]
*Refermer la porte de service
*Brancher la prise d'alimentation sur le secteur
A l'initialisation de l'armoire le voyant jaune de la face avant clignote puis passe au jaune fixe

= Préparation du réseau=
L'armoire à clés demande 2 connexions au réseau local, une pour le Module OF et une pour l'armoire à clés. Ils sont configurés en DHCP ce qui signifie qu'ils seront automatiquement reconnus par le réseau à chaque connexion et qu'une adresse IP leur sera affecté.

Cependant pour qu'ils puissent communiquer avec le logiciel OpenFlyers les équipements doivent avoir une adresse IP identique à chaque mise en route du routeur. Pour forcer le routeur à attribuer toujours la même adresse IP à un équipement il faut le configurer en créant l'association d'une [http://fr.wikipedia.org/wiki/Adresse_IP IP] à l'adresse [http://fr.wikipedia.org/wiki/Adresse_MAC MAC] du materiel.

Les adresses IP et MAC à configurer vous sont communiquées dans l'email confirmant l'envoi de l'armoire à clés et sur le bordereau de livraison, Ceci ce fait dans votre routeur ou la box de votre provider et dépend du matériel que vous disposez
==Idendification de l'adresse IP==
Pour connaître l'adresse IP de sa passerelle (box ou routeur).
===Sous Windows 7===
Pour les inconditionnels de l'interface graphique
*Cliquer sur le bouton '''Démarrer'''
*cliquer sur '''Panneau de configuration'''
*Cliquer sur '''Réseau et Internet'''
*Cliquer sur '''Centre de réseau et partage'''
*Cliquer sur '''Afficher l'intégralité du réseau''' dan
Survoler l’icône Passerelle et vous aurez l'adresse IP de votre matériel dans le message

[[Image:Reseau_W7.jpg?]]

Pour les fans de l'efficacité
*Cliquer sur le bouton '''Démarrer'''
*Dans le champs Rechercher taper '''cmd''' puis faite "Entrer" pour ouvrir la console DOS.
*Taper « netstat -r -n » qui affrichera la table de routage
L'adresse de votre routeur est indiquée à la colonne "Adr. passerelle" de la table de routage

[[Image:Table_routage_windows.jpg? ?]]
===Sous Linux===
*Ouvrir votre console
*Taper « netstat -r -n »
*L'adresse Ip est dans la colonne Gateway

[[Image:Reseau_Linux.jpg?]]
==Configuration du routeur==
===Livebox Orange===
Il y a de nombreux modèle de Livebox, voici un lien ou vous pouvez identifier votre [http://assistance.orange.fr/livebox-tous-les-modeles-524.php Modèle de Livebox]

Il y a généralement deux endroits pour configurer les IP en fonction des adresses MAC:
*celle pour le filtrage du réseau Wifi (WAN). Ceci ne fonctionnera pas pour le réseau filaire (LAN)
*celle permettant de mettre une IP statique (valide pour le wifi et le LAN). C'est cette configuration qu'il faut faire

====Livebox 2 de Sagem====
Il faut au préalable connecter l'armoire afin que la Livebox lui affecte par défaut une adresse IP.
*Connecter vous sur votre Livebox en tapant son IP et mettre l'identifiant et mot de passe (par défaut admin/admin qu'il est fortement conseillé de le changer)
*Aller dans
** Onglet Configuration
** Menu de gauche Réseaux & Services > Équipements > Visualiser
** Deux nouveaux icônes doivent apparaitre
** Cliquer dessus un des icône et vérifier à qu'elle matériel cette adresse MAC correspond (inscrit sur votre bordereau de livraison)
** Renommer les en "Armoire à clés" et "Module OF" pour une identification plus aisée. Orange a rajouté ses propres noms qui ne simplifient pas la reconnaissance du matériel !!!

*Ensuite aller dans:
** Onglet Configuration
** Menu de gauche Réseaux & Services > Livebox > Paramètres avancés
** Onglet DHCP
** Section Adresse IP statique
** Cliquer sur ajouter
[[Fichier:LiveBox.JPG]]
** Sélectionner dans le menu déroulant: Armoire à clés
** Mettre l'adresse 192.168.1.201
** Cliquer sur ajouter
** Sélectionner dans le menu déroulant: Daemon RPi
** Mettre l'adresse 192.168.1.200
** Sauver

Ensuite réinitialiser votre LiveBox

Vérifier la prise en compte de ces paramètres en allant dans
*Onglet Configuration
*Menu de gauche Réseaux & Services > Équipements > Visualiser
*Cliquer sur les icônes Daemon RPi et Armoire à cles. Vous devez avoir les adresses IP en 192.168.1.200 et 192.168.1.201

Note: L'interface d'Orange est faillible, nous avons constaté que leur interface indique que l'armoire n'était pas connecté alors qu'elle l'était. Vous pouvez vérifier cela indépendament de leur interface en allant avec un interface de ligne de commande et en faisant in ping des adresses
<BASH>ping 192.168.1.200
PING 192.168.1.200 (192.168.1.200) 56(84) bytes of data.
64 bytes from 192.168.1.5: icmp_req=1 ttl=64 time=0.241 ms
64 bytes from 192.168.1.5: icmp_req=2 ttl=64 time=0.143 ms
64 bytes from 192.168.1.5: icmp_req=3 ttl=64 time=0.144 ms
64 bytes from 192.168.1.5: icmp_req=4 ttl=64 time=0.145 ms

ping 192.168.1.201
PING 192.168.1.201 (192.168.1.201) 56(84) bytes of data.
64 bytes from 192.168.1.5: icmp_req=1 ttl=64 time=0.241 ms
64 bytes from 192.168.1.5: icmp_req=2 ttl=64 time=0.143 ms
64 bytes from 192.168.1.5: icmp_req=3 ttl=64 time=0.144 ms
64 bytes from 192.168.1.5: icmp_req=4 ttl=64 time=0.145 ms</BASH>

Si la réponse est "Unreachable" alors les adresses ne sont pas correctement affectées ou un câble est défectueux
<BASH>ping 192.168.1.201
PING 192.168.1.201 (192.168.1.201) 56(84) bytes of data.
From 192.168.1.5 icmp_seq=1 Destination Host Unreachable</BASH>

===Freebox===
Connectez-vous sur votre compte à l'adresse http://portail.free.fr/

A renseigner

===Box SFR===
Il faut au préalable connecter l'armoire afin que la Box SFR lui affecte par défaut une adresse IP.
*Connecter vous sur votre Box SFR en tapant son IP et mettre l'identifiant et mot de passe (par défaut admin/admin qu'il est fortement conseillé de le changer)

A renseigner
=Configuration OpenFlyers=

==Navigateur==
Un point '''important''': le navigateur Internet Explorer ne permet pas la communication avec l'armoire. Ce navigateur ne possède pas les fonctions avancées du standard W3C que nous utilisons pour sécuriser les accès.

Firefox ou Chrome sont des navigateurs qui fonctionnent pour déclencher la libération des clés.

Le ou les PC du club devront être paramétrés pour que ce soient un de ces navigateur qui soit en service.

Comme il est difficile de bloquer Internet Explorer sous Windows il faudra clairement informer les utilisateurs du club
Les navigateurs récents implémentent désormais des règles de filtrage pour bloquer le contenu non sécurisé provenant d'une page HTTP chargé depuis une page HTTPS. C'est le cas avec le serveur OF ou l'URL est en HTTPS et celles de l'armoire en HTTP. Il faut donc configurer les navigateurs pour ne pas réagir à ce mixte d'adresse URL

===Firefox===
Dans la barre d'adresse, taper about:config
*Valider le message d'avertissement comme quoi vous devez faire Attention
*Rechercher le paramètre security.mixed_content
*Double cliquer sur le paramètre security.mixed_content.block_active_content pour qu'il passe à '''false'''.
*La ligne s'affiche en gras

===Chrome===
*Clique droit sur l’icône de Chrome
*Cliquer sur Propriétés
*Ajouter dans le champs Cible à la fin --allow-running-insecure-content
*Le champs cible resemblera donc à <BASH>"C:\Program Files (x86)\Google\Chrome\Application\chrome.exe" --allow-running-insecure-content</BASH>

==Paramétrage OF==

*Aller dans '''Admin > Configuration > Paramétrage'''
**Dans la section '''Gestion des vols''' et cliquer sur l'option '''Activé(e)''' de la rubrique '''Gestion armoire à clés'''.
[[Fichier:Config OF0.JPG]]
**Cliquer dans Valider, de nouveaux champs seront alors de nouveau visibles
[[Fichier:Config OF1.jpg]]
**Cliquer sur '''Activé(e)''' dans la rubrique '''Gestion des clés'''
**Choisissez la durée de temporisation pour prendre la clé, elle dépend de la distance entre votre PC et l'armoire. 10 à 20 secondes sont des valeurs usuelles
**Dans la rubrique '''Logiciel de contrôle de l'armoire à clés''' choisissez '''PyOpenKey2'''
**Dans la rubrique '''IP du PC contenant le logiciel de contrôle''' indiquer l'adresse IP du Module OF ''' 192.168.1.200''' (A adapter en fonction de votre réseaux)
**Dans la rubrique '''Port du PC contenant le logiciel de contrôle''' indiquer le port '''4080''' (ou autre si spécifié sur le bordereau de livraison)
**Cliquer dans ''''Valider''', 2 nouveaux champs seront alors de nouveau visibles
[[Fichier:Config OF.jpg]]
**Dans la rubrique '''Fermeture automatique des vols au retour de la clé''' cocher '''Désactivé(e)'''
**Dans la rubrique '''Phrase mot de passe''', saisissez la même phrase que celle qui vous aura été indiquée sur le bordereau de livraison
**Cliquer sur Valider
*Aller dans '''Admin > Utilisateurs > Profils''' et vérifier que le profil sous lequel vous êtes connecté possède le droit '''Gestion des clés''' dans l'onglet '''Généralité admin'''
*Pour initialiser les clés dans OpenFlyers il faut aller dans la page '''Admin > Ressources > Ressources > Actives'''
*Sélectionner un numéro de clé pour chaque avion
[[Fichier:Page Ressource.jpg]]

=Première connexion=
Faite une réinitialisation en débranchant l'alimentation puis en la reconnectant après 5 secondes
*Le voyant vert de l'armoire doit s'allumer après quelques minutes
*Le voyant orange reste allumé durant la phase de connexion au serveur OF et à la reconnaissance des tag RFID des clés
*A la fin de l'initialisation le voyant orange s’éteint

Si l'initialisation des Tags n'est pas reconnu les clés se déclencheront successivement

==Connexion interface Web==
Dans votre navigateur mettre l'URL du Module OF suivi du port 8000.
<BASH> 192.168.1.200:8000</BASH>
Vous arrivez sur une page permettant de libérer les clés indépendamment d'une connexion avec le serveur
Le mot de passe administrateur sera celui qui vous aura été confirmez avec le bordereau de livraison
*Cliquer sur RESET pour supprimer l'alarme de défaut
*Pour libérer une clé, sélectionner le numéro et cliquer sur le bouton « Libérer la clé »

[[Fichier:WebAdmin.jpg]]

==Initialisation des clès==
La position des tags sont enregistrées dans openflyers si un tag est reposé à un emplacement incorrect, un halo rouge autour de la clé s'allume ainsi qu'un le halo à l'emplacement normalement identifié. La clé incorrecte est automatiquement déverrouillée

[[Fichier:Clé rouge.JPG]]

Si vous voulez modifier cette ordre il faut réinitialiser le serveur avec votre nouvelle configuration. Vous devez mettre toutes les clés au tableau tel que vous le souhaitez. Ne vous pré-occupez pas des lumières rouges autour des tags

Pour refaire l'initialisation allez dans '''Admin > Ressources > Ressources > Actives'''
*Cliquez sur l'icône '''Activer les tags des clés'''

Les identifiants de chaque clé doivent apparaître après rafraîchissement de la page.

[[Fichier:Ressources activees.jpg]]

Débranchez de nouveau l'armoire pour refaire l'initialisation

=Prise de clé à l'ouverture d'un vol=
Pour un contrôle de la prise de clé par un utilisateur il faut que le logiciel soit paramétré avec l'option '''Ouverture et fermeture des vols.''' Aller dans '''Admin > Configuration > Paramètres''' et dans la rubrique '''Gestion des vols''' activer l'option '''Ouverture et fermeture de vol'''

[[Fichier:Gestion des vols.JPG]]

Pour une prise de clé il faut cliquer droit sur une réservation et choisir l'option Saisir un vol
La page de saisie d'un vol s'ouvre avec l'option Départ en vol
Renseigner les champs et cliquer sur Valider
Une page de prise de clé s'ouvrira

[[Fichier:Prise de cle.JPG]]

Cliquer sur le bouton Libérer la clé pour l'aéronef F-XXXX
La porte doit se déverrouiller (voyant orange) et la clé être libérer durant la temporisation prévue (clé entourée d'un halo lumineux rouge)
Refermer la porte sinon un buzzer intermittent retenti

Déconnectez-vous de OpenFlyers pour l'utilisateur suivant

=Retour de vol=

Pour remettre la clé, se connecter sur OpenFlyers
Cliquer sur l'icône Ouvrir la porte en haut à gauche de la page du cahier de réservation

[[Fichier:Ouvrir porte.JPG]]

La porte sera déverrouillé durant la durée de la temporisation
*Remettre la clé à son emplacement
*Si la clé est incorrectement placée, l'armoire déverrouille la clé (halo rouge de la clé reposée) et signale l'emplacement correct en allumant le halo rouge de l'emplacement prévu.
*Sur le planning l'avion en vol est indiquer par une couleur bleu. Survoler ce vol avec la souris
*Un menu apparait avec l'option '''Fermer le vol'''
*Cliquer et enregistré le vol

'''Note:''' Ne pas aller directement sur le menu '''Vols > Saisir un vol''' pour fermer le vol. Dans ce cas il ne pourra être établi de corrélation entre l'affichage du planning et le vol que vous fermez. Le vol restera ouvert (en bleu sur le planning) et l'avion sera bloqué pour repartir en vol. Néanmoins si un pilote faire l'erreur alors il faut, dans le menu surgissant, cliquer sur '''Annuler'''

=Finalisation=
*Ouvrir la porte de service
*Brancher le connecteur de la batterie de sauvegarde (Déconnecté pour le transport)

[[Fichier:Connecteur Batterie.JPG]]
*Refermer la porte de service

Fichier:Fermeture vol popup.JPG

2014-01-18T22:01:20Z

Joel :

Fichier:Ouvrir porte.JPG

2014-01-18T21:59:27Z

Joel :

Fichier:Ouverture vol popup.JPG

2014-01-18T21:56:09Z

Joel :

Fichier:Prise de cle.JPG

2014-01-18T21:41:07Z

Joel :

Fichier:Gestion des vols.JPG

2014-01-18T21:30:29Z

Joel :

Fichier:Clé rouge.JPG

2014-01-18T21:21:24Z

Joel : a téléversé une nouvelle version de « Fichier:Clé rouge.JPG »

Fichier:Clé rouge.JPG

2014-01-18T21:19:53Z

Joel :

Fichier:WebAdmin.jpg

2014-01-18T20:50:34Z

Joel :

Fichier:Ressources activees.jpg

2014-01-18T20:30:42Z

Joel :

KeyPanel installation1

2014-01-18T20:20:44Z

Joel : /* Paramétrage OF */

L'armoire à clé [[Media:Deister_ProxSafe_Smart3U.pdf|ProxSafe Smart3U]]? de Deister permet la gestion de 8, 16 ou 32 clés avec l'application openFlyers

Existe aussi en version [[Media:Deister_ProxSafe_Mini3U.pdf|ProxSafe_Mini 3U]]? avec 8 à 16 clés de format plus réduit

Le modèle fournis via OpenFlyers ne comporte pas le Lecteur Deister mais un Module OF permettant le dialogue avec nos serveurs
= Connexions de l'armoire=
Rendre la clé dans la pochette fixée sur l'armoire et ouvrir la porte de service. Les câbles suivants doivent être passés avant la fixation définitive au mur.
*Alimentation
*Câble Ethernet en provenance de votre routeur pour l'armoire
*Câble Ethernet en provenance de votre routeur pour le module OF
Fixer l'armoire au mur par 4 chevilles et vis en ayant au préalable retirer l’adhésif de maintien de l’interrupteur qui détectera une tentative de vandalisme
*Vérifier que la carte SD est correctement enfichée dans son logement
*Brancher un câble Ethernet sur le Module OF

[[Fichier:Connexion rj45 OF.jpg]]
*Brancher un câble Ethernet sur l'armoire

[[Fichier:Connexion rj45masterplane.jpg]]
*Brancher le câble d'alimentation 220V

[[Fichier:Alim.JPG]]
*Refermer la porte de service
*Brancher la prise d'alimentation sur le secteur
A l'initialisation de l'armoire le voyant jaune de la face avant clignote puis passe au jaune fixe

= Préparation du réseau=
L'armoire à clés demande 2 connexions au réseau local, une pour le Module OF et une pour l'armoire à clés. Ils sont configurés en DHCP ce qui signifie qu'ils seront automatiquement reconnus par le réseau à chaque connexion et qu'une adresse IP leur sera affecté.

Cependant pour qu'ils puissent communiquer avec le logiciel OpenFlyers les équipements doivent avoir une adresse IP identique à chaque mise en route du routeur. Pour forcer le routeur à attribuer toujours la même adresse IP à un équipement il faut le configurer en créant l'association d'une [http://fr.wikipedia.org/wiki/Adresse_IP IP] à l'adresse [http://fr.wikipedia.org/wiki/Adresse_MAC MAC] du materiel.

Les adresses IP et MAC à configurer vous sont communiquées dans l'email confirmant l'envoi de l'armoire à clés et sur le bordereau de livraison, Ceci ce fait dans votre routeur ou la box de votre provider et dépend du matériel que vous disposez
==Idendification de l'adresse IP==
Pour connaître l'adresse IP de sa passerelle (box ou routeur).
===Sous Windows 7===
Pour les inconditionnels de l'interface graphique
*Cliquer sur le bouton '''Démarrer'''
*cliquer sur '''Panneau de configuration'''
*Cliquer sur '''Réseau et Internet'''
*Cliquer sur '''Centre de réseau et partage'''
*Cliquer sur '''Afficher l'intégralité du réseau''' dan
Survoler l’icône Passerelle et vous aurez l'adresse IP de votre matériel dans le message

[[Image:Reseau_W7.jpg?]]

Pour les fans de l'efficacité
*Cliquer sur le bouton '''Démarrer'''
*Dans le champs Rechercher taper '''cmd''' puis faite "Entrer" pour ouvrir la console DOS.
*Taper « netstat -r -n » qui affrichera la table de routage
L'adresse de votre routeur est indiquée à la colonne "Adr. passerelle" de la table de routage

[[Image:Table_routage_windows.jpg? ?]]
===Sous Linux===
*Ouvrir votre console
*Taper « netstat -r -n »
*L'adresse Ip est dans la colonne Gateway

[[Image:Reseau_Linux.jpg?]]
==Configuration du routeur==
===Livebox Orange===
Il y a de nombreux modèle de Livebox, voici un lien ou vous pouvez identifier votre [http://assistance.orange.fr/livebox-tous-les-modeles-524.php Modèle de Livebox]

Il y a généralement deux endroits pour configurer les IP en fonction des adresses MAC:
*celle pour le filtrage du réseau Wifi (WAN). Ceci ne fonctionnera pas pour le réseau filaire (LAN)
*celle permettant de mettre une IP statique (valide pour le wifi et le LAN). C'est cette configuration qu'il faut faire

====Livebox 2 de Sagem====
Il faut au préalable connecter l'armoire afin que la Livebox lui affecte par défaut une adresse IP.
*Connecter vous sur votre Livebox en tapant son IP et mettre l'identifiant et mot de passe (par défaut admin/admin qu'il est fortement conseillé de le changer)
*Aller dans
** Onglet Configuration
** Menu de gauche Réseaux & Services > Équipements > Visualiser
** Deux nouveaux icônes doivent apparaitre
** Cliquer dessus un des icône et vérifier à qu'elle matériel cette adresse MAC correspond (inscrit sur votre bordereau de livraison)
** Renommer les en "Armoire à clés" et "Module OF" pour une identification plus aisée. Orange a rajouté ses propres noms qui ne simplifient pas la reconnaissance du matériel !!!

*Ensuite aller dans:
** Onglet Configuration
** Menu de gauche Réseaux & Services > Livebox > Paramètres avancés
** Onglet DHCP
** Section Adresse IP statique
** Cliquer sur ajouter
[[Fichier:LiveBox.JPG]]
** Sélectionner dans le menu déroulant: Armoire à clés
** Mettre l'adresse 192.168.1.201
** Cliquer sur ajouter
** Sélectionner dans le menu déroulant: Daemon RPi
** Mettre l'adresse 192.168.1.200
** Sauver

Ensuite réinitialiser votre LiveBox

Vérifier la prise en compte de ces paramètres en allant dans
*Onglet Configuration
*Menu de gauche Réseaux & Services > Équipements > Visualiser
*Cliquer sur les icônes Daemon RPi et Armoire à cles. Vous devez avoir les adresses IP en 192.168.1.200 et 192.168.1.201

Note: L'interface d'Orange est faillible, nous avons constaté que leur interface indique que l'armoire n'était pas connecté alors qu'elle l'était. Vous pouvez vérifier cela indépendament de leur interface en allant avec un interface de ligne de commande et en faisant in ping des adresses
<BASH>ping 192.168.1.200
PING 192.168.1.200 (192.168.1.200) 56(84) bytes of data.
64 bytes from 192.168.1.5: icmp_req=1 ttl=64 time=0.241 ms
64 bytes from 192.168.1.5: icmp_req=2 ttl=64 time=0.143 ms
64 bytes from 192.168.1.5: icmp_req=3 ttl=64 time=0.144 ms
64 bytes from 192.168.1.5: icmp_req=4 ttl=64 time=0.145 ms

ping 192.168.1.201
PING 192.168.1.201 (192.168.1.201) 56(84) bytes of data.
64 bytes from 192.168.1.5: icmp_req=1 ttl=64 time=0.241 ms
64 bytes from 192.168.1.5: icmp_req=2 ttl=64 time=0.143 ms
64 bytes from 192.168.1.5: icmp_req=3 ttl=64 time=0.144 ms
64 bytes from 192.168.1.5: icmp_req=4 ttl=64 time=0.145 ms</BASH>

Si la réponse est "Unreachable" alors les adresses ne sont pas correctement affectées ou un câble est défectueux
<BASH>ping 192.168.1.201
PING 192.168.1.201 (192.168.1.201) 56(84) bytes of data.
From 192.168.1.5 icmp_seq=1 Destination Host Unreachable</BASH>

===Freebox===
Connectez-vous sur votre compte à l'adresse http://portail.free.fr/

A renseigner

===Box SFR===
Il faut au préalable connecter l'armoire afin que la Box SFR lui affecte par défaut une adresse IP.
*Connecter vous sur votre Box SFR en tapant son IP et mettre l'identifiant et mot de passe (par défaut admin/admin qu'il est fortement conseillé de le changer)

A renseigner
=Configuration OpenFlyers=

==Navigateur==
Un point '''important''': le navigateur Internet Explorer ne permet pas la communication avec l'armoire. Ce navigateur ne possède pas les fonctions avancées du standard W3C que nous utilisons pour sécuriser les accès.

Firefox ou Chrome sont des navigateurs qui fonctionnent pour déclencher la libération des clés.

Le ou les PC du club devront être paramétrés pour que ce soient un de ces navigateur qui soit en service.

Comme il est difficile de bloquer Internet Explorer sous Windows il faudra clairement informer les utilisateurs du club
Les navigateurs récents implémentent désormais des règles de filtrage pour bloquer le contenu non sécurisé provenant d'une page HTTP chargé depuis une page HTTPS. C'est le cas avec le serveur OF ou l'URL est en HTTPS et celles de l'armoire en HTTP. Il faut donc configurer les navigateurs pour ne pas réagir à ce mixte d'adresse URL

===Firefox===
Dans la barre d'adresse, taper about:config
*Valider le message d'avertissement comme quoi vous devez faire Attention
*Rechercher le paramètre security.mixed_content
*Double cliquer sur le paramètre security.mixed_content.block_active_content pour qu'il passe à '''false'''.
*La ligne s'affiche en gras

===Chrome===
*Clique droit sur l’icône de Chrome
*Cliquer sur Propriétés
*Ajouter dans le champs Cible à la fin --allow-running-insecure-content
*Le champs cible resemblera donc à <BASH>"C:\Program Files (x86)\Google\Chrome\Application\chrome.exe" --allow-running-insecure-content</BASH>

==Paramétrage OF==

*Aller dans '''Admin > Configuration > Paramétrage'''
**Dans la section '''Gestion des vols''' et cliquer sur l'option '''Activé(e)''' de la rubrique '''Gestion armoire à clés'''.
[[Fichier:Config OF0.JPG]]
**Cliquer dans Valider, de nouveaux champs seront alors de nouveau visibles
[[Fichier:Config OF1.jpg]]
**Cliquer sur '''Activé(e)''' dans la rubrique '''Gestion des clés'''
**Choisissez la durée de temporisation pour prendre la clé, elle dépend de la distance entre votre PC et l'armoire. 10 à 20 secondes sont des valeurs usuelles
**Dans la rubrique '''Logiciel de contrôle de l'armoire à clés''' choisissez '''PyOpenKey2'''
**Dans la rubrique '''IP du PC contenant le logiciel de contrôle''' indiquer l'adresse IP du Module OF ''' 192.168.1.200''' (A adapter en fonction de votre réseaux)
**Dans la rubrique '''Port du PC contenant le logiciel de contrôle''' indiquer le port '''4080''' (ou autre si spécifié sur le bordereau de livraison)
**Cliquer dans ''''Valider''', 2 nouveaux champs seront alors de nouveau visibles
[[Fichier:Config OF.jpg]]
**Dans la rubrique '''Fermeture automatique des vols au retour de la clé''' cocher '''Désactivé(e)'''
**Dans la rubrique '''Phrase mot de passe''', saisissez la même phrase que celle qui vous aura été indiquée sur le bordereau de livraison
**Cliquer sur Valider
*Aller dans '''Admin > Utilisateurs > Profils''' et vérifier que le profil sous lequel vous êtes connecté possède le droit '''Gestion des clés''' dans l'onglet '''Généralité admin'''
*Pour initialiser les clés dans OpenFlyers il faut aller dans la page '''Admin > Ressources > Ressources > Actives'''
*Sélectionner un numéro de clé pour chaque avion
[[Fichier:Page Ressource.jpg]]

=Première connexion=
Faite une réinitialisation en débranchant l'alimentation puis en la reconnectant après 5 secondes

=Finalisation=
*Ouvrir la porte de service
*Brancher le connecteur de la batterie de sauvegarde (Déconnecté pour le transport)

[[Fichier:Connecteur Batterie.JPG]]
*Refermer la porte de service

Fichier:Page Ressource.jpg

2014-01-18T20:19:53Z

Joel :

KeyPanel installation1

2014-01-18T20:16:38Z

Joel : /* Première connexion */

L'armoire à clé [[Media:Deister_ProxSafe_Smart3U.pdf|ProxSafe Smart3U]]? de Deister permet la gestion de 8, 16 ou 32 clés avec l'application openFlyers

Existe aussi en version [[Media:Deister_ProxSafe_Mini3U.pdf|ProxSafe_Mini 3U]]? avec 8 à 16 clés de format plus réduit

Le modèle fournis via OpenFlyers ne comporte pas le Lecteur Deister mais un Module OF permettant le dialogue avec nos serveurs
= Connexions de l'armoire=
Rendre la clé dans la pochette fixée sur l'armoire et ouvrir la porte de service. Les câbles suivants doivent être passés avant la fixation définitive au mur.
*Alimentation
*Câble Ethernet en provenance de votre routeur pour l'armoire
*Câble Ethernet en provenance de votre routeur pour le module OF
Fixer l'armoire au mur par 4 chevilles et vis en ayant au préalable retirer l’adhésif de maintien de l’interrupteur qui détectera une tentative de vandalisme
*Vérifier que la carte SD est correctement enfichée dans son logement
*Brancher un câble Ethernet sur le Module OF

[[Fichier:Connexion rj45 OF.jpg]]
*Brancher un câble Ethernet sur l'armoire

[[Fichier:Connexion rj45masterplane.jpg]]
*Brancher le câble d'alimentation 220V

[[Fichier:Alim.JPG]]
*Refermer la porte de service
*Brancher la prise d'alimentation sur le secteur
A l'initialisation de l'armoire le voyant jaune de la face avant clignote puis passe au jaune fixe

= Préparation du réseau=
L'armoire à clés demande 2 connexions au réseau local, une pour le Module OF et une pour l'armoire à clés. Ils sont configurés en DHCP ce qui signifie qu'ils seront automatiquement reconnus par le réseau à chaque connexion et qu'une adresse IP leur sera affecté.

Cependant pour qu'ils puissent communiquer avec le logiciel OpenFlyers les équipements doivent avoir une adresse IP identique à chaque mise en route du routeur. Pour forcer le routeur à attribuer toujours la même adresse IP à un équipement il faut le configurer en créant l'association d'une [http://fr.wikipedia.org/wiki/Adresse_IP IP] à l'adresse [http://fr.wikipedia.org/wiki/Adresse_MAC MAC] du materiel.

Les adresses IP et MAC à configurer vous sont communiquées dans l'email confirmant l'envoi de l'armoire à clés et sur le bordereau de livraison, Ceci ce fait dans votre routeur ou la box de votre provider et dépend du matériel que vous disposez
==Idendification de l'adresse IP==
Pour connaître l'adresse IP de sa passerelle (box ou routeur).
===Sous Windows 7===
Pour les inconditionnels de l'interface graphique
*Cliquer sur le bouton '''Démarrer'''
*cliquer sur '''Panneau de configuration'''
*Cliquer sur '''Réseau et Internet'''
*Cliquer sur '''Centre de réseau et partage'''
*Cliquer sur '''Afficher l'intégralité du réseau''' dan
Survoler l’icône Passerelle et vous aurez l'adresse IP de votre matériel dans le message

[[Image:Reseau_W7.jpg?]]

Pour les fans de l'efficacité
*Cliquer sur le bouton '''Démarrer'''
*Dans le champs Rechercher taper '''cmd''' puis faite "Entrer" pour ouvrir la console DOS.
*Taper « netstat -r -n » qui affrichera la table de routage
L'adresse de votre routeur est indiquée à la colonne "Adr. passerelle" de la table de routage

[[Image:Table_routage_windows.jpg? ?]]
===Sous Linux===
*Ouvrir votre console
*Taper « netstat -r -n »
*L'adresse Ip est dans la colonne Gateway

[[Image:Reseau_Linux.jpg?]]
==Configuration du routeur==
===Livebox Orange===
Il y a de nombreux modèle de Livebox, voici un lien ou vous pouvez identifier votre [http://assistance.orange.fr/livebox-tous-les-modeles-524.php Modèle de Livebox]

Il y a généralement deux endroits pour configurer les IP en fonction des adresses MAC:
*celle pour le filtrage du réseau Wifi (WAN). Ceci ne fonctionnera pas pour le réseau filaire (LAN)
*celle permettant de mettre une IP statique (valide pour le wifi et le LAN). C'est cette configuration qu'il faut faire

====Livebox 2 de Sagem====
Il faut au préalable connecter l'armoire afin que la Livebox lui affecte par défaut une adresse IP.
*Connecter vous sur votre Livebox en tapant son IP et mettre l'identifiant et mot de passe (par défaut admin/admin qu'il est fortement conseillé de le changer)
*Aller dans
** Onglet Configuration
** Menu de gauche Réseaux & Services > Équipements > Visualiser
** Deux nouveaux icônes doivent apparaitre
** Cliquer dessus un des icône et vérifier à qu'elle matériel cette adresse MAC correspond (inscrit sur votre bordereau de livraison)
** Renommer les en "Armoire à clés" et "Module OF" pour une identification plus aisée. Orange a rajouté ses propres noms qui ne simplifient pas la reconnaissance du matériel !!!

*Ensuite aller dans:
** Onglet Configuration
** Menu de gauche Réseaux & Services > Livebox > Paramètres avancés
** Onglet DHCP
** Section Adresse IP statique
** Cliquer sur ajouter
[[Fichier:LiveBox.JPG]]
** Sélectionner dans le menu déroulant: Armoire à clés
** Mettre l'adresse 192.168.1.201
** Cliquer sur ajouter
** Sélectionner dans le menu déroulant: Daemon RPi
** Mettre l'adresse 192.168.1.200
** Sauver

Ensuite réinitialiser votre LiveBox

Vérifier la prise en compte de ces paramètres en allant dans
*Onglet Configuration
*Menu de gauche Réseaux & Services > Équipements > Visualiser
*Cliquer sur les icônes Daemon RPi et Armoire à cles. Vous devez avoir les adresses IP en 192.168.1.200 et 192.168.1.201

Note: L'interface d'Orange est faillible, nous avons constaté que leur interface indique que l'armoire n'était pas connecté alors qu'elle l'était. Vous pouvez vérifier cela indépendament de leur interface en allant avec un interface de ligne de commande et en faisant in ping des adresses
<BASH>ping 192.168.1.200
PING 192.168.1.200 (192.168.1.200) 56(84) bytes of data.
64 bytes from 192.168.1.5: icmp_req=1 ttl=64 time=0.241 ms
64 bytes from 192.168.1.5: icmp_req=2 ttl=64 time=0.143 ms
64 bytes from 192.168.1.5: icmp_req=3 ttl=64 time=0.144 ms
64 bytes from 192.168.1.5: icmp_req=4 ttl=64 time=0.145 ms

ping 192.168.1.201
PING 192.168.1.201 (192.168.1.201) 56(84) bytes of data.
64 bytes from 192.168.1.5: icmp_req=1 ttl=64 time=0.241 ms
64 bytes from 192.168.1.5: icmp_req=2 ttl=64 time=0.143 ms
64 bytes from 192.168.1.5: icmp_req=3 ttl=64 time=0.144 ms
64 bytes from 192.168.1.5: icmp_req=4 ttl=64 time=0.145 ms</BASH>

Si la réponse est "Unreachable" alors les adresses ne sont pas correctement affectées ou un câble est défectueux
<BASH>ping 192.168.1.201
PING 192.168.1.201 (192.168.1.201) 56(84) bytes of data.
From 192.168.1.5 icmp_seq=1 Destination Host Unreachable</BASH>

===Freebox===
Connectez-vous sur votre compte à l'adresse http://portail.free.fr/

A renseigner

===Box SFR===
Il faut au préalable connecter l'armoire afin que la Box SFR lui affecte par défaut une adresse IP.
*Connecter vous sur votre Box SFR en tapant son IP et mettre l'identifiant et mot de passe (par défaut admin/admin qu'il est fortement conseillé de le changer)

A renseigner
=Configuration OpenFlyers=

==Navigateur==
Un point '''important''': le navigateur Internet Explorer ne permet pas la communication avec l'armoire. Ce navigateur ne possède pas les fonctions avancées du standard W3C que nous utilisons pour sécuriser les accès.

Firefox ou Chrome sont des navigateurs qui fonctionnent pour déclencher la libération des clés.

Le ou les PC du club devront être paramétrés pour que ce soient un de ces navigateur qui soit en service.

Comme il est difficile de bloquer Internet Explorer sous Windows il faudra clairement informer les utilisateurs du club
Les navigateurs récents implémentent désormais des règles de filtrage pour bloquer le contenu non sécurisé provenant d'une page HTTP chargé depuis une page HTTPS. C'est le cas avec le serveur OF ou l'URL est en HTTPS et celles de l'armoire en HTTP. Il faut donc configurer les navigateurs pour ne pas réagir à ce mixte d'adresse URL

===Firefox===
Dans la barre d'adresse, taper about:config
*Valider le message d'avertissement comme quoi vous devez faire Attention
*Rechercher le paramètre security.mixed_content
*Double cliquer sur le paramètre security.mixed_content.block_active_content pour qu'il passe à '''false'''.
*La ligne s'affiche en gras

===Chrome===
*Clique droit sur l’icône de Chrome
*Cliquer sur Propriétés
*Ajouter dans le champs Cible à la fin --allow-running-insecure-content
*Le champs cible resemblera donc à <BASH>"C:\Program Files (x86)\Google\Chrome\Application\chrome.exe" --allow-running-insecure-content</BASH>

==Paramétrage OF==

*Aller dans '''Admin > Configuration > Paramétrage'''
**Dans la section '''Gestion des vols''' et cliquer sur l'option '''Activé(e)''' de la rubrique '''Gestion armoire à clés'''.
[[Fichier:Config OF0.JPG]]
**Cliquer dans Valider, de nouveaux champs seront alors de nouveau visibles
[[Fichier:Config OF1.jpg]]
**Cliquer sur '''Activé(e)''' dans la rubrique '''Gestion des clés'''
**Choisissez la durée de temporisation pour prendre la clé, elle dépend de la distance entre votre PC et l'armoire. 10 à 20 secondes sont des valeurs usuelles
**Dans la rubrique '''Logiciel de contrôle de l'armoire à clés''' choisissez '''PyOpenKey2'''
**Dans la rubrique '''IP du PC contenant le logiciel de contrôle''' indiquer l'adresse IP du Module OF ''' 192.168.1.200''' (A adapter en fonction de votre réseaux)
**Dans la rubrique '''Port du PC contenant le logiciel de contrôle''' indiquer le port '''4080''' (ou autre si spécifié sur le bordereau de livraison)
**Cliquer dans ''''Valider''', 2 nouveaux champs seront alors de nouveau visibles
[[Fichier:Config OF.jpg]]
**Dans la rubrique '''Fermeture automatique des vols au retour de la clé''' cocher '''Désactivé(e)'''
**Dans la rubrique '''Phrase mot de passe''', saisissez la même phrase que celle qui vous aura été indiquée sur le bordereau de livraison
**Cliquer sur Valider
*Aller dans '''Admin > Utilisateurs > Profils''' et vérifier que le profil sous lequel vous êtes connecté possède le droit '''Gestion des clés''' dans l'onglet '''Généralité admin'''

=Première connexion=
Faite une réinitialisation en débranchant l'alimentation puis en la reconnectant après 5 secondes

=Finalisation=
*Ouvrir la porte de service
*Brancher le connecteur de la batterie de sauvegarde (Déconnecté pour le transport)

[[Fichier:Connecteur Batterie.JPG]]
*Refermer la porte de service

KeyPanel installation1

2014-01-18T20:14:21Z

Joel : Page créée avec « L'armoire à clé ProxSafe Smart3U‎ de Deister permet la gestion de 8, 16 ou 32 clés avec l'application openFlyers Existe aussi en... »

Fichier:Config OF0.JPG

2014-01-18T20:10:06Z

Joel :

Fichier:Config OF1.jpg

2014-01-18T20:09:38Z

Joel :

Fichier:Connecteur Batterie.JPG

2014-01-18T19:11:13Z

Joel :

Fichier:Alim.JPG

2014-01-18T19:05:52Z

Joel :

Fichier:Connexion rj45 OF.jpg

2014-01-18T19:03:35Z

Joel :

Fichier:Connexion rj45masterplane.jpg

2014-01-18T18:48:22Z

Joel :

Fichier:LiveBox.JPG

2014-01-18T18:38:41Z

Joel :

Fichier:Reseau Linux.jpg

2014-01-18T17:45:07Z

Joel : a téléversé une nouvelle version de « Fichier:Reseau Linux.jpg »

Fichier:Table routage windows.jpg

2014-01-18T17:41:27Z

Joel : Reseau

Reseau

Fichier:Reseau Linux.jpg

2014-01-18T17:36:25Z

Joel :

Fichier:Reseau W7.jpg

2014-01-18T17:30:26Z

Joel :

Fichier:Deister ProxSafe Mini3U.pdf

2014-01-18T15:15:44Z

Joel : Deister ProxSafe Mini

Deister ProxSafe Mini

Fichier:Deister ProxSafe Smart3U.pdf

2014-01-18T15:15:10Z

Joel : a téléversé une nouvelle version de « Fichier:Deister ProxSafe Smart3U.pdf » : Version du 18 janvier 2014 à 15:05 rétablie

Deister ProxSafe Smart 3U datasheet

Fichier:Deister ProxSafe Smart3U.pdf

2014-01-18T15:14:54Z

Joel : a téléversé une nouvelle version de « Fichier:Deister ProxSafe Smart3U.pdf »

Deister ProxSafe Smart 3U datasheet

Fichier:Deister ProxSafe Smart3U.pdf

2014-01-18T15:05:39Z

Joel : Deister ProxSafe Smart 3U datasheet

Deister ProxSafe Smart 3U datasheet

Compatibilité des navigateurs

2013-12-22T11:03:03Z

Joel : /* Navigateur compatible avec l'armoire à clés */

__TOC__

=Présentation=
Cette page présente la compatibilité des versions d'OpenFlyers pour chaque navigateur.

D'une façon générale nous déconseillons l'usage du navigateur Internet Explorer qui souffre depuis toujours d'un retard dans la mise en place des technologies du web et le respect des standards. A la place, nous recommandons sur Windows, l'usage de [[Wikipedia-fr:Google Chrome|Google Chrome]] ou de [[Wikipedia-fr:Mozilla Firefox|Mozilla Firefox]].

==Navigateur compatible avec l'armoire à clés==
Pour un fonctionnement avec une armoire à clé, le club doit être en HTTPS mais le dialogue entre le navigateur et le daemon est en HTTP. Le mixage des contenus HTTPS et HTTP est considéré comme anormal par les navigateurs car il y a une possibilité d'intrusion « Man in the middle ». Ce risque n'existe pas sur le réseau local. Il faut neutraliser ce bouclier dans les navigateurs :

*IE toute version: ne fonctionne pas avec l'armoire
*Firefox il faut mettre le paramètre security.mixed_content.block_active_content à false
**Ouvrir Firefox
**Saisir dans la barre d’adresse : about:config
**Rechercher : security.mixed_content.block_active_content
**Double-cliquer pour changer la valeur de true en : false
*Chrome il faut ajouter le paramètre --allow-running-insecure-content
**Clic droit sur l’icône Google Chrome sur le bureau.
**Sélectionner Propriétés
**A la fin des informations du champ Cible ajouter " --allow-running-insecure-content" (il y a un espace avant le premier tiret).
**Cliquer sur OK.

=Versions supportées=
Le tableau ci-dessous présente les versions des navigateurs les plus utilisés à partir desquelles le logiciel OpenFlyers peut être utilisé.

{| class="wikitable center"
!OpenFlyers
![[Wikipedia-fr:Internet Explorer|Internet Explorer]]
![[Wikipedia-fr:Google Chrome|Google Chrome]]
![[Wikipedia-fr:Mozilla Firefox|Mozilla Firefox]]
![[Wikipedia-fr:Opera|Opera]]
![[Wikipedia-fr:Safari_(logiciel)|Safari]]
|-
|'''version 1.3''' || version >= 8 || version >= 4 || version >= 3.5 || version >= 10.5 || version >= 5
|-
|'''version 2.1''' || versions 8 et 9|| version >= 4 || version >= 3.5 || version >= 10.5 || version >= 5
|-
|'''version 3.0.3''' || version >= 8 || version >= 4 || version >= 3.5 || version >= 10.5 || version >= 5
|-
|'''version 4''' || version >= 10 || version >= 4 || version >= 3.5 || version >= 10.5 || version >= 5
|}

Compatibilité des navigateurs

2013-12-22T11:01:04Z

Joel : /* Présentation */

__TOC__

=Présentation=
Cette page présente la compatibilité des versions d'OpenFlyers pour chaque navigateur.

D'une façon générale nous déconseillons l'usage du navigateur Internet Explorer qui souffre depuis toujours d'un retard dans la mise en place des technologies du web et le respect des standards. A la place, nous recommandons sur Windows, l'usage de [[Wikipedia-fr:Google Chrome|Google Chrome]] ou de [[Wikipedia-fr:Mozilla Firefox|Mozilla Firefox]].

==Navigateur compatible avec l'armoire à clés==
Pour un fonctionnement avec une armoire à clé, le club doit être en HTTPS mais le dialogue entre le navigateur et le daemon est en HTTP. Le mixage des contenu HTTPS et HTTP est considéré comme anormal par les navigateurs car il y a une possibilité d'intrusion « Man in the middle ». Il faut neutraliser ce bouclier dans le navigateurs :

*IE toute version: ne fonctionne pas avec l'armoire
*Firefox il faut mettre le paramètre security.mixed_content.block_active_content à false
**Ouvrir Firefox
**Saisir dans la barre d’adresse : about:config
**Rechercher : security.mixed_content.block_active_content
**Double-cliquer pour changer la valeur de true en : false
*Chrome il faut ajouter le paramètre --allow-running-insecure-content
**Clic droit sur l’icône Google Chrome sur le bureau.
**Sélectionner Propriétés
**A la fin des informations du champ Cible ajouter " --allow-running-insecure-content" (il y a un espace avant le premier tiret).
**Cliquer sur OK.

=Versions supportées=
Le tableau ci-dessous présente les versions des navigateurs les plus utilisés à partir desquelles le logiciel OpenFlyers peut être utilisé.

{| class="wikitable center"
!OpenFlyers
![[Wikipedia-fr:Internet Explorer|Internet Explorer]]
![[Wikipedia-fr:Google Chrome|Google Chrome]]
![[Wikipedia-fr:Mozilla Firefox|Mozilla Firefox]]
![[Wikipedia-fr:Opera|Opera]]
![[Wikipedia-fr:Safari_(logiciel)|Safari]]
|-
|'''version 1.3''' || version >= 8 || version >= 4 || version >= 3.5 || version >= 10.5 || version >= 5
|-
|'''version 2.1''' || versions 8 et 9|| version >= 4 || version >= 3.5 || version >= 10.5 || version >= 5
|-
|'''version 3.0.3''' || version >= 8 || version >= 4 || version >= 3.5 || version >= 10.5 || version >= 5
|-
|'''version 4''' || version >= 10 || version >= 4 || version >= 3.5 || version >= 10.5 || version >= 5
|}

Fichier:Ok.png

2013-06-03T02:20:43Z

Joel : Check icon

Check icon

Fichier:Checklist.png

2013-06-03T02:18:54Z

Joel : Validity icon

Validity icon

Maintenance aéronautique

2013-01-30T01:24:35Z

Joel : /* APRS (Approbation Pour Remise en Service) */

=Présentation=
Cette page présente les notions sur la maintenance aéronautique nécessaires à la prise en main du module de [[MRO3.0.2#Pr.C3.A9sentation|suivi de navigabilité]] d'OpenFlyers.

=Définitions=
==Butée calendaire==
C'est la date limite à laquelle une visite devra être effectuée ou un composant inspecté ou remplacé.

==Butée horaire==
C'est le nombre d'heures de vol total limite auquel une visite devra être effectuée ou un composant inspecté ou remplacé.

==Tolérance==
C'est le temps additionnel toléré d'une visite de maintenance

=La navigabilité d'un aéronef=
La réglementation aéronautique doit être soigneusement respectée afin de minimiser les risques d'accidents. La notion de navigabilité est un terme issu de l’aéronautique civile. Elle permet de s’assurer de l’aptitude au vol des appareils dans des conditions acceptables de sécurité vis-à-vis des passagers, des équipages transportés, des autres aéronefs et des territoires survolés. ([http://fr.wikipedia.org/wiki/Navigabilit%C3%A9 sources])

La navigabilité d'un aéronef dépend d'au moins trois éléments de base :
*la certification de la conception de l'aéronef, qui couvre des activités d'ingénierie d'évaluation, des simulations, des tests de laboratoire et de prototype, et des vols expérimentales ;
*la certification de la production, qui vise à assurer que l'aéronef quitte la chaîne de montage en conformité avec le certificat de conception ;
*la maintenance de l'aéronef, après sa production, avant et pendant chaque vol.

Le module proposé par OpenFlyers traite ce troisième point afin de simplifier le suivi de la navigabilité d'un aéronef.
Il est destiné aux mécaniciens qui effectuent les opérations de maintenance. Parfois, un seul mécanicien est responsable de l'entretien de plusieurs aéronefs, ce qui est le cas dans certains aéro-clubs.

=La maintenance=
==La maintenance courante==
Chaque structure aéronautique est dans l'obligation d'établir un programme d'entretien visant à prévenir ou prédire les dangers potentiels.
Il doit être validé par l'OSAC (Organisme pour la Sécurité de l'Aviation Civile), une organisation chargée du contrôle de la production et de l'entretien des aéronefs civils. Un avion est entretenu selon ce programme qui défini les opérations à effectuer lors de visites programmées. Ces visites sont réalisées selon la durée de fonctionnement et donc de l'usure de ses composants (50 h, 100h, 1000h, 2000 h, ....) mais aussi selon le vieillissement de l'appareil (1 an, 2ans, 6 ans, 10 ans,....) que l'on s'en serve ou pas. L'organisation des travaux peut être assouplie par des tolérances définies dans le programme.

==La maintenance réglementaire==
L'OSAC peut aussi dicter des consignes de navigabilité (CN ou AD pour Airworthiness Directives en anglais) que toute structure doit respecter. Généralement, elles sont émises lorsque des anomalies sont constatées en cours de vie de l'aéronef, par les constructeurs, les ateliers de maintenance, les organismes de surveillance, ...

==La maintenance événementielle==
La maintenance événementielle est déclenchée par des défaillances, accidents ou notations effectuées par les pilotes dans le carnet de route de l'avion.

==APRS (Approbation Pour Remise en Service)==
Après toute opération de maintenance, le mécanicien doit déposer sur le carnet de route une APRS certifiant à nouveau la navigabilité de l'appareil.

Le pilote doit vérifier la présence de cette APRS et ne peut entreprendre un vol avec l'appareil si elle est absente.

=Calcul de l'échéance d'une visite=
Le programme d'entretien d'un aéronef contient les informations qui permettent de suivre sa navigabilité de façon permanente. A chaque visite de maintenance, il faut estimer quand aura lieu la prochaine. Comme lors d'une navigation, un pilote dispose d'une carte sur laquelle la route à suivre est tracée (programme d'entretien). A chaque point tournant (visite), il estime l'heure à laquelle il atteindra le prochain en fonction des informations du moment (heure). Le calcul des échéances d'une visite tient compte de règles strictes décrites ci-dessous.

==Schémas : calcul d'échéances==
Les schémas suivants représentent l'évolution des échéances en fonction de l'hdv (heure de vol) à laquelle les visites sont réalisées.
*La ligne du temps est le nombre d'heures de vol du composant concerné par la visite
*Les parenthèses représentent la période tolérée
*La flèche rouge est le moment où la visite est réellement faite
*La flèche verte est la prochaine visite à faire
*Les flèches rouges et courbées représentent le décalage de la prochaine visite si la visite réelle est réalisée trop tôt

Ci-dessous, une visite de 50h est prévue avec 5h de tolérance. Dans les quatre cas illustrés la visite réalisée a lieu :

#en avance (à 43 hdv) : Un décalage de 7h est décompté sur les prochaines visites programmées
#:[[File:MRO302_maintenance_timeline_1.png|700px|timeline maintenance achieved at 43 flight hours]]
#en avance (à 46 hdv) : Cette fois ci avec un décalage de 4h
#:[[File:MRO302_maintenance_timeline_2.png|700px|timeline maintenance achieved at 46 flight hours]]
#dans la période tolérée (entre 50h et 50h+tolérance) : La prochaine visite programmée reste la même
#:[[File:MRO302_maintenance_timeline_3.png|700px|timeline maintenance achieved at 54 flight hours]]
#en retard (après 50hdv) : La prochaine visite programmée reste la même
#:[[File:MRO302_maintenance_timeline_4.png|700px|timeline maintenance achieved at 57 flight hours]]

Maintenance aéronautique

2013-01-30T01:23:11Z

Joel : /* La maintenance réglementaire */

=Présentation=
Cette page présente les notions sur la maintenance aéronautique nécessaires à la prise en main du module de [[MRO3.0.2#Pr.C3.A9sentation|suivi de navigabilité]] d'OpenFlyers.

=Définitions=
==Butée calendaire==
C'est la date limite à laquelle une visite devra être effectuée ou un composant inspecté ou remplacé.

==Butée horaire==
C'est le nombre d'heures de vol total limite auquel une visite devra être effectuée ou un composant inspecté ou remplacé.

==Tolérance==
C'est le temps additionnel toléré d'une visite de maintenance

=La navigabilité d'un aéronef=
La réglementation aéronautique doit être soigneusement respectée afin de minimiser les risques d'accidents. La notion de navigabilité est un terme issu de l’aéronautique civile. Elle permet de s’assurer de l’aptitude au vol des appareils dans des conditions acceptables de sécurité vis-à-vis des passagers, des équipages transportés, des autres aéronefs et des territoires survolés. ([http://fr.wikipedia.org/wiki/Navigabilit%C3%A9 sources])

La navigabilité d'un aéronef dépend d'au moins trois éléments de base :
*la certification de la conception de l'aéronef, qui couvre des activités d'ingénierie d'évaluation, des simulations, des tests de laboratoire et de prototype, et des vols expérimentales ;
*la certification de la production, qui vise à assurer que l'aéronef quitte la chaîne de montage en conformité avec le certificat de conception ;
*la maintenance de l'aéronef, après sa production, avant et pendant chaque vol.

Le module proposé par OpenFlyers traite ce troisième point afin de simplifier le suivi de la navigabilité d'un aéronef.
Il est destiné aux mécaniciens qui effectuent les opérations de maintenance. Parfois, un seul mécanicien est responsable de l'entretien de plusieurs aéronefs, ce qui est le cas dans certains aéro-clubs.

=La maintenance=
==La maintenance courante==
Chaque structure aéronautique est dans l'obligation d'établir un programme d'entretien visant à prévenir ou prédire les dangers potentiels.
Il doit être validé par l'OSAC (Organisme pour la Sécurité de l'Aviation Civile), une organisation chargée du contrôle de la production et de l'entretien des aéronefs civils. Un avion est entretenu selon ce programme qui défini les opérations à effectuer lors de visites programmées. Ces visites sont réalisées selon la durée de fonctionnement et donc de l'usure de ses composants (50 h, 100h, 1000h, 2000 h, ....) mais aussi selon le vieillissement de l'appareil (1 an, 2ans, 6 ans, 10 ans,....) que l'on s'en serve ou pas. L'organisation des travaux peut être assouplie par des tolérances définies dans le programme.

==La maintenance réglementaire==
L'OSAC peut aussi dicter des consignes de navigabilité (CN ou AD pour Airworthiness Directives en anglais) que toute structure doit respecter. Généralement, elles sont émises lorsque des anomalies sont constatées en cours de vie de l'aéronef, par les constructeurs, les ateliers de maintenance, les organismes de surveillance, ...

==La maintenance événementielle==
La maintenance événementielle est déclenchée par des défaillances, accidents ou notations effectuées par les pilotes dans le carnet de route de l'avion.

==APRS (Approbation Pour Remise en Service)==
Après toute opération de maintenance, le mécanicien doit déposer sur le carnet de route une APRS certifiant à nouveau la navigabilité de l'appareil. Ainsi le pilote doit vérifier la présence de cette APRS et ne peut entreprendre un vol avec l'appareil si elle est absente.

=Calcul de l'échéance d'une visite=
Le programme d'entretien d'un aéronef contient les informations qui permettent de suivre sa navigabilité de façon permanente. A chaque visite de maintenance, il faut estimer quand aura lieu la prochaine. Comme lors d'une navigation, un pilote dispose d'une carte sur laquelle la route à suivre est tracée (programme d'entretien). A chaque point tournant (visite), il estime l'heure à laquelle il atteindra le prochain en fonction des informations du moment (heure). Le calcul des échéances d'une visite tient compte de règles strictes décrites ci-dessous.

==Schémas : calcul d'échéances==
Les schémas suivants représentent l'évolution des échéances en fonction de l'hdv (heure de vol) à laquelle les visites sont réalisées.
*La ligne du temps est le nombre d'heures de vol du composant concerné par la visite
*Les parenthèses représentent la période tolérée
*La flèche rouge est le moment où la visite est réellement faite
*La flèche verte est la prochaine visite à faire
*Les flèches rouges et courbées représentent le décalage de la prochaine visite si la visite réelle est réalisée trop tôt

Ci-dessous, une visite de 50h est prévue avec 5h de tolérance. Dans les quatre cas illustrés la visite réalisée a lieu :

#en avance (à 43 hdv) : Un décalage de 7h est décompté sur les prochaines visites programmées
#:[[File:MRO302_maintenance_timeline_1.png|700px|timeline maintenance achieved at 43 flight hours]]
#en avance (à 46 hdv) : Cette fois ci avec un décalage de 4h
#:[[File:MRO302_maintenance_timeline_2.png|700px|timeline maintenance achieved at 46 flight hours]]
#dans la période tolérée (entre 50h et 50h+tolérance) : La prochaine visite programmée reste la même
#:[[File:MRO302_maintenance_timeline_3.png|700px|timeline maintenance achieved at 54 flight hours]]
#en retard (après 50hdv) : La prochaine visite programmée reste la même
#:[[File:MRO302_maintenance_timeline_4.png|700px|timeline maintenance achieved at 57 flight hours]]

Interfaçage OpenFlyers et armoire à clé

2013-01-01T18:54:15Z

Joel : /* Interface utilisateur OpenFlyers */

__TOC__

=Présentation=
L'objet de cette page est de décrire le protocole d'interfaçage avec toute solution d'armoire à clé.

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.

=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://structure.openflyers.tld/actionOnDemand.php où il faut remplacer structure.openflyers.tld 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://structure.openflyers.tld/actionOnDemand.php où il faut remplacer structure.openflyers.tld 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://structure.openflyers.tld/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>

Interfaçage OpenFlyers et armoire à clé

2013-01-01T18:49:29Z

Joel : /* Interface utilisateur OpenFlyers */

__TOC__

=Présentation=
L'objet de cette page est de décrire le protocole d'interfaçage avec toute solution d'armoire à clé.

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.

=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 :

[[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 '''LIBERER LA CLE''', 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://structure.openflyers.tld/actionOnDemand.php où il faut remplacer structure.openflyers.tld 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://structure.openflyers.tld/actionOnDemand.php où il faut remplacer structure.openflyers.tld 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://structure.openflyers.tld/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>

Interfaçage OpenFlyers et armoire à clé

2013-01-01T18:43:24Z

Joel : /* Exemple de script en Python de logiciel de contrôle d'une armoire */

__TOC__

=Présentation=
L'objet de cette page est de décrire le protocole d'interfaçage avec toute solution d'armoire à clé.

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.

=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 :

[[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 '''LIBERER LA CLE''', il dispose de X secondes. Cette durée est paramétrable par OpenFlyers dans le cas du protocole piloté par OpenKeys.exe sur Windows ou est programmé en dur dans PyOpenKeys sous Linux.

*Lorsqu'il rentre de vol, l'utilisateur n'a plus qu'a retourner sur le formulaire de saisie de vol et à fermer son vol. Après la fermeture, il lui est demandé de remettre sa clé sur l'armoire s'il ne l'a pas fait avant.

=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://structure.openflyers.tld/actionOnDemand.php où il faut remplacer structure.openflyers.tld 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://structure.openflyers.tld/actionOnDemand.php où il faut remplacer structure.openflyers.tld 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://structure.openflyers.tld/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>

Interfaçage OpenFlyers et armoire à clé

2013-01-01T18:18:46Z

Joel : /* Activation et configuration de la gestion des armoires à clé */

__TOC__

=Présentation=
L'objet de cette page est de décrire le protocole d'interfaçage avec toute solution d'armoire à clé.

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.

=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 :

[[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 '''LIBERER LA CLE''', il dispose de X secondes. Cette durée est paramétrable par OpenFlyers dans le cas du protocole piloté par OpenKeys.exe sur Windows ou est programmé en dur dans PyOpenKeys sous Linux.

*Lorsqu'il rentre de vol, l'utilisateur n'a plus qu'a retourner sur le formulaire de saisie de vol et à fermer son vol. Après la fermeture, il lui est demandé de remettre sa clé sur l'armoire s'il ne l'a pas fait avant.

=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://structure.openflyers.tld/actionOnDemand.php où il faut remplacer structure.openflyers.tld 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://structure.openflyers.tld/actionOnDemand.php où il faut remplacer structure.openflyers.tld 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

# HTTP Port from which the OF client contact OpenKeys service
SERVICE_PORT=4080
SERVICE_HOST="127.0.0.1"

KEYS_ADDR='192.168.23.118'
KEYS_PORT=6002
KEY_RELEASE_DURATION=15

# sha224 passwords
PASSWORDS=('847bed9bc354e7e47bc5350a3b3aaf6124f5748224a3c7ad79586c3c')

# init passphrase
passphrase = 'SDjklsdiuQSIPO23879ZERK2098ZL2908DFZLK'

OF_XMLRPC_URL="https://structure.openflyers.tld/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):
m = dummy_proto.dummy_ONOFF_Control()
m.setON(key_num)
self.protocol.send(m)
time.sleep(KEY_RELEASE_DURATION)
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_GET(self, request):
reponse = 0 # NOK par defaut
key_num = 0
if len(request.args) == 0:
# no GET args.
# return javascript code
return """
var handleSuccess = function(o){
if(o.responseText !== undefined){
/* TODO : regarder si on a OK ou NOK */
}
}
var handleFailure = function(o){
if(o.responseText !== undefined){
alert("Erreur lors de la liberation de la clef : "+o.status+" -- "+o.statusText);
}
}
var callback = {
success:handleSuccess,
failure: handleFailure,
argument: {}
};

function releasekey(sessid, keynum) {
YAHOO.util.Connect.asyncRequest('GET', "http://%s:%i/?sessid="+sessid+"&key="+keynum, callback);
document.getElementById('keybutton').enabled=false;
setTimeout ("document.getElementById('keybutton').enabled=true;", 10000);
}
""" % (SERVICE_HOST,SERVICE_PORT)
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:
response = 1
else:
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)
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>

BTS

2012-12-06T01:29:26Z

Joel : /* Comment rapporter un bug */

= Introduction =

Nous utilisons '''Mantis''' comme outil de "traceur de bugs" (ou [http://bts.openflyers.org/ Bug Tracking System]).

Pour pouvoir éditer des informations, il faut d'abord vous identifier.

Lors de la création de votre compte, un mail vous est envoyé automatiquement et instantanément. Si vous ne le recevez pas, vérifiez qu'il n'a pas été mis de côté (voir supprimé) par un outil anti-spam attaché à votre messagerie. Enfin, si vous ne retrouvez pas le mail, envoyez-nous un mail pour demander une activation manuelle de votre compte en nous précisant l'identifiant que vous avez choisi pour la création du compte.

Nous sommes conscient que l'utilisation de cet outil nécessite un peu plus de temps pour rapporter une anomalie que l'envoie d'un mail. Mais pour l'équipe de développement OpenFlyers, c'est un véritable gain de temps qui permet ainsi d'être plus efficace et donc de limiter les coûts !

=Comment rapporter un bug=
Avant de rapporter un bug, prenez le temps d'effectuer les actions suivantes :
*Vérifier que le bug n'est pas déjà rapporté.
*Renseigner les items dès le début pour éviter l'envoi dans une rubrique non adaptée.
*Choisir la bonne catégorie :

{| {{prettytable}}
!Intitulé!!Rubrique
|-
|Admin||si cela touche la partie configuration/administration
|-
|Booking||si cela touche la partie "cahier de réservations"
|-
|Flights Management|| si cela touche la partie "saisie des vols"
|-
|Accounting Management||si cela touche la partie financière
|-
|Documentation|| si cela concerne des précisions sur la documentation
|-
|Update||si cela touche l'utilitaire de changement de version
|-
|Translation||si cela touche les traductions (phrase dans une mauvaise langue ou manquante dans une langue)
|}
*Choisissez la bonne version d'OpenFlyers sur laquelle vous avez constaté le bug. Le numéro de la version d'OF que vous utilisez se trouve en bas à gauche de la page d'identification d'OF.
**1.3.x
**2.0
**2.1.0
**3.0 Alpha
**3.0.2 Alpha
*Résumé :
Rédiger un intitulé explicite

*Dans la description :
:*Si le bug est sur une version en ligne, indiquez sur quel espace client vous l'avez rencontré.
:*Si c'est une version en local, indiquez l'état dans laquelle est votre Base de données. Faire éventuellement une sauvegarde pour la figer dans un stade où le bug est reproductible.

:La description doit être complète pour que les développeurs sachent identifier l'endroit du problème.
:*La nature "réelle" (non affichage, warning, etc.) du problème et sa manifestation.
:*Quelles sont les actions qui vous conduisent au bug
:*Joindre une copie d'écran est parfois plus explicite que de long discours. Ne pas en abuser, on ne cherche pas à documenter un bug pour le contourner mais à fournir des explications au développeur pour traitement.
*En cours de traitement, utiliser les notes pour ajouter des informations, éviter les échanges par email parallèles.

*Lorsque le bug est résolu vous recevrez un email d'information :
:*Merci de bien vouloir confirmer que le bug est résolu en '''fermant votre rapport de bug'''.
:*Si vous constatez que la solution ne correspond pas à votre description (totale ou partielle), relancez le sujet en le changeant d'état.
:*Par contre si vous détectez une nouvelle anomalie rédigez un nouveau rapport de bug.
:La fermeture du Bug doit être effectuée par celui qui l'a émis.
:En l'absence d'action de votre part dans un temps raisonnable le développeur ou un administrateur le fermera.

==Faire une copie d'écran==
Il est souvent utile de joindre une copie d'écran montrant le problème. Cela permet de montrer visuellement le problème et peut nous faire gagner un temps précieux à comprendre la description du problème.

Le site de [http://www.commentcamarche.net www.commentcamarche.net] présente une explication sur [http://www.commentcamarche.net/faq/398-capture-d-ecran-copie-d-ecran comment réaliser des captures d'écran].

Sous Windows, la combinaison de touches Alt + PrintScreen donne le meilleur résultat dans la plupart des cas : la fenêtre active est capturée et placée dans le presse papier. Il faut l'enregistrer avec un nom de fichier type jpg. Pour cela il existe une multitude de [http://www.commentcamarche.net/download/graphisme-9 logiciels de traitement d'images]. Ceci dépend des utilisations que vous souhaitez en faire :
*le plus simple est l'utilitaire Paint inclut dans Windows mais il n'est pas très pratique
*[http://www.gimp.org/ Gimp] est très complet mais lourd pour juste faire des copies d'écran

[http://www.faststone.org/ FastStone] est pratique si vous devez capturer une page qui est plus grande que l'écran ou une portion de l'écran et il permet de sauver la capture au format que l'on souhaite.

=Description des états et de l'avancement de la résolution=
==Etats==
{| {{prettytable}}
!Intitulé de l'état!!Description!!Qui devrait mettre cet état
|-
|nouveau||nouveau bug, c'est l'état initial||le rédacteur du bug
|-
|commentaire||le bug nécessite plus d'informations, le rédacteur du bug devrait y préter attention||un gestionnaire ou un développeur
|-
|accepté||le bug a été lu mais n'est ni confirmé ni assigné||un gestionnaire ou le développeur dont dépend le bug
|-
|confirmé||le bug est confirmé et reproductible||un gestionnaire ou un développeur
|-
|assigné||le bug est assigné à un développeur||un gestionnaire ou un développeur qui le prend en charge
|-
|résolu||le bug devrait être résolu, en attente de la confirmation de sa résolution par le rédacteur du bug||le développeur qui a corrigé le bug
|-
|fermé||le bug est fermé||le rédacteur initial du bug ou un gestionnaire ayant confirmé le bug
|}
==Résolutions==
{| {{prettytable}}
!Intitulé de la résolution!!Description
|-
|ouvert||bug ouvert en attente
|-
|résolu||bug résolu d'après le développeur responsable
|-
|réouvert||bug considéré comme toujours existant après correction
|-
|impossible à reproduire||le bug rapporté n'arrive pas à être reproduit
|-
|impossible à corriger||il n'y a pas de possibilité de corriger le bug
|-
|doublon||le bug a déjà fait l'objet d'un rapport dans le BTS
|-
|pas un bug||Ce n'est pas considéré comme un bug
|-
|suspendu||Le bug est mis de côté
|-
|ne sera pas résolu||Le bug est reconnu mais ne sera pas résolu
|}
=Comment fermer un rapport ?=
Une fois qu'un rapport est positionné sur "résolu", voici comment procéder pour le fermer :
*Cliquer sur le bouton "Rouvrir"
*Mettre l'état du bug sur "fermer"

=Traitement des bugs dans le BTS (pour les développeurs et gestionnaires)=

*Lorsqu'un bug est résolu il faut faire attention à le marquer comme tel dans la '''version en cours''' de modif (=donc normalement la future version publiée)

*La fermeture du Bug doit être effectuée par celui qui l'a reporté.

*En l'absence d'action de sa part dans un temps raisonnable un gestionnaire le fermera.

'''Suivez vos bugs'''

=Respect des standards du web=
Nous avons à coeur de respecter les standards du web dont notamment le standard XHTML 1.0 strict.

Pour vérifier la validité d'une page, il existe plusieurs outils.

Voici comment utiliser celui fourni par le [http://www.w3.org/ W3C] :
*Afficher votre page à l'aide d'un navigateur (firefox ou internet explorer)
*sauver la page seule sur votre disque dur
*Allez sur la page du [http://validator.w3.org/ validator] du W3C
*Uploader le fichier sauvé sur le disque dur
*constatez le résultat

=Interopérabilité=
==JavaScript==
Les interactions dynamiques d'OpenFlyers nécessitent que JavaScript soit actif. Voici une page du support AdSense de Google qui présente [https://www.google.com/adsense/support/bin/answer.py?hl=fr&answer=12654 les différentes méthodes d'activation de JavaScript] en fonction du navigateur.

BTS

2012-12-06T01:27:02Z

Joel : /* Introduction */

= Introduction =

Nous utilisons '''Mantis''' comme outil de "traceur de bugs" (ou [http://bts.openflyers.org/ Bug Tracking System]).

Pour pouvoir éditer des informations, il faut d'abord vous identifier.

Lors de la création de votre compte, un mail vous est envoyé automatiquement et instantanément. Si vous ne le recevez pas, vérifiez qu'il n'a pas été mis de côté (voir supprimé) par un outil anti-spam attaché à votre messagerie. Enfin, si vous ne retrouvez pas le mail, envoyez-nous un mail pour demander une activation manuelle de votre compte en nous précisant l'identifiant que vous avez choisi pour la création du compte.

Nous sommes conscient que l'utilisation de cet outil nécessite un peu plus de temps pour rapporter une anomalie que l'envoie d'un mail. Mais pour l'équipe de développement OpenFlyers, c'est un véritable gain de temps qui permet ainsi d'être plus efficace et donc de limiter les coûts !

=Comment rapporter un bug=
Avant de rapporter un bug, prenez le temps d'effectuer les actions suivantes :
*Vérifier que le bug n'est pas déjà rapporté.
*Renseigner les items dès le début pour éviter l'envoi dans une rubrique non adaptée.
*Choisir la bonne catégorie :

{| {{prettytable}}
!Intitulé!!Rubrique
|-
|Admin||si cela touche la partie configuration/administration
|-
|Booking||si cela touche la partie "cahier de réservations"
|-
|Flights Management|| si cela touche la partie "saisie des vols"
|-
|Accounting Management||si cela touche la partie financière
|-
|Documentation|| si cela concerne des précisions sur la documentation
|-
|Update||si cela touche l'utilitaire de changement de version
|-
|Translation||si cela touche les traductions (phrase dans une mauvaise langue ou manquante dans une langue)
|}
*Choisissez la bonne version d'OpenFlyers sur laquelle vous avez constaté le bug. Le numéro de la version d'OF que vous utilisez se trouve en bas à gauche de la page d'identification d'OF.
**1.3.x
**2.0
**2.1beta

*Résumé :
Rédiger un intitulé explicite

*Dans la description :
:*Si le bug est sur une version en ligne, indiquez sur quel espace client vous l'avez rencontré.
:*Si c'est une version en local, indiquez l'état dans laquelle est votre Base de données. Faire éventuellement une sauvegarde pour la figer dans un stade où le bug est reproductible.

:La description doit être complète pour que les développeurs sachent identifier l'endroit du problème.
:*La nature "réelle" (non affichage, warning, etc.) du problème et sa manifestation.
:*Quelles sont les actions qui vous conduisent au bug
:*Joindre une copie d'écran est parfois plus explicite que de long discours. Ne pas en abuser, on ne cherche pas à documenter un bug pour le contourner mais à fournir des explications au développeur pour traitement.
*En cours de traitement, utiliser les notes pour ajouter des informations, éviter les échanges par email parallèles.

*Lorsque le bug est résolu vous recevrez un email d'information :
:*Merci de bien vouloir confirmer que le bug est résolu en '''fermant votre rapport de bug'''.
:*Si vous constatez que la solution ne correspond pas à votre description (totale ou partielle), relancez le sujet en le changeant d'état.
:*Par contre si vous détectez une nouvelle anomalie rédigez un nouveau rapport de bug.
:La fermeture du Bug doit être effectuée par celui qui l'a émis.
:En l'absence d'action de votre part dans un temps raisonnable le développeur ou un administrateur le fermera.

==Faire une copie d'écran==
Il est souvent utile de joindre une copie d'écran montrant le problème. Cela permet de montrer visuellement le problème et peut nous faire gagner un temps précieux à comprendre la description du problème.

Le site de [http://www.commentcamarche.net www.commentcamarche.net] présente une explication sur [http://www.commentcamarche.net/faq/398-capture-d-ecran-copie-d-ecran comment réaliser des captures d'écran].

Sous Windows, la combinaison de touches Alt + PrintScreen donne le meilleur résultat dans la plupart des cas : la fenêtre active est capturée et placée dans le presse papier. Il faut l'enregistrer avec un nom de fichier type jpg. Pour cela il existe une multitude de [http://www.commentcamarche.net/download/graphisme-9 logiciels de traitement d'images]. Ceci dépend des utilisations que vous souhaitez en faire :
*le plus simple est l'utilitaire Paint inclut dans Windows mais il n'est pas très pratique
*[http://www.gimp.org/ Gimp] est très complet mais lourd pour juste faire des copies d'écran

[http://www.faststone.org/ FastStone] est pratique si vous devez capturer une page qui est plus grande que l'écran ou une portion de l'écran et il permet de sauver la capture au format que l'on souhaite.

=Description des états et de l'avancement de la résolution=
==Etats==
{| {{prettytable}}
!Intitulé de l'état!!Description!!Qui devrait mettre cet état
|-
|nouveau||nouveau bug, c'est l'état initial||le rédacteur du bug
|-
|commentaire||le bug nécessite plus d'informations, le rédacteur du bug devrait y préter attention||un gestionnaire ou un développeur
|-
|accepté||le bug a été lu mais n'est ni confirmé ni assigné||un gestionnaire ou le développeur dont dépend le bug
|-
|confirmé||le bug est confirmé et reproductible||un gestionnaire ou un développeur
|-
|assigné||le bug est assigné à un développeur||un gestionnaire ou un développeur qui le prend en charge
|-
|résolu||le bug devrait être résolu, en attente de la confirmation de sa résolution par le rédacteur du bug||le développeur qui a corrigé le bug
|-
|fermé||le bug est fermé||le rédacteur initial du bug ou un gestionnaire ayant confirmé le bug
|}
==Résolutions==
{| {{prettytable}}
!Intitulé de la résolution!!Description
|-
|ouvert||bug ouvert en attente
|-
|résolu||bug résolu d'après le développeur responsable
|-
|réouvert||bug considéré comme toujours existant après correction
|-
|impossible à reproduire||le bug rapporté n'arrive pas à être reproduit
|-
|impossible à corriger||il n'y a pas de possibilité de corriger le bug
|-
|doublon||le bug a déjà fait l'objet d'un rapport dans le BTS
|-
|pas un bug||Ce n'est pas considéré comme un bug
|-
|suspendu||Le bug est mis de côté
|-
|ne sera pas résolu||Le bug est reconnu mais ne sera pas résolu
|}
=Comment fermer un rapport ?=
Une fois qu'un rapport est positionné sur "résolu", voici comment procéder pour le fermer :
*Cliquer sur le bouton "Rouvrir"
*Mettre l'état du bug sur "fermer"

=Traitement des bugs dans le BTS (pour les développeurs et gestionnaires)=

*Lorsqu'un bug est résolu il faut faire attention à le marquer comme tel dans la '''version en cours''' de modif (=donc normalement la future version publiée)

*La fermeture du Bug doit être effectuée par celui qui l'a reporté.

*En l'absence d'action de sa part dans un temps raisonnable un gestionnaire le fermera.

'''Suivez vos bugs'''

=Respect des standards du web=
Nous avons à coeur de respecter les standards du web dont notamment le standard XHTML 1.0 strict.

Pour vérifier la validité d'une page, il existe plusieurs outils.

Voici comment utiliser celui fourni par le [http://www.w3.org/ W3C] :
*Afficher votre page à l'aide d'un navigateur (firefox ou internet explorer)
*sauver la page seule sur votre disque dur
*Allez sur la page du [http://validator.w3.org/ validator] du W3C
*Uploader le fichier sauvé sur le disque dur
*constatez le résultat

=Interopérabilité=
==JavaScript==
Les interactions dynamiques d'OpenFlyers nécessitent que JavaScript soit actif. Voici une page du support AdSense de Google qui présente [https://www.google.com/adsense/support/bin/answer.py?hl=fr&answer=12654 les différentes méthodes d'activation de JavaScript] en fonction du navigateur.