Swipeguide: Logon único (SSO)

Last updated: June 19, 2026

Uso geral​

Fornecemos uma integração de autenticação OAuth2 para a plataforma, que pode ser usada para fazer login no CMS Web, no Aplicativo Web Frontline, nos Aplicativos Nativos SwipeGuide (iOS e Android) para acesso offline e no aplicativo Habilidades Inteligentes.

Isso permite que seus usuários se autentiquem por meio do provedor OAuth2 mantido pela sua empresa.

Observe que os níveis de autorização dentro da plataforma ainda são gerenciados na própria plataforma para manter um sistema amigável e compreensível para os usuários.

Oferecemos flexibilidade para configurar diferentes tipos de métodos de login no CMS e nos Aplicativos Frontline, dependendo das necessidades do Workspace, como e-mail e senha, além de SSO. Como alternativa, você pode exigir que seus usuários façam login SOMENTE com SSO.

Se desejar habilitar esse recurso em sua plataforma, entre em contato com o Suporte da SwipeGuide antes de usar esta documentação.

Pré-requisitos​

  1. Sua plataforma já deve ter as opções de login habilitadas (em vez de ser uma plataforma pública).
  2. O provedor OAuth2 que você deseja usar para entrar na SwipeGuide já deve ser gerenciado e configurado pelas suas equipes de TI, com credenciais ou certificados válidos. A SwipeGuide já deve estar adicionada como uma das aplicações em seus sistemas.

Configuração do OAuth2​

Para obter a documentação básica, consulte o site do OAuth. Para configurar sua plataforma, há algumas informações que precisam ser enviadas ao seu serviço de autenticação OAuth2, e há algumas informações de que precisamos para conectar os serviços. Temos uma URL de callback que precisará ser configurada no serviço de autenticação OAuth2 e precisaremos de alguns tokens de autorização OAuth2 do serviço. Eles serão diferentes para cada serviço.

Atualmente, oferecemos suporte nativo para:

  • Microsoft Entra ID (Anteriormente Azure AD)
  • Google

Microsoft Entra ID​

Para que a configuração do Microsoft Entra ID (anteriormente Azure AD) funcione, precisamos de: clientID, clientSecret, resource e tenant. Consulte a documentação do OAuth para o Azure Entra ID para saber mais sobre esses itens.

URL de callback

https://[platform].swipeguide.com/sso/azureadoauth2/callback

A plataforma na URL é o domínio principal da plataforma ao qual é necessário fazer referência. Observe que essa URL de callback funcionará para plataformas de domínio único e multidomínio, e o usuário será redirecionado de acordo.

Google​

Para que a configuração do Google funcione, precisamos de: clientID, clientSecret e hostedDomain. Consulte a documentação do OAuth para o Google para saber mais sobre esses itens.

URL de callback

https://[platform].swipeguide.com/sso/googleoauth2/callback

A plataforma na URL é o domínio principal da plataforma ao qual é necessário fazer referência. Observe que essa URL de callback funcionará para plataformas de domínio único e multidomínio, e o usuário será redirecionado de acordo.

Configuração do SAML 2.0​

Para que a configuração do SAML funcione, precisaremos do seu arquivo de metadados ou:

entryPoint: URL do serviço SSO cert: O certificado público de assinatura usado para validar as assinaturas das respostas SAML recebidas, se utilizado.

As declarações que precisamos que você nos envie: displayName, ID, Email

URL do Serviço de Consumidor de Asserção

https://[platform].swipeguide.com/sso/saml/consume

Metadados SAML

https://[platform].swipeguide.com/sso/saml/metadata

ID da entidade: swipe-guide

A plataforma na URL é o domínio principal da plataforma ao qual é necessário fazer referência. Observe que esta URL de retorno funcionará para plataformas de domínio único e multidomínio, e o usuário será redirecionado adequadamente.

Tempo limite automático da sessão​

Como um serviço e configuração adicionais da plataforma, você pode solicitar ao seu Gerente de Sucesso do Cliente que as sessões expirem automaticamente após X minutos de inatividade (ausência de solicitações ao servidor).

Perguntas frequentes

1. Saiba o que fazer quando o Erro de autenticação SSO for exibido após tentar entrar no SwipeGuide

Você pode receber um erro de autenticação ao entrar nas plataformas SwipeGuide devido a uma chave secreta expirada.

O logon único (SSO) é um método de autenticação que permite aos usuários se autenticarem com segurança em vários aplicativos e sites usando apenas um conjunto de credenciais.

Atualmente, o SSO é um recurso adicional que pode ser solicitado enviando um chamado ao Suporte. O departamento de TI da sua empresa precisa fornecer as informações solicitadas com base no provedor de solução desejado à equipe de engenharia da SwipeGuide para que isso seja configurado. Nós não gerenciamos nem mantemos nenhuma das chaves dos clientes.

Se você acha que sua chave secreta expirou ou está prestes a expirar, faça o seguinte:

  • Informe o departamento de TI local sobre isso e solicite proativamente um novo certificado
  • Entre em contato com o Suporte da SwipeGuide com os novos detalhes

Observação: recomendamos fortemente que sua empresa defina um lembrete a cada 2 anos para evitar que isso impeça seus usuários de fazer login e para compartilhar conosco as novas credenciais.

2. Vários usuários em um dispositivo compartilhado

Você pode se deparar com uma situação em que, por exemplo, "o Operador A e o Operador B usam um dispositivo compartilhado, o Operador A sai do APP e, em seguida, o Operador B entra no APP. O Operador B agora vê a Matriz de Habilidades do Operador A."

Por que isso acontece?

Quando um usuário entra no aplicativo usando SSO, ele verifica se já existe uma sessão SSO ativa nesse dispositivo. Se o Operador A sair do aplicativo, mas não sair completamente da própria conta SSO, a próxima pessoa (Operador B) será automaticamente reconhecida como Operador A ao entrar via SSO. Esse é um comportamento comum em muitos aplicativos que usam SSO ou serviços semelhantes, pois eles dependem do estado atual de login do navegador ou dispositivo.
 
Para garantir que cada usuário precise inserir suas credenciais ao usar um dispositivo compartilhado, siga estas etapas:
1. Após usar o aplicativo, saia do APP normalmente.
2. Além disso, saia completamente da conta SSO (do Google, por exemplo) no navegador ou dispositivo.
3. O próximo usuário poderá então entrar com suas próprias credenciais.
 
Como alternativa, para evitar esse reconhecimento automático pelo SSO, os usuários podem entrar com seu e-mail e senha em vez de usar o SSO em dispositivos compartilhados.