O

SSO (Sigle Sign On) é uma

ferramenta de controle de acesso para aplicações distribuídas na web com integração a sistemas corporativos e que utiliza o protocolo OAuth 2.0. Ele é responsável por gerenciar o processo de autenticação e permissões dos usuários em múltiplos serviços, dessa forma, é possível logar em um desses serviços e ter acesso aos demais serviços sem precisar logar em cada um deles. Um exemplo conhecido de sistema que utiliza o SSO é o Gmail (conta Google).

Já a SAML (Security Assertion Markup Language) é um padrão aberto que troca informações de autenticação entre provedor de serviços e um provedor de identidade (IdP). Dessa forma, é possível usar um IdP de terceiros para autenticar usuários e passar informações de identidade para o provedor de serviços por um arquivo XML assinado digitalmente.

Independente do tipo de autenticação escolhido (SSO ou SAML), o processo de configuração no Cronapp é o mesmo, como veremos abaixo. 

Seleção da autenticação

Nos subtópicos abaixo, você verá que há duas formas de configurar a autenticação via SSO dependendo de como foi criado o projeto.

Antes de criar o projeto

A seleção da autenticação pode ser feita durante ou após a criação do projeto no Cronapp. Na janela de criação do projeto é possível selecionar as opções SSO ou SAML no campo selecionar a opção SSO no campo Tipo de Autenticação (Figura 1). 

Image RemovedImage Added

Figura 1 - Seleção do tipo de autenticação na criação do projeto

Ao criar o projeto já como a autenticação do tipo SSO, a view de login virá somente com o botão Entrar (Figura 1.1) já configurado para acessar o servidor SSO configurado.

Image Added

Figura 1.1 - Projeto já criado com SSO

Após criar o projeto

Se a configuração for após a criação do projeto, acesse a aba Configurações do Projeto na Janela de mesmo nome Configurações do Projeto e selecione a opção SSO (Oauth2) ou SAML para exibir uma nova aba, o acordeão Configurações da Autenticação.  (Figura 2) .

Image RemovedImage Added

Figura 2 - Seleção do tipo de autenticação após o projeto criado

Após adicionar um botão "Login SSO" na tela de login, é necessário que ele chame uma função com o bloco Login via SSO (Oauth2), a página de login ficará como abaixo (Figura 2.1), contendo duas formas de logar.

Image Added

Figura 2.1 - Botão de Login SSO adicionado

Configuração

Após seguir os passos da figura Figura 2.1, acesse a aba Configurações da Autenticação e preencha os campos informados na figura Figura 3.Image Removed

Image Added

Figura 3 - Aba Configurações da Autenticação da janela de Configurações do Projeto

• ID do Cliente: O o ID do cliente encontrado nas configurações do provedor de autenticação SSO / SAML.

• Segredo do Cliente:

  O

  valor do segredo do cliente encontrado nas configurações do provedor de autenticação

  SSO / SAML

  SSO.

  Informações
  Alguns provedores SSO só exibem o segredo no momento da criação, Caso tenha perdido, será necessário excluir o antigo e criar um novo.

• URI do Token de Acesso: URI do provedor OAuth OAuth2 que fornece o token de acesso para a aplicação.
• URI de Autorização do Usuário: URI para o qual o usuário será redirecionado, se for necessário, para autorizar o acesso ao recurso.
• URI de Logout do Usuário: após o usuário fazer o logout da aplicação será direcionado para a URI inserida. Na próxima vez que o usuário precisar logar na aplicação, deverá fazer o login via SSO novamente.
• URI de Informações do Usuário: URI para obter detalhes atuais do usuário..

• Escopos: define os dados concedido para o provedor SSO, sendo possível adicionar novos escopos, separando-os com o caractere espaço " ".

  Nota

  Cuidado ao alterar as informações dos Escopos, se for inserido algo que não exista, gerará um erro. Alguns provedores SSO exigem parâmetros específicos para funcionar, dessa forma, acesse a documentação do seu provedor SSO para garantir a configuração correta. Exemplo: A depender de como o provedor Azure esteja configurado, ele exigirá o parâmetro "Read.User", assim, o campo Escopo deve ser preenchido da seguinte forma: openid profile email User.Read

  
  

  • openid: fornece tokens para autenticação;
  • profile: fornece o acesso às informações sobre o usuário, como: nome, sobrenome, nome preferencial e ID de objeto;
  • email: concede acesso ao endereço de e-mail principal do usuário.
• Chave Principal Customizada Oauth2: campo opcional que permite definir qual o identificador do usuário será retornado após a autenticação. Caso não seja preenchido, uma lista padrão retornará com os dados do usuário: id, e-mail, nome e outros.

Por fim, após feita a configuração e clicar no botão de login, o usuário será direcionado para o serviço de autenticação via SSO (exemplo na figura 3.1) e que após logar, retornará para a aplicação já com o usuário autenticado.

Image Added

Figura 3.1 - Redirecionamento para a página do servidor de SSO configurado