Afin de pouvoir utiliser une connexion OAuth2, vous avez besoin de créer une App. Ceci vous permettra de:
Déclarer un scope précis d'APIs
De restreindre les accès aux seuls utilisateurs ayant accès à l'App
Création de l'App
Aller dans l'espace développeur, vous arriverez sur l'onglet Apps, présentant un bouton pour en créer.
Ouvrir la vue pour créer une App.
Renseigner:
Nom
Titre
Code de l'app
Sauvegarder
Activation OAuth2
Aller dans l'onglet Sécurité de la fiche de l'App
Activer OAuth2 dans la section dédiée
Ajouter au moins une URL de redirection
Sauvegarder
Noter les éléments suivants:
Authorization URL
Access Token URL
Client ID
Client secret
Droits et restrictions des scopes
Vous pouvez désormais, choisir les scopes (endpoints) ouverts dans le cadre de cette authentification OAuth2 via le champs API Autorisées
Avant de démarrer le flow OAuth2, installez l'App et ouvrez les droits à cet App aux utilisateurs identifiés pour l'utiliser via l'interface de gestion des droits (sections Apps).
Démarrer le flow OAuth2
Depuis un client OAuth, vous pouvez démarrer le flow OAuth2:
Authorize → Redirige vers Boond pour obtenir un
authorization_codeCallback → Reçoit le code, l'échange contre un
access_tokenTest API Call → Tester un appel API avec le token
Voici un exemple curl:
curl -H "Authorization: Bearer <access_token>" \
-H "Accept: application/json" \
https://ui.boondmanager.com/api/application/current-user