Passer au contenu principal

Intégrations transverses

Configurer les intégrations communes aux produits Hamilton Apps : Identité & SSO, Messagerie SMTP, Fournisseur SMS, Calendriers Microsoft 365/Exchange (Meeting), API & Webhooks, et (si utilisé) synchronisation Azure AD (Visitor).

Mis à jour il y a plus de 2 mois

Panorama & cas d’usage

  • Identité & SSO (Azure AD / ADFS / SAML / OIDC) : authentification centralisée, MFA, moindre privilège.

  • SMTP (e‑mail) : invitations visiteur, confirmations/rappels réunion, notifications hôte.

  • SMS : alertes courtes (arrivée visiteur, rappels), selon politique interne.

  • Calendriers Microsoft 365/Exchange (Meeting) : création/MAJ d’événements et invitations Outlook.

  • API & Webhooks : automatisations (création/MAJ, notifications sortantes) et export piloté.

  • Synchronisation Azure AD (Visitor) : création/mise à jour de profils/résidents selon vos règles.


Mise en œuvre — étapes communes (check‑list)

  1. Cadrage IT : valider périmètre, sécurité (MFA, journaux), données échangées, rétention.

  2. Comptes techniques : créer des comptes de service dédiés (SMTP/SMS/API) et limiter les droits.

  3. Réseau : autoriser les flux sortants requis (IdP/Graph/SMTP/SMS) et vérifier la résolution DNS.

  4. Configuration dans Hamilton Apps (modules dédiés) et tests sur un environnement pilote.

  5. Surveillance : activer les journaux et définir les points de contact (IT/Support).


Fiches d’intégration — procédures synthétiques

A) Identité & SSO

  1. Créer l’application dans l’IdP (Azure AD/ADFS/SAML/OIDC).

  2. Renseigner dans Hamilton Apps : Issuer/EntityID, SSO URL, certificat (SAML) ou endpoints OIDC.

  3. Mapper les attributs (email, nom) et définir la politique (SSO obligatoire/mixte).

  4. Tester avec un compte pilote ; conserver un compte local Admin de secours.

B) SMTP (e‑mail)

  1. Créer le compte SMTP (ou connecter un relais d’entreprise).

  2. Configurer hôte/port, authentification, expéditeur (adresse générique) dans Hamilton Apps.

  3. Tester l’envoi (invitation/notification) et surveiller les rejets (SPF/DKIM/DMARC côté messagerie).

C) SMS

  1. Souscrire/brancher le fournisseur SMS.

  2. Saisir les identifiants API et le format des numéros (E.164).

  3. Tester une notification (arrivée visiteur / alerte hôte) et vérifier la livraison.

D) Calendriers Microsoft 365/Exchange (Meeting)

  1. Créer l’application (Graph/Exchange) et autoriser l’accès aux ressources de salle.

  2. Renseigner les secrets/permissions dans Hamilton Meeting.

  3. Tester création/modification/annulation et réception des invitations Outlook.

E) API & Webhooks

  1. Générer un token API et restreindre sa portée.

  2. Déclarer les endpoints de webhooks (HTTPS) pour les événements nécessaires.

  3. Journaliser et relire les réponses (2xx attendu), prévoir une relecture en cas d’échec.

F) Synchronisation Azure AD (Visitor)

  1. Créer l’app Azure AD (Graph/Graph API) et autoriser les lectures requises.

  2. Mapper attributs (email, nom) et groupes vers profils/résidents.

  3. Lancer une synchro pilote puis planifier la récurrence.


Bonnes pratiques

  • Moindre privilège : scoper les permissions par produit et périmètre.

  • Séparation des flux : comptes de service dédiés par intégration.

  • Observabilité : suivre taux d’erreur, latence et activer des alertes.

  • Gestion des secrets : rotation périodique, coffre‑fort d’entreprise.


Dépannage rapide

  • SSO en boucle : vérifier métadonnées IdP, certificat et dérive d’horloge.

  • E‑mails non délivrés : contrôler SMTP, expéditeur, SPF/DKIM/DMARC, et les indésirables.

  • SMS non reçu : format E.164, quotas fournisseur, couverture.

  • Outlook non mis à jour : valider droits ressource, resoumettre depuis Meeting ; vérifier le connecteur.

  • Webhooks en échec : inspecter logs HTTP (codes ≠ 2xx) et rejouer l’envoi.

  • Synchro Azure AD : revoir scopes/consent et le mappage d’attributs.


Pré‑requis

  • Accès Administrateur à Hamilton Apps.

  • IdP opérationnel (pour SSO), serveur SMTP, compte SMS, tenant Microsoft 365/Exchange si Meeting, abonnement Azure si synchro AD.

  • Ouvertures réseau sortant vers IdP/Graph/SMTP/SMS.


Liens associés

Côté Admin

  • Authentification & SSO (Paramétrage Admin)

  • Rapports & exports

  • Journal d’activité & audit

  • Meeting — Synchronisation calendriers (Microsoft Graph / Exchange)

  • Visitor — Synchronisation Azure Graph (IT)

  • API / Webhooks — bonnes pratiques

Côté Utilisateur

  • Outlook / Office 365 (Meeting)

  • Notifications (e‑mail / SMS) (Visitor)

Avez-vous trouvé la réponse à votre question ?