Configuration initiale du compte Azure

Pour synchroniser les utilisateurs et activer le SSO (Single Sign-On) entre Office 365 et Witco, il est indispensable de configurer correctement votre compte Azure.

Création de l'application Azure

• Accès au Portail Azure
  1. Connectez-vous au portail Azure.
  2. Naviguez vers la section App registrations.
• Enregistrement de l'Application
  
  1. Cliquez sur New registration pour faire apparaître le formulaire d'enregistrement :
     
  2. Dans le champ Name, remplissez le nom de l'application :
     
  3. Dans le champ Supported account types, choisissez Accounts in this organizational directory only comme type de compte pris en charge.
• Récupération des identifiants
  
  1. Une fois l'application créée, allez dans la section Overview.
  2. Récupérez l'Application ID et le Directory ID.
     Ces identifiants seront nécessaires pour la configuration dans Witco.
     

Configuration de l'authentification web

Allez dans la section Manage → Authentication :

• Paramétrage des URI de redirection
  Configurez les URI de redirection spécifiques pour chaque environnement (production, préproduction, développement, local), en suivant la forme du tableau ci-dessous :

• Paramétrage des URL de déconnexion
  Configurez les URI de déconnexion spécifiques pour chaque environnement (production, préproduction, développement, local), en suivant la forme du tableau ci-dessous :

• Paramétrage de l'authentification dans votre application
  1. Allez dans l'application que vous avez créée.
  2. Dans la section Manage → Authentication, cliquez sur Add a platform.
  3. Dans la section Configure platforms → Web applications, choisissez Single-page application :
     
  4. Les champs Redirect URIs et Front-channel logout URL apparaissent.
     Entre les URI de redirection et les URLs de déconnexion que vous avez obtenues précédemment :
     

Configuration de l'authentification pour appareils mobiles

• Paramétrage pour les Applications Mobiles
  De manière similaire à l'authentification web, configurez une URI de redirection pour les applications mobiles.
  L'URI pour les 4 types d'environnement (production, préprod, développement et local) est http://localhost:30662.
  
  
• Paramétrage de l'authentification dans votre application
  1. Allez dans l'application que vous avez créée.
  2. Dans la section Manage → Authentication, cliquez sur Add a platform.
  3. Dans la section Configure platforms → Web applications, choisissez Web.
  4. Le champ Redirect URIs apparaît.
     Entrez l'URI de redirection :
     
     

Synchronisation des utilisateurs

Création du Secret Client

• Création d'un Secret Client
  1. Allez dans l'application que vous avez créée.
  2. Dans la section Manage → Certificates & secrets → Client secrets de votre application Azure,, cliquez sur New client secret :
     
  3. Dans la section Add a client secret :
     • Entrez une description
     • Choisissez la durée d'expiration du client secret (1 an, 2 ans, ou jamais) :
       
  4. Cliquez sur Add pour valider la création.
  5. Notez le Client secret, qui sera utilisé pour la configuration dans Witco (exemple ci-dessous) :
     

Attribution et activation des permissions

• Ajout des Permissions
  1. Allez dans la section Manage → API permissions.
  2. Cliquez sur Add a permission :
     
  3. Dans la fenêtre Request API permissions → Select an API, cliquez sur Microsoft Graph :
     
  4. Dans la section Select permissions, cliquez dans le champ texte et entrez User.Read.All.
  5. Dans la section Select permissions → Permission → User, cochez la case User.Read.All.
     
  6. (Facultatif) Si vous gérez des groupes, ajoutez également Group.Read.All ,de la même façon.
• Activation des Permissions
  Les nouvelles permissions sont accompagnées d'une alerte ("Not granted permission").
  Consentez aux permissions via un compte administrateur pour les activer :
  

Données à fournir à Witco

Une fois les configurations terminées, il est crucial de transmettre à l’équipe Witco les informations suivantes pour finaliser l’intégration :

• Identifiants de l'Application Azure
  Fournissez :
  • L'Application ID
  • Le Directory ID
  • Le Client secret
  • La date d'expiration du Client secret.
    
    
    Important
    
    Contactez-nous au plus vite si vous changez l'un de ces élements. Dans le cas contraire, votre intégration risque de ne plus fonctionner.
• Importation des Utilisateurs
  Déterminez si tous les utilisateurs doivent être importés depuis votre Active Directory (AD) ou uniquement certains groupes.
  Pour chaque groupe, fournissez l’ID et le nom du groupe.
• Champs d'Utilisateur à Importer
  Spécifiez les champs à importer et à afficher dans Witco, comme : le nom, le prénom, le numéro de téléphone (fixe et/ou mobile), l'intitulé de poste, le département, le bureau, etc.
  Indiquez également les noms des champs AD correspondants.

Tests et validation

Utilisateurs de Test
Partagez avec Witco des utilisateurs de test, réels ou fictifs, pour valider l'import, la synchronisation et les connexions dans tous les environnements.
Fournissez le nom, l'adresse e-mail, et le mot de passe de chaque utilisateur de test.