OPALE - 10.0 - Utilisation - Paramétrage SMTP IBM-i
Différence entre versions
(→Envoi de mail) |
(→Configuration Mapping) |
||
| (10 révisions intermédiaires par 2 utilisateurs non affichées) | |||
| Ligne 1 : | Ligne 1 : | ||
=Préambule= | =Préambule= | ||
| − | Cette document décrit la configuration et le fonctionnement des | + | Cette document décrit la configuration et le fonctionnement des envois d'e-mails via l'API d'envoi d'e-mails IBM i. |
=Configuration système= | =Configuration système= | ||
==Configuration du répertoire de distribution== | ==Configuration du répertoire de distribution== | ||
| − | Depuis une entrée de commande, | + | Depuis une entrée de commande, taper '''WRKDIRE''' puis valider. |
| − | + | ||
| − | Dans « Nom et groupe du syst » | + | Créer un utilisateur et une adresse '''INTERNET GATEWAY''' (par exemple). |
| − | Dans « Profil utilisateur » ne rien saisir | + | |
| − | + | Dans « Nom et groupe du syst » indiquer '''INTERNET''' (par exemple). | |
| − | Dans « Type d’adresse » | + | |
| − | Dans « Nom de zone » | + | Dans « Profil utilisateur » ne rien saisir. |
| − | + | ||
| + | Défiler jusqu’à trouver « Adresse de prédilection » et indiquer 9. | ||
| + | |||
| + | Dans « Type d’adresse » indiquer '''ATCONTXT'''. | ||
| + | |||
| + | Dans « Nom de zone » indiquer '''NETUSERID *IBM'''. | ||
| + | |||
| + | Valider. | ||
==Configuration des attributs de distribution== | ==Configuration des attributs de distribution== | ||
| − | Depuis une entrée de commande, | + | Depuis une entrée de commande, taper '''CHGDSTA''' puis utiliser la touche '''F4'''. |
| − | Dans « Route vers la passerelle SMTP » | + | |
| + | Dans « Route vers la passerelle SMTP » indiquer '''INTERNET''' et adresse GATEWAY (nom créé à l’étape précédente) | ||
==Configuration des attributs SMTP== | ==Configuration des attributs SMTP== | ||
| − | Depuis une entrée de commande, | + | Depuis une entrée de commande, taper '''CHGSMTPA''' puis utiliser la touche F4 |
| − | Dans « Autostart server » | + | |
| − | + | Dans « '''Autostart server''' » indiquer '''*YES''' et taper '''ENTRER''' | |
| + | |||
| + | Faire défiler jusqu’à trouver « '''Mail routeur''' » et indiquer '''SERVEURSMTP''' (par exemple) | ||
| − | + | Remarques :<br> | |
| − | La commande STRTCPSVR *SMTP | + | La commande '''STRTCPSVR *SMTP''' démarre le serveur immédiatement.<br> |
| − | La commande ENDTCPSVR *SMTP | + | |
| + | La commande '''ENDTCPSVR *SMTP''' arrête le serveur immédiatement. | ||
===Ajouter l’adresse IP d’un serveur SMTP=== | ===Ajouter l’adresse IP d’un serveur SMTP=== | ||
| − | Depuis une entrée de commande, | + | Depuis une entrée de commande, taper '''CFGTCP''' puis prendre l’option 10 (Work with host table) |
| − | |||
| − | + | Ajouter l’adresse IP et le nom '''SERVEURSMTP''' (celui indiqué à l’étape précédente) | |
| − | + | <u>Pour chaque utilisateur IBM i pouvant envoyer des mails</u> : | |
| − | + | Taper '''WRKDIRE''' puis option 1 pour un nouvel utilisateur ou 2 pour un utilisateur local : | |
| − | |||
| − | |||
| − | |||
| − | + | Utiliser la touche F19 pour modifier le nom et l’adresse mail de l’utilisateur.<br> | |
| − | |||
| − | + | Exemple : | |
| − | + | SMTP user ID . . . . . . jdieu | |
| − | + | SMTP domain . . . . . . . mappingsuite.com | |
| + | |||
| + | L’adresse sera sous la forme UserID@Domain. | ||
| + | |||
| + | Valider 2 fois pour prendre en compte les modifications | ||
| + | |||
| + | Remarque : Si vous ne paramétrez pas un utilisateur et que celui-ci envoie quand même un mail, il y aura plantage. | ||
| + | |||
| + | Remarque : Si vous paramétrez un utilisateur mais ne paramétrez pas d’adresse mail pour l’utilisateur, le mail sera de la forme utilisateur@machine.domaine. | ||
| + | |||
| + | Remarque : La commande CFGTCPSMTP puis l’option 1 permet également de gérer les adresses mail (seulement pour les profils déjà créés). | ||
=Configuration Mapping= | =Configuration Mapping= | ||
| − | Depuis une entrée de commande, | + | Depuis une entrée de commande, taper '''MAPPING''' pour afficher le menu principal de Mapping |
| − | Dans la barre de menu, prendre le menu « e-Mail » puis « Paramétrage du mail » | + | |
| − | Dans « mode utilisé » | + | Dans la barre de menu, prendre le menu « '''e-Mail''' » puis « '''Paramétrage du mail''' » |
| − | Dans « Dossier temporaire » | + | |
| − | Dans « Dtaq d’attente de traitement » | + | Dans « mode utilisé » indiquer '''*IBM''' |
| − | Dans « Jobd d’envoi du mail » | + | |
| − | Dans « Message sur succès » indiquez à quelle file d’attente envoyer un message si le mail est envoyé | + | Dans « Dossier temporaire » indiquer le nom d’un dossier temporaire pour créer les mails |
| − | Dans « Message sur erreur » indiquez à quelle file d’attente envoyer une erreur est survenue | + | |
| + | Dans « Dtaq d’attente de traitement » indiquer le nom de la data queue d’attente | ||
| + | |||
| + | Dans « Jobd d’envoi du mail » indiquer la job description à utiliser pour soumettre la demande | ||
| + | |||
| + | Dans « Message sur succès » indiquez à quelle file d’attente envoyer un message si le mail est envoyé | ||
| + | |||
| + | Dans « Message sur erreur » indiquez à quelle file d’attente envoyer une erreur est survenue | ||
| − | + | Remarque : Si vous modifiez la jobd pour indiquer un utilisateur particulier (au lieu de *RQD), l’envoi en mail se fera depuis cet utilisateur. Il n’y aura donc pas besoin de paramétrer l’adresse mail de chaque utilisateur (étape 1e). En revanche, les envois de message se feront à cet utilisateur et non à l’utilisateur envoyant le mail. | |
| − | Il n’y aura donc pas besoin de paramétrer l’adresse mail de chaque utilisateur (étape 1e) | ||
| − | En revanche les envois de message se feront à cet utilisateur et non à l’utilisateur envoyant le mail. | ||
=Envoi de mails= | =Envoi de mails= | ||
| − | L’envoi de mail fonctionne comme pour un envoi *MAPPING. | + | L’envoi de mail fonctionne comme pour un envoi '''*MAPPING'''. |
La file d’attente de mail (commande MAPDSPMAIL) sera toujours disponible. | La file d’attente de mail (commande MAPDSPMAIL) sera toujours disponible. | ||
Version actuelle datée du 9 juillet 2019 à 14:25
Sommaire
Préambule
Cette document décrit la configuration et le fonctionnement des envois d'e-mails via l'API d'envoi d'e-mails IBM i.
Configuration système
Configuration du répertoire de distribution
Depuis une entrée de commande, taper WRKDIRE puis valider.
Créer un utilisateur et une adresse INTERNET GATEWAY (par exemple).
Dans « Nom et groupe du syst » indiquer INTERNET (par exemple).
Dans « Profil utilisateur » ne rien saisir.
Défiler jusqu’à trouver « Adresse de prédilection » et indiquer 9.
Dans « Type d’adresse » indiquer ATCONTXT.
Dans « Nom de zone » indiquer NETUSERID *IBM.
Valider.
Configuration des attributs de distribution
Depuis une entrée de commande, taper CHGDSTA puis utiliser la touche F4.
Dans « Route vers la passerelle SMTP » indiquer INTERNET et adresse GATEWAY (nom créé à l’étape précédente)
Configuration des attributs SMTP
Depuis une entrée de commande, taper CHGSMTPA puis utiliser la touche F4
Dans « Autostart server » indiquer *YES et taper ENTRER
Faire défiler jusqu’à trouver « Mail routeur » et indiquer SERVEURSMTP (par exemple)
Remarques :
La commande STRTCPSVR *SMTP démarre le serveur immédiatement.
La commande ENDTCPSVR *SMTP arrête le serveur immédiatement.
Ajouter l’adresse IP d’un serveur SMTP
Depuis une entrée de commande, taper CFGTCP puis prendre l’option 10 (Work with host table)
Ajouter l’adresse IP et le nom SERVEURSMTP (celui indiqué à l’étape précédente)
Pour chaque utilisateur IBM i pouvant envoyer des mails :
Taper WRKDIRE puis option 1 pour un nouvel utilisateur ou 2 pour un utilisateur local :
Utiliser la touche F19 pour modifier le nom et l’adresse mail de l’utilisateur.
Exemple :
SMTP user ID . . . . . . jdieu SMTP domain . . . . . . . mappingsuite.com
L’adresse sera sous la forme UserID@Domain.
Valider 2 fois pour prendre en compte les modifications
Remarque : Si vous ne paramétrez pas un utilisateur et que celui-ci envoie quand même un mail, il y aura plantage.
Remarque : Si vous paramétrez un utilisateur mais ne paramétrez pas d’adresse mail pour l’utilisateur, le mail sera de la forme utilisateur@machine.domaine.
Remarque : La commande CFGTCPSMTP puis l’option 1 permet également de gérer les adresses mail (seulement pour les profils déjà créés).
Configuration Mapping
Depuis une entrée de commande, taper MAPPING pour afficher le menu principal de Mapping
Dans la barre de menu, prendre le menu « e-Mail » puis « Paramétrage du mail »
Dans « mode utilisé » indiquer *IBM
Dans « Dossier temporaire » indiquer le nom d’un dossier temporaire pour créer les mails
Dans « Dtaq d’attente de traitement » indiquer le nom de la data queue d’attente
Dans « Jobd d’envoi du mail » indiquer la job description à utiliser pour soumettre la demande
Dans « Message sur succès » indiquez à quelle file d’attente envoyer un message si le mail est envoyé
Dans « Message sur erreur » indiquez à quelle file d’attente envoyer une erreur est survenue
Remarque : Si vous modifiez la jobd pour indiquer un utilisateur particulier (au lieu de *RQD), l’envoi en mail se fera depuis cet utilisateur. Il n’y aura donc pas besoin de paramétrer l’adresse mail de chaque utilisateur (étape 1e). En revanche, les envois de message se feront à cet utilisateur et non à l’utilisateur envoyant le mail.
Envoi de mails
L’envoi de mail fonctionne comme pour un envoi *MAPPING. La file d’attente de mail (commande MAPDSPMAIL) sera toujours disponible.
