Ce guide explique comment générer les identifiants dont votre intégration a besoin pour s’authentifier via le protocole OAuth 2.0.
Aperçu
Pour interagir de manière sécurisée avec l’API de Penneo, votre application doit s’identifier en utilisant un client OAuth. Cela garantit que les données restent protégées tout en permettant à votre intégration d’effectuer des actions au nom d’un utilisateur.
Prérequis
Avant de commencer, assurez-vous de remplir les conditions suivantes :
- Rôle : Vous devez disposer des droits d’administrateur sur le compte Penneo.
- Accès : Vous devez pouvoir vous connecter à l’application web Penneo.
Configuration étape par étape
- Connectez-vous à Penneo : Connectez-vous à l’application web Penneo. Assurez-vous d’être connecté au bon compte où vous disposez des droits d’administrateur.
- Accédez aux clients OAuth : Dans le menu de navigation principal, allez dans Configurer et sélectionnez Clients OAuth.
- Créez un nouveau client : Cliquez sur le bouton Créer un nouveau client pour commencer le processus de génération.
-
Configurez les détails du client : Saisissez le nom de votre application et spécifiez vos
redirect_uris. Vous pouvez mettre à jour les URI de redirection à tout moment, mais le nom du client doit clairement décrire votre intégration.
Avertissement de sécurité : Identifiants
Action immédiate requise : Stockez votre
client_idet votreclient_secretdans un coffre-fort sécurisé (par exemple, Azure Key Vault, 1Password) immédiatement après leur création.
- Le
client_secretne sera affiché qu’une seule fois. En cas de perte, vous devrez supprimer le client et en créer un nouveau.- Les
redirect_urispeuvent être mis à jour ultérieurement si vos URL de callback changent.