Autenticação
Autenticação
A Riversoft® STCP Gemini API autentica os operadores do Riversoft Console Portal e das integrações. Todos os métodos terminam com um token Bearer, enviado no header Authorization das chamadas protegidas e invalidado no logout.
Escolha o método
| Necessidade | Método | Guia |
|---|---|---|
| Reproduzir o login do Riversoft Console Portal, com 2FA | POST /oauth/v2/token | Login local e 2FA |
| Entrar com uma conta do diretório corporativo | LDAP em POST /oauth/v2/token | Login com LDAP |
| Integrar sistemas com operador e senha, sem 2FA | Password grant em POST /oauth/token | Password grant |
| Entrar pelo provedor corporativo no navegador | SSO (SAML 2.0 ou OAuth 2.0) | Single Sign-On |
| Usar o token e encerrar a sessão | Header Authorization: Bearer e DELETE /disconnect/api/v3/logout | Sessão e logout |
Nota
POST /oauth/token e POST /oauth/v2/token recebem o mesmo formulário. Só a rota v2 aplica a autenticação de dois fatores (2FA) e aceita LDAP. Com a 2FA habilitada, use sempre a rota v2.
Nesta seção
Autentique o operador em /oauth/v2/token, conclua a autenticação de dois fatores e faça o primeiro cadastro do TOTP.
Obtenha o token Bearer em /oauth/token, para integrações com operador e senha, sem 2FA.
Login e logout federados no navegador com SAML 2.0 e OAuth 2.0/OpenID Connect.
Envie o token nas rotas protegidas, trate a expiração e encerre a sessão.