> Menu profil utilisateur > Mon profil >

Synchronisation Office365#

Procédure#

Pour mettre en place une synchronisation des calendriers externes Office365 avec les applications artis.net et CRM, il est nécessaire d’inscrire les applications artis.net sur le portail Entra ID (nouveau nom d’Azure AD).

Remarque :

La procédure est commune pour les deux solutions artis.net et CRM, vous n’avez donc à la dérouler qu’une seule fois si vous utilisez les deux logiciels.

Ouvrir un navigateur pour accéder au Centre d’administration Microsoft Entra ID et se connecter à l’aide d’un compte compatible.
Dans le volet de navigation à gauche, se rendre dans Identité > Applications > Inscriptions des applications
Sélectionner alors Nouvelle inscription puis remplir les champs de la page Inscrire une application comme suit :
- Nom : Synchronisation Office365 et artis.net
- Types de comptes pris en charge : sélectionner Comptes dans cet annuaire d'organisation uniquement
Valider avec le bouton S’inscrire.
Sur la page qui s’affiche alors, noter les éléments suivants :
- ID d’application (client) (ou client_id)
- ID de l’annuaire (locataire) (ou tenant_id)
Ajouter des autorisations à la nouvelle application ajoutée comme suit :
- se rendre dans le menu API autorisées de l’inscription d’applications, et cliquer sur le bouton Ajouter une autorisation
- choisir la famille d’API Microsoft Graph
- cliquer sur Autorisations d’application et ajouter les autorisations suivantes :
  - Calendars.Read
  - Calendars.ReadWrite
  - User.Read.All
- sur la même page, cliquer sur Autorisations déléguées et ajouter les autorisations suivantes
  - Calendars.Read
  - Calendars.Read.Shared
  - Calendars.ReadWrite
  - Calendars.ReadWrite.Shared
  - Mail.ReadWrite
  - Mail.Send
  - User.ReadBasic.All
  - offline_access
  - openid
Un administrateur de locataire doit accorder un consentement préalable à l’application en cours de configuration.
Les administrateurs de locataires fournissent ce consentement dans cette même page API autorisées en sélectionnant Accorder le consentement administrateur.
La gestion des informations d’identification du client s’effectue dans la page Certificats et secrets.
- Le mot de passe d’une application (également appelé “secret client”, ou “secret d’application”) est généré par Entra ID. Cette génération est effectuée via le bouton Nouveau secret client.
- À ce stade, copier la chaîne du secret dans le Presse-papiers afin de pouvoir la communiquer à ARTIS AVANT de valider avec Enregistrer. En effet, cette chaîne ne s’affichera plus par la suite.
Transmettre au service technique d’ARTIS les éléments suivants :
- ID d’application (client) (ou client_id) :
  exemple de format tel qu’imposé par Microsoft : 99999999-9z99-999d-bb9e-9f9cb9e99f9
- ID de l’annuaire (locataire) (ou tenant_id) :
  exemple de format tel qu’imposé par Microsoft : fa2do2f-2e2-2ae2-2f22-c22a222d2222
- La valeur du secret de l’application ⁽¹⁾ (et non l’ID du secret) :
  exemple de format tel qu’imposé par Microsoft : ddD7D~dDddDDdddDddDdD6DdDddDdddYddd2d
  
  ⁽¹⁾ Remarque : La valeur du secret a une durée de vie. Lorsqu’elle arrive à expiration, il convient de suivre la procédure suivante.
À ce stade, le service technique d’ARTIS doit intervenir et prévient l’utilisateur lorsque la suite des actions peut-être menée.
Définir l’URI de redirection :

Si application artis.net :
Afin d’obtenir l’URI pour artis.net, il est nécessaire de commencer par configurer la synchronisation d’un utilisateur dans l’application comme suit :
- Ouvrir le menu Mon profil
- Ouvrir l’onglet Ma synchronisation,
- Cliquer sur le bouton
- Dans le champ Type de calendrier, sélectionner Microsoft Office365,
- Saisir :
  - l’identifiant du compte,
  - l’adresse mail du compte,
- Cliquer sur le bouton ou F2
- Un message demande à l’utilisateur de confirmer son adresse email. Cliquer sur le lien de redirection vers la plateforme Microsoft Online.
- Dans artis.net, se rendre dans le menu “A propos” et copier le contenu du champ Callback Office 365 en cliquant sur le bouton
- Coller l’adresse dans le dans le champ URI de redirection d’Entra ID via le menu suivant :
  - Applications > Inscriptions des applications > Authentification,
  - sélectionner Ajouter une plateforme,
  - sélectionner Web.
Si application CRM : Construire l’URI à partir de l’URL de base de l’application CRM suivi de /CallBack (exemple : https://crm-raisonsociale.artis.fr/coheriscrm/CallBack) : veiller à bien respecter la casse et ne PAS mettre de caractère / à la fin de l’URL.

L’application doit avoir accès aux autorisations via un jeton (token).
Ces jetons sont mis à disposition dans le menu Inscriptions d’applications d’Entra ID. Sélectionner l’application et aller dans Authentification pour cocher les jetons à émettre :

Que faire si la valeur du secret a changé ?#

La valeur du secret a une durée de vie. Lorsque celle-ci arrive à expiration, l’utilisateur a la possibilité de mettre à jour l’information dans artis.net pour éviter de contacter ARTIS. Pour ce faire :

Ouvrir le menu Menu Paramétrage > Paramètres généraux > Gérer les tables de décision
Rechercher et accéder à la table EntraID_Secret_Domaines_Techniques
Cliquer sur le bouton
À la première modification :
- Cliquer sur le bouton
- Sélectionner le domaine s’il y en a plusieurs d’interfacés (sélectionner Tous à défaut),
- Renseigner la nouvelle valeur dans la colonne “Secret”,
- Cliquer sur le bouton ou F2
Lors des modifications suivantes :
- Renseigner la nouvelle valeur dans la colonne “Secret”,
- Cliquer sur le bouton ou F2