Pular para o conteúdo principal

Usando Casdoor como um Servidor OAuth2 no ShowDoc

Usando Casdoor para Autenticação no ShowDoc​

ShowDoc é uma ferramenta de documentação técnica e documentação de API online que é perfeita para equipes de TI. O ShowDoc facilita o uso da sintaxe Markdown para escrever belos documentos de API, documentos de dicionário de dados, documentos técnicos, documentos Excel online e mais.

O ShowDoc suporta autenticação de terceiros, incluindo OAuth2. Aqui está um tutorial para alcançar isso.

Passo 1: Criar uma Aplicação Casdoor​

Vá até o seu Casdoor e adicione uma nova aplicação chamada ShowDoc. Aqui está um exemplo de como criar a aplicação ShowDoc no Casdoor.

create_application.png

Por favor, lembre-se do client ID e do client Secret para o próximo passo.

informação

Por favor, não preencha a URL de callback neste passo. A URL depende das configurações no ShowDoc no próximo passo. Voltaremos para definir uma URL de callback correta mais tarde.

Passo 2: Configurar o ShowDoc​

Primeiro, habilite o botão de login OAuth2. Então, preencha a URL de callback conforme mostrado no exemplo. Preencha o client ID e o client secret que foram lembrados no passo anterior.

showdoc_oauth2.png

Caminho de autorização, Caminho do AccessToken e Caminho das informações do usuário são necessários. Você pode preenchê-los conforme mostrado abaixo.

Authorize path:   /login/oauth/authorize
AccessToken path:   /api/login/oauth/access_token
User info path:   /api/get-account

Passo 3: Configurar a URL de Callback no Casdoor​

Volte à página de edição da aplicação no passo 1 e adicione a URL de callback que você preencheu no ShowDoc.

showdoc_callbackurl.png

Passo 4: Experimente no ShowDoc​

Você deverá ver o seguinte na página de login:

showdoc_login.png

Parabéns! Você completou todos os passos. Pressione o botão 'Casdoor SSO', e você será redirecionado para a página de login do Casdoor.