自定义登录界面- FineBI帮助文档 FineBI帮助文档

1. 概述

1.1 版本

BI 伺服器版本	JAR	功能變更
5.0	-	-
5.1	2020-08-04	使用自訂登入介面，開啓範本認證後，存取單張儀表板，跳轉到自訂登入介面登入成功後，可查看儀表板
5.1.15	-	2.3節，自訂登入網頁，支援先預覽效果再儲存

1.2 預期效果

使用者登入數據決策系統時，不希望使用預設登入介面，可透過自訂登入介面的方式修改預設登入介面，如下圖所示：

1.3 解決思路

登入介面，獲取到帳號和密碼的值，傳送到 BI 系統，BI 服務帶着這兩個參數存取認證位址進行認證。

2. 設定自訂登入介面

2.1 建立 HTML 檔案

建立 HTML 檔案自訂 BI 工程的登入頁面，並儲存在%BI_HOME%\webapps\webroot目錄下。檔案內容如下：

注：根據實際情況修改 html 檔案（即下方代碼）中 URL 的 IP 和埠號。

點選下載HTML 檔案：login.zip

<html>
 
<head>
    <meta charset="utf-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>自訂登入Demo</title>
 
    <!-- 自訂樣式，根據實際需求使用 -->
    <link href="https://cdn.bootcss.com/bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet">
    <script src="https://cdn.bootcss.com/html5shiv/3.7.3/html5shiv.min.js"></script>
    <script src="https://cdn.bootcss.com/respond.js/1.4.2/respond.min.js"></script>
 
    <style>
        .container {
            display: flex;
            justify-content: center;
        }
 
        .login-box {
            width: 300px;
            margin-top: 100px;
        }
 
        .login-box h2 {
            font-size: 26px;
            text-align: center;
            margin-bottom: 25px;
        }
 
        .login-item {
            margin-bottom: 20px;
        }
    </style>
</head>
 
<body>
<div class="container">
    <form class="login-box" action="" method="post" onsubmit="return false;">
        <h2>數據決策系統</h2>
        <div class="login-item">
            <label for="inputUsername" class="sr-only">帳號</label>
            <input type="text" id="inputUsername" class="form-control" placeholder="帳號" required="" autofocus="">
        </div>
        <div class="login-item">
            <label for="inputPassword" class="sr-only">密碼</label>
            <input type="password" id="inputPassword" class="form-control" placeholder="密碼" required="">
        </div>
        <button class="btn btn-lg btn-primary btn-block" type="submit" id="submitBtn">登入</button>
    </form>
</div>
<!-- 由於是內嵌在工程中，可以直接使用fineui -->
<script src="http://localhost:37799/webroot/decision/file?path=/com/fr/web/ui/fineui.min.js
</script>
<script>
    document.getElementById("submitBtn").addEventListener("click", function () {
        doSubmit();
    });
 
    function doSubmit() {
        var username = document.getElementById("inputUsername").value.trim();
        var password = document.getElementById("inputPassword").value.trim();
        if (username === "") {
            window.alert("請輸入帳號");
            return false;
        }
        if (password === "") {
            window.alert("請輸入密碼");
            return false;
        }
        /**
         * 透過登入API傳送post請求，攜帶帳號密碼等資訊
         */
        $.ajax({
            url: "http://localhost:37799/webroot/decision/login",
            contentType: "application/json",
            type: "POST",
            dataType: "json",
            data: JSON.stringify({
                username: username,
                password: password,
                validity: -1,
                origin: getUrlQuery("origin")
            }),
            success: function (res) {
                // 登入成功後儲存是否保持登入狀態以及token
                if (res.data) {
                    var data = res.data;
                    var day = data.validity === -2 ? (14 * 24) : -1;
                    BI.Cache.addCookie("fine_remember_login", data.validity, "/", day);
                    BI.Cache.addCookie("fine_auth_token", data.accessToken, "/", day);
 
                    // 然後跳轉到相應的頁面
                    var response = data.originUrlResponse;
                    if (BI.toUpperCase(response.method) === "GET") {
                        window.location.href = response.originUrl;
                    } else {
                        doActionByForm(response.originUrl, response.parameters, {method: response.method});
                    }
                } else {
                    // 提示錯誤資訊
                    alert(res.errorMsg);
                }
            },
            error: function () {
                alert("逾時或伺服器其他錯誤");
            }
        });
    }
 
    // 查詢url參數
    function getUrlQuery (name) {
        var reg = new RegExp("(^|
        var r = window.location.search.substr(1).match(reg);
        if (r !== null) return r[2];
        return "";
    }
 
    // 透過form表單跳轉
    function doActionByForm (url, data, options) {
            options = options || {};
            var config = {
                method: options.method,
                url: url,
                data: data,
                target: options.target
            };
            var $form = $("<form method=\""   config.method   "\" />");
            $form.attr("action", config.url);
            $form.attr("method", config.method || "post");
            $form.attr("target", config.target || "_self");
            for (var key in config.data) {
                $form.append("<input type=\"hidden\" name=\""   key   "\" value=\""   config.data[key]   "\" />");
            }
            $(document.body).append($form);
            $form[0].submit();
            $form.destroy();
        }
</script>
</body>
 
</html>

注：2020-01-15 及之後的 JAR 還可以使用 post 跳轉實現自訂登入，點選下載代碼：register.zip

2.2 設定登入網頁

管理者登入數據決策系統，點選「管理系統>外觀配置>登入頁」，選擇登入方式為「設定登入網頁」，並輸入自訂登入網頁面的路徑：「login.html」，如下圖所示：

注：登入頁檔案如果在同一個工程下面網頁 URL 可以用相對路徑，如果在不同工程下跨域使用，請使用http://ip:port/工程名/形式。

2.3 效果預覽

5.1.15 及之後版本的 BI 工程，支援先預覽自訂登入網頁效果。如下圖所示：

注1：請先「預覽」再「儲存」，防止登入頁配置錯誤，導致無法登入。

注2：若在預覽頁登入時跳出 404 報錯介面，說明上文的 HTML 檔案中存在錯誤，請仔細檢查修改，直至無誤。

2.4 儲存配置

預覽效果無誤後，使用者可點選右上角「儲存」按鈕，跳出當前帳號，重新登入數據決策系統時，自訂頁面效果如本文 1.2 節預期效果中所示。

3. 開啓範本認證後存取儀表板

2020-08-04 及之後的 JAR，使用自訂登入介面，開啓範本認證，存取單張儀表板，跳轉到自訂登入介面登入成功後，可查看儀表板。

範例：

設定自訂登入介面並開啓帳號密碼認證，儀表板預覽連結為：http://localhost:37799/webroot/decision/v5/design/report/6c92aa9694204baa838cadf0e0a9d551/view，另一使用者存取儀表板 URL ，效果如下圖所示：

已經是第一篇

已經是最後一篇

有幫助
沒幫助
只是瀏覽
评价文档，奖励 1 ~ 100 随机 F 豆！

自定义登录界面