Cuando se hacen solicitudes con las API de Sunshine Conversations, la autenticación es necesaria para verificar la identidad de la persona que llama. Se puede usarBasic authentication(Autenticación básica) oJSON Web Tokens (JWTs)(Tokens Web JSON (JWT)) para verificar la identidad de la persona. Ambos métodos requieren una clave API. La clave API se crea en la página API de conversaciones.
El acceso a la página API de conversaciones está incluido en elplan Zendesk Suite Professional y planes superiores. Es necesario teneractivadoel espacio de trabajo de agente de Zendesk para poder ver la página. Hay paquetes de complementos adicionales si se requieren más usuarios activos por mes (MAU) o más notificaciones. Si desea más información, consulteAcerca de los complementos de Zendesk Suite.
Este artículo contiene las siguientes secciones:
Acerca de las claves API
Una identifica y autentica Una aplicacio劈开APIn o un usuario y está compuesta de tres partes.
- LaID de la aplicaciónidentifica la cuenta de Zendesk.
- LaID de clavejunto con la clave secreta son las credenciales utilizadas para autenticar los JWT y las llamadas de API.
- Laclave secretaes la contraseña de autenticación.
Con la Autenticación básica, se pueden hacer solicitudes usando una clave API directamente. La ID de la clave es el nombre de usuario y el secreto es la contraseña.
Con los JWT, los tokens se firman con una clave API, y luego se usan para la autenticación con la API. La ID de la clave se incluye en el encabezado de JWT como la propiedadkid
, mientras que el secreto firma el JWT.
Las claves API no son tan seguras como los tokens de autenticación. Asegúrese de seguir las mejores prácticas paramanejar las credenciales de manera seguracuando vaya a usar una clave API en producción.
Si desea más información acerca de la autenticación de Sunshine Conversations, consulteAPI Authentication.
La clave API de Sunshine Conversations es diferente que lasclaves de autenticación de mensajería. Las claves de autenticación de mensajería se utilizan para firmar credenciales que autentican a los usuarios finales usando los SDK de Zendesk. La clave API aquí es para las llamadas de servidor a servidor y proporciona acceso a lasAPI públicas de Sunshine Conversationsque admiten el ámbito deapp
.
Crear y compartir las ID y la clave API
Un administrador de Zendesk debe crear una clave API y compartirla con el desarrollador. Se pueden almacenar hasta 10 claves.
Para crear y compartir una clave API
- En elCentro de administración, haga clic en
Aplicaciones e integracionesen la barra lateral y seleccioneAPI > API de conversaciones.
Nota:Es necesario tener unplan Zendesk Suite Professional o superiorpara ver esta ventana. - Haga clic enCrear clave de API.
Si está creando su primera clave, este botón aparecerá en la parte inferior de la página; si ya ha creado una clave anteriormente, aparecerá en la esquina superior derecha.
- Ingrese un nombre identificador para la clave en el cuadro de diálogo Crear nueva clave y luego haga clic enSiguiente.
- En el cuadro de diálogo Copiar secreto compartido, haga clic enCopiarpara cada ID y clave secreta para guardarlas en el portapapeles y luego haga clic enSiguiente.
Volverá a la ventana de la API, donde la nueva clave aparece en la lista.
Si genera una nueva clave pero ya ha alcanzado su límite de 10 claves, aparecerá una notificación que le indica que debe borrar las claves no utilizadas.
Para borrar una clave no utilizada
- En elCentro de administración, haga clic en
Aplicaciones e integracionesen la barra lateral y seleccioneAPI > API de conversaciones.
- Pase el puntero del mouse por encima de la clave que desea borrar, luego haga clic en el menú de opciones (
) y seleccioneBorrar.
- Para confirmar la acción, haga clic enBorrar.
0 Comentarios
Inicie sesiónpara dejar un comentario.