keycloak

一，先下载vuekeycloakjs npm install @dsb-norge/vue-keycloak-js --save 二，引入 import VueKeycloakJs from ' @dsb-norge/vue-keycloak-js ' 三，进行配置（里面的配置项需要在keycloak后台管理里面配置） Vue.use(VueKeycloakJs, { init: { onLoad: " login-required ", checkLoginIframe: false//防止登陆后重复刷新 }, config: { url: process.env.VUE_APP_SSO_URL, realm: process.env.VUE_APP_REALM, clientId: process.env.VUE_APP_CLIENTID }, onReady: keycloak => { new Vue({ router, store, render: h => h(App) }).$mount( " #app " ); } }); 四，应用 <span>{{$keycloak.token}}</span> <span>{{$keycloak.username}}</span> <span @click= " $keycloak.logoutFn " >退出</span>

术语 realm 领域的名称， 这是必需的。 resource 应用程序的client-id，每个应用程序都有一个用于标识该应用程序的client-id。 这是必需的。 realm-public-key 领域的公钥，PEM格式。 您可以从管理控制台中获取。 这是可选的，建议您不要进行设置。 如果未设置，则适配器将从Keycloak下载此文件，并且始终会在需要时重新下载它（例如Keycloak旋转其密钥）。 但是，如果设置了realm-public-key，那么适配器将永远不会从Keycloak下载新密钥，因此，当Keycloak旋转其密钥时，适配器会损坏。 auth-server-url Keycloak服务器的基本URL。 所有其他Keycloak页面和REST服务端点都从此派生。 通常采用https：// host：port / auth的形式。 这是必需的。 ssl-required 确保与Keycloak服务器之间的所有通信均通过HTTPS。 在生产中，这应该设置为全部。 这是可选的。 默认值为外部，这意味着外部请求默认情况下需要HTTPS。 有效值为“全部”，“外部”和“无”。 confidential-port Keycloak服务器用于通过SSL / TLS进行安全连接的机密端口。 这是可选的。 默认值为8443。 use-resource-role-mappings

要自定义keycloak页面，必要先熟悉其采用的模板引擎freemarker，读懂base模板代码。要理解其工作原理及术语，方便交流，有选择的使用前端技术替换实现。 工作原理 模板引擎 是一种基于模板和要改变的数据， 并用来生成输出文本(HTML网页，电子邮件，配置文件，源代码等)的通用工具。 它不是面向最终用户的，而是一个Java类库，是一款程序员可以嵌入他们所开发产品的组件。 模板引擎基于已经准备好的数据和模板来渲染HTML。数据放在多层嵌套的map结构中，当模板中使用点符号取数据，本质是一层层的从map中get。模板解析器会读取模板的字符，解析模板引擎的标签，表达式等，替换或生成对应的数据。 数据模型 为模板准备的数据整体被称作为 数据模型 。 数据模型是树形结构，在Java中实现就是多层map。 变量 模型中的key，取出对应的value替换变量。 方法 方法变量在存于实现了 TemplateMethodModel 接口的模板中。 public class IndexOfMethod implements TemplateMethodModel { ...... } root.put("indexOf", new IndexOfMethod()); ${indexOf("met", x)} 模板 .ftl文件，最简单的模板通常是普通的HTML文件，文件中自然可以包含html

登录及身份认证是现代web应用最基本的功能之一，对于企业内部的系统，多个系统往往希望有一套SSO服务对企业用户的登录及身份认证进行统一的管理，提升用户同时使用多个系统的体验，Keycloak正是为此种场景而生。本文将简明的介绍Keycloak的安装、使用，并给出目前较流行的前后端分离应用如何快速接入Keycloak的示例。 Keycloak是什么 Keycloak是一种面向现代应用和服务的开源IAM（身份识别与访问管理）解决方案 Keycloak提供了单点登录（SSO）功能，支持 OpenID Connect 、 OAuth 2.0 、 SAML 2.0 标准协议，拥有简单易用的管理控制台，并提供对LDAP、Active Directory以及Github、Google等社交账号登录的支持，做到了非常简单的开箱即用。 Keycloak常用核心概念介绍 首先通过官方的一张图来了解下整体的核心概念 这里先只介绍4个最常用的核心概念： Users : 用户，使用并需要登录系统的对象 Roles : 角色，用来对用户的权限进行管理 Clients : 客户端，需要接入Keycloak并被Keycloak保护的应用和服务 Realms : 领域，领域管理着一批用户、证书、角色、组等，一个用户只能属于并且能登陆到一个域，域之间是互相独立隔离的， 一个域只能管理它下面所属的用户