Ir al contenido principal

Por qué los tokens de API y los webhooks no se traspasan al desactivar un usuario

Al desactivar un usuario, sus tokens de API y sus webhooks dejan de funcionar y no pasan a otro usuario. Te contamos por qué y cómo mantener tus integraciones en marcha.

Escrito por Martina

Cuando desactivas un usuario, Parallel traspasa sus parallels, plantillas y otros recursos al usuario que elijas. Los tokens de API y los webhooks son distintos: se quedan en el usuario desactivado y dejan de funcionar. Nunca pasan a otro usuario.

Qué pasa con los tokens de API y los webhooks

  • Tokens de API: Parallel rechaza cualquier petición hecha con un token de un usuario desactivado.

  • Webhooks (suscripciones a eventos): dejan de enviar eventos.

Cuando desactivas a un usuario que tiene tokens de API o webhooks, la ventana de desactivación muestra un aviso con el número de tokens y webhooks que van a dejar de funcionar.

Si más adelante reactivas al usuario, sus tokens y sus webhooks vuelven a funcionar.

Por qué no los traspasamos

Traspasar una integración a otro usuario parece cómodo, pero tiene riesgos de seguridad:

  • Un token de API es una credencial. La persona que lo creó puede seguir teniendo una copia, por ejemplo en un script, en una herramienta de automatización o en su ordenador. Si el token pasara a otro usuario, esa persona seguiría teniendo acceso a Parallel después de dejar tu organización, y además con los permisos del nuevo usuario.

  • Un webhook envía datos a una dirección que eligió el usuario desactivado. Si el webhook pasara a otro usuario, esa dirección empezaría a recibir los eventos de todo lo que ve el nuevo usuario. Puede ser mucha más información que antes, enviada a una dirección que quizá tu organización no controla.

  • Trazabilidad. Todo lo que hiciera la integración después del traspaso aparecería como una acción del nuevo usuario, aunque él nunca la configuró.

Por eso Parallel no los traspasa automáticamente. Mantener una integración tiene que ser una decisión explícita, tomada por alguien que sabe dónde funciona la integración y quién tiene acceso a ella.

Cómo mantener una integración en marcha

Si una integración del usuario que vas a desactivar tiene que seguir funcionando, vuelve a configurarla con otro usuario. Te recomendamos hacerlo antes de desactivar al usuario, para que la integración no se interrumpa.

  1. Elige el usuario que será el dueño de la integración. Te recomendamos un usuario de servicio que no pertenezca a una persona, por ejemplo integraciones@tuempresa.com, con solo los permisos que necesita la integración. Así la integración no depende de ningún empleado.

  2. Crea un token de API nuevo con ese usuario, en Ajustes > Desarrolladores. Consulta Gestionar tokens para acceder a la API.

  3. Vuelve a crear los webhooks con ese usuario, en Ajustes > Desarrolladores, con la misma URL y los mismos eventos. Si tu sistema verifica las firmas de los eventos, añade también las claves de firma. Consulta Gestionar suscripciones a eventos y claves de firma.

  4. Actualiza tu sistema o tu herramienta de automatización (por ejemplo Zapier o Make): sustituye el token antiguo por el nuevo y, si verificas las firmas, la clave pública antigua por la nueva.

  5. Comprueba que la integración funciona: haz una llamada con el token nuevo y comprueba que el webhook nuevo recibe eventos.

  6. Desactiva al usuario. Sus tokens y webhooks antiguos dejan de funcionar.

Preguntas frecuentes

¿Puedo traspasar un token o un webhook a otro usuario?
No. Crea un token o un webhook nuevo con el usuario que será el dueño de la integración, como se explica arriba.

¿Se borran los tokens y los webhooks antiguos?
No. Se quedan en el usuario desactivado y no funcionan. Si reactivas al usuario, vuelven a funcionar.

¿Qué se traspasa al desactivar un usuario?
Sus parallels y plantillas, las asignaciones automáticas de plantillas y sus suscripciones a perfiles. Sus borradores solo se traspasan si marcas Incluir borradores; si no, se eliminan. Consulta Cómo desactivar a un usuario.

Si tienes cualquier duda, escríbenos por el chat.

¿Ha quedado contestada tu pregunta?