Saltar al contenido principal

Cómo administrar y crear claves de acceso (API-KEY) en Blip

  • Actualización

  1. Resumen

  2. Cómo crear una nueva clave de acceso

  3. Tipos de autenticación

  4. Reglas de la clave predeterminada y configuración HTTP

  5. Eliminación de una clave de acceso

  6. Mejores prácticas de seguridad 

 

Resumen

El objetivo de esta documentación es instruir a los usuarios sobre el proceso completo de administración de las claves de acceso (API-Key) en la plataforma. Este artículo detalla la creación de nuevas claves, la identificación de los tipos de autenticación (HTTP y SDK), la configuración de la clave predeterminada, el proceso de eliminación y las mejores prácticas de seguridad para el mantenimiento de las credenciales 

Antes de comenzar

Para poder realizar los siguientes procedimientos, asegúrate de que se cumplan los siguientes requisitos:

  • Solo los usuarios administradores del chatbot tendrán acceso a esta funcionalidad.

  • La creación de claves de acceso tiene un límite máximo de 3 claves activas a la vez en el bot.

  • Para que el chatbot funcione correctamente, es obligatorio contar con una clave de acceso predeterminada. Al crear un nuevo chatbot, esta clave predeterminada se genera automáticamente.

 

Cómo crear una nueva clave de acceso 

Sigue detalladamente los pasos a continuación para crear una nueva clave de Authorization (API-Key) en tu bot: 

  1. Ingresa al portal blip.ai y selecciona el bot deseado;

  2. Después de que se cargue la interfaz, haz clic en el nombre de tu bot y selecciona Configuración;

  3. Después, selecciona Claves de acceso;

  4. Haz clic en el botón Nueva clave;

  5. En el campo ‘Nombre’, agrega el nombre que elijas para identificar la nueva clave;

  6. Selecciona ‘Crear’;

  7. Después de hacer clic en el botón Crear, aparecerá una nueva pantalla que mostrará la información de la nueva clave generada;

  8. En esta pantalla podrás consultar tu nueva clave en formato HTTP o SDK. La clave de acceso se muestra solo una vez al momento de crearla:

  1. Guarda esta información en un lugar seguro, ya que no podrás consultarla ni recuperarla posteriormente por motivos de seguridad. Nunca compartas tu clave sin protección;

  2. Después de finalizar, se mostrará una referencia de esta clave en la pantalla principal de administración de claves, lo que te permitirá consultar el ID o eliminar la clave seleccionando el ícono de la papelera:


 

Tipos de autenticación

Al generar las credenciales, notarás que hay dos formatos distintos disponibles:

  • Formato SDK: Se utiliza para proyectos con integración mediante SDK. Algunos ejemplos son Blip C# SDK, Blip Javascript SDK, Blip Python SDK o Lime SDK.

  • Formato HTTP: Se utiliza en el encabezado (Authorization) de una solicitud HTTP, como en integraciones o solicitudes HTTP realizadas directamente a Blip.

Para profundizar en el conocimiento sobre los tipos de autenticación (SDK y HTTP), consulta la documentación técnica en https://docs.blip.ai/#authentication 

 

Reglas de la clave predeterminada y configuración HTTP

  • Clave predeterminada: Una clave marcada como predeterminada no podrá eliminarse y su eliminación no está permitida directamente. Para cambiar la clave predeterminada, crea una nueva clave. De esta manera, la última clave generada se convertirá automáticamente en la predeterminada.

  • Configuración HTTP: Para cambiar la configuración HTTP del bot en la plataforma, será necesario ingresar tu clave SDK. Este requisito aumenta la seguridad de quiénes pueden cambiar esta información confidencial de tu chatbot.

 

Eliminación de una clave de acceso

Antes de realizar el proceso de eliminación, asegúrate de que no haya ninguna integración que utilice la clave que deseas eliminar. La clave no puede estar en uso en ninguna integración para poder eliminarla. 

Si todas las claves están en uso y deseas eliminarlas, primero será necesario crear una nueva clave, actualizar todas las integraciones externas para que la utilicen y solo después eliminar las claves antiguas.

Para eliminar una clave, sigue estos pasos:

  1. En la pantalla de administración de claves, identifica la credencial que no está en uso y haz clic en el ícono de la papelera que aparece junto a ella.

  2. El sistema solicitará una verificación de seguridad. Confirma la eliminación haciendo clic en el botón Eliminar.

  3. En la interfaz aparecerá el mensaje "Clave eliminada correctamente", con lo que concluirá formalmente el proceso de eliminación.


 

Mejores prácticas de seguridad

Para garantizar la integridad de tu chatbot, sigue rigurosamente estas recomendaciones de seguridad:

  • Cambia periódicamente la clave de seguridad: Como medida de seguridad, recomendamos cambiar periódicamente la clave de acceso (por ejemplo, cada 6 meses). Como la clave no caduca, si se obtiene de manera indebida, podría utilizarse de forma indebida por tiempo indefinido hasta que se desactive en la plataforma.

  • Conserva la clave en un lugar seguro: No guardes la clave de acceso en un lugar público. Guarda la clave generada en un lugar seguro, como una bóveda de contraseñas o un sistema de administración de acceso privilegiado y, de preferencia, en sistemas que cuenten con administración del acceso a la información guardada.

  • Compartir la clave de acceso: Solo realiza esta acción si confías plenamente en la aplicación o en la persona con quien compartirás la información. Al compartir la clave de acceso, utiliza una forma segura de transmitir esta información, como una bóveda de contraseñas o un sistema de administración de acceso privilegiado con control de acceso.

  • No dejes la clave en el código: No dejes la clave de acceso directamente en el código de tu aplicación. Debes mantener los secretos separados de tu código y almacenarlos, por ejemplo, en archivos de configuración específicos o en variables de entorno.

 

¿Necesitas más ayuda? Explora nuestros contenidos en Blip Academy o en Blip Community, mira tutoriales en nuestro canal de YouTube o resuelve tus dudas en nuestro canal de atención 😃

Artículos relacionados