GPT Image 2.5 is live — OpenAI's newest image model, targeted edits that leave the rest of the frame alone
Todas las guías

· reAPI Team

Clave API filtrada: detén el uso y los cargos no autorizados

Contén una filtración de clave API, distingue el uso nuevo de los cargos pendientes, sustituye las credenciales expuestas de forma segura y prepara pruebas para revisar la facturación.

Clave API filtrada: detén el uso y los cargos no autorizados

Revoca ahora la clave expuesta en la consola de cuenta del proveedor. Anota la hora. Puedes investigar la captura de pantalla, el repositorio o la entrada del registro después de invalidar la credencial.

Eliminar el lugar donde apareció el secreto no invalida una copia que alguien ya tenga. Por eso, las recomendaciones de GitHub sitúan la revocación o rotación antes de la limpieza del repositorio.[1] Si tu aplicación utiliza la clave, cuenta con que sustituirla requerirá coordinación. Que una aplicación funcione no es motivo para mantener activa una credencial cuya exposición ya conoces.

Empieza por tu acceso habitual a la cuenta

Usa tu marcador habitual o la dirección de cuenta conocida del proveedor, no un enlace de un mensaje que afirme haber encontrado la filtración. Busca la credencial afectada mediante un identificador o etiqueta que puedas usar sin revelar secretos y utiliza el control de revocación o desactivación documentado. No necesitas pegar su valor completo en una nota del incidente.

En reAPI, la revocación impide nuevas solicitudes con esa clave. Las aplicaciones que aún la tengan necesitarán una sustituta. La documentación de autenticación también indica que las tareas pendientes pueden continuar hasta completarse y consumir créditos tras la revocación.[2] Esta segunda parte importa cuando miras el saldo justo después.

Comprueba por separado la recarga automática y el trabajo pendiente. Si decides desactivar la financiación automática, determina qué detiene realmente ese ajuste. No revoca una credencial API, no cancela trabajos aceptados ni explica por sí solo un cargo. Si un proveedor permite cancelar, comprueba el resultado confirmado de la tarea y la regla de facturación en lugar de suponer que pulsar Cancelar hizo gratuito el trabajo.

En esta fase, mantén una nota breve: cuenta afectada, etiqueta de la credencial, hora de detección y hora de revocación, con zona horaria. La investigación detallada puede venir después. Esperar a tener un informe perfecto deja disponible la credencial expuesta durante más tiempo.

Por qué puede cambiar el saldo después de la revocación

Supongamos que una generación se acepta a las 09:01, revocas la clave expuesta a las 09:03 y la tarea termina a las 09:07. Es una secuencia ilustrativa, no un incidente notificado. En reAPI, el comportamiento documentado de las tareas pendientes permite que ese trabajo anterior termine y consuma créditos. El contrato de tareas también distingue la reserva realizada al enviar la solicitud de la liquidación final.[2][3]

La liquidación de las 09:07 no demuestra, por sí sola, que la clave autenticara una solicitud nueva después de las 09:03. Comprueba cuándo se aceptó la tarea. Esa marca de tiempo responde a una pregunta distinta de la hora en que terminó el procesamiento o apareció un cargo.

Tampoco supongas lo contrario. Una solicitud desconocida aceptada después de la hora de revocación que anotaste sigue requiriendo investigación. Comprueba otras credenciales activas, la cuenta u organización que estás viendo y las aplicaciones o personas que pueden enviar trabajos allí. Si los registros disponibles no identifican la credencial o la hora de aceptación, deja esa parte como desconocida y pide ayuda al soporte para aclararla.

Para cada solicitud sospechosa, conserva su ID, modelo o punto de conexión, hora de aceptación, hora de finalización e importe liquidado cuando estén disponibles. Añade si tu aplicación la reconoce. Buscas separar el trabajo conocido del inexplicado, no demostrar una teoría a partir de un saldo que baja.

El importe en riesgo también puede diferir del ya liquidado. Interpreta los campos de reserva y uso final según el contrato de la plataforma. En reAPI, una tarea en procesamiento con uso liquidado igual a cero no ha completado la facturación; ese cero no demuestra que se haya reembolsado la reserva anterior.[3] Mantén visibles las tareas sin resolver hasta conocer sus resultados.

Sustituye la clave en el proceso que realmente la utiliza

Crea una sustituta desde el panel autenticado del proveedor y guárdala mediante el mecanismo de gestión de secretos de tu aplicación. reAPI documenta la creación de claves en los ajustes de API Keys y recomienda credenciales separadas para entornos y servicios.[2] Asigna a la sustituta un propósito claro para no tener que volver a descubrir todos sus consumidores en la siguiente rotación.

Antes de desplegarla en un consumidor afectado, bloquea cualquier vía de exposición que ya conozcas. Si ese proceso publica su credencial en un paquete frontend o la imprime en un registro compartido, corrige primero esa vía. La investigación completa puede continuar después; la sustituta no debe pasar por un mecanismo que ya se sabe que la filtra.

Después, sigue la credencial dentro de la aplicación. Comprueba el servicio web, los procesos de trabajo en segundo plano, las tareas programadas y cualquier automatización que llame a la API. Incluye el desarrollo local y la CI solo si utilizan esa credencial. El objetivo es encontrar a quienes realmente leen el secreto, no elaborar una larga lista de sistemas que no ejecutas.

Imagina que el sitio vuelve a funcionar tras la rotación, pero las llamadas API de un proceso de trabajo en segundo plano siguen devolviendo errores de autenticación. Es un caso de diagnóstico hipotético. La solicitud web correcta confirma que un proceso tiene una configuración funcional. No dice nada del entorno de otro proceso de trabajo. Comprueba qué carga realmente el proceso que falla antes de crear otra clave más.

Verifica la configuración sin imprimir el secreto. Utiliza etiquetas no sensibles, la referencia de secreto configurada y el procedimiento de validación existente de la aplicación. No hace falta iniciar una generación de pago que no conoces bien solo para comprobar que se proporcionó un valor de sustitución a un proceso.

Ante un error de autenticación de reAPI, comprueba la cabecera Bearer documentada y la respuesta de error real. Las credenciales no válidas o revocadas son distintas del saldo insuficiente y los errores de punto de conexión.[2] Si una clave nueva es válida pero la cuenta no puede financiar el trabajo solicitado, volver a rotarla no resolverá el problema de saldo.

Mantén las credenciales del servidor en el servidor. Las recomendaciones de Google sobre gestión de claves advierten contra la inclusión de secretos en código cliente, y GitHub recomienda una gestión más segura para evitar una nueva exposición.[4][1] Un paquete para el navegador o una aplicación móvil distribuida no es un lugar adecuado para ocultar la sustituta solo porque así funciona el ejemplo más corto de un tutorial.

Averigua cómo salió esta copia

Una vez invalidada la credencial antigua y entregada la sustituta a los consumidores legítimos, vuelve a la copia expuesta. Comprueba la vía concreta que pudo publicarla: historial del repositorio, archivos frontend compilados, registros de CI, cuadernos, capturas de pantalla o salidas compartidas de resolución de problemas.

Si apareció en un repositorio Git, eliminar el archivo actual es solo parte de la limpieza. GitHub explica que el contenido sensible puede permanecer en el historial, las bifurcaciones y los clones.[1] Coordina cualquier eliminación del historial con las personas que utilizan el repositorio. La revocación es lo que actúa sobre la credencial copiada; la limpieza reduce su exposición continuada en esos lugares.

Si apareció en un registro, busca el código que la imprimió. Eliminar una entrada y dejar activa la misma vía de registro puede exponer la sustituta la próxima vez que la aplicación informe de un error. Revisa la salida de tu procedimiento habitual de diagnóstico, además de las solicitudes correctas: los secretos pueden acabar en el material que la gente copia cuando algo falla.

Si apareció en una captura o un flujo de trabajo compartido, sustituye ese material por una versión sin información sensible y comprueba si el flujo aún contiene el valor antiguo. No pidas a tus compañeros que te devuelvan el secreto como prueba de que lo eliminaron. Utiliza la etiqueta no sensible de la credencial y la ubicación del archivo o mensaje afectado para seguir la limpieza.

Separa los hallazgos de la atribución. Una solicitud ausente de los registros de tu aplicación demuestra que esos registros no la explican. No demuestra quién la envió ni dónde obtuvo la credencial. Registra la exposición que puedas confirmar y el tráfico que puedas identificar; deja el resto abierto a la investigación.

Restringe la sustituta cuando los controles sean adecuados

Google recomienda credenciales separadas para aplicaciones o equipos, restricciones apropiadas y supervisión.[4] Aplicado a una rotación, significa dar a un proceso de imágenes en segundo plano solo el acceso que necesita cuando el proveedor admita esa restricción, en lugar de recrear por costumbre una credencial ampliamente compartida.

Los controles disponibles varían. fal documenta permisos, caducidad y ajustes de modelos permitidos. El Security Center de OpenRouter documenta controles de gasto y caducidad y distingue desactivar una clave de archivarla; su lista de IP permitidas es una función Enterprise.[5][6] Comprueba el alcance de la opción que tu cuenta ofrece realmente antes de depender de ella.

Para un límite de gasto, determina si restringe una credencial, una cuenta, una operación de financiación u otra cantidad, y qué ocurre con el trabajo aceptado. Para la caducidad, identifica qué aplicaciones necesitan una sustituta antes de esa fecha. Para una restricción de modelo, verifica que siga permitiendo la carga de trabajo legítima. Un control es útil cuando sabes qué fallo contiene.

Asigna a alguien la respuesta a las alertas de uso inusual. Una notificación puede indicarte que investigues; responder sigue requiriendo a alguien capaz de identificar la credencial afectada y revocarla. Guarda esa información de responsabilidad junto al propósito de la clave. Durante un incidente resulta más fácil de usar que una lista de nombres de credenciales antiguas sin explicación.

Cambiar de proveedor API puede ser una decisión de producto independiente después del incidente. No invalida una clave que haya quedado activa en el proveedor anterior ni corrige una aplicación que introduce su próximo secreto de servidor en el mismo paquete público.

Envía al soporte las preguntas sin resolver

Prepara la solicitud de facturación a partir de la cronología que has construido. Incluye la cuenta o proyecto, un identificador no sensible de la credencial, el intervalo de actividad sospechosa, la hora de revocación y los ID de las solicitudes. Adjunta los registros de cargos pertinentes y cualquier identificador de recibo que necesite el proveedor. Mantén las claves API, los datos de tarjeta y los archivos privados de clientes fuera de los tickets públicos y las capturas.

Puedes formular la solicitud en torno a los hechos que aún necesitas confirmar:

Revocamos la credencial afectada a las [hora y zona horaria]. La lista de solicitudes adjunta distingue la actividad reconocida por nuestra aplicación de la que no podemos explicar. Confirmad si alguna de estas solicitudes se aceptó después de la revocación, explicad la liquidación de los trabajos pendientes anteriores y revisad los cargos impugnados.

Completa lo que respalden tus registros. Si falta una marca de tiempo de aceptación o la asociación con una credencial, indícalo en lugar de inventarlo. Incluye las medidas ya tomadas para que el soporte pueda distinguir un acceso que continúa de una factura que aún requiere conciliación.

Una investigación de seguridad y un ajuste de facturación son resultados distintos. Detectar una filtración o abrir un ticket no demuestra que los cargos vayan a revertirse. Mantén abierta la revisión hasta que el proveedor haya respondido a las solicitudes concretas y explicado cualquier ajuste. Mientras tanto, la credencial de sustitución de la aplicación, la vía de exposición reparada y los trabajos pendientes pueden comprobarse cada uno con sus propios registros.

Referencias

  1. GitHub. Eliminar datos sensibles de un repositorio. Consultado el 15 de noviembre de 2026. Recomendaciones de seguridad de GitHub.
  2. reAPI. Referencia de autenticación. Consultado el 15 de noviembre de 2026. Documentación de autenticación.
  3. reAPI. Referencia de tareas. Consultado el 15 de noviembre de 2026. Ciclo de vida de las tareas y liquidación.
  4. Google Cloud. Prácticas recomendadas para gestionar claves API. Consultado el 15 de noviembre de 2026. Recomendaciones de autenticación de Google Cloud.
  5. fal. Autenticación basada en claves. Consultado el 15 de noviembre de 2026.
  6. OpenRouter. Gestiona tus claves API y reduce sus riesgos con el nuevo Security Center. Publicado el 28 de septiembre de 2026; consultado el 15 de noviembre de 2026.
Todas las guías