Nom de l’auteur/autrice :admin

Crochets Web de l’API REST

Avis

E-mail défini par l’utilisateur et notifications basées sur l’API REST pour gérer GRC – long

Crochets Web de l'API REST

Passer des notifications par e-mail à REST

Introduction
Activation des notifications REST
Test des appels REST

Introduction

Vos notifications peuvent envoyer des e-mails ou des appels REST, cela vous ouvre un monde d'opportunités d'automatisation et de messagerie (Slack, Teams, etc.). Vous pourrez lancer automatiquement des appels REST en fonction de vos conditions de notification.

Activation des notifications REST

Le processus par lequel vous créez une notification REST est le même que celui expliqué avec les e-mails, la différence est que vous devez activer la bascule REST. Comme vous pouvez le voir, vous pouvez envoyer des e-mails et/ou des appels REST sur chaque notification.

Une fois la bascule activée, vous verrez qu’un nouvel onglet devient visible (« Webhooks ») et un bouton en bas du formulaire aussi « List Triggered Webhooks ». Pour configurer vos demandes, utilisez le nouvel onglet et configurez les paramètres de votre point de terminaison.

Dans l’en-tête et le contenu (charge utile) des appels REST, vous pouvez inclure des macros de l’élément qui a déclenché la notification.

Test des appels REST

Une fois que vous avez défini les paramètres REST, vous pouvez tester le REST (sans avoir besoin d'enregistrer la notification) en cliquant sur "Tester". eramba exécutera les appels REST et renverra les résultats.

Episode 1

Présentation des notifications

Episode 2

Créer des notifications

Episode 3

File d'attente des e-mails

Episode 4

Crochets Web de l'API REST

Episode 5

Mise en œuvre des notifications

Crochets Web de l’API REST Lire la suite »

File d’attente des e-mails

Avis

E-mail défini par l’utilisateur et notifications basées sur l’API REST pour gérer GRC – long

File d'attente des e-mails

Vérifiez quels e-mails ont été envoyés

Introduction
File d'attente des e-mails
Courriels de notification

Introduction

Dans cet épisode, nous expliquerons comment eramba envoie des e-mails et comment vous pouvez vérifier quels e-mails ont été envoyés et si une erreur s'est produite lors de la tentative de les envoyer.

File d'attente des e-mails

La plupart des e-mails envoyés par eramba iront dans une file d'attente dans "Système" > "Paramètres" > "File d'attente des e-mails" avant d'être envoyés. L'exception est l'e-mail de réinitialisation du mot de passe.

Toutes les heures, cette file d'attente est vidée en fonction d'un paramètre défini dans votre configuration de messagerie ("Système" > "Paramètres" > "File d'attente de messagerie"). Par défaut, 15 e-mails sont envoyés toutes les heures. Vous pouvez ajuster ce nombre au nombre que vous voulez. Cela signifie que si une notification "Commentaire et pièce jointe" se déclenche à 13h23, l'e-mail ne sera envoyé que 37 minutes plus tard s'il n'y a pas plus de 14 e-mails en attente dans la file d'attente.

Cette file d’attente a une trace de chaque e-mail envoyé par eramba, il existe deux types de statut pour les e-mails dans la file d’attente :

  • En attente : l’e-mail est dans la file d’attente mais n’a pas encore été envoyé
  • Envoyé : l’e-mail a été envoyé

Vous pouvez passer en revue à l’aide de filtres les deux files d’attente, utilisez simplement les filtres dans le coin supérieur droit. 

Courriels de notification

Si vous souhaitez savoir quels e-mails une notification a envoyés, accédez à la notification et cliquez sur "Modifier", puis cliquez sur "Liste des e-mails déjà envoyés".

Par exemple, si un contrôle échoue à trop d’audits, vous pouvez déclencher un statut et l’envoyer au propriétaire du contrôle. Cette notification peut prendre la forme d’un e-mail ou d’une API REST.

Episode 1

Présentation des notifications

Episode 2

Créer des notifications

Episode 3

File d'attente des e-mails

Episode 4

Crochets Web de l'API REST

Episode 5

Mise en œuvre des notifications

File d’attente des e-mails Lire la suite »

Créer des notifications

Avis

E-mail défini par l’utilisateur et notifications basées sur l’API REST pour gérer GRC – long

Créer des notifications

Créez tous les types de notifications par e-mail

Introduction
Onglets des modules
Notifications d'avertissement
Notifications d'avertissement (état dynamique)
Avis de rapport
Notification des commentaires et des pièces jointes
Avis de sensibilisation

Introduction

Dans cet épisode nous allons vous expliquer comment sont créés les différents types de notifications. Gardez à l'esprit que tout au long des cours de cette plateforme (risque, conformité, etc.), nous expliquons également comment les notifications sont créées à l'aide de cas d'utilisation spécifiques pour chaque module.

Les quatre types de notifications utilisent un formulaire très similaire pour créer des notifications. Ce formulaire est organisé en trois onglets :

  • Général
  • Destinataires
  • Corps de l'e-mail

Onglets des modules

Chaque module a des notifications, certains modules ont plusieurs onglets également sur ces onglets, vous trouverez des notifications.

La raison en est que chaque onglet contient des éléments et que chaque élément nécessite une forme de notification. Les notifications « Avertissement » qui se déclenchent contre une « Date limite » nécessitent la date limite de l’élément et souvent celle-ci se trouve dans un onglet séparé (Audit, Avis, etc.).

Par exemple : le module Contrôles internes comporte quatre onglets. Si vous souhaitez envoyer des notifications par e-mail 10 jours avant une échéance « Audit », vous devez créer cette notification « Avertissement » dans l’onglet « Audit » car c’est sur cet onglet que le « Planifié La date de début » est (par opposition à l’onglet Contrôle interne).

Même si vous essayez de créer la notification « Avertissement » mentionnée ci-dessus dans l’onglet « Contrôle interne », vous verrez qu’une telle option n’existe même pas (car sur cet onglet, il n’y a pas de date limite).

Ne vous inquiétez pas – chaque cours de cette plateforme mentionnera sur quel onglet vous devez regarder.

Notifications d'avertissement (date limite)

Nous diviserons l'explication des notifications "Avertissement" en deux, celles qui se déclenchent en fonction d'un délai (Risk Review, etc.) et celles qui se déclenchent en fonction d'un statut dynamique.

Le processus de création d'une notification d'avertissement basée sur une échéance commence par vous localiser au niveau du module où vous souhaitez créer la notification. Si ce module a plus d'un onglet, assurez-vous que vous êtes dans le bon onglet (l'onglet qui a des éléments avec une date limite). L'onglet de droite aura sous "Notifications" > "Avertissement" > "Nouveau" des options pour choisir le nombre de jours (avant ou après).

Le formulaire comporte trois onglets : Général, Destinataires et Corps de l’e-mail. Dans l’onglet « Général », vous devez sélectionner dans la liste déroulante la condition que vous souhaitez utiliser (-1, -10, etc.). Nommez ensuite la notification et choisissez si vous utiliserez les e-mails ou REST.

Sous l’onglet « Destinataires », vous devez sélectionner à qui vous souhaitez que la notification soit envoyée. Avant de plonger dans cet onglet, il est important que vous compreniez ce qui se passera chaque nuit chez eramba une fois que vous aurez créé une notification, disons -10 (10 jours avant la date prévue) :

  • Chaque nuit, eramba vérifiera quelles notifications existent sur chaque onglet
  • Trouvera votre notification -10 jours
  • Examinera chaque élément de cet onglet, qui n’est pas « Terminé » et si la condition correspond (10 jours avant la date limite), il enverra un e-mail en fonction de vos paramètres de destinataire et de corps d’e-mail.

Cela signifie qu’eramba peut faire correspondre un ou plusieurs éléments au cours du cycle décrit ci-dessus, et eramba appliquera les mêmes « Destinataire » et « Corps de l’e-mail » à tous. Vos notifications s’appliquent à TOUS les éléments de la section.

Sous l’onglet « Destinataire », vous avez trois options :

Utilisateurs : vous pouvez sélectionner des utilisateurs et/ou des groupes dans eramba. N’oubliez pas que si vous sélectionnez cette option, à chaque match, ces personnes recevront toujours un e-mail.

Rôles personnalisés : vous pouvez sélectionner les rôles disponibles dans cette section, par exemple « réviseur ». eramba vérifiera alors qui appartient (utilisateur ou groupe) au rôle « reviewer » pour l’élément qui a déclenché cette notification et l’enverra par e-mail. Il s’agit généralement de l’option que vous souhaitez utiliser pour ce type de notification. Vous verrez les rôles pour la section que vous êtes et la section « parent », vous pouvez dire à quelle section le rôle appartient en fonction des parenthèses. 

Sur chaque cours (risque, politiques, etc.) de cette plate-forme, nous vous donnons nos recommandations quant aux personnes à inclure.

 

Sous e-mails, vous pouvez écrire le nombre d’adresses e-mail que vous souhaitez. N’oubliez pas que pour chaque match, eramba enverra un e-mail à ces contacts.

Dans l’onglet « Corps de l’e-mail », vous pouvez (et devriez !) ajuster le corps de l’e-mail à tout ce qui, selon vous, aidera les gens à comprendre ce que vous attendez d’eux. Vous pouvez utiliser des macros pour injecter les attributs de l’élément, vous pouvez également inclure un lien vers l’élément qui a déclenché la notification ou vers la section où se trouve l’élément.

Si vous sélectionnez « URL de la section », ils seront redirigés (après la connexion à eramba) vers la section où la notification est créée et tous les éléments de la section qui sont visibles pour l’utilisateur seront affichés.

Si vous sélectionnez « URL de l’élément », ils seront redirigés (après connexion à eramba) vers l’élément qui a déclenché la notification. Seul cet élément sera affiché (à l’aide d’un filtre) et cette option est donc généralement recommandée pour ce type de notifications.

Notifications d'avertissement (état dynamique)

Le statut dynamique est une autre option dans les notifications "Avertissement" et par conséquent, l'intégralité de l'explication fournie dans la section ci-dessus s'applique. La différence est que cette notification se déclenche lorsqu'un état dynamique (voir le cours sur l'état dynamique) s'active ou se désactive. 

Dans l'onglet "Général", vous trouverez toujours (contrairement au type de notification d'avertissement Date limite qui ne peut être trouvé que dans les sections et les onglets où il y a un champ de date limite) l'option Changement de statut dynamique.

Vous devrez définir quel statut dynamique vous souhaitez envoyer (à partir de la liste des statuts dynamiques sur l’onglet/la section où la notification est créée) et si vous souhaitez déclencher la notification lorsque le statut correspond ou cesse de correspondre.

Les deux autres onglets : « Destinataires » et « Corps de l’email » s’appliquent exactement de la même manière que sur les notifications d’avertissement de type délai.

Avis de rapport

Les notifications de rapport sont utilisées pour envoyer des filtres et des rapports graphiques à intervalles réguliers. Pour utiliser cette notification, vous devez avoir préalablement créé l'un de ces rapports.

Pour créer une notification de rapport, vous devez vous rendre dans la section ou l’onglet où vous avez le rapport et cliquer sur « Notifications » > « Rapports » > « Nouveau »

Dans l’onglet « Général », sélectionnez le « Rapport » que vous souhaitez envoyer. Dans le cas des « Filtres », vous pouvez sélectionner si vous souhaitez envoyer le filtre au format PDF ou CVS et également si vous souhaitez déclencher l’e-mail même si le filtre ne renvoie aucun résultat.

Dans tous les cas, vous devez sélectionner la fréquence d’envoi des rapports. 0 signifie tous les jours, 1 tous les deux jours, etc. à partir du jour où vous avez créé la notification. Les rapports que vous avez configurés seront exécutés ces jours-là et quel que soit leur résultat, ils seront envoyés en fonction de vos paramètres « Destinataire » et « Corps de l’e-mail ».

Sous « Destinataire », vous pouvez configurer les utilisateurs, les groupes et les adresses e-mail qui recevront cette notification. Il n’y a pas d’option « Rôle personnalisé ».

Sous « Corps de l’e-mail », vous pouvez définir l’objet et le corps de votre notification. Les macros ne s’appliquent pas à ce type de notification.

Notification des commentaires et des pièces jointes

Tout élément dans n'importe quelle section et onglet d'eramba a la possibilité d'inclure des commentaires et des pièces jointes. Cette fonctionnalité est fondamentale pour interagir avec d'autres personnes de votre organisation lorsque vous créez des éléments, les révisez, gérez leurs changements de statut, etc.

Vous souhaitez être averti lorsque des personnes rédigent des commentaires et téléchargent des pièces jointes. Pour cela, vous avez besoin d’une notification. Cette notification est susceptible d’être configurée sur n’importe quel module et onglet que vous utilisez activement.

Pour créer une notification Commentaires et pièces jointes dans la section et éventuellement l’onglet où vous souhaitez déclencher la notification sur tout commentaire inclus sur n’importe quel élément et cliquez sur « Notifications » > « Commentaires et pièces jointes » > « Nouveau »

Dans l’onglet « Général », sélectionnez les conditions qui déclencheront la notification, vos options sont comme indiqué sur la capture d’écran ci-dessous. Le résumé s’exécute une fois par jour à minuit.

Sous l’onglet « Destinataires », vos options sont les mêmes que celles expliquées dans les notifications « Avertissement », nous vous suggérons fortement que si vous avez configuré une notification d’avertissement, vous utilisiez les mêmes paramètres pour vous assurer que les mêmes personnes sont impliquées dans toutes les notifications.

Sous « Corps de l’e-mail », vos paramètres sont exactement les mêmes que ceux expliqués dans les notifications « Avertissement ».

Avis de sensibilisation

La notification de sensibilisation est utilisée pour déclencher un e-mail à chaque élément de la section où la notification est configurée, cela pourrait potentiellement signifier de nombreux e-mails et vous devez donc vous assurer de comprendre comment cette notification fonctionne avant de l'utiliser.

Pour créer une notification "Awareness", vous devez vous rendre dans la section ou l'onglet où vous souhaitez envoyer l'e-mail et cliquer sur "Notifications" > "Awareness" > "New"

Sous l’onglet « Général », le seul paramètre pertinent est la périodicité de la notification, la logique est la même que celle expliquée sur la notification « Rapport ». Sous « Destinataires », la logique est la même que celle utilisée pour « Avertissements » ou « Commentaires et pièces jointes », vous utiliserez très probablement le champ « Rôle personnalisé ». Sous le « Corps de l’e-mail », les paramètres sont à nouveau les mêmes que ceux trouvés dans les notifications « Avertissements » ou « Commentaires et pièces jointes ».

Episode 1

Présentation des notifications

Episode 2

Créer des notifications

Episode 3

File d'attente des e-mails

Episode 4

Crochets Web de l'API REST

Episode 5

Mise en œuvre des notifications

Créer des notifications Lire la suite »

Déclenchement des API REST

API REST

Recevez et envoyez des API REST et créez vos propres intégrations – longtemps

 

Déclenchement des API REST

Fonctionnement des schémas de données et des points de terminaison

Introduction
Avis d'avertissement

Introduction

Vous pouvez déclencher des appels REST depuis eramba dans deux circonstances :

  • Lorsqu'une notification "Commentaire et pièce jointe" se déclenche
  • Lorsqu'une notification "Avertissement" / "Statut dynamique" se déclenche

Pour utiliser cette fonctionnalité, vous devez être familiarisé avec l'eramba dans son ensemble et les deux cours suivants :

  • Statut dynamique
  • Avis

Avis d'avertissement

Lors de la configuration de l'une des notifications mentionnées ci-dessus, vous pourrez choisir d'envoyer des "e-mails" ou/et une "notification Web hook"

L’activation de la bascule rendra l’onglet « Webhook » visible, vous y configurerez le point final que vous souhaitez atteindre, sa charge utile, etc. Vous pouvez également utiliser des macros pour saisir dans les requêtes les champs de l’élément (risque, contrôle , Etc) qui a déclenché la notification.

Le bouton « Tester » vous permet de … tester vos requêtes par rapport à votre point de terminaison, eramba affichera la requête envoyée et la réponse obtenue du point de terminaison. Lorsque vous enregistrez la notification, vous pouvez voir toutes les demandes effectuées par la notification sous « Système » / « Paramètres » / « Demandes de crochet Web ». Vous pouvez également configurer le paramètre « Timeout » (en secondes) qui s’appliquera à toutes les requêtes envoyées.

Episode 1

Présentation des API REST

Episode 2

Réception des API REST

Episode 3

Déclenchement des API REST

Déclenchement des API REST Lire la suite »

Réception des API REST

API REST

Recevez et envoyez des API REST et créez vos propres intégrations – longtemps

 

Réception des API REST

Fonctionnement des schémas de données et des points de terminaison

Introduction
Authentification
fanfaronnade
Pagination et limite
Modifier (correctif)
Statut, commentaires et pièces jointes

Introduction

Dans cet épisode, nous expliquerons les concepts clés sur les types d'appels REST qu'eramba peut recevoir à partir de points d'extrémité distants.

Authentification

Vous devez créer un compte dans eramba et activer la bascule "API REST", les groupes et les paramètres de visualisation appliqués à ce compte limiteront le type de données que vous pouvez voir et le type de requêtes que vous serez autorisé à effectuer. Veuillez consulter le cours "Gestion des accès" pour plus de détails.

Les appels REST qui parviennent à eramba doivent utiliser une authentification de base et s'exécuter sur TLS.

Vous devrez également créer un groupe (système / paramètres / groupes) appelé « Documentation API » (ou le nom de votre choix) et activer l’élément « Documentation API » dans la section que vous prévoyez d’utiliser des API. Cela rendra la documentation Swagger disponible pour votre compte.

Toute la documentation de l’API est gérée par swagger et vous la trouverez dans chaque section où les API sont activées dans la barre de menu supérieure sous le nom « API ».

fanfaronnade

L'accès à Swagger s'ouvrira sur un nouvel onglet avec l'interface swagger qui contient :

  • méthodes disponibles
  • terminaux disponibles
  • simulation (récupérer uniquement les requêtes)
  • définitions de schéma pour tous les points de terminaison

Tout développeur pourra comprendre le schéma et les appels basés sur cette documentation, vous pouvez également tester les requêtes (uniquement GET) à l’aide de l’interface. Il est probable que vos développeurs auront besoin de l’aide de quelqu’un qui comprend le fonctionnement d’eramba et ses modules interagissent les uns avec les autres.

Pagination et limite

Vous pouvez transmettre à votre requête les arguments suivants pour contrôler la pagination et les limites :

?page=$pageNumber&limit=$élémentsParPage

Il n'y a pas de tri disponible à ce stade.

Modifier (correctif)

Si vous souhaitez modifier un élément, le JSON doit contenir tous les champs de l'élément, pas seulement celui que vous souhaitez modifier. Pour cette raison, vous devez d'abord afficher l'élément (et obtenir tous les champs), puis l'utiliser pour effectuer le correctif (en ne modifiant que le champ que vous souhaitez mettre à jour et en laissant le reste tel quel)

Statut, commentaires et pièces jointes

Si vous souhaitez extraire un état d'élément ou des commentaires/pièces jointes, vous devez appeler un point de terminaison distinct où l'élément/la section que vous souhaitez interroger est transmis en tant que paramètre.

Si vous voulez voir les valeurs de statut (par exemple) d’un risque, vous devez cliquer sur :

Episode 1

Présentation des API REST

Episode 2

Réception des API REST

Episode 3

Déclenchement des API REST

Réception des API REST Lire la suite »

Envoyez nous un message

Appellez nous

(+237) 674368662

Notre siege

BP 12331 Douala – Cameroun, Boulevard de la République à Akwa

Copyright © 2026. Tous droits reservés.

Facebook-f Twitter Linkedin Youtube