Chaves e tokens
Tokens pessoais, chaves de ingestão de erros e credenciais de serviço: para que serve cada uma.
O Mira usa quatro tipos de credencial no dia a dia, e o token de migração, que só existe durante uma migração entre instâncias.
| Credencial | Para quê | Quem gerencia | Onde |
|---|---|---|---|
| Token pessoal | Seu acesso à API e à CLI | Cada pessoa | Configurações do Mira → Tokens pessoais |
| Token de agente | Um agente de IA ler e comentar reports pelo MCP | Cada pessoa | Conectar agente, no menu do perfil |
| Chave de ingestão | Aplicação enviar erros ao Mira | Admin ou Mantenedor | Configurações do projeto → Erros |
| Credencial de serviço | Sistema externo consultar o Mira sem login humano | Administrador | Administração do Mira → Serviços de API |
Tokens pessoais
Em Tokens pessoais, a tabela mostra o nome, o prefixo, o último uso e a data de criação. Para criar:
- Clique em Novo token e informe um nome.
- Confirme a senha da sua conta.
- Copie o segredo. Ele aparece uma única vez.
Para revogar, abra o menu … do token e confirme. Um token herda seu acesso: trate como uma senha. Para usar tokens na CLI, no MCP ou na API, veja Tokens e escopos.
Chaves de ingestão
Cada ambiente gera as próprias chaves de ingestão, que permitem à aplicação enviar erros. Elas só escrevem: não leem nada do Mira.
Abrir a seção Erros
Em Configurações do projeto → Erros, escolha o ambiente no seletor do topo.
Gerar a chave
Dê um nome à chave, como web, e clique em Gerar chave. A tabela mostra o DSN.
Entregar ao time de desenvolvimento
Copie o DSN pelo botão da linha e passe para quem integra a aplicação.
Cada chave vale só para o ambiente em que foi gerada. Revogar pede confirmação, não tem volta, e faz as aplicações que usam aquele DSN pararem de enviar ocorrências. As chaves revogadas continuam na tabela, riscadas.
Credenciais de serviço
Em Administração do Mira → Serviços de API, administradores criam identidades para sistemas externos, definem os projetos permitidos, o acesso a evidências e a quota. Em Chaves, emitem credenciais com validade e as revogam uma a uma. Desativar a identidade revoga todas as chaves dela. O uso técnico está em API.