{"section":"tutorials","requestedLocale":"es","requestedSlug":"claves-generadas","locale":"es","slug":"claves-generadas","path":"docs/es/tutorials/gestión-de-la-cuenta/claves-de-api/claves-generadas.md","branch":"main","content":"Las claves de API internas son credenciales generadas y gestionadas por tu cuenta VTEX. Esto significa que debes tener acceso a todos los pares de claves y tokens de API (el equivalente a los nombres de usuario y contraseña) para las integraciones de API.\n\nLa pestaña **Generadas** presenta las claves de API creadas por tu cuenta. Puedes utilizar la barra de búsqueda para encontrar una clave por nombre o por el valor de **Identificación de la clave** generado al crearla.\n\n\n\nLa página muestra la siguiente información en forma de tabla: \n\n| Columna | Descripción |\n| :---- | :---- |\n| **Clave/Nombre** | Clave de API, seguida del nombre definido cuando se creó la clave. Si el token se pasa del periodo de renovación recomendado (3 meses de forma predeterminada), se mostrará un ícono de alerta de renovación al lado de clave. Más información en [Configurar alerta de renovación de tokens de API](/es/docs/tutorials/configurar-alerta-para-renovar-tokens-de-api). |\n| **Roles** | Roles asociados a la clave de API. |\n| **Fecha de creación** | Fecha de creación de la clave de API. |\n| **Status** | Status de la clave de API, que puede ser **Activa** o **Inactiva**. |\n\nEsta página te permite realizar las siguientes acciones:\n\n* [Generar clave](#generar-clave) \n* [Editar clave generada](#editar-clave-generada)\n* [Desactivar o activar la clave generada](#desactivar-o-activar-la-clave-generada)\n* [Renovar token](#renovar-token)\n* [Eliminar clave](#eliminar-clave)\n\n## Generar clave\n\nSigue las instrucciones a continuación para crear una nueva clave de API:\n\n1. 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*. \n2. Comprueba que estás en la pestaña **Generadas**. \n3. Haz clic en `+ Generar clave`. \n4. Rellena el campo **Identificación de la clave** con el nombre para identificar la clave de API. Este campo es obligatorio. \n5. Selecciona los [roles](/es/docs/tutorials/roles) que se asociarán a la clave. De manera predeterminada, no se preselecciona ningún rol.\n\n > ℹ️ Marca solo los roles necesarios para la integración que utilizará la clave de API. El uso sin restricciones de roles muy permisivos aumenta el riesgo de ataques en las tiendas al filtrarse las credenciales de inicio de sesión.\n\n6. Haz clic en `Generar`.\n\n 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.\n\n7. Para copiar el link de acceso único al nuevo token en el portapapeles, haz clic en `Copiar`. Este link solo se mostrará una vez. En esta etapa, la clave ya está activa y disponible para su uso.\n8. Haz clic en `Cerrar`.\n9. 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.\n10. 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.\n\n\n\n> ⚠️ 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.\n\n## Editar clave generada\n\nSigue los pasos a continuación para realizar cambios en una clave de API:\n\n1. 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*. \n2. Comprueba que estás en la pestaña **Generadas**. \n3. En la fila de la clave de API deseada, haz clic en el menú (⋮) y después en `Editar`. \n4. Aplica los cambios deseados a partir de las opciones a continuación:\n\n * Cambiar los roles seleccionados para la clave de API. \n * Desmarcar o marcar la opción **Activa** para [desactivar o activar la clave generada](#desactivar-o-activar-la-clave-generada). \n5. Haz clic en `Guardar`.\n\n## Desactivar o activar la clave generada\n\nSi una clave de API que tiene acceso a tu cuenta se ve comprometida, debes desactivarla inmediatamente para revocar el acceso a tu cuenta. Si es necesario, genera una nueva clave para reemplazarla.\n\nSi cometes un error puedes volver a activar la clave de API para restablecer la integración afectada.\n\nSigue los pasos a continuación para desactivar o activar una clave de API:\n\n1. 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*. \n2. Comprueba que estás en la pestaña **Generadas**. \n3. En la fila de la clave de API deseada, haz clic en el menú (⋮) y realiza una de las siguientes acciones: \n * **Desactivar:** si la llave está **activa**, haz clic en `Desactivar` para desactivarla. Esta acción interrumpirá las integraciones que usen la clave, así que utilízala con precaución. Es necesario hacer clic en `Desactivar` una vez más para confirmar la acción. \n * **Activar:** si la clave está **desactivada**, haz clic en `Activar` para activarla.\n\n> ℹ️ Solo se debe volver a activar una clave de API si estás seguro de que no se vio comprometida. Cuando la clave está activa, cualquier persona con el token de API asociado puede tener acceso a tu cuenta.\n\n## Renovar token\n\nRenovar el token de API con frecuencia es muy importante para mantener la seguridad de la tienda. Para garantizar la protección continua, renueva los tokens antes de recibir la [alerta](/es/docs/tutorials/configurar-alerta-para-renovar-tokens-de-api) de renovación siguiendo las instrucciones en [Renovar token de API](/es/docs/tutorials/renovar-token-de-api).\n\n## Eliminar clave\n\nLas claves de API que no se vayan a utilizar pueden eliminarse. Al eliminarlas, es posible mantener la lista organizada y facilitar la gestión de las claves en uso. \n\n> ⚠️ Asegúrate de que la clave de API no está siendo utilizada por ninguna integración antes de eliminarla. Este procedimiento no puede deshacerse.\n\nPara eliminar una clave de API de forma permanente sigue los pasos a continuación:\n\n1. 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*. \n2. Comprueba que estás en la pestaña **Generadas**. \n3. En la fila de la clave de API deseada, haz clic en el menú (⋮) y después en `Eliminar clave`.\n4. Marca la opción *Entiendo que esta acción no se puede deshacer*. \n5. Para confirmar, haz clic en `Eliminar`.\n\n## Más información\n\n* [Claves de API](/es/docs/tutorials/claves-de-api)\n* [Renovar token de API](/es/docs/tutorials/renovar-token-de-api)\n* [Configurar alerta para renovar tokens de API](/es/docs/tutorials/configurar-alerta-para-renovar-tokens-de-api) \n* [Claves externas](/es/docs/tutorials/claves-externas)"}