For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Navegação principal
Theme

Colaboração e compartilhamento

Prisma AIRS

Conecte o Prisma AIRS da Palo Alto Networks para inspecionar os prompts do Codex

Conecte o Prisma AIRS da Palo Alto Networks para aplicar suas políticas de segurança aos prompts do Codex antes que cheguem ao modelo. Os administradores do espaço de trabalho configuram a integração uma única vez para todo o espaço de trabalho.

O Prisma AIRS pode aplicar as proteções configuradas no seu perfil de segurança, como prevenção contra perda de dados, detecção de injeção de prompt e detecção de URLs maliciosas.

Antes de começar

Você precisa de:

  • Um espaço de trabalho do ChatGPT com acesso ao Prisma AIRS habilitado. Para solicitar acesso, entre em contato com a equipe da OpenAI responsável pela sua conta.
  • Permissões de administrador do espaço de trabalho.
  • Uma chave de API do Prisma AIRS, um perfil de segurança configurado e o endpoint do serviço para sua implantação.

Conectar o Prisma AIRS

  1. Acesse o Console de administração como administrador do espaço de trabalho e selecione seu espaço de trabalho.
  2. Em Política e segurança, selecione Proteções externas e localize Prisma AIRS. Se essa opção não estiver disponível, peça à equipe da OpenAI responsável pela sua conta que habilite o acesso para seu espaço de trabalho.
  3. Informe a Chave de API, o nome ou ID do Perfil de segurança e a URL do endpoint.
  4. Escolha um Modo de aplicação da política e defina o comportamento em Em caso de falha do AIRS.
  5. Selecione Salvar conexão. O Codex valida a conexão e criptografa sua chave de API.
  6. Selecione Testar conexão para verificar a configuração salva.
  7. Ative a opção Habilitar Prisma AIRS para iniciar a inspeção dos prompts em todo o espaço de trabalho.

Salvar a conexão não inicia a inspeção. Você também precisa ativar a opção Habilitar Prisma AIRS.

Escolher um endpoint

Use o endpoint aprovado para sua implantação do Prisma AIRS:

Região Endpoint
Estados Unidos https://service.api.aisecurity.paloaltonetworks.com
Alemanha https://service-de.api.aisecurity.paloaltonetworks.com
Índia https://service-in.api.aisecurity.paloaltonetworks.com
Singapura https://service-sg.api.aisecurity.paloaltonetworks.com

Por padrão, o Codex usa o endpoint dos Estados Unidos. Os requisitos de residência de dados do espaço de trabalho podem limitar a escolha do endpoint.

Escolher como lidar com os prompts

O Modo de aplicação da política determina o que acontece quando o Prisma AIRS sinaliza um prompt:

  • Bloquear: impede que o prompt chegue ao modelo. Essa é a opção padrão.
  • Apenas alertar: registra a detecção e permite que o prompt siga para o modelo.

A opção Em caso de falha do AIRS determina o que acontece se o Prisma AIRS estiver indisponível ou não responder:

  • Permitir prompts: permite que o prompt siga para o modelo mesmo que a inspeção não tenha sido concluída. Essa é a opção padrão.
  • Bloquear prompts: bloqueia o prompt até que o Prisma AIRS possa inspecioná-lo.

Escolha Bloquear prompts se sua política de segurança exigir uma decisão baseada na inspeção de cada prompt abrangido por ela.

Entender o que é inspecionado

O Codex envia o texto de cada novo prompt ao endpoint configurado do Prisma AIRS para inspeção. A inspeção se aplica aos fluxos de trabalho do Codex abrangidos pela integração, inclusive no aplicativo, na CLI, na extensão para IDE e na nuvem, quando os usuários se autenticam no espaço de trabalho do ChatGPT configurado. A integração não abrange sessões autenticadas com uma chave de API da plataforma. Consulte Exigir um método de login ou espaço de trabalho para exigir o método de login e o espaço de trabalho desejados.

Por meio dessa integração, o Prisma AIRS não inspeciona respostas do assistente, chamadas de ferramentas, resultados de ferramentas, arquivos nem imagens. O perfil de segurança que você configurou determina quais ameaças e dados sensíveis o Prisma AIRS detecta.

O Codex criptografa sua chave de API e nunca mais a exibe depois que você a salva. Antes de habilitar a inspeção de prompts, consulte as políticas de tratamento, retenção e residência de dados da Palo Alto Networks. Essas políticas se aplicam aos prompts enviados ao Prisma AIRS.

Gerenciar a conexão

Volte ao Console de administração, selecione seu espaço de trabalho e acesse Política e segurança > Proteções externas para gerenciar a integração:

  • Selecione Testar conexão para verificar a chave de API, o perfil de segurança e o endpoint salvos.
  • Insira uma nova chave e selecione Substituir chave de API para trocar a chave salva sem alterar as demais configurações.
  • Desative a opção Habilitar Prisma AIRS para interromper a inspeção e manter a configuração salva.
  • Selecione Desconectar e confirme para interromper a inspeção e excluir a conexão e a chave de API salvas.

Desativar ou desconectar a integração quando a opção não aparece na barra lateral

Se Proteções externas não aparecer em um espaço de trabalho com uma configuração salva, um administrador desse espaço poderá acessar a página de recuperação com recursos limitados em https://admin.openai.com/workspace/<workspace-id>/external-guardrails. Substitua <workspace-id> pelo ID do espaço de trabalho que aparece na URL do Console de administração.

Nessa página, você pode consultar a configuração salva, desativar a opção Habilitar Prisma AIRS ou selecionar Desconectar e confirmar. A página não permite configurar a integração, alterar as configurações, testar a conexão, substituir a chave de API nem reativar a integração. Para recuperar o acesso às configurações, entre em contato com a equipe da OpenAI responsável pela sua conta.

Para saber mais sobre a configuração do espaço de trabalho e o gerenciamento de políticas, consulte o Guia de implantação para administradores e a página Configuração gerenciada.