Paramétrage applicatif (v1.6)

Pré-requis

Il est nécessaire de vider votre fichier de configuration context.xml si celui-ci contient encore des paramètres de l’application.

Nouveaux paramètres

Vous trouverez ici tous les nouveaux paramètres pour la version 1.6.0 :

Licence Calcium

Informations concernant la licence de Calcium, voir Gestion de la licence Calcium pour en savoir plus.

calcium:
  licence:
    # Clé publique RSA — à demander à l'équipe Calcium
    public-key: "clé à demander"

    # Chemin du fichier .lic déposé sur le serveur Tomcat de l'établissement, à demander à l'équipe Calcium
    # Licence PERMANENTE
    path: "${catalina.home}/conf/calcium.lic"
    
    # Secret HMAC — à demander à l'équipe Calcium
    # Licence TEMPORAIRE
    temp-secret: "CHANGEME_SECRET_HMAC_FORT_ET_UNIQUE"

Envoi de SMS

Ces paramètres sont facultatifs. L’application se lancera si ceux-ci ne sont pas présents ou renseignés.

Général

Informations globales sur l’envoi de SMS

sms:
  # Adresse mail qui recevra le récapitulatif journalier des sms envoyés
  recap:
    mail:
  # numéro de téléphone de test, utilisé si 'param.test' à true
  test:
    numero:

OVH

Si votre établissement utilise le service d’envoi de SMS de OVH :

sms:
    # utilisation d'OVH
  ovh:
    # Adresse mail validé par OVH
    from:
    destinataire: email2sms@ovh.net
    # Compte SMS à utiliser (ex : sms-xx11111-1)
    compte:
    # Utilisateur SMS à utiliser sur le compte associé
    utilisateur:
    # Mot de passe de l'utilisateur
    motdepasse:
    # Un des expéditeurs déclarés sur votre compte SMS
    expediteur:
    # Paramètre optionnel, séparés par ":" : cf https://help.ovhcloud.com/csm/fr-sms-sending-from-email-address?id=kb_article_view&sysparm_article=KB0051386#etape-2-ajouter-des-champs-facultatifs
    options: "NoStop=1"

Mail

Si votre établissement utilise un service d’envoi de SMS via l’envoi d’un mail

sms:
    mail:
    # adresse mail du service d'envoi de sms (vide si non utilisé)
    to:
    # adresse mail de l'expéditeur, lié au service d'envoi de sms (vide si non utilisé)
    from:

ESUP

Si votre établissement utilise le service d’envoi de SMS via ESUP-SMS

sms:
    esup:
    # URL de l'API ESUP-SMS
    url: https://sms.univ.fr/esup-sms/rest/
    # authentification à l'API ESUP-SMS (vide si non utilisé)
    username:
    password:

Calcium PRdV

Dépôt de document des étudiants

Chemin vers le dossier contenant les documents que les étudiants pourront déposer depuis la plateforme PRdV

# Dépôt de documents PDF par les étudiants via Calcium PRdv (répertoire dédié, distinct de document.path)
depot:
   path: /path/vers/dossier/depots
   # taille max d'un PDF déposé en Mo (défaut 10 ; doit rester <= spring.servlet.multipart.max-file-size, 20MB)
   # max-size-mb: 10
   # nombre max de dépôts en attente de validation par étudiant (défaut 5)
   # max-en-attente: 5

Date bascule vers agenda v2

Défini la date à partir de laquelle il ne sera plus possible de prendre des rendez-vous sur l’ancien planning

prdv:
     # Gel anticipé (bascule agenda v2) : plus aucune prise de RDV dans l'ancien planning
     # à partir de cette date (format yyyy-MM-dd). Vide ou absent = pas de gel.
   # date-gel: 2026-09-01

Bascule de l’API PRdV vers agenda v2

Pour que Calcium PRdV puisse récupérer les informations du nouvel agenda

prdv:
     # Bascule agenda v2 : true = PRdv utilise l'API /rest/prdv/v2 (agenda v2) pour la
     # prise de rendez-vous (exposé à PRdv via GET /rest/prdv/param, champ apiV2Actif).
   # v2:
   #    actif: false

Sécurisation de la communication Calcium <-> PRdV

En lien avec la configuration de PRdV : Connexion sécurisée avec Calcium

prdv:
     # Sécurisation des tokens JWT (défauts dans le code, tout est optionnel) :
   # jwt:
   #    # false (défaut) = tolère les tokens "legacy" sans exp/iss/aud en les loggant en warning ;
     #    # passer à true une fois Calcium PRdv mis à jour (les tokens legacy sont alors rejetés)
   #    strict: false
   #    issuer: calcium-prdv       # claim iss attendu
   #    audience: calcium-core     # claim aud attendu
   #    max-validite-minutes: 15   # durée de validité max acceptée d'un token
   #    app: ''                    # valeur attendue du claim "app" (vide = non contrôlé)
     #    # Phase 1 - signature asymétrique RS256 (la clé privée reste sur le serveur PRdv) :
     #    # hmac (défaut) = tokens HMAC seuls ; mixte = HMAC + RS256 (transition) ; rsa = RS256 seul
     #    # (en mode rsa, le claim idIdentite devient obligatoire sur les endpoints étudiants)
   #    mode: hmac
   #    public-key: ''             # clé publique RSA de PRdv en Base64 (X.509/SPKI), requise si mode != hmac
   #    public-key-secondaire: ''  # 2e clé publique acceptée pendant une rotation de clés

Calcium Scan

Une nouvelle version de Calcium Scan est disponible.

Afin de renforcer la sécurité de communication entre Calcium et Calcium Scan, un secret est à définir.

TODO comment récupérer le secret

# Calcium Scan (secret partagé avec l'application installée sur les postes)
scan:
   secret: votreSecretScan

Envoi de notification sur l’application mobile

Si votre établissement utilise l’application mobile esup-multi, vous pouvez ajouter ces paramètres afin que Calcium puisse envoyer des notifications mobiles, pour les convocations et les rendez-vous, depuis cette application.

Vous pourrez alors paramétrer l’envoi pour les convocation et/ou les rendez-vous depuis la vue des Paramètres.

# notification appli mobile
notif:
  # URL de l'API de notification
  api:
  # Clé JWT pour l'authentification auprès de l'API
  jwt:
  # application qui demande l'envoi des notifications
  channel:
  # uid de l'expediteur des notifications
  sender:
    uid:
  # uid TEST, recevra la notification si 'param.test' à true
  test:

Fichier application.yml

Tous les paramètres de lancement et de configuration de Calcium se situent dans le fichier application.example.yml

Vous devez renommer ce fichier en application.yml et remplir les différents paramètres.

URL de l’application

app:
   url: https://calcium.univ.fr

Proxy

Si vous utilisez un proxy pour votre application, sinon vous pouvez laisser vide.

proxy:
   host:
   port:

CAS

Si vous n’utilisez pas le CAS, vous pouvez laisser le champ vide. Cela n’affichera que la connexion locale lors de la connexion d’un utilisateur.

cas:
   # URL du CAS
   url: https://auth.univ.fr

URL

URLs liés à la documentation et au support, à ne pas modifier.

url:
    # URL de la documentation
    doc: https://calcium.univ-lorraine.fr
    # URL mail de l'assistance
    help: mailto:calcium-support@univ-lorraine.fr

Spring – Base de données et envoi de mail

Informations concernant votre connexion à votre base de données (url, username et password), ainsi que la configuration pour l’envoi de mail (from, host et port)

Si votre timezone n’est pas Europe/Paris, il faut alors le modifier l’option ‘serverTimezone‘ de l’url de votre base de données.

spring:
    # Base de donnees
    datasource:
        url: jdbc:mysql://localhost:3306/calcium?serverTimezone=Europe/Paris
        username: user
        password: xxxx
    # Mails
    mail:
        from: noreply.calcium@univ-lorraine.fr
        host: smtp-test.sig.univ.fr
        port: 25

Si vous utilisez un SMTP authentifié, il faudra rajouter ces paramètres :

spring:
    mail:
        from: noreply.calcium@univ-lorraine.fr
        host: smtp-test.sig.univ.fr
        port: 25
        username: login
        password: password
        properties:
            mail:
                smtp:
                    auth: true
                    starttls:
                        enable: true

Logs

Localisation des fichiers de logs, ainsi que le mail qui reçoit les logs d’erreurs. Veuillez vous assurer que le chemin renseigné ai les mêmes droits que le serveur !

logging:
    file:
        path: target/logs
    mail:
        to: dev-log@univ.fr

Propriétés CALCIUM

Clé de chiffrement

Propre à votre établissement, elle doit être basée sur 16 caractères alpha numériques sans caractères spéciaux (accent, …)

encryption:
   key: 1234567890123456

Université

Nom de votre université. Ce nom sera notamment utilisé lors d’envoi de mail de convocation.

L’année renseignée sera utilisé lors de la création manuel d’un dossier médical étudiant. C’est cette année qui sera utilisée comme année d’inscription de sa scolarité.

univ:
   nom: Université
   # Annee universitaire d'inscription (exemple : 2022 pour 2022-2023)
   annee-inscription: 20XX

Batch

Vérification des processus à lancer tous les X millisecondes (600000ms = 10min). Pas de nécessité à modifier ce paramètre sauf indication de notre part.

batch:
   fixedRate: 600000

Import scolarité

Contient le mail qui recevra le rapport des importations, le nom du fichier contenant les informations de scolarité, ainsi que le chemin du répertoire du fichier précédent

import:
   rapport: dev@univ.fr
   fichier: Calcium.csv
   repertoire: /repertoire/IMPORT

Relances

Mail qui recevra les mails de rapports de relance

relance:
    rapport: utilisateur@univ.fr

Modèle, Document et Archive

Chemin vers le dossier contenant les modèles d’impression. Ce dossier contiendra des documents de type Word, utilisés pour l’impression des documents (ordonnances, certificats…). Cf Gestion des modèles.

Chemin vers le dossier contenant les documents médicaux. Ce dossier contiendra des documents médicaux chiffrés.

Chemin vers le dossier des archives et rapport d’archivage. Ce dossier contiendra les dossiers médicaux archivés des étudiants si l’action a été faite depuis l’application.

modeles:
   path: /path/vers/dossier/modeles
document:
   path: /path/vers/dossier/documents
archives:
   path: /path/vers/dossier/archives

PRdV

Paramètres liés à l’application satellite de prise de rendez-vous en ligne.

Si vous n’utilisez pas cette application, le témoin en-service doit être mis à false.

Si vous utilisez cette application, le témoin sera à true. Le paramètre role ne doit pas changer, mais le secret doit être exactement le même que celui renseigné dans l’application PRdV.

prdv:
   en-service: true
   role: calcium-prdv
   secret: votreSecret

BCB – Banque Claude Bernard

Paramétrages liés à la Banque de données Claude Bernard. Si votre service de santé à un abonnement, il faut renseigner le paramètre code_editeur ainsi que le paramètre id_ps que la BCB vous a fourni.

Si vous avez un abonnement, il faudra préciser UNIV-LORRAINE dans le champ code_editeur

bcb:
  code_editeur:
  id_ps:

VIDAL

Paramétrages liés au dictionnaire médicale VIDAL. Si votre service de santé à un abonnement, il faut renseigner le paramètre app_id ainsi que le paramètre app_key que VIDAL vous a fourni.

vidal:
  app_id:
  app_key:

MesVaccins.net

A dé-commenter et remplir avec les valeurs fournies, seulement si le service est utilisé.

Actuellement, le service n’est pas fonctionnel.

#mv:
#   production: false
#   token: xxx
#   secret: xxx
#   organisationId: xxx
#   OTP: xxx
#   path:
#      certificate: /path/to/certificate

Divers

Sur votre instance de test, le témoin test est à mettre à true. Ainsi, les mails qui sont normalement envoyés à l’étudiant (convocation, …) seront envoyés à l’adresse mail renseigné dans le paramètre mail.test.

Sur le paramétrage dashboard, le paramètre id est fourni par l’équipe Calcium afin que nous puissions avoir un retour de vos installations. Nous ne récupérons que le nom de l’université, si c’est en test ou non et le numéro de version actuel.

param:
   test: true
   mail:
      test: dev@univ.fr
   dashboard:
      # - ID Calcium (a demander a calcium-contact si vous ne l'avez pas)
      id:
      # - cle API (ne pas modifier pour l'instant)
      api: 8469e00f-cfbf-4059-9f3f-bf708873772d
      # - cle secrete (ne pas modifier pour l'instant)
      secret: xxx

Fichier exemple

# URL de l'application
app:
   url: https://calcium.univ.fr
 
# Proxy
proxy:
   host:
   port:
 
cas:
   # URL du CAS
   # Si vous n'utilisez pas le CAS, laisser tel quel
   url: https://auth.univ.fr
 
url:
    # URL de la documentation
    doc: https://calciumv2.univ-lorraine.fr
    # URL mail de l'assistance
    help: mailto:calcium-support@univ-lorraine.fr
 
spring:
    # Base de donnees
    datasource:
        url: jdbc:mysql://localhost:3306/calcium?serverTimezone=Europe/Paris
        username: user
        password: xxxx
    # Mails
    mail:
        from: noreply.calcium@univ-lorraine.fr
        host: smtp-test.sig.univ.fr
        port: 25
 
# Localisation des fichiers de logs, ainsi que le mail qui recoit les logs d'erreurs
logging:
    file:
        path: target/logs
    mail:
        to: dev-log@univ.fr
 
##
# Propriétés CALCIUM
##
 
# Clé de chiffrement propre à votre établissement
# Elle doit être basée sur 16 caractères alpha numériques sans caractères spéciaux (accent, etc...)
# ATTENTION à ne pas mettre d'espace blanc à la fin de la clé
encryption:
   key: 1234567890123456
 
# Université
univ:
   nom: Université
   # Annee universitaire d'inscription (exemple : 2022 pour 2022-2023)
   annee-inscription: 20XX
 
# Batch
batch:
   # Verification des batchs à lancer tous les x millisecondes (600000ms = 10min)
   fixedRate: 600000
 
# Import scolarite
import:
   # mail qui recevra le rapport des importations
   rapport: dev@univ.fr
   # nom du fichier contenant les informations de scolarite
   fichier: Calcium.csv
   # chemin du repertoire du fichier precedent
   repertoire: /repertoire/IMPORT
    
# Relances
relance:
    # mail qui recevra les mails de rapports
    rapport: utilisateur@univ.fr
 
# Divers parametres
param:
   # - Bandeau "TEST" en rouge
   test: true
   # - redirection mail de étudiant vers 'mail.test' si 'test' à true
   mail:
      test: dev@univ.fr
   # dashboard
   dashboard:
      # - ID Calcium (a demander a calcium-contact si vous ne l'avez pas)
      id:
      # - cle API (ne pas modifier pour l'instant)
      api: 8469e00f-cfbf-4059-9f3f-bf708873772d
      # - cle secrete (ne pas modifier pour l'instant)
      secret: xxx
       
# Calcium PRdV
# Ce secret doit correspondre EXACTEMENT à celui que vous avez rentré sur le fichier application.properties du serveur de prise de rendez-vous en ligne
prdv:
   en-service: true
   role: calcium-prdv
   secret: votreSecret
 
# Chemin
modeles:
   # vers les modèles Docx
   path: /path/vers/dossier/modeles
document:
   # vers les documents medicaux
   path: /path/vers/dossier/documents
archives:
   # vers les archives et les rapports d'archivage
   path: /path/vers/dossier/archives
 
# BCB
# à decommenter et remplir avec les valeurs fournies, ssi le service est utilise
bcb:
  code_editeur:
  id_ps:
 
# VIDAL
vidal:
  app_id:
  app_key:
 
# MesVaccins.net
# à décommenter et remplir avec les valeurs fournies, ssi le service est utilisé
# actuellement le service ne fonctionne pas
#mv:
#   production: false
#   token: xxx
#   secret: xxx
#   organisationId: xxx
#   OTP: xxx
#   path:
#      certificate: /path/to/certificate