Authentification HTTP

Prérequis

Pour créer une connexion à l'aide du connecteur HTTP, vous devez fournir les détails nécessaires pour le type d'authentification sélectionné. Consultez les sections suivantes pour obtenir les détails requis pour chaque type d’authentification. Pour plus d’informations sur la façon de récupérer ces informations, consultez la documentation du fournisseur de l’API.

Jeton d’accès d’utilisateur UiPath

Établissez une connexion via les services UiPath pris en charge. Aucune configuration requise.

Code d'autorisation OAuth 2.0

Fournissez les détails suivants :

• Nom de connexion : un nom descriptif pour vous aider à identifier cette connexion.
• URL de base : l'URL de base de votre API (par exemple https://api.example.com).
• ID Client : l'identifiant unique de votre application tel que fourni par votre fournisseur OAuth lors de l'enregistrement de l'application.
• Secret du client : la clé secrète confidentielle de votre application fournie par votre fournisseur OAuth.
• URL d'autorisation : l'URL du point de terminaison d'autorisation complète fournie par votre fournisseur OAuth (par ex. https://login.example.com/oauth2/authorize).
• URL du jeton : l’URL du point de terminaison du jeton où les codes d’autorisation ou les informations d’identification sont échangés contre des jetons d’accès fournis par votre fournisseur OAuth (par exemple https://login.example.com/oauth2/token).
• Étendue : les étendues OAuth requises en fonction de votre fournisseur d’API ou de vos besoins d’intégration.

Configuration supplémentaire :

• URL du jeton d'actualisation : l'URL du point de terminaison du jeton d'actualisation fournie par votre fournisseur OAuth (par exemple https://example.com/docs/oauth/refresh)
• URL de révocation du jeton : l'URL du point de terminaison de révocation du jeton, telle que fournie par votre fournisseur OAuth (https://example.com/docs/oauth/revoke).
• Intervalle d’actualisation : durée en secondes entre les tentatives d’actualisation de jeton OAuth.
• En-tête de base OAuth : permet d’envoyer l’ID client et la clé secrète comme en-tête d’authentification de base lors de l’échange de jetons OAuth. La plupart des fournisseurs ont besoin que cette option soit activée.

Code d'autorisation OAuth 2.0 avec PKCE

Fournissez les détails suivants :

• Nom de connexion : un nom descriptif pour vous aider à identifier cette connexion.
• URL de base : l'URL de base de votre API (par exemple https://api.example.com).
• ID Client : l'identifiant unique de votre application tel que fourni par votre fournisseur OAuth lors de l'enregistrement de l'application.
• Secret du client : la clé secrète confidentielle de votre application fournie par votre fournisseur OAuth.
• URL d'autorisation : l'URL du point de terminaison d'autorisation complète fournie par votre fournisseur OAuth (par ex. https://login.example.com/oauth2/authorize).
• URL du jeton : l’URL du point de terminaison du jeton où les codes d’autorisation ou les informations d’identification sont échangés contre des jetons d’accès fournis par votre fournisseur OAuth (par exemple https://login.example.com/oauth2/token).
• Étendue : les étendues OAuth requises en fonction de votre fournisseur d’API ou de vos besoins d’intégration.

Configuration supplémentaire :

• URL du jeton d'actualisation : l'URL du point de terminaison du jeton d'actualisation fournie par votre fournisseur OAuth (par exemple https://example.com/docs/oauth/refresh)
• URL de révocation du jeton : l'URL du point de terminaison de révocation du jeton, telle que fournie par votre fournisseur OAuth (https://example.com/docs/oauth/revoke).
• Intervalle d’actualisation : durée en secondes entre les tentatives d’actualisation de jeton OAuth.
• En-tête de base OAuth : permet d’envoyer l’ID client et la clé secrète comme en-tête d’authentification de base lors de l’échange de jetons OAuth. La plupart des fournisseurs ont besoin que cette option soit activée.

Informations d'identification du client OAuth 2.0

Fournissez les détails suivants :

• Nom de connexion : un nom descriptif pour vous aider à identifier cette connexion.
• URL de base : l'URL de base de votre API (par exemple https://api.example.com).
• ID Client : l'identifiant unique de votre application tel que fourni par votre fournisseur OAuth lors de l'enregistrement de l'application.
• Secret du client : la clé secrète confidentielle de votre application fournie par votre fournisseur OAuth.
• URL du jeton : l’URL du point de terminaison du jeton où les codes d’autorisation ou les informations d’identification sont échangés contre des jetons d’accès fournis par votre fournisseur OAuth (par exemple https://login.example.com/oauth2/token).
• Étendue : les étendues OAuth requises en fonction de votre fournisseur d’API ou de vos besoins d’intégration.

Configuration supplémentaire :

• Intervalle d’actualisation : durée en secondes entre les tentatives d’actualisation de jeton OAuth.
• En-tête de base OAuth : permet d’envoyer l’ID client et la clé secrète comme en-tête d’authentification de base lors de l’échange de jetons OAuth. La plupart des fournisseurs ont besoin que cette option soit activée.

Mot de passe OAuth 2.0

Fournissez les détails suivants :

• Nom de connexion : un nom descriptif pour vous aider à identifier cette connexion.
• URL de base : l'URL de base de votre API (par exemple https://api.example.com).
• Nom d'utilisateur - Les informations d’identification du nom d'utilisateur de l'utilisateur final pour l'authentification.
• Mot de passe - Les informations d’identification du mot de passe de l'utilisateur final pour l'authentification.
• ID Client : l'identifiant unique de votre application tel que fourni par votre fournisseur OAuth lors de l'enregistrement de l'application.
• Secret du client : la clé secrète confidentielle de votre application fournie par votre fournisseur OAuth.
• URL d'autorisation : l'URL du point de terminaison d'autorisation complète fournie par votre fournisseur OAuth (par ex. https://login.example.com/oauth2/authorize).
• URL du jeton : l’URL du point de terminaison du jeton où les codes d’autorisation ou les informations d’identification sont échangés contre des jetons d’accès fournis par votre fournisseur OAuth (par exemple https://login.example.com/oauth2/token).
• Étendue : les étendues OAuth requises en fonction de votre fournisseur d’API ou de vos besoins d’intégration.

Configuration supplémentaire :

• URL du jeton d'actualisation : l'URL du point de terminaison du jeton d'actualisation fournie par votre fournisseur OAuth (par exemple https://example.com/docs/oauth/refresh).
• URL de révocation du jeton : l'URL du point de terminaison de révocation du jeton, telle que fournie par votre fournisseur OAuth (https://example.com/docs/oauth/revoke).
• Intervalle d’actualisation : durée en secondes entre les tentatives d’actualisation de jeton OAuth.
• En-tête de base OAuth : permet d’envoyer l’ID client et la clé secrète comme en-tête d’authentification de base lors de l’échange de jetons OAuth. La plupart des fournisseurs ont besoin que cette option soit activée.

Authentification de base

Fournissez les détails suivants :

• Nom de connexion : un nom descriptif pour vous aider à identifier cette connexion.
• URL de base : l'URL de base de votre API (par exemple https://api.example.com).
• Nom d'utilisateur - Les informations d’identification du nom d'utilisateur de votre compte d'API.
• Mot de passe : les identifiants du mot de passe de votre compte API.

Configuration supplémentaire :

• API de validation d'authentification : saisissez le chemin relatif qui sera utilisé pour vérifier vos informations d'authentification (par exemple /api/v1/me, /user/profile, /auth/validate). Ce routage d’API doit renvoyer une réponse de réussite lorsque vos informations d’identification sont valides.

Clé API

Fournissez les détails suivants :

• Nom de connexion : un nom descriptif pour vous aider à identifier cette connexion.
• URL de base : l'URL de base de votre API (par exemple https://api.example.com).
• Nom du paramètre : le nom exact du paramètre de clé API tel que requis par votre API (par exemple X-API-Key, api_key, Authorization). Il sera utilisé soit comme nom d’en-tête, soit comme nom de paramètre de requête, en fonction de votre sélection.
• Valeur : la valeur complète de votre clé API telle que fournie par votre fournisseur d'API. Elles seront stockées et utilisées de manière sécurisée dans le cadre de l'authentification.

Configuration supplémentaire :

• Ajouter à : sélectionnez s'il faut ajouter la clé API dans l'en-tête de la requête ou en tant que paramètre de la requête. L’en-tête est recommandé pour une meilleure sécurité.
• API de validation d'authentification : saisissez le chemin relatif qui sera utilisé pour vérifier vos informations d'authentification (par exemple /api/v1/me, /user/profile, /auth/validate). Ce routage d’API doit renvoyer une réponse de réussite lorsque vos informations d’identification sont valides.

Porteur JWT OAuth 2.0

Fournissez les détails suivants :

• Nom de connexion : un nom descriptif pour vous aider à identifier cette connexion.
• URL de base : l'URL de base de votre API (par exemple https://api.example.com).
• ID Client : l'identifiant unique de votre application tel que fourni par votre fournisseur OAuth lors de l'enregistrement de l'application.
• Secret du client : la clé secrète confidentielle de votre application fournie par votre fournisseur OAuth.
• Clé encodée JWT au format Base64 : votre clé privée encodée en Base64. Veillez à bien suivre les instructions de votre fournisseur d’API pour la génération de clé et l’encodage.
• URL d'autorisation : l'URL du point de terminaison d'autorisation complète fournie par votre fournisseur OAuth (par ex. https://login.example.com/oauth2/authorize).
• URL du jeton : l’URL du point de terminaison du jeton où les codes d’autorisation ou les informations d’identification sont échangés contre des jetons d’accès fournis par votre fournisseur OAuth (par exemple https://login.example.com/oauth2/token).
• Étendue : les étendues OAuth requises en fonction de votre fournisseur d’API ou de vos besoins d’intégration.

Configuration supplémentaire :

• URL du jeton d'actualisation : l'URL du point de terminaison du jeton d'actualisation fournie par votre fournisseur OAuth (par exemple https://example.com/docs/oauth/refresh).
• URL de révocation du jeton : l'URL du point de terminaison de révocation du jeton, telle que fournie par votre fournisseur OAuth (https://example.com/docs/oauth/revoke).
• Intervalle d’actualisation : durée en secondes entre les tentatives d’actualisation de jeton OAuth.
• En-tête de base OAuth : permet d’envoyer l’ID client et la clé secrète comme en-tête d’authentification de base lors de l’échange de jetons OAuth. La plupart des fournisseurs ont besoin que cette option soit activée.

Jeton d’accès personnel

Fournissez les détails suivants :

• Nom de connexion : un nom descriptif pour vous aider à identifier cette connexion.
• URL de base : l'URL de base de votre API (par exemple https://api.example.com).
• Préfixe du jeton : le préfixe du jeton (par ex. Bearer, Token, Basic). Elle sera combinée à votre jeton dans l’en-tête d’autorisation. Laissez ce champ vide si aucun préfixe n'est requis.
• Jeton : la valeur complète du jeton d’accès personnel. Elle sera combinée au type de jeton dans l’en-tête d’autorisation (par ex. Bearer your-token-here).

Configuration supplémentaire :

• API de validation d'authentification : saisissez le chemin relatif qui sera utilisé pour vérifier vos informations d'authentification (par exemple /api/v1/me, /user/profile, /auth/validate). Ce routage d’API doit renvoyer une réponse de réussite lorsque vos informations d’identification sont valides.

Ajouter la connexion HTTP

1. Sélectionnez Integration Service dans la barre de gauche.
2. Dans la liste Connecteurs , sélectionnez HTTP. Vous pouvez également utiliser la barre de recherche pour trouver le connecteur.
3. Sélectionnez le bouton Se connecter à HTTP .
4. Dans l'écran de connexion, fournissez les détails requis.
5. Select Connect.
6. Votre connexion a été ajoutée.