Visão geral
A lista de IPs permitidos é uma funcionalidade de segurança opcional que permite restringir os endereços IP que podem aceder à sua API da OpenAI.
Quando está ativada, só são permitidos pedidos provenientes dos endereços IP ou intervalos de IP configurados. Os pedidos provenientes de todos os outros IPs são rejeitados, mesmo que incluam uma chave de API válida.
Esta funcionalidade destina-se a ajudar a reduzir o risco de utilização não autorizada da API, limitando o acesso a ambientes de rede fidedignos.
Nota: a lista de IPs permitidos aplica-se apenas a pedidos à API. Não afeta o acesso a platform.openai.com nem o início de sessão dos utilizadores.
Porquê usar uma lista de IPs permitidos
A lista de IPs permitidos pode ajudar a:
Restringir o acesso à API a infraestruturas conhecidas (por exemplo, os seus servidores ou ambientes na nuvem)
Reduzir a exposição ao risco em caso de fuga de uma chave de API
Adicionar uma camada de controlo sobre a origem do tráfego da API
A lista de IPs permitidos é mais utilizada em ambientes de produção onde o tráfego da API tem origem em intervalos de rede fixos ou bem definidos.
Como funciona
Configure uma lista de endereços IP ou intervalos CIDR permitidos.
Os pedidos provenientes de IPs permitidos são aceites.
Os pedidos provenientes de IPs que não constam da lista de IPs permitidos são rejeitados.
A lista de IPs permitidos pode ser aplicada:
Ao nível da organização ou
Ao 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 os passos abaixo.
Configurar a lista de IPs permitidos
Nota: pode adicionar até 50 endereços IP ou intervalos CIDR.
Abra as Definiçõ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 os pedidos a partir dos ambientes que pretende utilizar.
Recomendamos que comece por um único projeto antes de aplicar a restrição a toda a organização.
As alterações podem demorar até 15 minutos a entrar em vigor.
Nota: tem de ter as permissões adequadas na organização para configurar as definições da lista de IPs permitidos.
Resolução de problemas
Se os pedidos falharem inesperadamente:
Confirme que o pedido tem origem num endereço IP permitido.
Verifique se os IPs da sua infraestrutura mudaram.
Verifique se os intervalos de IP configurados estão corretos.
Aguarde até 15 minutos para que as alterações de configuração se propaguem.
Use a ferramenta Verificar para confirmar se um IP é permitido.
O que acontece quando um pedido é bloqueado
Se um pedido tiver origem num endereço IP que não consta da lista de IPs permitidos, falhará com:
Estado 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 impede toda a utilização não autorizada da minha chave de API?
Não. A lista de IPs permitidos pode ajudar a reduzir o risco ao restringir a origem dos pedidos à API, mas não impede totalmente todas as formas de utilização indevida. Deve ser utilizada em conjunto com outras boas práticas de segurança, como o armazenamento seguro de chaves, a rotação de chaves e medidas robustas de segurança da conta. Para reforçar a segurança, consulte os guias do nosso centro de ajuda sobre Boas práticas de segurança das chaves de API e Prevenção de utilização não autorizada.
A lista de IPs permitidos afeta a latência?
A lista de IPs permitidos pode introduzir uma latência mínima em alguns casos, normalmente nos pedidos iniciais. Não se prevê que afete significativamente o desempenho geral da API.
Como posso saber se um pedido está a falhar devido à lista de IPs permitidos?
Os pedidos que falham devido à lista de IPs permitidos devolvem:
HTTP status: 401 UnauthorizedError code: ip_not_authorized