keyCloak自定义登陆页主题以及图形验证码（数字字母以及混合验证）

一，下载以及配置keycloak

1)，下载keycloak：https://www.keycloak.org/downloads.html ；
2)，下载完毕之后，打开文件，访问 bin 路径，点击 standalone.bat 打开；
3)，访问 http://localhost:8080/auth/ 即可进入keycloak配置后台。详情配置以及集成请看 https://www.cnblogs.com/moutudou/p/14189368.html，这里不做赘述。
**

二，修改自定义主题

**
1），打开下载的kaycloak文件，找到 theme 文件夹，复制一份 base 并命名成自己的主题名称.

2)，打开mytheme2021文件夹，这里有很多个文件夹，都是可自定义去修改的，这里咱们只修改login主题

3），打开login，会看到有一个 theme.properties和一个资源文件夹 resources，自定义的css和js等其他静态资源文件放到resources文件夹下，theme.properties定义主题引用文件，打开theme.properties可看到css可通过此处引入。自定义主题的样式图片等静态资源文件都放在此处即可。


4），接下来，在 theme / base 文件夹下，找到login.ftl，keycloak主题都是基于base的，所以我们修改login主题就需要在base下的login.ftl文件下修改，打开login.ftl文件，这里有两个需要注意的地方，一个是顶部引入的 template.ftl 文件，一个是需要修改的图形验证码处，如图：


在图形验证码处修改成自己需要的样式，我这里就是加了个input框和一个图形验证码容器，两处修改后如以下图（此时图形验证码未出来）：

5），接着就是图形验证码：
打开template.ftl，（这个文件就是在login.ftl引入的）引入js文件，请注意这个文件路径，是在自定义主题下的resources下的js里面，引入图形验证码js文件并在此处调用方法,如图：


6）template.ftl调用图形验证码以及登陆验证。

$(function () {
      // 定义：存储验证码
      var verifyCode = new GVerify("v_container");
      var verifyCode = new GVerify({
        id:"v_container",
        type:"number" // 验证码类型：默认类型blend:数字字母混合类型、number:纯数字、letter:纯字母
      });
      // 登录的js验证
      $("#kc-login").click(function () {
          var postform = document.getElementById("kc-form-login");//获取表单,调用submit方法
          var value = document.getElementById("regText").value;
          var res = verifyCode.validate(value);  //获取验证码
          // 判断：输入框里验证码和获取到的验证码是否一致
          if (value !== '') {
            if (res) { // 验证通过
              $("#kc-content").find(".alert-error").remove();
              postform.submit();
            } else if (value !== verifyCode.code) {//验证码输入错误
              $("#kc-content").find(".alert-error").remove();
              var html = '<div class="alert alert-error"><span class="pficon pficon-error-circle-o"></span><span class="kc-feedback-text">${msg("invalidTotpMessage")}</span></div>'
              $("#kc-content-wrapper").prepend(html);
              return false;
            }
          } else {
            $("#kc-content").find(".alert-error").remove();
            var html = '<div class="alert alert-error"><span class="pficon pficon-error-circle-o"></span><span class="kc-feedback-text">${msg("missingTotpMessage")}</span></div>'
            $("#kc-content-wrapper").prepend(html);
            return false;
          }
      });
  });

7）生成图形验证码的js代码：

// 生成图形验证码的JS文件 authenticatorCode.js
!(function(window, document) {
    function GVerify(options) { //创建一个图形验证码对象，接收options对象为参数
        this.options = { //默认options参数值
            id: "", //容器Id
            canvasId: "verifyCanvas", //canvas的ID
            width: "100", //默认canvas宽度
            height: "30", //默认canvas高度
            type: "number", //图形验证码默认类型blend:数字字母混合类型、number:纯数字、letter:纯字母
            code: ""
        };

        if(Object.prototype.toString.call(options) == "[object Object]"){//判断传入参数类型
            for(var i in options) { //根据传入的参数，修改默认参数值
                this.options[i] = options[i];
            }
        }else{
            this.options.id = options;
        }

        this.options.numArr = "0,1,2,3,4,5,6,7,8,9".split(",");
        this.options.letterArr = getAllLetter();

        this._init();
        this.refresh();
    }

    GVerify.prototype = {
        /**版本号**/
        version: '1.0.0',

        /**初始化方法**/
        _init: function() {
            var con = document.getElementById(this.options.id);
            var canvas = document.createElement("canvas");
            this.options.width = con.offsetWidth > 0 ? con.offsetWidth : "100";
            this.options.height = con.offsetHeight > 0 ? con.offsetHeight : "30";
            canvas.id = this.options.canvasId;
            canvas.width = this.options.width;
            canvas.height = this.options.height;
            canvas.style.cursor = "pointer";
            canvas.innerHTML = "您的浏览器版本不支持canvas";
            con.appendChild(canvas);
            var parent = this;
            canvas.onclick = function(){
                parent.refresh();
            }
        },

        /**生成验证码**/
        refresh: function() {
            this.options.code = "";
            var canvas = document.getElementById(this.options.canvasId);
            if(canvas.getContext) {
                var ctx = canvas.getContext('2d');
            }else{
                return;
            }

            ctx.textBaseline = "middle";

            ctx.fillStyle = randomColor(180, 240);
            ctx.fillRect(0, 0, this.options.width, this.options.height);

            if(this.options.type == "blend") { //判断验证码类型
                var txtArr = this.options.numArr.concat(this.options.letterArr);
            } else if(this.options.type == "number") {
                var txtArr = this.options.numArr;
            } else {
                var txtArr = this.options.letterArr;
            }

            for(var i = 1; i <= 4; i++) {
                var txt = txtArr[randomNum(0, txtArr.length)];
                this.options.code += txt;
                ctx.font = randomNum(this.options.height/1, this.options.height) + 'px SimHei'; //随机生成字体大小
                ctx.fillStyle = randomColor(50, 160); //随机生成字体颜色
                ctx.shadowOffsetX = randomNum(-3, 3);
                ctx.shadowOffsetY = randomNum(-3, 3);
                ctx.shadowBlur = randomNum(-3, 300);
                ctx.shadowColor = "rgba(0, 0, 0, 0.1)";
                var x = this.options.width / 5 * i;
                var y = this.options.height / 2;
                var deg = randomNum(-30, 30);
                /**设置旋转角度和坐标原点**/
                ctx.translate(x, y);
                ctx.rotate(deg * Math.PI / 180);
                ctx.fillText(txt, 0, 0);
                /**恢复旋转角度和坐标原点**/
                ctx.rotate(-deg * Math.PI / 180);
                ctx.translate(-x, -y);
            }
            /**绘制干扰线**/
            for(var i = 0; i < 4; i++) {
                ctx.strokeStyle = randomColor(40, 180);
                ctx.beginPath();
                ctx.moveTo(randomNum(0, this.options.width), randomNum(0, this.options.height));
                ctx.lineTo(randomNum(0, this.options.width), randomNum(0, this.options.height));
                ctx.stroke();
            }
            /**绘制干扰点**/
            for(var i = 0; i < this.options.width/4; i++) {
                ctx.fillStyle = randomColor(0, 255);
                ctx.beginPath();
                ctx.arc(randomNum(0, this.options.width), randomNum(0, this.options.height), 1, 0, 2 * Math.PI);
                ctx.fill();
            }
        },

        /**验证验证码**/
        validate: function(code){
            var code = code.toLowerCase();
            var v_code = this.options.code.toLowerCase();
            if(code == v_code){
                return true;
            }else{
                this.refresh();
                return false;
            }
        }
    };
    /**生成字母数组**/
    function getAllLetter() {
        var letterStr = "a,b,c,d,e,f,g,h,i,j,k,m,n,o,p,q,r,s,t,u,v,w,x,y,z,A,B,C,D,E,F,G,H,J,K,L,M,N,O,P,Q,R,S,T,U,V,W,X,Y,Z";
        return letterStr.split(",");
    }
    /**生成一个随机数**/
    function randomNum(min, max) {
        return Math.floor(Math.random() * (max - min) + min);
    }
    /**生成一个随机色**/
    function randomColor(min, max) {
        var r = randomNum(min, max);
        var g = randomNum(min, max);
        var b = randomNum(min, max);
        return "rgb(" + r + "," + g + "," + b + ")";
    }
    window.GVerify = GVerify;
})(window, document);

最终修改后：


最后提一句，语言包是在 base / theme / login / messages 下：里面已经有语言国际化，可对应引入使用即可，也可继续添加，messages使用时语法 ：${msg(“invalidTotpMessage”)}
如：

<span class="kc-feedback-text">${msg("invalidTotpMessage")}</span>

仅作记录。