Bloqueio de acesso a organizações da API

Com o bloqueio de acesso a organizações da API, você pode restringir quais organizações da API os usuários podem acessar pela sua rede. No proxy ou no serviço de Secure Access Service Edge (SASE), configure uma lista com os IDs das organizações permitidas.

Como funciona

• Cabeçalho personalizado com a lista de organizações permitidas: Para definir quais organizações da API os usuários podem acessar, adicione o cabeçalho HTTP personalizado OpenAI-Allowed-Organization-Ids à configuração da rede. Você pode incluir no cabeçalho um ou mais IDs de organização (por exemplo, org-…). Se houver mais de um ID, separe-os por vírgulas, sem espaços.
• A Plataforma de API aplica a lista de organizações permitidas:
  • Quando um usuário entra na Plataforma de API pela sua rede, a OpenAI lê o cabeçalho e verifica se o ID da organização da API que o usuário tenta acessar está entre os IDs listados no cabeçalho OpenAI-Allowed-Organization-Ids.
  • Se o usuário tentar acessar uma organização que não consta no cabeçalho, a OpenAI rejeitará automaticamente a solicitação e retornará um erro com o código de status 403, bloqueando o acesso a essa organização. Somente as organizações listadas no cabeçalho ficarão acessíveis.

Configuração

Etapa 1: Localize os IDs das organizações

Para permitir o acesso a organizações específicas, copie o ID de cada organização que você quer incluir na lista. Você encontra o ID da organização na página de configurações da organização na Plataforma de API:

• Entre na sua conta da Plataforma de API e selecione a organização desejada.
• Acesse a página de configurações da organização e anote o ID da organização (por exemplo, org-Tkxfm8owx4zIPaJGNDVrPs6m).

Etapa 2: Configure o cabeçalho

Configure sua rede para enviar o cabeçalho por meio de um proxy ou serviço de Secure Access Service Edge (SASE).

• Para permitir o acesso a várias organizações, insira os IDs das organizações separados por vírgulas, sem espaços.
• Defina a quais URLs o cabeçalho se aplica:
  • Configure o proxy ou serviço SASE para aplicar o cabeçalho somente às solicitações feitas a https://api.openai.com/*.

Etapa 3: Verifique a configuração

Depois de configurar o cabeçalho, teste o acesso em um dispositivo conectado à rede em que a regra se aplica.

1. Entre na Plataforma de API com uma conta que tenha acesso às duas organizações a seguir:
   • Uma organização que esteja na lista de organizações permitidas.
   • Uma organização que esteja fora da lista.
2. Abra a organização que está na lista. Confirme que você consegue acessá-la.
3. Tente abrir a organização que está fora da lista. Confirme que o acesso foi bloqueado e que o erro apresenta o código de status 403.
4. Se você permitiu o acesso a várias organizações, confirme que consegue acessar cada uma delas.

Se os resultados forem diferentes do esperado, verifique se a regra do proxy ou do serviço SASE se aplica ao dispositivo usado no teste e se o cabeçalho contém os IDs corretos das organizações.

Solução de problemas de acesso

• Código de status 403: Se um usuário tentar acessar uma organização da API que não está na lista de organizações permitidas, verá um erro com o código de status 403 e uma mensagem informando que não tem autorização para acessar essa organização.
• Código de status 400: Se o valor do cabeçalho estiver malformado (por exemplo, se o ID da organização for inválido), todas as solicitações que incluírem esse cabeçalho falharão com o código de status 400.