...
Utilisateur et mot de passe de connexion à allmysms.com (fourni par allmysms.com) :
Bloc de code sms.connector.allmysms.account.login=xxx sms.connector.allmysms.account.apikey=xxx
Pour configurer le champ expéditeur d'un SMS. Attention, ce champ est limité : 11 caractères max et caractères alphanumériques+espace
Bloc de code sms.connector.allmysms.from.mapJSON = { "": "Univ Xxxxxx", "compte1": "Foo" }
- NB : pour avoir les accusés de réception, il faut configurer https://sms.univ.fr/esup-smsuapi/backChannelAck dans le WebHook accusé de allmysms à l'url https://manager.allmysms.com/api
Broker OLM
Voici la liste des paramètres disponibles dans le fichier src/main/resources/properties/broker/olm/libmgs.properties :
...
Bloc de code |
---|
mvn package |
puis copiez le war dans le répertoire webapps de tomcat.
ou si vous préférez vous pouvez utiliser ant en configurant préalablement le chemin de déploiement dans build.properties
Bloc de code |
---|
ant deploy |
Ajouter l'application dans le contexte du serveur du portail, par exemple par le biais du fichier conf/Catalina/localhost/esup-smsuapi.xml
Bloc de code |
---|
<Context docBase="/usr/local/esup-smsuapi/tomcat/webapps/esup-smsuapi" >
<Resource
name="jdbc/esup-smsuapi"
auth="Container" type="javax.sql.DataSource" driverClassName="com.mysql.jdbc.Driver"
url="jdbc:mysql://localhost/smsuapi" username="xxx" password="xxx"
maxActive="100" maxWait="10000"
validationQuery="select 1"
removeAbandoned="true" removeAbandonedTimeout="60" logAbandoned="true" />
</Context>
|
Remarque : <Resource> n'est pas nécessaire si on utilise hibernate.useJndi=false
(le contexte peut aussi être configuré dans le fichier tomcat conf/server.xml)
L'application peut être déployée dans un serveur d'applications existant, voir la documentation du framework esup-commons
...
L'application se lance quand on lance le serveur tomcat.
Pour envoyer plus de 10000 SMS, il faut configurer le paramètre tomcat "maxParameterCount".
Les services REST d'esup-smsu-api sont synchrones : esup-smu-api ne répond que lorsque l'opération demandée est effectivement traitée. Aussi si une requête sur smsu-api correspond à demander à envoyer un sms à plusieurs milliers de numéros de téléphones, le temps de réponse peut être long. Il faut donc s'assurer qu'aucun timeout au niveau d'un éventuel reverse-proxy ne vienne perturber le bon renvoi de la réponse par esup-smus-api.
...
Bloc de code |
---|
insert into institution (INS_LABEL) values ("monUniv"); insert into account (ACC_LABEL, ACC_QUOTA) values ("test", 100); insert into application (INS_ID, ACC_ID, APP_NAME, APP_CERTIFCATE, APP_QUOTA) values (1, 1, "test", "xxxleMotDePassePourAllerAvecLeUserTest", 20); |
Problèmes
Erreur de connexion au broker OLM
Si vous rencontrez le warning suivant dans smsuapi.log :
Bloc de code |
---|
Warning sent by lib SGS : - arg0 : Problem while sending data.(javax.net.ssl.SSLHandshakeException : Received fatal alert: handshake_failure)
|
ajoutez
Bloc de code |
---|
-Dsun.security.ssl.allowUnsafeRenegotiation=true
|
au lancement de tomcat.
...