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çãoRotaO que faz
criar_token_de_appPOST /token_de_appTroca 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>
Exemplo
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;
}

Nesta página