Versionv1

Visão geral para integradores (Intastellar Accounts)

Para desenvolvedores integrando login na web — React, sites estáticos, SPAs ou apps com servidor.


O que você integra

O Intastellar Accounts emite tokens e sessões depois que o usuário se autentica. Na web você normalmente:

  1. Registra um app e escolhe público (navegador, PKCE) vs confidencial (servidor guarda um secret).
  2. Leva o usuário pela autorização (redirecionamento ou popup) com URI de redirecionamento válida e state.
  3. Troca o código de autorização (navegador com PKCE, ou servidor com client secret para clientes confidenciais).
  4. Armazena sessão ou tokens conforme seu modelo de ameaça — veja Sessões, cookies e tokens.

Escolha seu caminho

SituaçãoComece aqui
ReactIntastellar Sign-In — React e JavaScript
HTML / JS puro (sem React)HTML, CSS e JavaScript puro
OAuth custom / mobile / backendPrimeiros passos, depois Fluxo de código de autorização
SPAs, sem secret no navegadorSPAs e clientes JavaScript
Troca de código no seu servidorClientes confidenciais no servidor

Modelo mental

  • Nunca coloque client secret em código front-end; use PKCE para clientes públicos.
  • URIs de redirecionamento devem bater exatamente com o registrado — trate como config de produção, não strings espalhadas em repositórios.
  • Logout e tratamento de erros fazem parte da superfície do produto — veja Logout, erros e solução de problemas.

Testes (integrador)

  • Anônimo + janela normal; recarregamento forçado após mudar listas de redirect.
  • Aba Network: pedido de autorização, callback, troca de token (se visível), sem 4xx inesperados na sua origem.
  • Verificação rápida multi-navegador (Chrome, Safari, Firefox) se você depende de cookies ou armazenamento.

Releases e suporte

  • Atualizações de SDK / pacote: Changelog e notas de release no npm para @intastellar/signin-sdk-react.
  • Bugs de produto: Contato e suporte — issue no GitHub de Accounts quando disponível.
  • Documentação errada ou faltando: mesmo fluxo para o repositório de ajuda quando oferecido.

Terminologia: Glossário (login). Correções sistemáticas: Depuração do login.

Last updated