Pular para o conteúdo principal

Como Habilitar o Single Sign-On

Introdução

Você conectou o Casdoor e configurou mais de um aplicativo em uma organização. Você quer que os usuários façam login uma vez em qualquer aplicativo da organização e depois possam fazer login quando forem para outro aplicativo sem cliques extras.

Nós oferecemos este recurso de single sign-on. Para habilitá-lo, você só precisa:

  • Habilitar o botão de Auto Sign-In.
  • Preencher a URL para a página inicial.
  • Adicionar uma função de Silent Sign-In à página inicial do aplicativo.
nota

O processo básico de login fornecido pelo Casdoor permite que os usuários façam login em outros aplicativos da organização selecionando o usuário que está atualmente logado ou usando outra conta.

Após habilitar o auto login, a caixa de seleção não será exibida, e o usuário logado entrará diretamente.

Configuração

  1. Preencher o campo "home". Pode ser a página inicial do aplicativo ou a página de login.

sso_home.png 2. Habilitar o botão de Auto Sign-In.

sso_signin.png

Adicionar Silent Sign-In

Na verdade, implementamos o login automático incluindo parâmetros na URL. Portanto, seus aplicativos precisam ter um método para acionar o login após saltar para a URL. Nós fornecemos o casdoor-react-sdk para ajudá-lo a implementar rapidamente este recurso. Você pode ver os detalhes em use-in-react.

informação

Como funciona

  1. Na URL para a página inicial do aplicativo, vamos incluir o parâmetro silentSignin.
  2. Na sua página inicial, determine se você precisa fazer login silenciosamente (automaticamente) verificando o parâmetro silentSignin. Se silentSignin === 1, a função deve retornar o componente SilentSignin, que ajudará você a iniciar uma solicitação de login. Uma vez que você habilitou o login automático, os usuários farão login automaticamente sem clicar.

Adicionar Popup Sign-In

A função de "popup sign-in" abrirá uma pequena janela. Após fazer login no Casdoor em uma janela secundária, ele enviará informações de autenticação para a janela principal e então fechará automaticamente. Implementamos este recurso incluindo parâmetros na URL.

informação

Como usar

Use o método popupSignin() no casdoor-js-sdk para implementar rapidamente este recurso. Você pode ver uma demonstração em casdoor-nodejs-react-example.

Como funciona

  1. Na URL para a página inicial do aplicativo, vamos incluir o parâmetro popup.
  2. Quando popup=1 estiver nos parâmetros de login, o Casdoor enviará code e state como uma mensagem para a janela principal e terminará de obter o token na janela principal usando o SDK.

Usando SSO

A configuração está completa. Abaixo, mostraremos como usar o login automático.

informação

Certifique-se de que seu aplicativo possa redirecionar para a página de perfil do usuário. A API getMyProfileUrl(account, returnUrl) é fornecida em nosso SDK para cada linguagem.

Abrir a página de perfil e ir para a página "Home" (caminho da URL /). Você verá a lista de aplicativos fornecida pela organização. Vale ressaltar que apenas usuários em organizações diferentes de "built-in" podem ver a lista de aplicativos na página "Home". Todos os administradores globais (aqueles na organização "built-in") não podem vê-la.

sso_homepage.png

Clique em um bloco na lista de aplicativos, e ele saltará para a URL da página inicial desse aplicativo com o parâmetro GET ?silentSignin=1. Ele fará login automaticamente no aplicativo se o aplicativo estiver integrado com o Casdoor SSO (assim ele reconhecerá o parâmetro ?silentSignin=1 e realizará um login silencioso em segundo plano).