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

Equipas, Funções e Registos de Auditoria

Aula 10 de 14 Atualizada a 28 de julho de 2026 Intermediario
Nesta página
  1. Quando uma única chave já não é suficiente
  2. O âmbito de uma equipa
  3. Funções e o princípio do privilégio mínimo
  4. Proteja cada chave com ACLs
  5. A memória da sua conta
  6. Pontos-chave

Quando uma única chave já não é suficiente

Numa grande organização, nem todos os utilizadores têm as mesmas necessidades ou direitos. Um programador precisa de aceder à API, um gestor financeiro precisa de visualizar a faturação e um administrador precisa de gerir tudo. Enquanto três pessoas partilharem uma única chave, o problema mantém-se teórico e todos se desenrascam. Mas assim que trinta pessoas, distribuídas por cinco projetos, acedem à mesma API, a falta de estrutura resulta em incidentes difíceis de atribuir e em faturas que ninguém consegue explicar. A oferta Enterprise da xAI estrutura este acesso através de um sistema de equipas e funções.

O âmbito de uma equipa

Uma equipa na xAI representa um grupo de utilizadores que partilham recursos comuns: chaves de API, pools de capacidade provisionada, faturação e limites de despesas. Cada equipa possui as suas próprias chaves com ACLs específicas, limites de despesas independentes, métricas de utilização separadas e faturação rastreável. Na prática, uma equipa que esgota o seu orçamento mensal não bloqueia as outras, e a direção financeira consegue responder à pergunta «quanto nos custa o projeto do chatbot?» sem ter de reconstruir manualmente os valores numa folha de cálculo.

Três estruturas surgem regularmente, e a escolha certa depende de como a sua organização toma decisões orçamentais. A divisão por departamento — equipe-engineering, equipe-data, equipe-support — funciona quando cada serviço gere o seu próprio orçamento e contabiliza o seu consumo. A divisão por projeto — projet-chatbot, projet-analyse, projet-recherche — faz sentido quando as iniciativas são transversais e financiadas separadamente, com contribuintes de vários serviços. A divisão por ambiente — team-production, team-staging, team-dev — protege melhor a produção: uma experiência que entra num ciclo infinito numa sexta-feira à noite consome então o orçamento de desenvolvimento, e não o do serviço ao cliente.

Funções e o princípio do privilégio mínimo

As funções definem o que cada membro pode fazer dentro de uma equipa. O administrador gere tudo: chaves, membros, faturação e limites. O programador cria e utiliza chaves de API e visualiza métricas, sem tocar nas definições da equipa. O leitor visualiza métricas e faturação sem quaisquer poderes de modificação, o que se adequa a perfis de pilotagem e reporte. A função de faturação, finalmente, gere os métodos de pagamento e visualiza faturas, sem qualquer acesso técnico.

Atribua a cada utilizador apenas os direitos necessários para a sua missão. Este princípio fundamental de segurança limita o impacto de uma conta comprometida e a sua aplicação diária é simples: um programador de frontend só precisa de modelos de chat, não de modelos de geração de imagens; um cientista de dados não tem razão para aceder à faturação; um estagiário deve trabalhar em modo de só leitura. Aplicar esta grelha a uma lista de utilizadores existente revela quase sempre duas ou três pessoas com direitos de administração, porque foi a solução mais rápida na data de início e ninguém a reviu desde então.

Proteja cada chave com ACLs

A API de Gestão permite-lhe definir controlos de acesso granulares (ACLs) em cada chave de API:

{
  "name": "cle-chatbot-support",
  "acls": [
    "api-key:endpoint:chat",
    "api-key:model:grok-4.3"
  ],
  "qps": 10,
  "qpm": 100,
  "tpm": 500000,
  "expireTime": "2026-12-31T23:59:59Z"
}

Esta chave ilustra exatamente o princípio anterior: chama apenas o endpoint de chat, apenas com o grok-4.3, dentro de um limite de 10 pedidos por segundo, e deixa de funcionar no final do ano. Se for comprometida, um atacante não consegue gerar imagens nem consultar um modelo mais dispendioso, e a sua janela de exploração está limitada no tempo sem qualquer intervenção da sua parte. As ACLs cobrem quatro dimensões: endpoints autorizados entre chat, embed, image, tts, tokenize e documents; modelos acessíveis, com restrição a um ou mais modelos específicos; limites de taxa expressos em pedidos por segundo (QPS), por minuto (QPM) e tokens por minuto (TPM); e a data de expiração da chave.

A memória da sua conta

Os registos de auditoria registam todas as ações significativas realizadas na sua conta Enterprise: logins e logouts de utilizadores, criação, modificação e eliminação de chaves de API, alterações de funções e permissões, modificações de faturação e limites de despesas, rotações de chaves. Constituem um elemento essencial tanto para a conformidade como para a deteção de incidentes.

A sua utilidade manifesta-se em quatro áreas. Para a conformidade, demonstram aos auditores que o acesso é controlado e rastreado, o que alimenta diretamente a documentação SOC 2 e HIPAA. Para a investigação, permitem reconstruir as ações durante um incidente: saber qual a chave criada, por quem e a que hora transforma uma suposição num facto estabelecido e encurta consideravelmente as reuniões de crise. Para a otimização, revelam chaves não utilizadas e padrões anómalos, por exemplo, uma chave de teste que continua a funcionar seis meses após o abandono do protótipo. Finalmente, para a governança, verificam se as políticas de acesso são realmente respeitadas e não apenas escritas num memorando.

Pontos-chave

  • As equipas permitem segmentar o acesso, a faturação e os limites por departamento ou projeto
  • As funções aplicam o princípio do privilégio mínimo a cada utilizador
  • As ACLs das chaves de API controlam endpoints, modelos, limites de taxa e expiração
  • Os registos de auditoria rastreiam todas as ações significativas para conformidade e investigação
  • Estruture as suas equipas desde o início para evitar dívida de governança