Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Autenticação e Segurança de Ações

Aula 10 de 17 Atualizada a 5 de novembro de 2026 Intermediario
Nesta página
  1. Por que razão a autenticação é inegociável
  2. Os três modos de autenticação
  3. Proteger as suas Ações
  4. A sua vez: uma cadeia completa apenas de leitura
  5. Pontos-chave

Estado em 5 de novembro de 2026: os GPTs estão nas suas últimas semanas. A OpenAI vai desativar os GPTs personalizados a 11 de dezembro de 2026 (11 de fevereiro de 2027, para certos espaços de trabalho Enterprise com uma isenção). As contas Pessoais, Gratuitas, Go, Plus e Pro já não podem criar nem publicar novos GPTs; nos espaços de trabalho Business, Enterprise e Edu, a criação depende das definições e cessou a 26 de outubro de 2026 nos espaços Enterprise afetados. Os GPTs existentes permanecem utilizáveis e editáveis se o seu plano o permitir, até à desativação; as suas conversas com eles permanecerão acessíveis depois disso. A migração (Migrate to plugin, em My GPTs) converte as instruções numa competência (skill), a base de conhecimento em ficheiros de referência e as aplicações ligadas em apps; as ações personalizadas não são transferidas. Esta lição explica como funcionam os GPTs para o ajudar a mantê-los, migrá-los e aplicar os seus princípios a um plugin (Lições 15–17).

Por que razão a autenticação é inegociável

Na lição anterior, ligou o seu GPT a uma API pública — um cenário confortável porque a API respondia a qualquer pessoa. A realidade profissional é diferente: o seu CRM, calendário e base de dados exigem prova de identidade antes de libertarem quaisquer dados. Faz todo o sentido — não quereria que qualquer GPT lesse os registos dos seus clientes. Sem uma autenticação adequada, o seu GPT receberá negações de acesso em vez de dados. Esta lição abrange os três modos de autenticação para ações, seguidos das regras de segurança que devem acompanhar cada Ação.

Os três modos de autenticação

O primeiro modo, sem autenticação, corresponde ao caso da lição anterior: APIs públicas que não exigem identificação, como certas APIs meteorológicas, conjuntos de dados abertos ou serviços gratuitos. Reserve isto para prototipagem e APIs verdadeiramente públicas — nenhuma ferramenta profissional séria opera desta forma.

O segundo modo, Chave de API (API Key), é o mais comum na prática. O princípio: o serviço externo emite-lhe uma chave secreta, que o GPT anexa a cada pedido para provar a sua identidade. No editor, configurar uma chave de API requer apenas alguns campos, e a chave pode ser transmitida via Basic, Bearer ou um cabeçalho personalizado:

  • Tipo de Autenticação: Chave de API
  • Chave de API: a sua chave (armazenada de forma segura pela OpenAI)
  • Nome do cabeçalho: o nome do cabeçalho, tipicamente Authorization, X-API-Key ou api-key
  • Prefixo: o prefixo opcional, frequentemente Bearer com um espaço

Uma vez preenchidos estes campos, o GPT adiciona automaticamente a chave a cada chamada. Um ponto crítico para a confidencialidade: o utilizador final nunca vê a chave — a sua identidade é utilizada, independentemente de quem esteja a conversar com o GPT.

O terceiro modo, OAuth 2.0, responde a uma necessidade diferente: fazer com que o GPT atue em nome de cada utilizador, e não em seu nome. Este é o mecanismo utilizado por serviços como o Google, Microsoft ou Salesforce. Especificamente, quando um utilizador lança o GPT pela primeira vez, é redirecionado para a página de login do serviço externo, onde autoriza pessoalmente o acesso aos seus próprios dados. A configuração requer elementos fornecidos pelo serviço: um Client ID e um Client Secret, o Authorization URL (a página de login), o Token URL (para troca de tokens) e o Scope — ou seja, as permissões solicitadas, como apenas leitura ou leitura/escrita. É mais complexo de configurar do que uma chave de API, mas é o único modo correto sempre que cada utilizador deve aceder aos seus próprios dados.

Proteger as suas Ações

Ligar um GPT às suas ferramentas confia-lhe acesso — e todo o acesso merece salvaguardas. A primeira é o princípio do privilégio mínimo: solicite apenas as permissões estritamente necessárias. Se o seu GPT só precisa de ler contactos no CRM, a permissão de escrita é um risco desnecessário; se consulta um calendário, não tem nada a fazer a mexer em e-mails. Do lado do OAuth, isto traduz-se em scopes reduzidos ao mínimo — um detalhe que conta em dobro, porque um GPT que solicite permissões excessivas também assusta os utilizadores na etapa de autorização.

A segunda salvaguarda diz respeito às suas próprias chaves de API. A regra absoluta: nunca cole uma chave nas instruções do GPT. As instruções são extraíveis por qualquer utilizador curioso — muitas vezes basta pedir ao GPT que as recite — e a sua chave tornaria-se pública. Utilize exclusivamente o campo de autenticação seguro do editor. No mesmo espírito, crie uma chave dedicada ao seu GPT, separada das suas chaves pessoais: no dia em que precisar de a revogar, as suas outras ferramentas continuarão a funcionar. E se o serviço o permitir, imponha limites de taxa (rate limits) a esta chave, para que uma utilização anormal não saia do controlo.

Terceira salvaguarda: condicione as operações de escrita. Se a sua API permitir criar, modificar ou eliminar dados, o GPT pode fazê-lo — incluindo por má interpretação. Construa bloqueios diretamente nas instruções: “Peça sempre confirmação antes de criar um contacto no CRM”, “Nunca elimine dados sem validação explícita do utilizador” ou “Limite as modificações a 5 por conversa”. Estas frases, aparentemente inocentes, são o que separa um incidente menor de uma base de dados destruída.

Um último ponto, este de natureza regulamentar: se publicar um GPT com Ações publicamente, a OpenAI exige um URL para uma política de privacidade. Esta deve explicar que dados são recolhidos através das Ações, como são processados e quem tem acesso. Sem ela, o seu GPT será rejeitado na GPT Store.

Três modos de autenticação Três colunas. Nenhum: para uma API pública, sem dados privados. Chave de API: acesso servidor-para-servidor, transmitido via Basic, Bearer ou cabeçalho personalizado, utilizando a identidade do criador para todos. OAuth: conta de cada pessoa, com client ID, URL e scopes, reduzidos ao mínimo. PROTEGER UMA AÇÃO Três modos de autenticação Nenhum Utilização API pública Dados Nada privado Exemplo Meteorologia, taxas de câmbio Chave de API Utilização Servidor para servidor Transmissão Basic, Bearer, cabeçalho Identidade A do criador, para todos OAuth Utilização Conta de cada pessoa Definições Client, URL, scopes Princípio Scopes mínimos Uma ação partilhada publicamente requer um URL válido para a política de privacidade.
Com base nos artigos "Configuring actions in GPTs" e "Sharing and publishing GPTs" do Centro de Ajuda da OpenAI (novembro de 2026).

A sua vez: uma cadeia completa apenas de leitura

Uma chave dedicada, acesso mínimo. O melhor exercício é construir uma cadeia completa em condições reais, mas sem riscos. Crie uma conta de programador num serviço com API — Airtable, Notion ou HubSpot funcionam bem — e gere um token ou chave de acesso dedicado com permissões mínimas, apenas de leitura. Em seguida, configure a autenticação por chave de API no seu GPT e teste uma chamada simples, como ler uma lista de dados. Termine com uma verificação que muitos criadores negligenciam: abra os registos do serviço e confirme que as chamadas estão realmente a vir do seu GPT. Este hábito de monitorizar a utilização servi-lo-á continuamente no futuro, para detetar comportamentos anormais ou sobreconsumo antes que se tornem um problema.

Fontes oficiais: Configuring actions in GPTs (Centro de Ajuda da OpenAI: autenticação, esquema OpenAPI, testes, limites) · Sharing and publishing GPTs (política de privacidade obrigatória para ações públicas)

Pontos-chave

  • Três modos de autenticação: nenhum, chave de API, OAuth 2.0
  • Aplique o princípio do privilégio mínimo — solicite apenas as permissões necessárias
  • Nunca coloque chaves de API nas instruções do GPT
  • Adicione salvaguardas para operações de escrita e eliminação
  • Qualquer ação num GPT partilhado publicamente deve ter um URL válido para a política de privacidade