Connectez-vous à des services tiers et à des API (génériques)

Pour vous connecter à des services tiers via Connecteur API

1. Dans le volet de navigation de gauche, choisissez les connecteurs dans la section Gérer. Vous serez redirigé vers une page affichant une liste des connecteurs existants avec quelques détails sur chacun d'eux.

2. Choisissez + Créer un connecteur.

3. Choisissez API Connector. Configurez maintenant votre connecteur en remplissant les champs suivants.

4. Nom du connecteur : donnez un nom à votre connecteur.

5. Description du connecteur : Fournissez une description de votre connecteur.

6. URL de base : site Web ou hébergeur de la connexion tierce. Par exemple, www.slack.com.

7. Méthode d'authentification : choisissez la méthode d'authentification auprès du service cible.

   • Aucun : accédez au service cible sans authentification.

   • Basique : Accédez au service cible à l'aide d'un nom d'utilisateur et d'un mot de passe obtenus auprès du service auquel vous êtes connecté.

   • Jeton porteur : accédez au service cible à l'aide de la valeur Token d'un jeton d'authentification obtenu à partir du compte utilisateur ou des paramètres de l'API du service.

   • OAuth 2.0 : accédez au service cible à l'aide du protocole OAuth 2.0, qui permet à App Studio d'accéder au service et aux ressources sans partager d'informations d'identification ni d'identité. Pour utiliser la méthode d'authentification OAuth 2.0, vous devez d'abord créer une application à partir du service auquel vous êtes connecté qui représente App Studio afin d'obtenir les informations nécessaires. À l'aide de ces informations, remplissez les champs suivants :

     1. Flux d'informations d'identification des clients : idéal pour les interactions de système à système dans lesquelles l'application agit pour son propre compte sans interaction de l'utilisateur. Par exemple, une application CRM qui met automatiquement à jour les enregistrements Salesforce en fonction des nouveaux enregistrements ajoutés par les utilisateurs, ou une application qui extrait et affiche les données de transaction dans les rapports.

        1. Dans ID client, entrez l'ID obtenu à partir de l'application OAuth créée dans le service cible.

        2. Dans Secret client, entrez le secret obtenu à partir de l'application OAuth créée dans le service cible.

        3. Dans URL du jeton d'accès, entrez l'URL du jeton obtenue à partir de l'application OAuth créée dans le service cible.

        4. Si vous le souhaitez, dans Domaines d'application, entrez les domaines de l'application. Les étendues sont les autorisations ou les niveaux d'accès requis par l'application. Consultez la documentation de l'API du service cible pour comprendre leur étendue et configurez uniquement ceux dont votre application App Studio a besoin.

        Choisissez Vérifier la connexion pour tester l'authentification et la connexion.

     2. Flux de code d'autorisation : idéal pour les applications qui nécessitent d'agir au nom d'un utilisateur. Par exemple, une application de support client dans laquelle les utilisateurs se connectent pour consulter et mettre à jour les tickets d'assistance, ou une application commerciale dans laquelle chaque membre de l'équipe se connecte pour consulter et gérer ses données de vente.

        1. Dans ID client, entrez l'ID obtenu à partir de l'application OAuth créée dans le service cible.

        2. Dans Secret client, entrez le secret obtenu à partir de l'application OAuth créée dans le service cible.

        3. Dans URL d'autorisation, entrez l'URL d'autorisation du service cible.

        4. Dans URL du jeton d'accès, entrez l'URL du jeton obtenue à partir de l'application OAuth créée dans le service cible.

        5. Si vous le souhaitez, dans Domaines d'application, entrez les domaines de l'application. Les étendues sont les autorisations ou les niveaux d'accès requis par l'application. Consultez la documentation de l'API du service cible pour comprendre leur étendue et configurez uniquement ceux dont votre application App Studio a besoin.

8. En-têtes : ajoutez des en-têtes HTTP qui sont utilisés pour fournir des métadonnées relatives à la demande ou à la réponse. Vous pouvez ajouter à la fois des clés et des valeurs, ou uniquement fournir une clé à laquelle le générateur peut fournir une valeur dans l'application.

9. Paramètres de requête : ajoutez des paramètres de requête qui sont utilisés pour transmettre des options, des filtres ou des données dans le cadre de l'URL de la demande. À l'instar des en-têtes, vous pouvez fournir à la fois une clé et une valeur, ou uniquement fournir une clé à laquelle le générateur peut fournir une valeur dans l'application.

10. Choisissez Créer. Le connecteur nouvellement créé apparaîtra dans la liste des connecteurs.