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 [Interface] |
docs:admin:routeur [2023/04/07 12:26] (Version actuelle) florian [SMTP] |
||
---|---|---|---|
Ligne 42: | Ligne 42: | ||
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|}} |