README.md

Installation et Utilisation de Eyes of Application

Dans cette documentation, nous verrons comment installer EOA ainsi que son utilisation sur Windows.

Installation

Pré-requis

EOA a besoin des paquets "Redistribuable Visual C++ pour Visual Studio 2015" pour fonctionner correctement.

Téléchargez et installez les applications vc_redist.x64.exe et vc_redist.x86.exe, disponibles sur le site officiel Microsoft ici.

EOA

• Récupérez EOA sur GitHub via le lien suivant.
• Extrayez le dossier téléchargé. Pour lancer l’installation il vous faudra tout d’abord signer le setup.bat.
• Pour ce faire, faites un clic-droit sur setup.bat, allez dans Propriété.
• Cochez la case "Débloquer pour que Windows vous autorise l’utilisation du script, ceci est une sécurité de Windows pour prévenir du lancement de script malveillant".

• Lancez ensuite le fichier setup.bat.
• Renseignez les informations demandées selon vos critères :

Vous avez à présent un nouveau dossier à la racine de votre disque.

• Dirigez-vous vers ce dossier, puis dans Apps. Ouvrez www.eyesofnewtork.fr.ps1 dans un éditeur de texte (Notepad++, Visual Studio Code, etc). Modifiez les éléments suivants en fonction de votre configuration :

$TargetedEON : Adresse IP de votre EON
$NrdpToken : Votre token
$GUI_Equipement_InEON : Nom de votre hôte Windows sur EON

• Dé-commentez la ligne correspondant à votre version de Firefox installé sur votre poste Windows.

Dans l’exemple, le poste a la version 32 bits de Firefox d’installé.

• Enfin, renommez le $Hostname :

Configuration SSH

Le programme utilise une connexion SSH via une paire de clés.
Il vous faut créer cette paire de clés, pour ce faire rendez-vous sur votre serveur EON.

• En tant qu'utilisateur eon4apps exécutez la commande ssh-keygen –t dsa.
• Dirigez-vous ensuite dans le dossier /srv/eyesofnetwork/eon4apps/.ssh afin de retrouver la paire de clé précédement générée.

• Envoyez la clé publique générée dans le fichier authorized_keys avec la commande cat id_dsa.pub >> authorized_keys

• Une fois ceci fait, retournez sur votre poste Windows. Ouvrez PowerShell en administrateur et lancez cette commande pour récupérer la clé et l’envoyer dans le bon dossier. Le login du compte root de la machine EON est nécessaire.

• Après la récupération de votre clé, allez dans le dossier C:\Axians\EOA\sshkey, et lancez puttygen.exe. Importez la clé :

• Puis sauvegardez-la dans C:\Axians\EOA\sshkey :

• Allez dans C:\Axians\EOA\sshkey. Renommez la clé nouvellement généré en id_dsa sans l'extension .ppk

• Supprimez la clé envoyé initialement du serveur EON pour ne garder que la nouvelle clé dans C:\Axians\EOA\sshkey

Configuration d’Eyes Of Network

Maintenant, il faut configurer EON pour qu’il récupère les informations venant d’EOA.

• Rendez-vous sur la page web d’EON.
• Avant de créer et configurer l’hôte, il vous faut créer la commande check_dummy. Le plugin est présent dans EON mais la commande n’existe pas sur l’interface web. Si ce n’est pas le cas, reportez-vous à la documentation de création de commandes.

• Si le service template "GENERIC_PASSIVE" n'est pas présent sur votre serveur EON, il faut le créer en dupliquant le service template GENERIC_SERVICE, puis en apportant les modifications suivantes :

  • sur l'onglet "General", renommer le service et sa description :

  • Désactiver l'option "Active Checks"

  • Activez le "Check Freshness" et passer l'option "Freshness threshold" à 1200

• Rajoutez l’hôte :

• Créez ensuite les services suivants, et configurez-les comme suit :

Votre service doit heriter du template de service "GENERIC_PASSIVE"

Ces services récupèrerons les informations qu’enverra EOA à EON, ce sont des services passifs.

Utilisation et Tests

Maintenant que la configuration est terminée, passons à l’utilisations d’EOA. EOA Simule un utilisateur, le script fait une recherche d’image puis clique et si elle ne la trouve pas, l’envoie à EON. Rendez-vous sur votre poste Windows.

Lancez l’application EyesOfApplicationGUI.exe, et laissez-la travailler quelques instants. Elle ouvrira le site www.eyesofnetwork.fr sur Firefox et tentera de cliquer sur le bouton téléchargement du site. Si elle n’y arrive pas, elle envoie l’erreur à EON en prenant une capture d’écran.

Pour vérifier que tout s’est bien passé, vérifiez sur EON le service non-user de votre hôte :

Si comme ici, vous obtenez CRITICAL à droite, c’est que EOA n’a rien envoyé et que la commande a échouée.
Attention : Il faut que vous ayez lancé EOA avant la vérification et attendu que le programme ait fini, sinon il est normal que cela affiche CRITICAL.

Pour savoir ce qu’il s’est passé, aller dans les logs dans le dossier suivant et ouvrez dans Notepad++ le fichier présent :

Allez à la fin du fichier de Logs, et déterminez la commande PowerShell envoyée commençant ainsi :

Vérifiez dans la commande que les informations des options sont les bonnes, tel que url, token, hostname, et service.
Corrigez les erreurs dans cette commande et dans le script www.eyesofnetwork.fr.ps1 du début de cette documentation, et lancez la commande corrigée en manuel :

Vous devriez obtenir ceci :

Pour vérifier que la commande a bien fonctionnée sur EON, allez sur le lien suivant https://IP_EON/nrdp/. Entrez le nom de votre token (ici toke) et cliquez sur Submit Check Data :

Vous devriez obtenir ceci :

Une fois la commande lancez dans PowerShell, allez dans EON, et vérifiez rapidement que vous avez bien ceci dans user_www.eyesofnetwork.fr :

La commande envoyée manuellement a alors fonctionné. Si vous obtenez ceci également avec le GUI, tout fonctionne. Si l’image est trouvée, vous obtenez alors ce résultat :

Si la sonde est en erreur, un screenshot sera envoyé à EON via ssh, avec le lien de l'image à cliquer en commentaires du service. Pour rendre le lien cliquable, il faut éditer la configuration thruk sur le serveur EON:

# vim /etc/thruk/cgi.cfg
[...]
escape_html_tags=0
[...]
# systemctl restart httpd

Selenium

EOA permet de gérer des scénarios basé sur des copies d'écrans, mais également avec Selenium pour les services web.

Voir la documentation Readme.md pour l'installation des drivers.