Première prise en mains, création du premier scénario

L'objectif de cet article est de présenter la démarche pour créer son premier scénario.

Avant de développer le processus technique de création, il est essentiel d'avoir défini le périmètre et l'objectif du scénario :

• quel événement doit-on observer?
• quelle(s) action(s) doit-on déclencher?
• des restrictions de déclenchement de ces actions sont-elles nécessaires?
• si plusieurs actions sont identifiées, l'ordre est-il important?
• qui sont les destinataires des actions?
  
  

1- Tableau de bord et interface

Après installation du composant (voir notre tutoriel), vous accéderez à Obsewhere dans l'administration en Composants / Automatisations Obsewhere.

Obsewhere se présente sous la forme d'un tableau de bord et d'un espace de navigation sur la gauche.

Le tableau de bord est composé de widgets affichant les principaux indicateurs tels que nombre de logs du mois, nombre d'enregistrement en cours dans la file d'attente et surtout le nombre d'actions effectuées (nombre d'emails envoyés, nombre de SMS envoyés etc...). Chaque plugin Action peut-être associé à un widget.

Votre tableau de bord au démarrage 

Exemple de tableau de bord en exploitation 

L'espace de navigation, actuellement appelé "Admin", constitue le menu principal d'Obsewhere. On y retrouve principalement les accès aux séquences Observation, aux séquences Action et aux Scénarios.

en développement Cet espace de navigation sera bientôt composé de 3 onglets, outre l'onglet "Admin" vous trouverez :

• "Alertes" : affiche plusieurs types d'alertes liées à votre environnement : alertes de sécurité (anomalies de connexion, tentative de flooding, fichier système modifié), alertes d'installation (plugin manquant ou dépublié en relation avec un scénario existant).
• "Mises à jour" : information de nouvelles versions de plugins.
  
  

2- Le principe du scénario

Les scénarios peuvent avoir des objectifs très différents : surveiller les accès au site, administrer des paramètres utilisateurs, informer des utilisateurs de la mise à jour d'un contenu, afficher une pop-up sur votre boutique en ligne, créer une aide en ligne pour votre administration, accroître la sécurité de votre site en surveillant des paramètres/fichiers systèmes, récupérer des informations de votre base de données pour une exploitation spécifique, envoyer des messages via des applications externes etc...

Pour constituer les séquences de votre scénario vous devez disposer des plugins correspondant, certains sont gratuits et livrés au sein du pack Obsewhere, d'autres sont payants.
De même, nous proposons quelques scénarios gratuits. Les scénarios payants sont constitués de plugins dont l'un au moins est payant.

Dès lors que vous avez acquis un plugin payant, celui peut-être réutilisé à l'infini si vous en avez la nécessité.

Vous pouvez ainsi créer autant de scénarios que vous souhaitez. Dès lors que vous avez acquis la mécanique de création, qui est toujours la même, le processus vous paraîtra simple.

3- Scénario d'exemple : objectif

Lorsqu'une tentative de connexion non autorisée intervient sur le site, nous allons alerter l'administrateur dans la messagerie Joomla.

Ce scénario fait appel uniquement à des plugins gratuits livrés avec le pack Obsewhere, il est téléchargeable gratuitement sur cette page et s'installe selon cette procédure.

Vous pourrez le tester facilement en essayant de vous connecter à l'administration avec un profil utilisateur "Enregistré". Cette tentative de connexion non autorisée déclenchera l'envoi d'un message d'alerte au groupe d'utilisateurs "Super utilisateurs" dans leur messagerie Joomla.

4- Etape 1- création d'une nouvelle séquence Observateur

Il est possible de créer la séquence observateur lors de la création du scénario, mais nous allons procéder ici étape par étape et créer individuellement chaque séquence "Observateur" et "Action".

Pour accéder à la création et la gestion des séquences "Observateur", il vous suffit de cliquer sur le lien dans le menu "Admin" de votre tableau de bord :  .

Puis cliquer sur le bouton   en haut à gauche de l'écran.

Sur l'image ci-dessous, indiquer un titre explicite (1), cette séquence peut être à usage unique ou réutilisée dans le cadre d'autres scénarios. Vous pouvez créer autant de séquences "Observateur" que vous le souhaitez.

Puis, cliquer sur le bouton  , cela déclenche l'ouverture d'une pop-up qui propose tous les plugins possibles sur votre installation (les plugins gratuits et ceux que vous avez éventuellement acheté).
L'image ci-dessous, présente les plugins tels qu'ils se présentent suite à l'installation du Pack Obsewhere :

Nous allons choisir la thématique "Utilisateur" et sélectionner le plugin "Accès utilisateur", pour cela cliquer sur son bouton 

A noter que le bouton   vous donne accès à la page de tutoriel spécifique de ce plugin, avec le détail des explications de ses paramètres.

Chaque plugin correspond à un objectif précis d'observation et est donc associé à des paramètres spécifiques. Chacun de ces paramètres est enrichi d'une info-bulle explicite.
Voici les explications des paramètres du plugin "Accès utilisateur" :

Applications concernées (1) : on peut surveiller un événement qui concerne le site uniquement, l'administration uniquement, ou les 2. La pertinence de ce choix dépend du contexte et de l'objectif. 
Nous décidons ici de suivre les tentatives de connexion non autorisées à l'administration.

Connexion : l'observation de cet événement permet par exemple de mettre en place un message suite à la connexion, de prévoir une redirection, de logguer cet événement pour des besoins statistiques...

Tentative de connexion bloquée : il s'agit de surveiller des tentatives de connexion de comptes bloqués. L'utilisation de cette fonctionnalité répond dans ce cas à une nécessité de surveillance.
Pour rappel un utilisateur bloqué présente le paramètre suivant : 

Tentative de connexion non autorisée (sélectionné sur l'image ci-dessous - 2) : il s'agit de surveiller des tentatives de connexion à des environnement non autorisés, l'administration ou certaines parties du site. Celles-ci, non visibles sur le site, pourraient être visitées si elles ont été indexées par Google par exemple.

Erreur de connexion : un mot de passe erroné ou un utilisateur inexistant constituent des "erreurs de connexion"; une action de proposition d'assistance peut être déclenchée suite à cet événement. 

Déconnexion : des actions telles qu'une redirection ou un message peuvent être associées à un événement de déconnexion.

Qui peut déclencher cet observateur (3) : il est possible de restreindre la surveillance à un certain type d'utilisateurs (utilisateur connecté) ou un groupe. Dans cet exemple, il n'y a aucune restriction.

Bien entendu, ne pas oublier d'enregistrer ces paramétrages. Vous arrivez ensuite sur l'écran de gestion des séquences Observateur, où l'on peut visualiser que cette première séquence n'est pas encore rattachée à un scénario et qu'elle n'a jamais été exécutée. 

5- Etape 2- création d'une nouvelle séquence Action

Pour accéder à la création et la gestion des séquences "Action", il vous suffit de cliquer sur le lien dans le menu "Admin" de votre tableau de bord : 

Puis cliquer sur le bouton   en haut à gauche de l'écran.

Notre objectif est d'envoyer une alerte au groupe des utilisateurs "Super utilisateurs" au sein de la messagerie privée Joomla.
Après avoir indiqué un titre explicite, avec le bouton  , il faut choisir la thématique Message et sélectionner le plugin "Messagerie privée" :

Après avoir indiqué un titre explicite, vous renseignez les paramètres de la séquence Action qui va envoyer une alerte dans la messagerie Joomla du groupe des Super Utilisateurs :

1 Applications concernées : il s'agit forcément de l'administration qui est la seule à héberger la messagerie Joomla.

2 Titre du message : indiquez un titre suffisamment clair afin qu'il ne puisse pas être confondu avec d'autres types de messages

3 Contenu du message : contenu libre, il est possible d'insérer du HTML

4 Utilisateurs à informer : sélectionner "Groupe d'utilisateurs" puis le groupe ACL "Super Utilisateurs" (plusieurs groupes possibles)

Après avoir enregistré ces paramétrages, vous arrivez ensuite sur l'écran de gestion des séquences Action, où l'on peut visualiser que cette première séquence n'est pas encore rattachée à un scénario et qu'elle n'a jamais été exécutée. 

6- Etape 3 - création du scénario

Pour accéder à la création et la gestion des scénarios, il vous suffit de cliquer sur le lien dans le menu "Admin" de votre tableau de bord : 

Puis cliquer sur le bouton   en haut à gauche de l'écran.

Après indication d'un titre explicite, on visualise à l'écran qu'un scénario est composé d'1 séquence "Observation" et X séquences "Action" (1 ou plusieurs).

Pour définir les séquences "Observation" et "Action" de votre scénario, vous pouvez :

• les créer directement au sein du scénario 
• les sélectionner parmi celles préalablement créées (ce qui correspond à la présente démarche)

Cette démarche de sélection est simple puisque dans notre exemple, nous sommes au démarrage de l'exploitation d'Obsewhere : 1 seule séquence Observation et 1 seule séquence Action sont créées.

Cela donne l'image ci-dessous : une note vous indique d'enregistrer le scénario pour afficher les pictogrammes informatifs. En survol de l'image ci-dessous, vous obtenez le visuel du scénario enregistré.

On remarque que plusieurs actions peuvent être paramétrées.
Exemple simple d'actions multiples : on peut vouloir, suite à l'observation d'un événement, déclencher une action auprès de l'utilisateur connecté (ou un groupe d'utilisateurs) ET déclencher une autre action vers l'administrateur du site.
Exemple avancé d'actions multiples : on peut être amené, suite à l'observation d'un événement, à rechercher une information dans la base de données (action 1) et la restituer dans un message (action 2).

Après enregistrement du scénario, vous arrivez dans l'écran de gestion des scénarios on vous constatez que :

• dans le menu "Administration le nombre de scénarios et de séquences Observateur et Action sont à 1,
• le nombre d'exécutions, pour le moment à 0,
• le scénario créé affiche les séquences Observateur (en Vert) et Action (en Orange) qui le composent : en cliquant sur , un fenêtre pop-up s'affiche avec une synthèse très visuelle des séquences.

De façon similaire, en gestion des séquences Observateur et Action, on peut visualiser les scénarios auxquels elles sont rattachées. Dans la colonne "Utilisé dans" il suffit de cliquer sur  :

7- Etape 4 - test du scénario

1- Créez un utilisateur ayant les droits "Enregistré".

2- Essayez de vous connecter à l'administration de votre site avec cet utilisateur.

3- Connectez-vous avec votre profil "Super utilisateur" et en pied de page de l'administration, vous trouverez l'indicateur d'un nouveau message

4- En cliquant sur , vous accédez à la liste des messages et à celui que vous avez paramétré dans la séquence Action :

5- Au sein de l'écran de gestion des scénarios, le nombre d'exécutions est passé à 1.

6- Dans le menu de gauche d'Obsewhere en "Log interne", vous pouvez analyser et constater l'ensemble du traitement tel qu'il se décompose avec les séquences. Outre la conservation de l'historique, vous disposez également d'informations utiles telles que la date du traitement. On remarque dans notre exemple que 2 utilisateurs, appartenant au groupe ACL "Super utilisateurs", ont été alertés dans leur messagerie.

Pour connaitre plus de détails sur l'exploitation des logs internes, veuillez consulter notre tutoriel.

8- Pour aller plus loin 

Nous vous invitons à consulter notre documentation sur les sujet suivants :

• La gestion des séquences Observateurs (avec tutoriel vidéo)
• La gestion des séquences Actions (avec tutoriel vidéo)
• La gestion des Scénarios
• La log interne Obsewhere
• Listes, sélections des séquences Observateur/Action et des scénarios
• Prise en main avancée d'Obsewhere
• Les abonnés, groupe d'abonnés et leurs champs personnalisés
• La file d'attente des scénarios