Configure la autenticación necesaria para probar la API de Knowledge Base o conectar una aplicación a ella.
Las peticiones de la API de Knowledge Base usan autenticación bearer-token.Use un token de usuario autenticado para pruebas a corto plazo, o configure una cuenta técnica para una aplicación o integración.
Antes de empezar
Asegúrese de que:
- Su organización tiene acceso a Knowledge Base.
- Tienes acceso a los recursos de la API necesarios para tu flujo de trabajo.
- Puede acceder a Adobe Developer Console si está configurando una integración de aplicación.
El acceso a la API no anula los permisos de Knowledge Base.La identidad autenticada debe tener acceso a las colecciones, documentos y operaciones solicitadas por la aplicación.
Elija un método de autenticación
Use el método de autenticación que coincida con su fase de desarrollo.
| caso de uso | Autenticación |
|---|---|
| Probar peticiones o explorar la API | Token bearer de usuario autenticado |
| Generar una aplicación o integración | Cuenta técnica |
Token bearer de usuario
Un token bearer de usuario autenticado es útil para probar peticiones de API, incluidas las peticiones realizadas a través de la referencia de la API.
El token representa al usuario que ha iniciado sesión y es válido durante 24 horas.Las peticiones realizadas con el token tienen el mismo acceso a Knowledge Base disponible para ese usuario.
Después de obtener un token bearer de usuario, inclúyelo con cada solicitud:
Authorization: Bearer <access-token>
También puede usar el token con la referencia interactiva de la API de Knowledge Base para probar los puntos finales disponibles.
Comience con una operación que recupere un recurso al que ya tenga acceso.Una respuesta exitosa confirma que el token es aceptado y la identidad autenticada puede acceder a ese recurso.
No genere una integración de aplicación persistente alrededor de un token bearer de usuario.
Cuenta técnica
Use una cuenta técnica para aplicaciones e integraciones que deban autenticarse sin una sesión de usuario interactiva.
Las cuentas técnicas se configuran a través de Adobe Developer Console. Sigue el proceso de configuración de cuenta técnica para crear las credenciales requeridas por tu aplicación.
Después de crear la cuenta técnica, regresa a esta página para validar tu acceso a la API de Knowledge Base.
Comprenda los permisos de API
La autenticación establece la identidad que realiza la solicitud de API. La autorización determina qué puede hacer esa identidad.
Por ejemplo, una identidad autenticada puede ser capaz de recuperar una colección pero no otra, o puede no tener acceso a un recurso de nivel de administrador.
Si la autenticación se realiza correctamente pero se rechaza una operación, verifique que la identidad autenticada tenga permiso para acceder al recurso solicitado antes de tratar la respuesta como un fallo de autenticación.
Validar el acceso a la API
Después de que se configure la autenticación:
- Obtener un token de acceso.
- Enviar una solicitud a un recurso al que pueda acceder la identidad autenticada.
- Confirmar que la API devuelve la respuesta esperada.
- Continuar con el flujo de trabajo de introducción a la API.
