Pular para o conteúdo principal

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.
perigo

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çãoO que faz
Regerar SecretGera 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 / ReativarAlterna o App entre ativo e revogado. Um App revogado deixa de autenticar novas requisições. Pede confirmação antes de executar.
EditarSó permite alterar o nome do App.
ExcluirRemove 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.