Autenticação
Autenticação
A Riversoft STCP DirectLink API autentica usuários por login local, por tokens OAuth ou por um provedor de identidade corporativo. O método disponível para cada usuário depende da configuração do ambiente; confirme com o administrador do serviço qual método foi autorizado para a sua integração.
Escolha o método
| Necessidade | Método | Guia |
|---|---|---|
| Reproduzir o login do usuário, com MFA | Login local (HTTP Basic) | Login local e MFA |
| Integrar sistemas com usuário e senha | Password grant (pode estar desabilitado; não faz parte do OAuth 2.1) | Tokens OAuth |
| Reaproveitar um JWT emitido por outro sistema | Token exchange | Tokens OAuth |
| Usar uma credencial técnica de longa duração | Token de impersonação | Tokens OAuth |
| Entrar pelo provedor corporativo no navegador | SSO (OAuth 2.0 e 2.1/OpenID Connect ou SAML 2.0) | Single Sign-On |
Nota
/auth/login e os endpoints de token (/auth/token e /oauth2/token) têm contratos diferentes. O login usa HTTP Basic e devolve um cookie de sessão; os endpoints de token recebem um formulário OAuth 2.0 e devolvem um token Bearer no JSON.
Nesta seção
Autentique o usuário com HTTP Basic em /auth/login e conclua o segundo fator, quando exigido.
Obtenha um token Bearer por password grant ou troque um JWT de origem por um token da API (token exchange).
Login e logout federados no navegador com OAuth 2.0 e 2.1/OpenID Connect e SAML 2.0.
Envie a credencial de sessão nas rotas protegidas, trate a expiração e encerre a sessão.
Inicie o primeiro acesso ou a recuperação de senha e conclua a definição da nova senha pelo link seguro.