Démarrage

Vous pouvez créer un connecteur personnalisé à partir d'une zone de dessin vierge ou à partir d'une spécification d'API.

Avant de créer un connecteur, familiarisez-vous d'abord avec les types d'authentification disponibles.

Type d’authentification

Cette section explique les types d'authentification les plus courants disponibles dans Connector Builder. Il comprend une comparaison entre trois types d'authentification en termes de cas d'utilisation, de flux d'authentification et de sécurité. Pour plus de détails, consultez les Types d'authentification (Authentication Types).

Flux de code d’autorisation OAuth 2.0

• Idéal pour les applications qui doivent accéder aux données utilisateur au nom de l'utilisateur.
• Haute sécurité : le jeton d'accès n'est jamais exposé à l'agent utilisateur et est échangé de serveur à serveur.

Flux :

1. Autorisation utilisateur : l'utilisateur est redirigé vers le serveur d'autorisation pour accorder l'accès.
2. Code d'autorisation : si l'utilisateur accorde l'accès, un code d'autorisation est renvoyé au client.
3. Échange de jetons : le client échange le code d'autorisation contre un jeton d'accès au niveau du point de terminaison du jeton.

OAuth 2.0 Flux de code d'informations d'identification client

• Convient aux interactions de serveur à serveur où aucune interaction utilisateur n'est impliquée.
• Sécurité moyenne : elle repose sur la sécurité des informations d'identification du client.

Flux :

1. Demande directe de jeton : le client demande directement un jeton d'accès au serveur d'autorisation à l'aide de ses informations d'identification client.
2. Jeton d'accès : Le serveur d'autorisation renvoie un jeton d'accès

Clé API

• Simple et rapide à mettre en œuvre, souvent utilisé pour les API publiques.
• Faible sécurité : les clés API peuvent être facilement partagées ou exposées.

Flux :

Utilisation de la clé API : l’utilisateur inclut une clé API dans chaque requête pour s’authentifier.

Choisir un flux d'authentification

Dans Exemple A : créer un connecteur à partir d'une zone de dessin vierge avec l'authentification par jeton d'accès personnel, nous utilisons le type d'authentification par jeton d'accès personnel (PAT). L'exemple d'API Générer une image (Generate Image API) suit la pratique standard d'utilisation de l'en-tête d'autorisation avec le schéma du porteur (Bearer) pour la clé API, en particulier pour les jetons OAuth 2.0.

Certaines API, telles que les ressources SAP S4 ODataV2, utilisent un en-tête personnalisé comme Clé API pour authentifier l'application. Ceci est utilisé dans l' Exemple B : créer un connecteur à partir d'une zone de dessin vierge avec authentification par clé API.

Exemple C : créez un connecteur à partir d'une spécification d'API avec OAuth 2.0 L'authentification par informations d'identification client utilise OAuth 2.0 Flux d'informations d'identification client, avec une application OAuth 2.0.