Cuanto más antiguo sea el token, mayor será el riesgo de exposición y los posibles daños para la operación. El procedimiento de renovación de tokens garantiza la continuidad de la seguridad de tu tienda y minimiza posibles vulnerabilidades.

Renueva el token de API con frecuencia, si posible antes de recibir la alerta de renovación para mantener la seguridad de la tienda.

Sigue los pasos a continuación para renovar el token de una clave de API:

1. En la barra superior del Admin VTEX, haz clic en el avatar de tu perfil, marcado por la inicial de tu email, y luego en Configuración de la cuenta > Claves de API.

2. Comprueba que estás en la pestaña Generadas.

3. En la fila de la clave de API deseada, haz clic en el menú (⋮) y después en Renovar token.

   Podrás visualizar el nuevo token mediante un link de acceso único, válido por hasta 24 horas, si no se accede a él dentro de ese plazo.

4. Para copiar el link de acceso único al nuevo token en el portapapeles, haz clic en Copiar. Este link solo se mostrará una vez.

5. Marca una de las siguientes opciones en la sección Eliminar token antiguo:

   • Después: será necesario eliminar manualmente el token antiguo en cuanto el nuevo token esté en uso en las integraciones. Ambos tokens serán válidos y funcionales hasta que se elimine el antiguo. En la lista de la pestaña Generadas, en la columna Duración del token, se mostrará el plazo de validez de los dos tokens, hasta que se elimine el antiguo.

   • Ahora: el token antiguo se eliminará del sistema cuando finalice el proceso de renovación y a partir de ese momento solo será válido el token nuevo.

   Si se cierra la página antes de seleccionar una de las dos opciones, se aplicará la opción Después, lo que significa que tendrás que eliminar el token antiguo manualmente.

6. Haz clic en Finalizar.

7. Accede al link copiado o compártelo con la persona que usará el nuevo token. El link solo podrá utilizarse una vez y su validez es de 24 horas si no se accede a él.

8. Haz clic en Copiar para copiar el token de la API al portapapeles. Este secreto solo se mostrará una vez, asegúrate de guardarlo en un lugar seguro.

Al completar la renovación, no será posible renovar el token nuevamente hasta que el link de acceso único sea utilizado o expire después de 24 horas. Si es necesario, puedes deshacer la renovación del token mientras el link siga en vigor.

Si el link de acceso único expira antes de ser utilizado, repite el proceso para renovar el token y generar un nuevo link.

La URL oficial para acceder al token siempre sigue el formato share.vtex.com/credentials/{token}. El {token} es un identificador aleatorio generado cuando se crea o renueva la clave. Comprueba el formato del link antes de abrirlo para evitar riesgos de phishing o acceso a páginas maliciosas.

Asegúrate de que el token antiguo no está siendo utilizado por ninguna integración antes de eliminarlo. Este procedimiento no puede deshacerse.

Sigue las instrucciones para eliminar manualmente un token antiguo tras la renovación. Este procedimiento solo es posible si se selecciona la opción Después al renovar un token.

1. En la barra superior del Admin VTEX, haz clic en el avatar de tu perfil, marcado por la inicial de tu email, y luego en Configuración de la cuenta > Claves de API.

2. Comprueba que estás en la pestaña Generadas.

3. En la fila de una clave de API que tenga la alerta Eliminación pendiente - Token antiguo, haz clic en el menú (⋮) y luego en Eliminar token antiguo.

   

4. Para confirmar, haz clic en Eliminar.

Este procedimiento solo es posible mientras el token antiguo no haya sido eliminado. Si se eliminó el token antiguo, será necesario renovar el token de nuevo o eliminar la clave de API.

Si renovaste el token por error u olvidaste copiar el nuevo token generado, sigue los pasos a continuación para deshacer la renovación.

1. En la barra superior del Admin VTEX, haz clic en el avatar de tu perfil, marcado por la inicial de tu email, y luego en Configuración de la cuenta > Claves de API.
2. Comprueba que estás en la pestaña Generadas.
3. En la fila de la clave de API deseada, haz clic en el ícono de menú (⋮) y después en Deshacer renovación.
4. Para confirmar, haz clic en Deshacer.

• Claves de API
• Configurar alerta para renovar tokens de API
• Claves generadas