Aller au contenu

Création d’un enregistrement d’application dans Azure

Les étapes suivantes doivent être complétées pour créer un enregistrement d’application dans Document Inbound. Un enregistrement d’application est requis par Document Inbound afin de pouvoir utiliser toutes les fonctionnalités disponibles.

Info

Pour effectuer cette configuration, il est nécessaire que le compte administrateur soit présent à la fois dans Business Central et dans le portail Azure, car seuls les administrateurs disposent des privilèges nécessaires.

Business Central (SaaS)

  1. Accédez à Document Inbound - Paramètres du module.
  2. Cliquez sur l’action Créer un enregistrement dans Document Inbound - Paramètres du module pour continuer.
  3. Si une fenêtre contextuelle de connexion apparaît, assurez-vous de vous connecter avec un compte administrateur dans Document Inbound et Azure pour poursuivre la création de l’enregistrement d’application.
  4. Une fois l’enregistrement d’application créé, un nouvel utilisateur nommé Document Inbound sera automatiquement généré pour l’application Azure Active Directory. Une fenêtre contextuelle vous guidera vers la page de l’application Azure Active Directory où vous pourrez cliquer sur le bouton Accorder le consentement pour fournir le consentement et les autorisations administratives dans Azure.
  5. Le groupe de champs Enregistrement d’application dans Document Inbound - Paramètres du module devrait maintenant être complété, et un enregistrement d’application nommé Document Inbound aura été créé dans vos enregistrements d’application du portail Azure.

Business Central (On-Premise)

La création automatique de l’enregistrement d’application depuis Business Central On-Premise n’est pas possible. Par conséquent, la création de l’enregistrement d’application doit être effectuée manuellement via le portail Azure.

Création de l’enregistrement d’application Azure dans le portail Azure

Les étapes suivantes vous guideront pour créer un nouvel enregistrement d’application pour Document Inbound dans le portail Azure.

  1. Connectez-vous au portail Azure à l’adresse Azure Portal.
  2. Cliquez sur l’icône Azure Active Directory dans le menu de navigation à gauche.
  3. Dans le menu Azure Active Directory, cliquez sur Enregistrements d’application.
  4. Cliquez sur le bouton Nouvel enregistrement.
  5. Saisissez le nom Document Inbound dans le champ Nom.
  6. Choisissez l’option appropriée pour Types de comptes pris en charge.
  7. Saisissez l’URI de redirection approprié pour votre enregistrement d’application. Il s’agit de l’URI vers lequel Azure AD redirigera l’utilisateur après l’authentification. L’URI doit être défini sur Web pour la plateforme et rédigé au format suivant : https://**adresse externe de Business Central/BC/OAuthLanding.htm**.
  8. Cliquez sur le bouton Enregistrer pour créer l’enregistrement d’application.
  9. Sur la page de l’enregistrement d’application, notez l’ID d’application (client) et l’ID de répertoire (locataire). Il s’agit de l’identifiant unique de votre enregistrement d’application que vous devrez utiliser lors de la configuration de Document Inbound dans Business Central.
  10. Sous l’onglet Certificats et secrets, cliquez sur Nouveau secret client pour créer un nouveau secret qui sera utilisé pour authentifier votre application avec Azure AD.
  11. Saisissez une description pour le secret, sélectionnez une date d’expiration, puis cliquez sur Ajouter.
  12. Notez la valeur du secret générée, car elle ne sera affichée qu’une seule fois et ne pourra pas être récupérée ultérieurement. Veuillez noter cette valeur du secret, car elle est nécessaire pour configurer Document Inbound dans Business Central.

  13. Sous l’onglet Autorisations API, cliquez sur Ajouter une autorisation et ajoutez les autorisations suivantes :

    Groupe d’autorisations API / Nom de l’autorisation Type Description
    Microsoft Graph Directory.Read.All Application Lire les données de l’annuaire
    Microsoft Graph Group.ReadWrite.All Application Lire et écrire tous les groupes
    Microsoft Graph Mail.ReadBasic.All Application Lire les courriels de base dans toutes les boîtes
    Microsoft Graph Mail.ReadWrite Application Lire et écrire les courriels dans toutes les boîtes
    Microsoft Graph User.Read Déléguée Se connecter et lire le profil utilisateur
    Microsoft Graph User.Read.All Application Lire les profils de tous les utilisateurs

  14. Cliquez sur le bouton Accorder le consentement administrateur pour accorder les autorisations.

Saisie des informations d’enregistrement d’application Azure dans Business Central

Les étapes suivantes vous guideront pour configurer l’enregistrement d’application pour Document Inbound via l’assistant d’enregistrement d’application.

  1. Accédez à Document Inbound - Paramètres du module.
  2. Cliquez sur l’action Configurer l’enregistrement d’application dans Document Inbound - Paramètres du module pour continuer.
  3. Un assistant d’enregistrement d’application apparaîtra. Cliquez sur Commencer pour démarrer la configuration.
  4. Pour continuer cette étape, il est nécessaire d’avoir déjà préparé un enregistrement d’application pour Document Inbound. Si vous n’avez pas encore créé d’enregistrement d’application, veuillez vous référer à la section Création de l’enregistrement d’application Azure dans le portail Azure.
  5. Renseignez les champs Nom de l’enregistrement d’application, ID client, Secret client, ID locataire et URL de redirection.
  6. Une fois tous les champs correctement remplis, cliquez sur Suivant pour poursuivre la configuration.
  7. En cliquant sur Terminer, les modifications seront appliquées aux paramètres de l’enregistrement d’application dans Document Inbound.

Warning

  • Si l’enregistrement d’application n’est pas correctement configuré, Document Inbound ne pourra pas fonctionner correctement dans certaines zones.
  • Un enregistrement d’application existant sera écrasé lors de la finalisation de l’assistant d’enregistrement d’application.

Voir aussi