Menú
Feedback
Comienza aquí


Comunicados
Comunicados
Diciembre
Claves de API: nueva experiencia centrada en usabilidad y seguridad
Photo of the author
Júlia Rabello
Publicado el3/12/2024
Última actualización el5/2/2025
4 min de lectura

Presentamos la nueva experiencia de gestión de claves de API que permite controlar las credenciales de forma más eficiente.

La actualización incluye una interfaz optimizada para facilitar la gestión, además de nuevas funcionalidades que mejoran la seguridad, como definir la duración de los tokens, renovar tokens y eliminar claves no utilizadas.

{"base64":"  ","img":{"width":1920,"height":936,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":167516,"url":"https://raw.githubusercontent.com/vtexdocs/help-center-content/refs/heads/main/docs/es/announcements/2024/diciembre/2024-12-03-claves-de-api-nueva-experiencia-centrada-en-usabilidad-y-seguridad_1.png"}}

¿Qué cambió?

Las novedades se describen en la tabla a continuación:

CambioDescripción
NombreCambiamos el nombre claves de aplicación a claves de API en la interfaz del Admin.
DiseñoRediseñamos la interfaz de gestión, creación y edición de claves de API para proporcionar una experiencia más intuitiva y eficiente.
Separación de clavesAhora las claves generadas internamente y las claves externas están en pestañas separadas para facilitar la gestión de cada tipo de clave.
Duración de tokensAhora todos los tokens generados internamente tienen una duración predeterminada de 3 meses, con opción de extenderla a 6 meses desde la interfaz.La configuración se aplica a todos los tokens generados en la cuenta, ya sean nuevos o existentes, y la duración se calculará desde la fecha en que se creó la clave.Solo se puede ver y configurar la duración de los tokens externos a través de la cuenta en que se crearon.La interfaz notificará a los retailers cuando los tokens generados pasen a estar obsoletos. El uso del token no se ve impactado. El status obsoleto es solo un recurso visual para indicar la duración del token y sugerir su renovación.Más información en Configurar la duración de las claves de API.
Renovación de tokensAhora se pueden renovar los tokens de claves generados en la cuenta. La funcionalidad te da la opción de eliminar el token antiguo inmediatamente o más tarde.Si decides eliminarlo más tarde, ambos tokens serán válidos y funcionales hasta que elimines el antiguo, lo que te permite actualizar el token utilizado en las integraciones sin impactar la operación.Más información en Renovar token de API.
Eliminación de claves de APIAhora es posible eliminar las claves de API que no están en uso.
Permisos específicosNuevos permisos requeridos para gestionar claves de API:View API Keys (ver, filtrar, buscar y ordenar claves de API y externas)Edit API Keys (crear, eliminar, modificar status y agregar o remover permisos)Renew API Token (ver y renovar los tokens de claves generadas)Edit API Keys settings (editar la configuración de la duración de tokens de claves generadas) Más información en Recursos de License Manager.Los usuarios con control de usuarios y roles tendrán los nuevos permisos asignados de forma automática según se describe en la tabla a continuación: Si el usuario tiene…Se le asigna automáticamente…Get account by identifierView API KeysGet paged usersView API KeysGet paged rolesView API KeysFind user by emailView API KeysSave userEdit API KeysOwner - Super AdminEdit API Keys settingsUser Administrator - RESTRICTEDRenew API Token

¿Por qué realizamos este cambio?

El objetivo de la nueva experiencia es proporcionar mayor control y seguridad para tus claves de API de forma simplificada. La interfaz agiliza la gestión de diferentes tipos de claves y optimiza la visibilidad de la información.

Por otro lado, la configuración de la duración de tokens es una capa adicional de seguridad, mientras que las opciones de renovación evitan que las operaciones de la tienda se vean impactadas.

¿Qué se necesita hacer?

Sigue los pasos a continuación para acceder a la nueva experiencia:

  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. Haz clic en Probar nueva experiencia.

Puedes volver a la versión anterior de la página haciendo clic en Volver a la versión anterior.

Para más información, accede a la documentación relacionada:

¿Te ha parecido útil?
No
Sugerir cambios (GitHub)
En esta página
¿Tienes otras preguntas?
Pregunta a la comunidad
Encuentra soluciones y comparte ideas en VTEX Community
Únete a nuestra comunidad
Solicita soporte a VTEX
Recibe asistencia personalizada de nuestros especialistas
Abre un ticket de soporte
GitHubDeveloper PortalComunidadFeedback