Visão geral
A lista de IPs permitidos é um recurso de segurança opcional que permite restringir quais endereços IP podem acessar sua API da OpenAI.
Quando o recurso está ativado, apenas solicitações provenientes dos endereços IP ou intervalos de IP configurados são permitidas. Solicitações de todos os outros IPs são rejeitadas, mesmo que incluam uma chave de API válida.
Esse recurso foi criado para ajudar a reduzir o risco de uso não autorizado da API, limitando o acesso a ambientes de rede confiáveis.
Observação: a lista de IPs permitidos se aplica apenas às solicitações à API. Ela não afeta o acesso a platform.openai.com nem o login dos usuários.
Por que usar a lista de IPs permitidos
A lista de IPs permitidos pode ajudar você a:
Restringir o acesso à API a uma infraestrutura conhecida (por exemplo, seus servidores ou ambientes de nuvem)
Reduzir a exposição a riscos em caso de vazamento de uma chave de API
Adicionar uma camada extra de controle sobre a origem do tráfego da API
A lista de IPs permitidos é mais usada em ambientes de produção nos quais o tráfego da API vem de intervalos de rede fixos ou bem definidos.
Como funciona
Você configura uma lista de endereços IP ou intervalos CIDR permitidos.
Solicitações de IPs permitidos são aceitas.
Solicitações de IPs que não estão na lista de IPs permitidos são rejeitadas.
A lista de IPs permitidos pode ser aplicada:
No nível da organização ou
No nível do projeto
Disponibilidade
A lista de IPs permitidos está disponível para todos os clientes da API.
Para configurar a lista de IPs permitidos, siga as etapas abaixo.
Configurar a lista de IPs permitidos
Observação: você pode adicionar até 50 endereços IP ou intervalos CIDR.
Abra Configurações.
Selecione Segurança.
Selecione Lista de IPs permitidos.
Adicione um ou mais endereços IP ou intervalos CIDR.
(Opcional) Use a ferramenta Verificar para confirmar se um IP está incluído na sua lista de IPs permitidos.
Ative a lista de IPs permitidos para:
Um projeto específico ou
Toda a sua organização.
Teste as solicitações a partir dos ambientes que você pretende usar.
Recomendamos começar com um único projeto antes de aplicar a restrição a toda a organização.
Após as alterações, as atualizações podem levar até 15 minutos para entrar em vigor.
Observação: você precisa ter as permissões adequadas na organização para configurar a lista de IPs permitidos.
Solução de problemas
Se ocorrerem falhas inesperadas nas solicitações:
Confirme se a solicitação vem de um endereço IP permitido.
Verifique se os IPs da sua infraestrutura mudaram.
Confira se os intervalos de IP configurados estão corretos.
Aguarde até 15 minutos para que as alterações de configuração sejam propagadas.
Use a ferramenta Verificar para confirmar se um IP é permitido.
O que acontece quando uma solicitação é bloqueada
Se uma solicitação vier de um endereço IP que não está na lista de IPs permitidos, ela falhará com:
Status HTTP: 401 Unauthorized
Código de erro: ip_not_authorized
Exemplo de resposta:
{
"error": {
"message": "Your IP is not authorized to access this organization.",
"type": "ip_not_authorized"
}
}
Perguntas frequentes
A lista de IPs permitidos impedirá todo uso não autorizado da minha chave de API?
Não. A lista de IPs permitidos pode ajudar a reduzir os riscos ao restringir a origem das solicitações à API, mas não impede completamente todas as formas de uso indevido. Ela deve ser usada junto com outras boas práticas de segurança, como armazenamento seguro de chaves, rotação de chaves e proteção robusta da conta. Para aumentar a segurança, consulte nossos guias da Central de Ajuda sobre Boas práticas para a segurança de chaves de API e Como evitar o uso não autorizado.
A lista de IPs permitidos afeta a latência?
A lista de IPs permitidos pode adicionar uma latência mínima em alguns casos, geralmente nas solicitações iniciais. Não se espera que ela afete significativamente o desempenho geral da API.
Como saber se uma solicitação está falhando por causa da lista de IPs permitidos?
Solicitações que falham por causa da lista de IPs permitidos retornam:
HTTP status: 401 UnauthorizedError code: ip_not_authorized