Token de app
1 função do TermoAuth para token de app.
// npm install termo_core --save-exact
import * as auth from "termo_core/auth";
// ou: import { auth } from "termo_core";| Função | Rota | O que faz |
|---|---|---|
criar_token_de_app | POST /token_de_app | Troca o segredo do app por um token de aplicativo |
criar_token_de_app
POST/token_de_app Pública
Troca o segredo do app por um token de aplicativo
Pública, sem token de usuário. O backend de um app manda o segredo gerado em /master/apps (cadastrado pelo master na tela de provedores do app e entregue ao termo_core) e recebe um JWT EdDSA de 15 minutos, assinado com a mesma chave do token de usuário (valide pelo /.well-known/jwks.json). Claims: iss, aud, sub (id do app), iat, exp, tipo = aplicativo, name (nome do app) e isMaster (falso quando o app aceita o perfil cliente). Vale só nas APIs de sistema dos outros apps, nunca no painel. Peça outro quando faltar menos de 60 s para expira_em.
function criar_token_de_app(
corpo_da_requisicao: tipos.TokenDeAppCriar,
opcoes_da_chamada?: OpcoesDaChamada,
): Promise<tipos.TokenDeAppEmitido>import { criar_token_de_app } from "termo_core/auth";
const resposta = await criar_token_de_app(corpo_da_requisicao);Argumentos
Nome
Tipo
Retorno: Promise<tipos.TokenDeAppEmitido> · Rust: Result<tipos::TokenDeAppEmitido, ErroAoChamarServico> · veja TokenDeAppEmitido.
Tipos
Tipos usados pelas funções desta página. O nome é o mesmo nos dois pacotes.
TokenDeAppCriar
import type { TokenDeAppCriar } from "termo_core/auth";
export interface TokenDeAppCriar {
segredo: string;
}TokenDeAppEmitido
import type { TokenDeAppEmitido } from "termo_core/auth";
export interface TokenDeAppEmitido {
app: string;
expira_em: number;
token: string;
}