Autenticación HTTP

Requisitos previos

Para crear una conexión utilizando el conector HTTP, debes proporcionar los detalles necesarios para el tipo de autenticación seleccionado. Consulta las siguientes secciones para obtener información sobre los detalles necesarios para cada tipo de autenticación. Para obtener información sobre cómo recuperar estos detalles, consulta la documentación del proveedor de la API.

Token de acceso de usuario de UiPath

Establece una conexión a través de los servicios compatibles de UiPath. No se requiere configuración.

Código de autorización OAuth 2.0

Introduzca los siguientes datos:

• Nombre de la conexión: un nombre descriptivo para ayudarte a identificar esta conexión.
• URL base: la URL base de tu API (por ejemplo https://api.example.com).
• ID de cliente: el identificador único para tu aplicación proporcionado por tu proveedor de OAuth durante el registro de la aplicación.
• Secreto de cliente: la clave secreta confidencial para tu aplicación proporcionada por tu proveedor de OAuth.
• URL de autorización: la URL completa del punto final de autorización proporcionada por tu proveedor de OAuth (p. ej. https://login.example.com/oauth2/authorize).
• URL del token: la URL del punto final del token donde los códigos de autorización o las credenciales se intercambian por tokens de acceso según lo proporcionado por tu proveedor de OAuth (por ejemplo https://login.example.com/oauth2/token).
• Ámbito: los ámbitos OAuth necesarios en función de tu proveedor de API o necesidades de integración.

Configuración adicional:

• URL del token de actualización: la URL del punto final del token de actualización proporcionada por tu proveedor de OAuth (p. ej. https://example.com/docs/oauth/refresh)
• URL de revocación del token: la URL del punto final de revocación del token proporcionada por tu proveedor de OAuth (https://example.com/docs/oauth/revoke).
• Intervalo de actualización: tiempo en segundos entre los intentos de actualización del token OAuth.
• Encabezado básico OAuth: habilita para enviar el ID de cliente y el secreto como encabezado de autenticación básico durante el intercambio de tokens OAuth. La mayoría de los proveedores necesitan que esto esté habilitado.

Código de autorización OAuth 2.0 con PKCE

Introduzca los siguientes datos:

• Nombre de la conexión: un nombre descriptivo para ayudarte a identificar esta conexión.
• URL base: la URL base de tu API (por ejemplo https://api.example.com).
• ID de cliente: el identificador único para tu aplicación proporcionado por tu proveedor de OAuth durante el registro de la aplicación.
• Secreto de cliente: la clave secreta confidencial para tu aplicación proporcionada por tu proveedor de OAuth.
• URL de autorización: la URL completa del punto final de autorización proporcionada por tu proveedor de OAuth (p. ej. https://login.example.com/oauth2/authorize).
• URL del token: la URL del punto final del token donde los códigos de autorización o las credenciales se intercambian por tokens de acceso según lo proporcionado por tu proveedor de OAuth (por ejemplo https://login.example.com/oauth2/token).
• Ámbito: los ámbitos OAuth necesarios en función de tu proveedor de API o necesidades de integración.

Configuración adicional:

• URL del token de actualización: la URL del punto final del token de actualización proporcionada por tu proveedor de OAuth (p. ej. https://example.com/docs/oauth/refresh)
• URL de revocación del token: la URL del punto final de revocación del token proporcionada por tu proveedor de OAuth (https://example.com/docs/oauth/revoke).
• Intervalo de actualización: tiempo en segundos entre los intentos de actualización del token OAuth.
• Encabezado básico OAuth: habilita para enviar el ID de cliente y el secreto como encabezado de autenticación básico durante el intercambio de tokens OAuth. La mayoría de los proveedores necesitan que esto esté habilitado.

Credenciales de cliente OAuth 2.0

Introduzca los siguientes datos:

• Nombre de la conexión: un nombre descriptivo para ayudarte a identificar esta conexión.
• URL base: la URL base de tu API (por ejemplo https://api.example.com).
• ID de cliente: el identificador único para tu aplicación proporcionado por tu proveedor de OAuth durante el registro de la aplicación.
• Secreto de cliente: la clave secreta confidencial para tu aplicación proporcionada por tu proveedor de OAuth.
• URL del token: la URL del punto final del token donde los códigos de autorización o las credenciales se intercambian por tokens de acceso según lo proporcionado por tu proveedor de OAuth (por ejemplo https://login.example.com/oauth2/token).
• Ámbito: los ámbitos OAuth necesarios en función de tu proveedor de API o necesidades de integración.

Configuración adicional:

• Intervalo de actualización: tiempo en segundos entre los intentos de actualización del token OAuth.
• Encabezado básico OAuth: habilita para enviar el ID de cliente y el secreto como encabezado de autenticación básico durante el intercambio de tokens OAuth. La mayoría de los proveedores necesitan que esto esté habilitado.

Contraseña OAuth 2.0

Introduzca los siguientes datos:

• Nombre de la conexión: un nombre descriptivo para ayudarte a identificar esta conexión.
• URL base: la URL base de tu API (por ejemplo https://api.example.com).
• Nombre de usuario: la credencial del nombre de usuario del usuario final para la autenticación.
• Contraseña: la credencial de contraseña del usuario final para la autenticación.
• ID de cliente: el identificador único para tu aplicación proporcionado por tu proveedor de OAuth durante el registro de la aplicación.
• Secreto de cliente: la clave secreta confidencial para tu aplicación proporcionada por tu proveedor de OAuth.
• URL de autorización: la URL completa del punto final de autorización proporcionada por tu proveedor de OAuth (p. ej. https://login.example.com/oauth2/authorize).
• URL del token: la URL del punto final del token donde los códigos de autorización o las credenciales se intercambian por tokens de acceso según lo proporcionado por tu proveedor de OAuth (por ejemplo https://login.example.com/oauth2/token).
• Ámbito: los ámbitos OAuth necesarios en función de tu proveedor de API o necesidades de integración.

Configuración adicional:

• URL del token de actualización: la URL del punto final del token de actualización proporcionada por tu proveedor de OAuth (p. ej. https://example.com/docs/oauth/refresh).
• URL de revocación del token: la URL del punto final de revocación del token proporcionada por tu proveedor de OAuth (https://example.com/docs/oauth/revoke).
• Intervalo de actualización: tiempo en segundos entre los intentos de actualización del token OAuth.
• Encabezado básico OAuth: habilita para enviar el ID de cliente y el secreto como encabezado de autenticación básico durante el intercambio de tokens OAuth. La mayoría de los proveedores necesitan que esto esté habilitado.

Autenticación básica

Introduzca los siguientes datos:

• Nombre de la conexión: un nombre descriptivo para ayudarte a identificar esta conexión.
• URL base: la URL base de tu API (por ejemplo https://api.example.com).
• Nombre de usuario: la credencial de nombre de usuario para tu cuenta API.
• Contraseña: la credencial de contraseña para tu cuenta API.

Configuración adicional:

• API de validación de autenticación: introduce la ruta relativa que se utilizará para verificar tus credenciales de autenticación (p. ej. /api/v1/me, /user/profile, /auth/validate). Esta ruta API debería devolver una respuesta correcta cuando tus credenciales sean válidas.

Clave API

Introduzca los siguientes datos:

• Nombre de la conexión: un nombre descriptivo para ayudarte a identificar esta conexión.
• URL base: la URL base de tu API (por ejemplo https://api.example.com).
• Nombre del parámetro: el nombre exacto del parámetro de la clave API según lo requiera tu API (p. ej. X-API-Key, api_key, Authorization). Esto se utilizará como nombre de encabezado o nombre de parámetro de consulta en función de su selección.
• Valor: el valor completo de tu clave API proporcionado por tu proveedor de API. Esto se almacenará de forma segura y se utilizará para la autenticación.

Configuración adicional:

• Añadir a: selecciona si añadir la clave API en el encabezado de la solicitud o como parámetro de consulta. Se recomienda el encabezado para mayor seguridad.
• API de validación de autenticación: introduce la ruta relativa que se utilizará para verificar tus credenciales de autenticación (p. ej. /api/v1/me, /user/profile, /auth/validate). Esta ruta API debería devolver una respuesta correcta cuando tus credenciales sean válidas.

Portador OAuth 2.0 JWT

Introduzca los siguientes datos:

• Nombre de la conexión: un nombre descriptivo para ayudarte a identificar esta conexión.
• URL base: la URL base de tu API (por ejemplo https://api.example.com).
• ID de cliente: el identificador único para tu aplicación proporcionado por tu proveedor de OAuth durante el registro de la aplicación.
• Secreto de cliente: la clave secreta confidencial para tu aplicación proporcionada por tu proveedor de OAuth.
• Clave codificada JWT en Base64: tu clave privada codificada en Base64. Asegúrate de seguir las instrucciones de tu proveedor de API para la generación y codificación de claves.
• URL de autorización: la URL completa del punto final de autorización proporcionada por tu proveedor de OAuth (p. ej. https://login.example.com/oauth2/authorize).
• URL del token: la URL del punto final del token donde los códigos de autorización o las credenciales se intercambian por tokens de acceso según lo proporcionado por tu proveedor de OAuth (por ejemplo https://login.example.com/oauth2/token).
• Ámbito: los ámbitos OAuth necesarios en función de tu proveedor de API o necesidades de integración.

Configuración adicional:

• URL del token de actualización: la URL del punto final del token de actualización proporcionada por tu proveedor de OAuth (p. ej. https://example.com/docs/oauth/refresh).
• URL de revocación del token: la URL del punto final de revocación del token proporcionada por tu proveedor de OAuth (https://example.com/docs/oauth/revoke).
• Intervalo de actualización: tiempo en segundos entre los intentos de actualización del token OAuth.
• Encabezado básico OAuth: habilita para enviar el ID de cliente y el secreto como encabezado de autenticación básico durante el intercambio de tokens OAuth. La mayoría de los proveedores necesitan que esto esté habilitado.

Token de acceso personal

Introduzca los siguientes datos:

• Nombre de la conexión: un nombre descriptivo para ayudarte a identificar esta conexión.
• URL base: la URL base de tu API (por ejemplo https://api.example.com).
• Prefijo del token: el prefijo del token (por ejemplo Bearer, Token, Basic). Esto se combinará con tu token en el encabezado de Autorización. Dejar vacío si no se requiere prefijo.
• Token: el valor completo del token de acceso personal. Esto se combinará con el tipo de token en el encabezado de Autorización (por ejemplo Bearer your-token-here).

Configuración adicional:

• API de validación de autenticación: introduce la ruta relativa que se utilizará para verificar tus credenciales de autenticación (p. ej. /api/v1/me, /user/profile, /auth/validate). Esta ruta API debería devolver una respuesta correcta cuando tus credenciales sean válidas.

Añadir la conexión HTTP

1. Selecciona Integration Service en la barra izquierda.
2. En la lista Conectores , selecciona HTTP. También puedes utilizar la barra de búsqueda para encontrar el conector.
3. Selecciona el botón Conectar a HTTP .
4. En la pantalla de conexión, proporciona los detalles necesarios.
5. Select Connect.
6. Se ha agregado su conexión.