Controles de claves de septiembre: rota accesos sin romper tus workers

Documentación revisada el 14 de octubre de 2026. Esta guía analiza la versión fechada que se describe a continuación; consulta la documentación oficial enlazada para confirmar el comportamiento actual de la API y la disponibilidad de tu cuenta antes de implementarla.

Una clave que funciona para siempre resulta cómoda hasta que nadie recuerda qué sigue usándola. OpenAI incorporó caducidad de claves de proyecto el 10 de septiembre de 2026 y controles de creación el día 15. El historial y la guía de producción se comprobaron el 14 de octubre.

Inventaría referencias, no secretos

Anota servicio, responsable, entorno, referencia al secreto y forma de rotación. No copies las claves a una hoja. Separa experimentos personales de workers de producción. Si una credencial no tiene responsable, resuélvelo antes de imponer una caducidad corta.

Las reglas pueden permitir claves de cuentas de servicio, claves de usuarios o impedir nuevas claves. La organización prevalece sobre el proyecto. Estas restricciones de creación no revocan claves existentes: no las interpretes como eliminación automática del acceso antiguo.

Prueba una rotación completa

En un proyecto de prueba autorizado, crea el reemplazo con permisos y duración adecuados. Actualiza la referencia mediante tu gestor de secretos y ejecuta una petición inocua. Comprueba que el worker cargó el nuevo valor y no mantiene el anterior en memoria. Evita logs y trazas de comandos con credenciales.

Retira después la clave anterior según tu política y repite la comprobación. Prueba también rechazo y caducidad: deben producir un error claro, reintentos limitados y aviso al responsable. Reintentar indefinidamente no arregla autorización vencida.

Ajusta la duración a tu capacidad real

Las vidas cortas limitan credenciales olvidadas, pero requieren renovación fiable. Elige un período compatible con automatización y personal. Avisa con margen e incluye responsable y referencia, nunca el secreto.

Empieza por un servicio y observa un ciclo completo antes de ampliar. Documenta cómo recuperar una renovación fallida durante un incidente o fin de semana sin pegar una clave personal en una terminal compartida.

Estas funciones hacen explícito el ciclo de acceso. No sustituyen permisos mínimos, límites de gasto ni respuesta a incidentes. La prueba final: el worker previsto continúa, la clave retirada falla y otro operador entiende la evidencia sin ver la credencial.