Swipeguide: Início de sessão único (SSO)

Last updated: June 19, 2026

Utilização geral​

Disponibilizamos uma integração de autenticação OAuth2 para a plataforma, que pode ser utilizada para iniciar sessão no CMS Web, na aplicação Web Frontline, nas aplicações nativas da SwipeGuide (iOS e Android) para acesso offline e na aplicação Competências Inteligentes.

Isto permite que os seus utilizadores se autentiquem através do fornecedor OAuth2 gerido pela sua empresa.

Tenha em atenção que os níveis de autorização dentro da plataforma continuam a ser geridos na própria plataforma, de modo a manter um sistema intuitivo e fácil de compreender para os utilizadores.

Disponibilizamos flexibilidade para configurar diferentes tipos de métodos de início de sessão no CMS e nas aplicações Frontline, dependendo das necessidades do Workspace, como e-mail e palavra-passe, bem como SSO. Em alternativa, pode exigir que os seus utilizadores iniciem sessão APENAS com SSO.

Se pretender ativar esta funcionalidade na sua plataforma, certifique-se de que contacta o Suporte da SwipeGuide antes de utilizar esta documentação.

Pré-requisitos​

  1. A sua plataforma deve ter as opções de início de sessão já ativadas (em vez de ser uma plataforma pública).
  2. O fornecedor OAuth2 que pretende utilizar para iniciar sessão na SwipeGuide já deve ser gerido e configurado pelas suas equipas de TI, com credenciais ou certificados válidos. A SwipeGuide já deve ter sido adicionada como uma das aplicações nos seus sistemas.

Configuração do OAuth2​

Para obter documentação básica, consulte o site do OAuth. Para configurar a sua plataforma, existem algumas informações que têm de ser submetidas ao seu serviço de autenticação OAuth2 e algumas informações de que necessitamos para ligar os serviços. Temos um URL de retorno de chamada que terá de ser configurado no serviço de autenticação OAuth2 e necessitaremos de alguns tokens de autorização OAuth2 do serviço. Estes serão diferentes consoante o serviço.

Atualmente, suportamos imediatamente:

  • 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 mais informações sobre estes elementos na documentação OAuth do Azure Entra ID.

URL de retorno

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

A plataforma no URL é o domínio principal da plataforma ao qual é necessário fazer referência. Tenha em atenção que este URL de retorno funcionará para plataformas com um único domínio e com vários domínios, e o utilizador será redirecionado em conformidade.

Google​

Para que a configuração do Google funcione, precisamos de: clientID, clientSecret e hostedDomain. Consulte mais informações sobre estes elementos na documentação OAuth do Google.

URL de retorno

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

A plataforma no URL é o domínio principal da plataforma ao qual é necessário fazer referência. Tenha em atenção que este URL de retorno funcionará para plataformas com um único domínio e com vários domínios, e o utilizador será redirecionado em conformidade.

Configuração SAML 2.0​

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

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

As claims que precisamos que nos envie: displayName, ID, Email

URL do Serviço de Consumo de Asserções

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

Metadados SAML

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

ID da entidade: swipe-guide

A plataforma no URL corresponde ao domínio principal da plataforma que deve ser referido. Tenha em atenção que este URL de retorno funcionará tanto para plataformas com um único domínio como para plataformas com vários domínios, e o utilizador será redirecionado em conformidade.

Tempo limite automático da sessão​

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

Perguntas frequentes

1. Saiba o que fazer quando aparece um erro de autenticação SSO depois de tentar iniciar sessão no SwipeGuide

Pode receber um erro de autenticação ao iniciar sessão nas plataformas SwipeGuide devido a uma chave secreta expirada.

O início de sessão único (SSO) é um método de autenticação que permite aos utilizadores autenticarem-se de forma segura em várias aplicações e sites utilizando apenas um conjunto de credenciais.

Atualmente, o SSO é uma funcionalidade Add-On que pode ser solicitada através do envio de um ticket ao Suporte. O departamento de TI da sua empresa precisa de fornecer as informações solicitadas, com base no fornecedor da solução pretendida, à equipa de engenharia da SwipeGuide para que esta seja configurada. Nós não gerimos nem mantemos nenhuma das chaves dos clientes.

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

  • Informe a sua equipa de TI e solicite proativamente um novo certificado
  • Contacte o Suporte da SwipeGuide com os novos dados

Nota: Recomendamos vivamente que a sua empresa defina um lembrete a cada 2 anos para evitar que isto impeça os seus utilizadores de iniciar sessão e para partilhar connosco as novas credenciais.

2. Vários utilizadores num dispositivo partilhado

Pode deparar-se com uma situação em que, por exemplo, "o Operador A e o Operador B utilizam um dispositivo partilhado, o Operador A termina sessão na APP e, em seguida, o Operador B inicia sessão na APP. O Operador B vê agora a Matriz de Competências do Operador A."

Porque é que isto acontece?

Quando um utilizador inicia sessão na aplicação utilizando SSO, verifica se já existe uma sessão SSO ativa nesse dispositivo. Se o Operador A terminar sessão na aplicação, mas não terminar completamente a sessão na própria conta SSO, a pessoa seguinte (Operador B) será automaticamente reconhecida como o Operador A ao iniciar sessão através de SSO. Este é um comportamento comum em muitas aplicações que utilizam SSO ou serviços semelhantes, uma vez que dependem do estado atual de início de sessão do navegador ou dispositivo.
 
Para garantir que cada utilizador tem de introduzir as suas credenciais ao utilizar um dispositivo partilhado, siga estes passos:
1. Depois de utilizar a aplicação, termine sessão na APP como habitualmente.
2. Termine também completamente a sessão da conta SSO (por exemplo, do Google) no navegador ou dispositivo.
3. O utilizador seguinte poderá então iniciar sessão com as suas próprias credenciais.
 
Em alternativa, para evitar este reconhecimento automático através de SSO, os utilizadores podem iniciar sessão com o seu e-mail e palavra-passe, em vez de utilizarem SSO, em dispositivos partilhados.