跳到主内容

在ShowDoc中使用Casdoor作为OAuth2服务器

在ShowDoc中使用Casdoor进行身份验证​

ShowDoc是一个在线API文档和技术文档工具，非常适合IT团队使用。 ShowDoc使得使用Markdown语法编写美观的API文档、数据字典文档、技术文档、在线Excel文档等变得简单易行。

ShowDoc支持第三方认证，包括OAuth2。 这是一个实现此目标的教程。

步骤1：创建一个Casdoor应用​

前往你的Casdoor并添加一个名为ShowDoc的新应用。 这是在Casdoor中创建ShowDoc应用程序的一个示例。

create_application.png

请记住下一步所需的客户端 ID和客户端密钥。

信息

请不要在此步骤中填写回调URL。 URL取决于下一步中ShowDoc的配置。 我们稍后会回来设置一个正确的回调URL。

步骤2：配置ShowDoc​

首先，启用OAuth2登录按钮。 然后，按照示例填写回调URL。 在上一步中记住的client ID和client secret填入。

showdoc_oauth2.png

Authorize path、AccessToken path和User info path是必需的。 您可以按照下面的示例来填写。

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

步骤3：在Casdoor中配置回调URL​

返回到步骤1中的应用编辑页面，并添加你在ShowDoc中填写的回调URL。

showdoc_callbackurl.png

步骤4：尝试使用ShowDoc​

你应该在登录页面上看到以下内容：

showdoc_login.png

恭喜您！ 您已完成所有步骤 按下'Casdoor SSO'按钮，您将被重定向到Casdoor登录页面。