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 :

- Sélectionnez le pays approprié.
- Connexion :

- 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 ».

- Sur la page suivante, sélectionnez « Étape 1 : Enregistrer », puis cliquez sur le bouton « Enregistrer votre application ».

- Sur la page suivante, vous verrez un formulaire d’inscription ; vous pouvez choisir « Connexion » au bas du formulaire.

- 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.





- 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 » :

- 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.

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 :

- 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 :

- 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 :

- 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 :

- É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 ».

- La page qui s’affiche présente les paramètres permettant de pré-authentifier votre application :

- 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.