Sommaire |
---|
Service SMS-U |
|
| Université de Paris 1 |
|
|
| Manuel d'installation de l'api mail |
...
Installation de l'api mail du service SMS-U
L'application de api mail packagée se trouve dans le dossier /dist du projet.
Dézippez le contenue de la distribution la plus récente de esup-smsuapimail dans un répertoire de travail.
Le paramétrage suivant est à effectuer dans le dossier ainsi créé.
...
Back office est disponible sur github. Il est conseillé d'utiliser git pour télécharger les sources :
Bloc de code |
---|
git clone https://github.com/EsupPortail/esup-smsu-api-mail.git |
N'hésitez pas également à utiliser GIT en interne pour exploiter et maintenir à jour vos instances.
Vous pouvez aussi trouver des zip sur cette page : https://github.com/EsupPortail/esup-smsu-api-mail/tags.
...
Déploiement de l'application api-mail
Le api-mail se déploie en mode servlet. Il faut tout d'abord vérifier la configuration des fichiers suivant :
Créez src/main/resources/properties/config.properties en s'inspirant de config.sample.properties. Si vous utilisez git pour l'exploitation et la mise à jour, il est conseillé de faire :
Bloc de code |
---|
ln -s config.sample.properties src/main/resources/properties/config.properties
git add src/main/resources/properties/config.properties
git commit -m 'utiliser config.sample.properties comme base de configuration' |
Il faut configurer les fichiers suivants :
- src/main/resources/properties/config.propertiesproperties/config.properties
- le paramétrage général de l'application.
- build.properties
- le mode quick start doit être activé
- propertiessrc/main/resources/properties/logging/log4j.properties
- Vérifier le chemin d'accès du fichier de log
...
Lancement simple avec jetty
Bloc de code |
---|
mvn jetty:run
# ou ant jetty.run |
...
L'application se lance par la tache ant start :
ant start |
...
Paramétrage de l'api mail du service SMS-U
Un fichier de propriété permet aux exploitants de paramétrer l'api mail du service SMS-U.
Voici la liste des paramètres disponibles disponibles :
Le nom du compte d'imputation par défaut qui sera utilisé par le service
mailmail :
Bloc de code smsuapimail.account.label=
Ce paramètre défini le compte d'imputation qui sera utilisé pour envoyer des SMS lorsque l'email reçu ne spécifie pas de compte d'imputation.
La taille maximale d'un
messagemessage :
Bloc de code smsuapimail.message.maxLength=160
Ce paramètre défini la taille maximale (en nombre de caractères) que peut faire le message avant que celui ci ne soit tronqué.
L'adresse du serveur
poppop :
Bloc de code smsuapimail.pop.serverAddress=pop.example.fr
Ce paramètre défini l'adresse du serveur pop où se trouve la boite email à scruter.
Le login de la boite email sur le serveur
poppop :
Bloc de code smsuapimail.pop.serverLogin=aLogin
Ce paramètre défini le login à utiliser pour se connecter au serveur pop où se trouve la boite email à scruter.
Le mot de passe de la boite email sur le serveur
poppop :
Bloc de code smsuapimail.pop.serverPassword=aPassword
Ce paramètre défini le mot de passer à utiliser pour se connecter au serveur pop où se trouve la boite email à scruter.
Le nom du répertoire où se trouve les
emailsemails :
Bloc de code smsuapimail.pop.folderName=INBOX
Ce paramètre défini le nom du dossier dans lequel sont déposés les emails à traiter.
La balise qui est attendue dans les emails pour définir les
destinatairesdestinataires :
Bloc de code smsuapimail.pop.recipientsTag=destinataires
Ce paramètre défini la balise qui doit se trouver dans les emails reçus et qui définie les destinataires.
La balise qui est attendue dans les emails pour définir le compte d'imputation:
Bloc de code smsuapimail.pop.accountTag=compte
Ce paramètre défini la balise qui doit se trouver dans les emails reçus et qui définie le compte d'imputation.
La balise qui est attendue dans les emails pour définir le
messagemessage :
Bloc de code smsuapimail.pop.contentTag=message
Ce paramètre défini la balise qui doit se trouver dans les emails reçus et qui définie le message.
Le pattern définissant un numéro de téléphone
validevalide :
...
Bloc de code
...
smsuapimail.pop.phoneNumerPattern
...
=(06
...
|07)[0-9
...
]
...
{8
...
}
Ce
...
paramètre
...
défini
...
le
...
pattern
...
qui
...
est
...
utilisé
...
pour
...
définir
...
ce
...
qu'est
...
un
...
numéro
...
de
...
téléphone
...
valide.
L'encodage de caractère utiliser dans les
emailsemails :
Bloc de code smsuapimail.pop.mailCharset=UTF-8
Ce paramètre défini l'encodage utilisé dans les emails reçus.
L'adresse du web service du back
officeoffice :
Bloc de code
...
smsuapi.ws.
...
address=https://host.domain.fr:8081/
...
Ce paramètre défini l'adresse du web service du back office.
- .
La
localisation du truststore :
smsuapimail.ws.trustStore=/an/example/trustStore.jks
Ce paramètre défini la localisation du trustStore de l'application.
- Le mot de passe du truststore :
smsuapimail.ws.trustStorePassword=password
Ce paramètre défini le mot de passe du trustStore.
- La localisation du keyStore :
smsuapimail.ws.keyStore=/an/example/keyStore.jks
Ce Ce paramètre défini la localisation du keyStore de l'application.
- Le mot de passe du keyStore :
smsuapimail.ws.keyStorePassword=password
Ce paramètre défini le mot de passe du keyStore
- Fichier de sauvegarde de l'identifiant message :
Balise Wiki |
---|
*smsuapimail.ws.messageIdFileName{*}=\[Chemin_Accès\]/properties/messageId.txt
Ce fichier conserve le dernier identifiant d'envoi de message envoyé en back office. Il permet de regrouper les SMS provenant un même mail. |
- L'identifiant d'expéditeur envoyé au back office :
smsuapimail.ws.senderId=
Ce paramètre défini l'identifiant d'expéditeur transmis au back office (ce paramètre peut rester vide)
- L'identifiant de groupe d'expéditeur envoyé au back office :
smsuapimail.ws.groupSenderId=
Ce paramètre défini l'identifiant du groupe de l'expéditeur transmis au back office (ce paramètre peut rester vide)
- L'identifiant du service envoyé au back office :
smsuapimail.ws.serviceId=
Ce paramètre défini l'identifiant du service transmis au back office (ce paramètre peut rester vide)
- La
fréquence d'exécution de la tache mail vers
SMSSMS :
Bloc de code smsuapimailquartz.mailToSmsTrigger.cronExpression=0
...
/
...
40 * * * * ?
Ce paramètre défini l'expression cron qui définie la fréquence de polling de la boite email et du processus d'envoi
...
- La fréquence d'exécution de la tache mail vers SMS :
...
.