Documentation

Connecter votre messagerie, Microsoft 365 et Google Workspace

Pas à pas pour l’administration TI : adresse d’envoi des courriels, Teams et calendriers dans les workflows, et authentification unique. Chaque guide indique qui doit le faire, les autorisations demandées et les problèmes fréquents.

Adresse d’envoi des courriels

Dans Praximo : Paramètres → Courriel

Par défaut, les courriels de votre organisation (rappels, approbations, invitations) partent de l’adresse de Praximo. Pour qu’ils partent de la vôtre (ex. praximo@votre-domaine.com), connectez votre messagerie. C’est facultatif.

Envoyer depuis une adresse Microsoft 365

Qui : Administrateur général ou Administrateur de rôle privilégié du tenant Microsoft 365Durée : 5 minutes
  1. Choisir l’adresse d’envoi

    Une boîte existante de votre organisation, de préférence dédiée (ex. praximo@votre-domaine.com). Une boîte partagée convient : elle ne consomme pas de licence.
  2. Lancer l’autorisation dans Praximo

    Paramètres → Courriel → fournisseur Microsoft 365 → Autoriser dans Microsoft 365. Une page de connexion Microsoft s’ouvre.
  3. Se connecter avec un compte administrateur

    Compte requis : Administrateur général ou Administrateur de rôle privilégié du tenant Microsoft 365.
  4. Accepter les autorisations

    Microsoft affiche « Autorisations demandées » pour l’application Praximo. La liste comprend toutes les permissions de l’application, celles de l’adresse d’envoi comme celles des intégrations (tableau ci-dessous) : c’est normal, une seule autorisation couvre les deux. Cliquez sur Accepter.
  5. Saisir l’adresse d’expédition

    De retour dans Praximo : adresse choisie à l’étape 1, nom affiché (ex. « Praximo – Votre entreprise ») et, au besoin, une adresse de réponse.
  6. Envoyer un test, puis activer

    Le courriel de test doit arriver ; ensuite seulement, Activer. Tant que l’adresse n’est pas active, l’adresse de Praximo reste utilisée.

Qui doit faire l’opération

Le retour de Microsoft n’est accepté que dans le navigateur de la personne qui a cliqué dans Praximo, et dans les 15 minutes. Si l’administration Microsoft 365 est faite par quelqu’un d’autre, faites l’opération ensemble (partage d’écran : la personne administratrice saisit ses identifiants Microsoft dans la fenêtre ouverte), ou invitez-la dans Praximo avec le rôle Administrateur pour qu’elle la fasse elle-même.

Permissions demandées

Permissions Microsoft Graph de l’application Praximo
Permission (application)Pourquoi
Mail.SendEnvoyer les courriels de Praximo depuis l’adresse choisie (adresse d’envoi)
Calendars.ReadWriteCréer les événements de calendrier, gérer les délégations de calendrier
Mail.ReadLire les boîtes surveillées (démarrage d’un workflow par courriel reçu)
User.Read.AllLire les attributs des utilisateurs (département, gestionnaire, UPN…)
GroupMember.ReadWrite.AllAjouter ou retirer des membres de groupes
Group.CreateCréer des groupes de sécurité ou Microsoft 365
TeamMember.ReadWrite.AllAjouter des membres à une équipe Teams
Channel.CreateCréer des canaux Teams

Recommandé : limiter Praximo à certaines boîtes

Les permissions d’application valent pour tout le tenant. Une stratégie d’accès Exchange les limite aux boîtes d’un groupe : l’adresse d’envoi, et les boîtes surveillées et calendriers utilisés par vos workflows s’il y en a. L’ID d’application de Praximo se trouve, après l’autorisation, dans Microsoft Entra ID → Applications d’entreprise → Praximo. (Les rôles RBAC pour applications d’Exchange Online sont une alternative.)
Connect-ExchangeOnline
# Groupe de sécurité à extension messagerie : les seules boîtes que Praximo pourra utiliser
New-DistributionGroup -Name "Praximo - boites autorisees" -Type Security -Members envoi@votre-domaine.com
New-ApplicationAccessPolicy -AppId <ID d'application de Praximo> -PolicyScopeGroupId "Praximo - boites autorisees" -AccessRight RestrictAccess -Description "Praximo"
# Vérification : Granted pour une boîte du groupe, Denied pour les autres
Test-ApplicationAccessPolicy -Identity envoi@votre-domaine.com -AppId <ID d'application de Praximo>

Problèmes fréquents

  • « Besoin d’une approbation de l’administrateur » ou accès refusé

    Le compte utilisé n’a pas le bon rôle : recommencez avec un Administrateur général ou Administrateur de rôle privilégié du tenant Microsoft 365.
  • Retour dans Praximo : « connexion expirée » ou refusée

    Le retour de Microsoft n’est accepté que dans le navigateur de la personne qui a cliqué dans Praximo, et dans les 15 minutes. Si l’administration Microsoft 365 est faite par quelqu’un d’autre, faites l’opération ensemble (partage d’écran : la personne administratrice saisit ses identifiants Microsoft dans la fenêtre ouverte), ou invitez-la dans Praximo avec le rôle Administrateur pour qu’elle la fasse elle-même.
  • Le test échoue après la mise en place d’une stratégie d’accès

    L’adresse d’envoi n’est pas dans le groupe autorisé : ajoutez-la, puis attendez jusqu’à une heure (délai de Microsoft).

Envoyer depuis une adresse Google Workspace

Qui : La personne qui utilise le compte Gmail d’envoi (et l’administration Google Workspace si les applications tierces sont bloquées)Durée : 5 minutes
  1. Choisir le compte d’envoi

    Un compte Google Workspace de votre organisation, de préférence dédié (ex. praximo@votre-domaine.com).
  2. Connecter le compte

    Paramètres → Courriel → fournisseur Google Workspace → Connecter Google, puis connectez-vous avec ce compte. Google demande seulement le droit d’envoyer des courriels (gmail.send) : Praximo ne lit pas cette boîte.
  3. Saisir l’adresse d’expédition

    L’adresse du compte, ou un alias déclaré dans Gmail → Paramètres → Comptes → « Envoyer des messages en tant que ».
  4. Envoyer un test, puis activer

    Comme pour Microsoft 365 : le test doit réussir avant l’activation.

Problèmes fréquents

  • « Accès bloqué » ou « Cette application est bloquée » chez Google

    Votre administration Google Workspace restreint les applications tierces : console d’administration → Sécurité → Accès et contrôle des données → Commandes des API → Accès des applications tierces, puis autoriser Praximo.
  • Refus d’envoi avec une autre adresse

    Cette adresse doit d’abord être déclarée dans Gmail (« Envoyer des messages en tant que ») pour le compte connecté.

Envoyer par un serveur SMTP

Qui : La personne qui gère votre messagerie ou votre hébergeurDurée : 10 minutes
  1. Réunir les paramètres de votre fournisseur

    Nom du serveur, port, sécurité, identifiant et mot de passe du compte d’envoi. Votre hébergeur les publie dans son aide.
  2. Les saisir dans Praximo

    Paramètres → Courriel → Serveur SMTP. Sécurité : SSL avec le port 465, STARTTLS avec le port 587. Le nom du serveur doit être un nom public (pas une adresse IP) ; ports acceptés : 465, 587, 25 et 2525.
  3. Saisir l’adresse d’expédition

    Une adresse que ce compte a le droit d’utiliser comme expéditeur.
  4. Envoyer un test, puis activer

    Le message d’erreur du test indique quoi corriger (voir ci-dessous).

Gmail en SMTP

smtp.gmail.com, port 465 (SSL) ou 587 (STARTTLS), avec un mot de passe d’application (la validation en deux étapes doit être active sur le compte). La connexion Google Workspace ci-dessus évite ce mot de passe.

Microsoft 365 : préférez la connexion Microsoft 365

Microsoft retire l’authentification SMTP par mot de passe (SMTP AUTH) d’Exchange Online : utilisez plutôt le guide Microsoft 365, sans mot de passe à conserver.

Délivrabilité

Votre domaine doit autoriser ce serveur à envoyer en son nom (enregistrements SPF et DKIM de votre fournisseur), sinon les courriels risquent d’arriver dans les indésirables.

Problèmes fréquents

  • Échec d’authentification

    Identifiant ou mot de passe refusé : vérifiez-les, ou créez un mot de passe d’application si votre fournisseur l’exige.
  • Erreur TLS / SSL

    Le mode de sécurité ne correspond pas au port : SSL avec 465, STARTTLS avec 587.
  • « Serveur SMTP introuvable (DNS) »

    Le nom du serveur est mal saisi ou n’existe pas publiquement.
  • « Adresse interne : envoi refusé »

    Le serveur pointe vers une adresse privée : Praximo n’envoie que par des serveurs joignables sur Internet.

Microsoft 365, Teams et boîtes de courriel dans les workflows

Dans Praximo : Paramètres → Intégrations

La connexion Microsoft 365 permet aux workflows d’agir dans vos outils : créer une réunion Teams, ajouter une personne à une équipe Teams ou à un groupe, créer un canal, lire les informations d’un employé, et démarrer un workflow à la réception d’un courriel. Les intégrations passent par Microsoft 365 ; toute autre boîte (Gmail, hébergeur…) peut démarrer un workflow par IMAP.

Connecter Microsoft 365 (Teams, calendriers, groupes, boîtes)

Qui : Administrateur général ou Administrateur de rôle privilégié du tenant Microsoft 365Durée : 5 minutes
  1. Lancer la connexion dans Praximo

    Paramètres → Intégrations → Connecter Microsoft 365. Une page de connexion Microsoft s’ouvre.
  2. Se connecter avec un compte administrateur

    Compte requis : Administrateur général ou Administrateur de rôle privilégié du tenant Microsoft 365.
  3. Accepter les autorisations

    Microsoft affiche « Autorisations demandées » pour l’application Praximo. La liste comprend toutes les permissions de l’application, celles de l’adresse d’envoi comme celles des intégrations (tableau ci-dessous) : c’est normal, une seule autorisation couvre les deux. Cliquez sur Accepter.
  4. Vérifier la connexion

    De retour dans Praximo, la carte indique le tenant connecté. Les étapes « Microsoft 365 » et « Événement de calendrier » des workflows sont alors utilisables.
  5. Facultatif : démarrer un workflow par courriel

    Dans la même page, « Démarrer un workflow par courriel » : choisissez une boîte (ex. demandes@votre-domaine.com) et le workflow à suivre. Chaque courriel reçu crée une demande.

Qui doit faire l’opération

Le retour de Microsoft n’est accepté que dans le navigateur de la personne qui a cliqué dans Praximo, et dans les 15 minutes. Si l’administration Microsoft 365 est faite par quelqu’un d’autre, faites l’opération ensemble (partage d’écran : la personne administratrice saisit ses identifiants Microsoft dans la fenêtre ouverte), ou invitez-la dans Praximo avec le rôle Administrateur pour qu’elle la fasse elle-même.

Permissions demandées

Permissions Microsoft Graph de l’application Praximo
Permission (application)Pourquoi
Mail.SendEnvoyer les courriels de Praximo depuis l’adresse choisie (adresse d’envoi)
Calendars.ReadWriteCréer les événements de calendrier, gérer les délégations de calendrier
Mail.ReadLire les boîtes surveillées (démarrage d’un workflow par courriel reçu)
User.Read.AllLire les attributs des utilisateurs (département, gestionnaire, UPN…)
GroupMember.ReadWrite.AllAjouter ou retirer des membres de groupes
Group.CreateCréer des groupes de sécurité ou Microsoft 365
TeamMember.ReadWrite.AllAjouter des membres à une équipe Teams
Channel.CreateCréer des canaux Teams

Recommandé : limiter Praximo à certaines boîtes

Même stratégie d’accès Exchange que pour l’adresse d’envoi : mettez dans le groupe les boîtes surveillées, les calendriers des organisateurs de réunions et l’adresse d’envoi.
Connect-ExchangeOnline
# Groupe de sécurité à extension messagerie : les seules boîtes que Praximo pourra utiliser
New-DistributionGroup -Name "Praximo - boites autorisees" -Type Security -Members envoi@votre-domaine.com
New-ApplicationAccessPolicy -AppId <ID d'application de Praximo> -PolicyScopeGroupId "Praximo - boites autorisees" -AccessRight RestrictAccess -Description "Praximo"
# Vérification : Granted pour une boîte du groupe, Denied pour les autres
Test-ApplicationAccessPolicy -Identity envoi@votre-domaine.com -AppId <ID d'application de Praximo>

Après une mise à jour de Praximo

Si une nouvelle fonction demande une permission de plus, Praximo l’indique : refaites « Connecter Microsoft 365 » pour renouveler l’autorisation.

Problèmes fréquents

  • Une étape Microsoft 365 d’un workflow passe en « Échec »

    La raison est dans l’historique de la demande : permission refusée (autorisation à renouveler ou stratégie d’accès trop restrictive), utilisateur ou équipe introuvable.
  • Retour dans Praximo refusé

    Le retour de Microsoft n’est accepté que dans le navigateur de la personne qui a cliqué dans Praximo, et dans les 15 minutes. Si l’administration Microsoft 365 est faite par quelqu’un d’autre, faites l’opération ensemble (partage d’écran : la personne administratrice saisit ses identifiants Microsoft dans la fenêtre ouverte), ou invitez-la dans Praximo avec le rôle Administrateur pour qu’elle la fasse elle-même.

Démarrer un workflow à partir de n’importe quelle boîte (IMAP)

Qui : La personne qui connaît le mot de passe de la boîte (ou l’administration de la messagerie)Durée : 3 minutes
  1. Réunir les paramètres IMAP

    Serveur IMAP, port et sécurité (SSL/TLS sur le port 993, ou STARTTLS sur le port 143), identifiant et mot de passe de la boîte. Votre hébergeur de messagerie les fournit.
  2. Ajouter la boîte dans Praximo

    Paramètres → Intégrations → « Démarrer un workflow par courriel » → Autre boîte (IMAP): adresse de la boîte, workflow à suivre, puis les paramètres IMAP. La connexion est testée avant l’enregistrement.
  3. Vérifier

    Envoyez un courriel à cette boîte : dans les 5 minutes, il apparaît dans « Derniers courriels reçus » avec la demande créée.

Ce que fait Praximo dans la boîte

Lecture seule de la boîte de réception : aucun message n’est marqué comme lu, déplacé ni supprimé. Seuls les courriels reçus après l’ajout créent des demandes. Le mot de passe est chiffré et jamais réaffiché.

Gmail

imap.gmail.com, port 993 (SSL/TLS), avec un mot de passe d’application (validation en deux étapes active sur le compte) ; l’accès IMAP doit être activé dans Gmail.

Microsoft 365

Pour une boîte de votre tenant, préférez la connexion Microsoft 365 ci-dessus : elle ne demande aucun mot de passe.

Problèmes fréquents

  • Identifiant ou mot de passe refusé

    Vérifiez l’identifiant (souvent l’adresse complète). Gmail et la plupart des comptes protégés par la double authentification exigent un mot de passe d’application.
  • Serveur injoignable ou certificat invalide

    Vérifiez le nom du serveur et le port : Praximo exige une connexion chiffrée (SSL/TLS ou STARTTLS) avec un certificat valide.

Authentification unique (SSO)

Dans Praximo : Paramètres → Authentification unique

Vos employés se connectent à Praximo avec leur compte Microsoft ou Google d’entreprise. Ici, c’est votre organisation qui crée l’application chez son fournisseur, puis en donne les identifiants à Praximo. Offert avec le forfait Entreprise.

SSO avec Microsoft Entra ID

Qui : Administrateur d’applications (ou Administrateur général) de Microsoft Entra IDDurée : 15 minutes
  1. Créer l’application

    Portail Azure → Microsoft Entra ID → Inscriptions d’applications → Nouvelle inscription. Nom : Praximo ; types de comptes : comptes de cet annuaire organisationnel uniquement ; URI de redirection : plateforme Web, avec la valeur affichée dans Praximo (Paramètres → Authentification unique).
  2. Créer un secret client

    Certificats et secrets → Nouveau secret client. Copiez sa valeur tout de suite : elle n’est affichée qu’une fois.
  3. Ajouter les revendications (recommandé)

    Configuration du jeton → revendications facultatives email et xms_edov dans le jeton d’ID.
  4. Remplir Praximo

    Fournisseur Entra ID, ID de locataire (page Vue d’ensemble), ID d’application (client), secret, et vos domaines (ex. votre-domaine.com).
  5. Vérifier les domaines

    Ajoutez l’enregistrement DNS TXT affiché (praximo-verification=…) sur chaque domaine, puis Vérifier les domaines.
  6. Tester, puis imposer (facultatif)

    Tester la connexion SSO avec votre propre compte. Ensuite seulement, vous pouvez imposer le SSO à tous les membres.

Double authentification

Toujours exigée. Par défaut, celle de Praximo est demandée après le SSO ; si un accès conditionnel Entra exige la MFA pour Praximo, vous pouvez accepter celle d’Entra à la place.

Accès de secours

Même avec le SSO imposé, les administrateurs gardent la connexion par mot de passe et MFA si Microsoft est indisponible.

Problèmes fréquents

  • Le test SSO refuse la connexion

    Le compte doit déjà être membre actif de l’organisation dans Praximo, avec le même courriel : le SSO ne crée pas de compte.
  • Domaine non vérifié

    L’enregistrement TXT peut prendre de quelques minutes à quelques heures à se propager ; revérifiez ensuite.

SSO avec Google Workspace

Qui : Administration Google Cloud de votre organisationDurée : 15 minutes
  1. Écran de consentement

    Google Cloud Console → API et services → Écran de consentement OAuth : type Interne.
  2. Créer l’identifiant

    Identifiants → Créer → ID client OAuth → application Web ; URI de redirection autorisé : la valeur affichée dans Praximo (Paramètres → Authentification unique).
  3. Remplir Praximo

    Fournisseur Google Workspace, ID client, secret client, et vos domaines.
  4. Vérifier les domaines, tester, puis imposer (facultatif)

    Mêmes étapes que pour Entra ID.

Problèmes fréquents

  • Le test SSO refuse la connexion

    Le compte doit appartenir à un domaine vérifié de votre Google Workspace et être déjà membre actif dans Praximo.

Une question ? Écrivez-nous : nous répondons sous un jour ouvrable.