Apps
Um App é uma credencial OAuth2 usada para autenticar integrações externas na API do Rouxinol — cada App gera um client_id e um client_secret próprios, sem estarem associados a nenhum usuário específico.
Criando um App
O único campo do formulário é o Nome (ex: "Integração ERP", "Sistema de Relatórios") — identifica o App na listagem.
Ao salvar, uma notificação exibe o Client ID e o Client Secret gerados:
Client ID: {id}
Client Secret: {plainSecret}
Copie o Client Secret agora — ele não será exibido novamente.
Guarde o secret agora
O Client Secret só aparece nessa notificação, uma única vez. Se perder, será necessário regerar um novo (o que invalida o anterior imediatamente).
Tabela
A listagem mostra o nome, o Client ID (com botão de copiar), o tipo de concessão OAuth2 (badge) e se o App está ativo.
Ações
| Ação | O que faz |
|---|---|
| Regerar Secret | Gera um novo Client Secret e invalida o anterior imediatamente. Pede confirmação antes de executar, já que a mudança é irreversível para quem usa o secret antigo. O novo secret aparece na mesma notificação persistente usada na criação. |
| Revogar / Reativar | Alterna o App entre ativo e revogado. Um App revogado deixa de autenticar novas requisições. Pede confirmação antes de executar. |
| Editar | Só permite alterar o nome do App. |
| Excluir | Remove o App e revoga todos os tokens já emitidos por ele antes de excluir o registro. |
Próximo passo
Depois de criar um App, siga o fluxo de Autenticação para trocar o client_id/client_secret por um token de acesso.