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.pscToken: MIIcbAIBA...Bv4sVwVpAICCAA=
  mssAuthentication.userName: xxx-pers@mssante.fr
}