Bloqueo de organizaciones de la API

El bloqueo de organizaciones de la API te permite restringir las organizaciones de la API a las que los usuarios pueden acceder desde tu red. Configura una lista con los ID de las organizaciones permitidas mediante tu proxy o servicio Secure Access Service Edge (SASE).

Cómo funciona

• Encabezado personalizado para la lista de organizaciones permitidas: agrega el encabezado HTTP personalizado OpenAI-Allowed-Organization-Ids a la configuración de tu red para especificar a qué organizaciones de la API se puede acceder. Puedes incluir en el encabezado uno o más ID de organizaciones (por ejemplo, org-…), separados por comas sin espacios.
• La Plataforma API aplica la lista de organizaciones permitidas:
  • Cuando un usuario inicia sesión en la Plataforma API desde tu red, OpenAI lee el encabezado y comprueba si el ID de la organización de la API a la que el usuario intenta acceder coincide con alguno de los ID incluidos en el encabezado OpenAI-Allowed-Organization-Ids.
  • Si el usuario intenta acceder a una organización que no figura en el encabezado, OpenAI rechaza automáticamente la solicitud con un error cuyo código de estado es 403 y bloquea el acceso a esa organización. Solo se podrá acceder a las organizaciones que figuren en el encabezado.

Configuración

Paso 1: busca los ID de tus organizaciones

Para permitir el acceso a organizaciones específicas, copia el ID de cada organización que quieras incluir en la lista. Puedes encontrar el ID en la página de configuración de la organización en la Plataforma API:

• Inicia sesión en tu cuenta de la Plataforma API y cambia a la organización que quieras incluir.
• Ve a la página de configuración de la organización y anota el ID de la organización (por ejemplo, org-Tkxfm8owx4zIPaJGNDVrPs6m).

Paso 2: configura el encabezado

Configura tu red para que envíe el encabezado mediante un proxy o un servicio Secure Access Service Edge (SASE).

• Para permitir el acceso a varias organizaciones, ingresa los ID de las organizaciones separados por comas sin espacios.
• Especifica a qué URL se aplica el encabezado:
  • Configura tu proxy o servicio SASE para que aplique el encabezado solo a las solicitudes dirigidas a https://api.openai.com/*.

Paso 3: verifica la configuración

Después de configurar el encabezado, prueba el acceso desde un dispositivo conectado a la red en la que se aplica la regla.

1. Inicia sesión en la Plataforma API con una cuenta que tenga acceso a las dos organizaciones siguientes:
   • Una organización que figure en la lista de organizaciones permitidas.
   • Una organización que no figure en la lista.
2. Abre la organización que figura en la lista. Confirma que puedes acceder a ella.
3. Intenta abrir la organización que no figura en la lista. Confirma que se bloquea el acceso y que el código de estado del error es 403.
4. Si permites el acceso a varias organizaciones, confirma que puedes acceder a cada una.

Si los resultados difieren de lo esperado, comprueba que la regla del proxy o del servicio SASE se aplique al dispositivo de prueba y que el encabezado contenga los ID correctos de las organizaciones.

Solución de errores de acceso

• Código de estado 403: si un usuario intenta acceder a una organización de la API que no está permitida, verá un error con el código de estado 403 y un mensaje que indica que no tiene autorización para acceder a esa organización.
• Código de estado 400: si el valor del encabezado tiene un formato incorrecto (por ejemplo, si el ID de la organización no es válido), todas las solicitudes que incluyan ese encabezado fallarán con un error cuyo código de estado es 400.