Ci-dessous, les différences entre deux révisions de la page.
| Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente | ||
|
docs:admin:routeur [2023/03/27 13:48] florian |
docs:admin:routeur [2023/04/07 12:26] (Version actuelle) florian [SMTP] |
||
|---|---|---|---|
| Ligne 23: | Ligne 23: | ||
| {{:docs:admin:routeur:ui_routeur.png?400|}} | {{:docs:admin:routeur:ui_routeur.png?400|}} | ||
| + | //Liste des services disponibles lorsque l'on arrive sur le module routeur// | ||
| ===== Arborescence ===== | ===== Arborescence ===== | ||
| Ligne 37: | Ligne 38: | ||
| (5) Formulaire de paramétrage d'une instance de connecteur. | (5) Formulaire de paramétrage d'une instance de connecteur. | ||
| - | //Liste des services disponibles lorsque l'on arrive sur le module routeur// | ||
| ====== Services ====== | ====== Services ====== | ||
| Concernant le vocabulaire qui sera utilisé: | Concernant le vocabulaire qui sera utilisé: | ||
| * On parle de service pour désigner les "types de services". | * On parle de service pour désigner les "types de services". | ||
| - | * On parle d'instance de service pour désigner un paramétrage spécifique de ce type de service. | + | * On parle d'instance de service pour désigner une instance de paramétrage basée sur ce type de service. |
| - | Un service représente du côté EzGED un type de fonctionnalité ou un ensemble de fonctionnalités rendues par un service ou une application externe. | + | Un service représente du côté EzGED une fonctionnalité ou un ensemble de fonctionnalités rendues par un service, un serveur ou une application externe. |
| Certains services ne nécessitent pas obligatoirement de paramétrer une instance pour être utilisés. | Certains services ne nécessitent pas obligatoirement de paramétrer une instance pour être utilisés. | ||
| Ligne 52: | Ligne 52: | ||
| - Lorsqu'un script tel que le "tblrouting" effectue des envois de mail. | - Lorsqu'un script tel que le "tblrouting" effectue des envois de mail. | ||
| - | ===== Connecteur par défaut ===== | + | ===== Paramétrage ===== |
| + | |||
| + | ==== Connecteur par défaut ==== | ||
| Le connecteur par défaut sert à deux choses: | Le connecteur par défaut sert à deux choses: | ||
| Ligne 66: | Ligne 68: | ||
| + | |||
| + | ==== Ajouter une instance ==== | ||
| + | |||
| + | <code> | ||
| + | Fonctionnalité à venir | ||
| + | </code> | ||
| ==== Paramétrer une instance ==== | ==== Paramétrer une instance ==== | ||
| <code> | <code> | ||
| - | Fonctionnalité non disponible pour le moment | + | Fonctionnalité à venir |
| </code> | </code> | ||
| Ligne 87: | Ligne 95: | ||
| ====== Connecteurs ====== | ====== Connecteurs ====== | ||
| - | Un connecteur implémente la logique permettant de se "connecter" et de communiquer avec une API ou application tierce. | + | Un connecteur implémente la logique permettant de se "connecter" et de communiquer avec un serveur, une application ou une API tierce. |
| ===== Ajouter une instance ===== | ===== Ajouter une instance ===== | ||
| Ligne 96: | Ligne 103: | ||
| - | Pour ajouter une nouvelle instance vous pouvez le faire soit depuis la vue de tout les connecteurs en cliquant sur | + | Pour ajouter une nouvelle instance vous pouvez le faire soit: |
| + | * depuis la liste de toutes les instances (élément (3) dans [[#arborescence|l'arbo d'exemple]] ) | ||
| + | * depuis un type de connecteur spécifique (élément (4) dans [[#arborescence|l'arbo d'exemple]]) | ||
| + | |||
| + | |||
| + | |||
| + | ===== Paramétrer une instance ===== | ||
| + | |||
| + | Il suffit de cliquer dans l'arborescence sur l'élément correspond à l'instance à configurer. | ||
| + | Par exemple sur l'élément (5) dans [[#arborescence|l'arbo d'exemple]] | ||
| + | |||
| + | Concernant le paramétrage, chaque connecteur étant différent, se référer à la documentation propre à chaque connecteur ci-dessous. | ||
| ===== Connecteurs disponibles ===== | ===== Connecteurs disponibles ===== | ||
| Ligne 104: | Ligne 122: | ||
| Services compatibles: [[#Envoi de mail]] | Services compatibles: [[#Envoi de mail]] | ||
| + | Description: un connecteur qui utilise le protocole SMTP pour envoyer un mail | ||
| + | ^ Paramètre ^ Description ^ Exemple ^ | ||
| + | | Adresse | Adresse du serveur smtp | smtp.mondaine.fr | | ||
| + | | Port | Port d'écoute | 465, 25 | | ||
| + | | SSL/TLS | Active ou non TLS (utilisation de smtp ou smtps) | | | ||
| + | | StartTLS | Activer StartTLS | Pour les serveur exchange généralement | | ||
| + | | Compte | Login pour s'authentifier | | | ||
| + | | Mot de passe | Mot de passe pour s'authentifier | | | ||
| + | | Expéditeur | Adresse de l'expéditeur | admin@mondaine.fr | | ||
| ==== Office365 ==== | ==== Office365 ==== | ||
| - | Services compatibles: [[#Envoi de mail]] | + | **Services compatibles**: [[#Envoi de mail]] |
| + | |||
| + | **Description**: un connecteur qui utilise l'API Graph Microsoft pour envoyer un mail via Office365. | ||
| + | |||
| + | Le paramétrage d'un connecteur Office365 consiste à lui associer un compte Office365 pour lequel on obtiendra autorisation d'émettre des mails. | ||
| + | |||
| + | **Procédure de paramétrage:** | ||
| + | |||
| + | - Première étape, on clique sur "Associer un compte".\\ {{:docs:admin:routeur:connecteur_office365_form_01.png?400|}} | ||
| + | - Une fenêtre s'ouvre pour débuter la demande d'autorisation. Elle fournit un code et un lien sur lequel il faut cliquer. Ce lien amène vers une page de Microsoft. \\ {{:docs:admin:routeur:connecteur_office365_auth_01.png?400|}} | ||
| + | - Sur la page un premier formulaire nous invite à saisir le code.\\ {{:docs:admin:routeur:connecteur_office365_auth_02.png?400|}} | ||
| + | - On sélectionne ensuite le compte Office365 pour lequel on va autoriser EzGED à envoyer des mails. Si le compte n'est pas listé on l'ajoute et on s'y connecte\\ {{:docs:admin:routeur:connecteur_office365_auth_03.png?400|}} | ||
| + | - Une fois authentifié une fenêtre présente la demande d'autorisation et nous invite à confirmer en nous présentant les actions que nous allons autoriser\\ {{:docs:admin:routeur:connecteur_office365_auth_04.png?400|}} | ||
| + | - Si accepté un écran nous confirme que la demande d'autorisation est terminée\\ {{:docs:admin:routeur:connecteur_office365_auth_05.png?400|}} | ||
| + | - On peut retourner sur EzGED où l'on doit nous confirmer que la demande d'autorisation a bien réussie.\\ {{:docs:admin:routeur:connecteur_office365_auth_06.png?400|}} | ||