Keycloak¶

在这篇文章中

• Keycloak 核心功能
• 部署功能
• 将 Keycloak 作为 Managed App 部署后的入门指南
• 从 Marketplace 部署 Keycloak 后的入门指南
• 授权与更改凭据
• Keycloak 启动界面
• 通过 API 订购 Keycloak

Keycloak 核心功能¶

• 多应用的单点登录 (SSO) - 用户只需登录系统一次，即可访问所有关联的服务，无需再次输入密码。
• 无缝集成 - 与现有的企业目录（如 LDAP 或 Microsoft Active Directory）兼容，无需进行数据迁移或重复用户数据。
• 身份代理 (Identity brokering) - 能够配置通过社交网络（Google、GitHub、Facebook）或其他外部企业身份提供商进行登录。
• 多因素身份验证 (MFA/2FA) - 内置对一次性密码 (TOTP，例如 Google Authenticator) 和 WebAuthn 标准（硬件安全密钥）的支持。
• 灵活的权限管理 - 通过角色、组和用户属性分配访问权限，包括在单个应用程序资源级别的细粒度授权。
• 通过 Realm 实现隔离 - 每个 realm 是一个独立的隔离环境，拥有各自的用户、角色和设置。如果您需要在单个 Keycloak 实例上为多个不同的项目或客户提供服务，这将非常方便。
• 成熟且有支持的解决方案 - 该项目由大型社区和企业赞助商开发；定期发布更新和安全补丁。

部署功能¶

将 Keycloak 作为 Managed App 部署后的入门指南¶

将 Keycloak 部署为 managed app 后，您可以在服务器控制面板的 My Apps 选项卡中找到以下内容：

• 应用程序链接；
• 用于访问的登录名和密码；
• 有关服务使用和管理的信息。

有关使用 managed apps 的更多详细信息，请参阅 说明文档。

从 Marketplace 部署 Keycloak 后的入门指南¶

付款处理完成后，一旦服务器准备好运行，系统将向注册时提供的电子邮件地址发送通知。邮件中将包含 VPS IP 地址以及连接所需的登录名和密码。客户可以在 Server Control Panel and API —— Invapi 中管理其硬件。

授权凭据可以在服务器控制面板的 Configuration >> Tags 部分或通过发送的电子邮件中找到：

• 访问 Keycloak Web 界面链接：位于 webpanel 标签中；
• Username：root;
• 服务器管理 Password：在软件部署后，服务器准备就绪时通过电子邮件发送。

授权与更改凭据¶

要访问管理面板，请导航至 https://keycloak{server_id}.hostkey.com/ 并输入您的凭据：Username - root，Password - 来自邮件的内容。然后点击 Sign in 按钮：

成功授权后，您将被重定向到管理面板的启动页面：

在首次登录后，建议更改默认管理员密码以提高安全性：

1. 点击界面右上角的个人资料图标并选择 Manage account。

   

2. 选择 Account security 菜单，然后选择 Signing in，并在 My password 字段中，点击 Update 按钮。

   

3. 在打开的页面中，输入新的密码值。

Keycloak 启动界面¶

成功授权后，您将进入 Keycloak 启动界面，在此您可以管理和配置各种参数以确保安全性：

通过 API 订购 Keycloak¶