Primeros pasos

Puedes crear un conector personalizado desde un lienzo en blanco o desde una especificación de API.

Antes de crear un conector, primero familiarízate con los tipos de autenticación disponibles.

Tipos de autenticación

Esta sección explica los tipos de autenticación más comunes disponibles en el Creador de conectores. Incluye una comparación entre tres tipos de autenticación en términos de caso de uso, flujo de autenticación y seguridad. Para obtener más información, consulta Tipos de autenticación.

Flujo de código de autorización OAuth 2.0

• Ideal para aplicaciones que necesitan acceder a los datos del usuario en nombre del usuario.
• Alta seguridad: el token de acceso nunca se expone al agente de usuario y se intercambia de servidor a servidor.

Flujo:

1. Autorización de usuario: el usuario es redirigido al servidor de autorización para conceder acceso.
2. Código de autorización: si el usuario concede acceso, se devuelve un código de autorización al cliente.
3. Intercambio de tokens: el cliente intercambia el código de autorización por un token de acceso en el punto final del token.

Flujo de código de credenciales de cliente OAuth 2.0

• Adecuado para interacciones de servidor a servidor en las que no hay interacción del usuario.
• Seguridad moderada: se basa en que las credenciales del cliente se mantengan seguras.

Flujo:

1. Solicitud directa de token: el cliente solicita directamente un token de acceso del servidor de autorización utilizando sus credenciales de cliente.
2. Token de acceso: el servidor de autorización devuelve un token de acceso

Clave API

• Simple y rápido de implementar, a menudo utilizado para API públicas.
• Baja seguridad: las claves API se pueden compartir o exponer fácilmente.

Flujo:

Uso de clave API: el usuario incluye una clave API en cada solicitud de autenticación.

Elegir un flujo de autenticación

En el Ejemplo A: crear un conector a partir de un lienzo en blanco con autenticación de token de acceso personal, utilizamos el tipo de autenticación Token de acceso personal (PAT). El ejemplo Generar API de imagen sigue la práctica estándar de utilizar el encabezado de Autorización con el esquema Bearer para la clave API, especialmente para los tokens OAuth 2.0.

Algunas API, como los recursos de SAP S4 ODataV2, utilizan un encabezado personalizado como la clave API para autenticar la aplicación. Esto se utiliza en el Ejemplo B: crear un conector a partir de un lienzo en blanco con autenticación de clave API.

Ejemplo C: crear un conector a partir de una especificación de API con la autenticación de credenciales de cliente OAuth 2.0 utiliza el flujo de credenciales de cliente OAuth 2.0, con una aplicación OAuth 2.0.