Gestion multi-opérateurs

Le connecteur MS Santé de la DevBox est compatible avec plusieurs opérateurs. Cette liste contient par exemple mailiz et médimail (liste non exhaustive) et évolue sans cesse en fonctions des besoins des clients.

Ainsi le connecteur permet au PS de se connecter à un large panel d’opérateurs.

Liste des opérateurs

Un service REST permet d’avoir la liste des opérateurs ainsi que le nom des principaux dossiers (inbox, sent, draft et trash) qui peuvent varier en fonction des opérateurs.

GET {url}/mssante/v2/operators

[
  {
    "name": "medimail",
    "apiVersion": "2,",
    "messageManagerActive": true,
    "inboxFolderId": "INBOX",
    "trashFolderId": "TRASH",
    "draftFolderId": "DRAFT",
    "sentFolderId": "SENT",
    "withAllHeaders": true,
    "authenticationModes": [
      "PSC"
    ]
  },
  {
    "name": "mailiz",
    "apiVersion": "2,",
    "messageManagerActive": true,
    "inboxFolderId": "INBOX",
    "trashFolderId": "Trash",
    "draftFolderId": "Drafts",
    "sentFolderId": "Sent",
    "withAllHeaders": true,
    "authenticationModes": [
      "PSC", "P12"
    ]
  },
  {
    "name": "mailiz-v1",
    "apiVersion": "1,",
    "messageManagerActive": false,
    "inboxFolderId": "2",
    "trashFolderId": "3",
    "draftFolderId": "6",
    "sentFolderId": "5",
    "withAllHeaders": false,
    "authenticationModes": [
      "LOGIN_OTP", "CPS"
    ]
  }
  ...
]

name: nom de l’opérateur à passer dans le header mssAuthentication.operator
apiVersion: version de l’api, url du type /mssante/messages pour la v1 et /mssante/v2/messages pour la v2
messageManagerActive: cf Message Manager
withAllHeaders: Permet de récupérer tous les headers renvoyés par le service imap
xxxFolderId: Nom des 4 principaux dossiers
authenticationModes: PSC, P12, LOGIN_OTP et CPS: modes d’authentification supportés par l’opérateur

Ensuite il suffit de passer dans les headers le nom de l’opérateur sur lequel le PS souhaite se connecter.

Exemple:

headers {
  mssAuthentication.operator: mailiz
  mssAuthentication.psc: MIIcbAIBA...Bv4sVwVpAICCAA=
  mssAuthentication.userName: xxx-pers@mssante.fr
}

Autoconfiguration

Si l’opérateur respecte l’exigence suivante :

EX_LPS_0300

Sur les interfaces de l’API LPS, le système DOIT exposer un mécanisme d’auto-configuration à destination des LPS, conforme aux RFC 2782 & 6186, en déclarant sur chacun des noms de domaines déclarés en liste blanche les 4 attributs DNS suivants :

_submission._tcp SRV 10 100 587 [front smtp psc de l'opérateur]
_submission._tcp SRV 20 100 587 [front smtp authcli de l'opérateur]

_imap._tcp SRV 10 100 143 [front imap psc de l'opérateur]
_imap._tcp SRV 20 100 143 [front imap authcli de l'opérateur]

Il suffit à la DevBox_santé de connaître l’url de l’opérateur pour s’y connecter, pour cela la devbox-sante va s’appuyer sur l’adresse email de l’expéditeur.