invantive documentation
Forums d'Invantive SupportConnectez-vous/inscrivez-vous

Preauthenticate Exact Online

Pour pré-authentifier une application Exact Online, veuillez suivre les étapes suivantes :

Préparation

Exécutez les étapes suivantes :

  • Accédez à l’Exact App Center : Page d'accueil d'Exact App Center dans un navigateur, avec un champ de recherche et les applications les plus récentes telles qu’Invantive Bridge.
  • Sélectionnez le pays approprié.
  • Connexion : Page de connexion à Exact Online accessible depuis l’Exact App Center, avec les champs de nom d’utilisateur et de mot de passe.
  • Pour l’étape suivante, assurez-vous de disposer d’un abonnement à l’Exact Online App Center. Il s’agit d’un abonnement gratuit qui vous permet d’enregistrer vos propres clés API.
  • Pour créer un tel compte, rendez-vous sur https://apps.exactonline.com
  • Faites défiler vers le bas et recherchez « Êtes-vous un développeur d’applications ? », puis cliquez sur « En savoir plus ». La page Exact App Center avec la section « Êtes-vous un développeur d’applications ? » et son lien « En savoir plus ».
  • Sur la page suivante, sélectionnez « Étape 1 : Enregistrer », puis cliquez sur le bouton « Enregistrer votre application ». La page Exact App Center avec l'étape 1, « Registreer » et le bouton permettant d'enregistrer une application.
  • Sur la page suivante, vous verrez un formulaire d’inscription ; vous pouvez choisir « Connexion » au bas du formulaire. Le formulaire d'inscription à l'Exact Online App Center avec le lien « Connexion » en bas de page.
  • Vérifiez maintenant les points suivants : l’option « Gérer l’abonnement » doit être cochée dans la section « Accorder des droits à l’utilisateur ». Vous pouvez le vérifier sur la page « Accorder des droits » de l’utilisateur : Données de base > Aperçu | Utilisateurs > Utilisateur > Droits. Le menu « Entreprise » d’Exact Online avec l’option « Données de base » mise en surbrillance sous « Gérer l’entreprise actuelle ». Le menu « Utilisateurs » d’Exact Online avec l’entrée « Aperçu » mise en surbrillance par un cadre rouge. La liste des utilisateurs d’Exact Online avec la fiche d’un utilisateur mise en évidence par un cadre rouge. Le menu « Monitor » d’Exact Online avec l’entrée « Droits » mise en évidence par un cadre rouge. La liste des droits d’Exact Online dans l’onglet « Général », avec « Gérer l’abonnement » mis en évidence par un cadre rouge.
  • Si vous revenez à https://apps.exactonline.com, une nouvelle option devrait être disponible :
  • Sélectionnez « Gérer mes applications » ou « Enregistrer des clés API » : Page d'accueil d'Exact App Center après connexion, avec le lien « Gérer mes applications » dans la barre supérieure.
  • Choisissez l’application sur laquelle vous souhaitez pré-authentifier un utilisateur.
  • Cliquez sur « Afficher » à côté du secret client.
  • Notez les valeurs suivantes telles qu’indiquées ci-dessous : ID client, secret client et URI de redirection.
  • Lorsque vous effectuez une pré-authentification pour une utilisation avec Exact Online à l’aide d’un produit Invantive et que l’utilisation d’une URL de rappel fournie en externe est conforme à votre politique de sécurité, vous pouvez utiliser https://exactonlineclientredirect.invantive.com. En effet, la plupart des produits Invantive prennent en charge n’importe quelle URL de rappel puisqu’ils fonctionnent sans environnement de navigateur. Boîte de dialogue « Enregistrer une application de production » d’Exact App Center, avec le nom de l’application, l’URI de redirection et les conditions acceptées. Détails d’autorisation de l’application Exact Online Détails d’autorisation de l’application Exact Online

Pré-authentification

Procédez ensuite à la pré-authentification de l’application :

  • Ouvrez Invantive Cloud.
  • Sélectionnez « Pré-authentification » dans le menu.
  • Lisez et remplissez le formulaire comme indiqué en utilisant les valeurs notées précédemment : Le formulaire « Pré-authentifier l’application Exact Online » d’Invantive Cloud, avec l’ID client, l’URI de redirection et les accusés de réception.
  • Lorsque vous utilisez une URI de redirection différente de cloud.invantive.com, n’oubliez pas de cocher la case « URI de redirection différente ». Dans ce cas, un formulaire supplémentaire intitulé « Code d’échange » s’affiche.
  • Cliquez sur le bouton « Pré-authentifier ».
  • Exact Online va maintenant vous demander de vous authentifier : Formulaire de connexion à Exact Online avec les champs de nom d'utilisateur et de mot de passe, affiché lors de la pré-authentification.
  • Une fois l’authentification réussie, Exact Online vous demandera d’autoriser l’accès de l’application à vos données Exact Online avec les mêmes privilèges que l’utilisateur : La page de consentement d’Exact Online demandant si une application peut accéder aux données d’Exact Online, avec les boutons « Toestaan » et « Weigeren ».
  • Cliquez sur « Autoriser ».
  • Le navigateur sera redirigé vers l’URI de redirection.
  • L’URL contiendra des informations essentielles pour la pré-authentification.
  • Cliquez dans l’URL et copiez l’URL complète dans le presse-papiers : La barre d'adresse du navigateur affichant l'URI de redirection avec un paramètre « code », à copier.
  • Échangez l’URL contre un jeton de rafraîchissement OAuth2 en le collant dans le champ « URL de retour du code » et cliquez sur le bouton « Échanger ». Le formulaire Invantive Cloud « Récupérer le jeton d'actualisation à partir du code d'autorisation », avec un champ URL de retour et un bouton.
  • La page qui s’affiche présente les paramètres permettant de pré-authentifier votre application : Résultats de la pré-authentification Invantive Cloud, affichant le jeton de rafraîchissement, la chaîne de connexion et le fichier XML de paramètres.
  • Le champ « Refresh Token » contient le jeton d’actualisation OAuth2.
  • Les champs « Contenu settings.json » et « Contenu settings.xml » contiennent chacun la même définition de la base de données Invantive, dans les deux formats décrits ci-dessous. Les deux contiennent le secret client et le jeton d’actualisation ; traitez-les donc comme des identifiants.

À partir de la version 27.0

Le champ « Contenu settings.json » contient une définition de base de données Invantive à stocker sous la forme d’un fichier nommé settings-<NAME>.json dans %USERPROFILE%\invantive, comme décrit dans Settings.

Jusqu’à la version incluse 26.0

Le champ « Contenu settings.xml » contient la même définition de base de données pour le stockage qu’un fichier nommé settings-<NAME>.xml situé dans %USERPROFILE%\invantive, comme décrit dans Settings.xml. Ne conservez qu’un seul des deux : à partir de la version 26.1, un fichier settings-<NAME>.json a priorité sur un fichier settings-<NAME>.xml portant le même nom.

Notes de Version