Comment configurer SCIM avec Microsoft Entra ID

Utilisez SCIM pour synchroniser vos utilisateurs Calendly avec Microsoft Entra ID (anciennement Azure Active Directory). SCIM peut automatiquement ajouter, mettre à jour, désactiver ou supprimer des utilisateurs en fonction de votre fournisseur d'identité (IdP).

Avant de commencer

• Configurez l'authentification unique (SSO) SAML avant de configurer SCIM.
• Vous devez être un propriétaire ou un administrateur Calendly.
• Gardez Calendly et Microsoft Entra ID ouverts dans des fenêtres séparées pendant l'installation.

Étape 1 - Activez SCIM dans Calendly

1. Ouvrez Calendly.
2. Accédez au Centre d'administration, puis sélectionnez Connexion.
3. En haut, sélectionnez Provisionnement des utilisateurs.
4. Activez Appliquer SCIM pour mon organisation.
5. Choisissez quand le jeton doit expirer.
6. Sélectionnez Générer un nouveau jeton porteur.
7. Sélectionnez Copier le jeton. Enregistrez-le : vous ne pouvez le copier qu'une seule fois.

Étape 2 – Configurer SCIM dans Microsoft Entra ID

1. Ouvrez le portail Microsoft Entra ID.
2. Accédez à applications pour entreprises.
3. Dans Toutes les applications, sélectionnez l'application que vous utilisez pour SSO SAML.
4. Dans la barre latérale, sélectionnez Provisioning.
5. Dans le menu Gérer, sélectionnez à nouveau Provisioning.
6. Réglez le mode de provisionnement sur Automatique.
7. Collez le jeton Calendly dans le champ Clé secrète.
8. Copiez l'URL de base de Calendly et collez-la dans le champ URL du compte.
9. Sélectionnez Tester la connexion.
   • En cas d'échec, essayez de copier de nouveau le jeton et l'URL principale.
10. Sélectionnez Enregistrer.

Étape 3 - Définir des correspondances utilisateur

1. Dans Entra ID, allez dans Associations.
2. Sélectionnez Provisionner les groupes Microsoft Entra ID.
   • Désactivez Activé, puis sélectionnez Enregistrer et fermez.
3. Sélectionnez Provisionner les utilisateurs Microsoft Entra ID.
   • Assurez-vous que Créer et Mettre à jour sont activés.
   • Décidez si vous souhaitez activer Supprimer :
     • Si cette option est activée, les utilisateurs supprimés perdront toutes les données Calendly.
     • Si elle est désactivée, les utilisateurs seront désactivés, mais pourront être réactivés.
4. Sous Mappages d'attributs :
   • Gardez nom d'utilisateur, actif et nom d'affichage.
   • Supprimez tous les autres attributs.
5. Modifier le nom d'utilisateur :
   • Modifiez la source en courrier.
   • Sélectionnez Ok.
6. Sélectionnez Enregistrer, puis Oui, et fermez la fenêtre.

Étape 4 – Commencer le provisionnement

1. Accédez à la section Paramètres.
2. (Facultatif) Activez des alertes par e-mail en cas d'erreur. Ajoutez les e-mails pour recevoir des alertes.
3. Sous Périmètre, choisissez Synchroniser uniquement les utilisateurs et les groupes attribués.
4. Activez le statut de provisionnement.
5. Sélectionnez Enregistrer.

Remarque : la synchronisation SCIM s'exécute toutes les 40 minutes. Vous pouvez également le démarrer manuellement à l'aide de Approvisionnement à la demande.

Étape 5 – Ajouter des utilisateurs à Calendly

1. Dans Entra ID, revenez à l'application Calendly.
2. Sélectionnez Utilisateurs et groupes.
3. Sélectionnez + Ajouter un utilisateur/un groupe.
4. Choisissez vos utilisateurs et sélectionnez Attribuer.

Étape 6 - Configurer les attributs pour le mappage de groupe (facultatif)

Si vous souhaitez que SCIM place automatiquement les utilisateurs dans des groupes Calendly :

1. Dans l'identifiant Entra :
   • Accédez à Afficher les options avancées, puis sélectionnez Modifier la liste d'attributs.
   • Ajouter une nouvelle ligne :
     • Attribut : urn:ietf:params:scim:schemas:extension:Calendly:2.0:User:group
     • Type : Chaîne
2. Revenez à la table des associations d'attributs.
3. Sélectionnez Ajouter une nouvelle association :
   • Choisissez un attribut source (par exemple, service).
   • Définissez l'attribut cible sur urn:ietf:params:scim:schemas:extension:Calendly:2.0:User:group.
   • Sélectionnez OK et Enregistrer.

Étape 7 - Associez des utilisateurs à des groupes Calendly (facultatif)

Suivez ces étapes pour automatiser l'approvisionnement automatique des groupes.