Vous devez maintenant créer votre première application et l’associer à l’API Sage Business Cloud Comptabilité pour obtenir un Client ID et un Client Secret indispensables pour accéder aux données Sage Business Cloud Comptabilité.
Après avoir choisi d’associer cette application à l’API Sage Business Cloud Comptabilité vous obtiendrez ses identifiants.

1. Cliquez sur l’onglet Applications ou sur le bouton Suivant.
   Un écran vous invite à ajouter votre première application, cliquez sur le bouton Ajouter une nouvelle application

   
   
   

2. L’écran de définition d’une nouvelle application apparaît :

   • Identifiez votre application, toutes ces informations pourront servir pour publier la fiche descriptive de votre application.

     • Nom : Intitulé convivial de l’application.
     • Description : Explication claire pour un client décrivant l’intérêt de votre application.
     • Url : Un lien vers un de vos sites permettant d’obtenir des informations plus détaillées sur votre application.
     • Email de contact : Une adresse e-mail que vos clients ou Sage pourront utiliser pour vous contacter à propos de votre application.

   • Qualifiez le type d’application souhaitée :

     • Web Application : application Web classique pouvant utiliser un client secret.
     • Mobile Application : application native pour mobile, par sécurité le client secret n’est pas utilisé.
     • Single Page Application : une application web accessible via une page web unique, par sécurité le client secret n’est pas utilisé

   
   
   

3. Vous allez maintenant choisir le ou les modules Sage Business Cloud concernées par votre application.
   Chaque module dispose de sa propre API. Pour l’exemple vous allez choisir l’API Sage Business Cloud Comptabilité en basculant le bouton on/off sur on.

   
   
   

4. Le formulaire des informations relatives à l’API apparaît.

   
   
   

5. Qualifiez les informations du formulaire :

   Renseignez les informations indispensables :

   • Url de redirection : Après authentification votre application sera rappelée à cette Url.
   • Url de déconnexion : Après déconnection votre application sera rappelée à cette Url.
   • Droits : droits nécessaires à votre application, par défaut Lecture et Ecriture.
     
     

   Vous pourrez aussi définir selon les exigences de votre application :

   • Url d’origine autorisée : Url autorisée pour appel depuis Javascript à Auth0.
   • Url d’origine web : Url autorisée pour requête utilisant Cross-Origin-authentication
     
     

   Astuce : Pour chaque type d’Url vous pouvez définir plusieurs Urls pour tester votre application dans différents environnements.

   
   
   

6. Une fois les informations renseignées, cliquez sur le bouton Enregistrer.
   Vos identifiants Client ID et Client Secret sont alors générés.
   

   • Ils seront nécessaires pour connecter votre application à l’API Sage Business Cloud Comptabilité.
   • Cliquez sur l’icône oeil à droite du Client secret pour le révéler
   • Vous pourrez à tout moment renouveler le Client secret en cliquant sur l’icône Renouveler, attention dans ce cas vous devrez le mettre à jour dans votre application.
   • Si votre type d’application n’est pas Web Application, le Client secret ne sera pas visible car ne pouvant pas être utilisé dans ce contexte.

   
   
   

7. Cliquer sur le bouton Fermer. L’application que vous venez de créer apparait maintenant dans la liste des applications.
   Vous pourrez à tout moment modifier ses paramètres.