企业部署Power BI 报表服务器，在第三方系统嵌套该报表服务器，并实现单点登录

2025-05-14 07:57:07 0 阅读

简介

Power BI Report Server 简称PBIRS，中文名"Power BI 报表服务器"

微软的文档：Power BI 报表服务器文档 - Power BI | Microsoft Learn

借用官网的介绍：

Power BI 报表服务器类似于 SQL Server Reporting Services 和 Power BI 联机服务，
Power BI 报表服务器也可托管 Power BI 报表 (.pbix)、Excel 文件和分页报表 (.rdl)。
Power BI 报表服务器是本地服务器。
Power BI 报表服务器功能是 Reporting Services 的超集：Reporting Services 可执行的所有操作均可由 Power BI 报表服务器执行，后者还支持 Power BI 报表。

想要实现的功能：

私有化部署Power BI报表服务器
本地开发PBI报表之后，直接部署到服务器
在第三方系统嵌套报表服务器，并实现单点登录

安装

准备一台服务器：

CPU：4vCPUs
内存：8GiB
硬盘：100G
镜像： Windows Server 2022 数据中心版 64位中文_40GB/深圳市伊登软件有限公司

远程登录到服务器，安装软件：

SQL2022-SSEI-Dev：微软数据库 SQL
SSMS-Setup-CHS：微软数据库管理工具
PowerBIReportServer：PBI 报表服务器
安装 IIS 证书：启用 https
VisualStudioSetup： Visual Studio 开发工具，用于自定义Form登录

安装 SQL Server

下载文件：SQL Server 下载 | Microsoft

双击下载好的exe文件

选择自定义安装

选择安装位置，默认即可

等待安装过程

安装完成之后，出现这个页面，选择【安装】-【全新 SQL Server 独立安装或向现有安装添加功能】

版本：指定可用版本【Developer】-【下一步】

许可条款：【勾选】-【下一步】

Microsoft 更新：【不勾选】-【下一步】

适用于 SQL Server 的Azure 扩展：【不勾选】-【下一步】

功能选择：勾选【数据库引擎服务】-【下一步】

实例配置：【默认实例】-【下一步】

服务器配置：直接【下一步】

数据库引擎配置：身份验证模式选择【混合模式】-【设置sa账号密码】-【添加当前用户】-【下一步】

准备安装：直接【下一步】

安装进度

安装完成：点击【关闭】

安装 SSMS

下载地址：下载 SQL Server Management Studio （SSMS） | Microsoft Learn

可以直接按下图进入下载地址

运行exe文件进行安装：【选择安装位置】-【安装】

安装进度

安装完成

安装 PBIRS

下载地址：https://www.microsoft.com/zh-cn/download/details.aspx?id=105943&culture=zh-cn&country=cn

选择下载的程序：【PowerBIReportServer.exe]

运行 PowerBIReportServer.exe 文件：【安装 Power BI 报表服务器】

【选择安装版本】-【下一步】

【勾选许可条款】-【下一步】

直接【下一步】

【指定安装位置】-【下一步】

安装进度

安装完成

安装 IIS 证书

:::color4 开启https，需要满足以下条件，：

需要购买证书
服务器导入证书
需要购买域名
需要将域名与服务器的ID地址做域名解析
在 web 服务部署证书

:::

本地下载证书

在本地下载已经授权好的证书，这里使用的是在华为云购买的证书

将下载好的 IIS 证书传到服务器上

服务器上安装证书

在服务器上 Win+R 打开运行，输入mmc

控制台

【文件】-【添加管理单元】

选择【证书】-【添加】

设置证书管理单元：【计算机账户】-【下一步】

选择计算机：【本地计算机】-【下一步】

证书管理单元添加完成：【确定】

在左侧找到【个人】右键选择【所有任务】-【导入】

证书导入向导

选择证书

要选择所有文件，才能在指定文件夹下显示证书

选择 pfx 文件-【打开】

打开txt格式的密钥文件，复制文件内容到密码-【下一步】

证书存储：选择【根据证书类型，自动选择证书存储】-【下一步】

完成导入

导入成功

安装 Visual Studio

:::info 安装 Visual Studio 是为了自定义Form登录，如果不需要修改登录，可以不用安装这个

:::

下载地址：Visual Studio 2022 IDE - 适用于软件开发人员的编程工具

运行VisualStudioSetup.exe准备安装程序

什么都不需要选，直接点【安装】-【继续】

安装进度

安装完成

配置

配置 PBIRS

打开 PBIRS 配置管理

报表服务器连接配置

web 服务 URL：【选择HTTPS 证书】-【应用】

:::color4 如果没有证书，可以不用选择 https 证书，但如果不启用https，就无法实现使用 iframe 嵌入

:::

数据库：【更改数据库连接】

操作：【创建新的报表服务器数据库】-【下一步】

数据库服务器：【直接下一步】

数据库：【直接下一步】

凭据：【直接下一步】

摘要：【直接下一步】

数据库配置完成

web 门户 URL：【应用】，点击url 地址即可访问报表服务器了

服务器访问效果：不需要登录

外网通过ID地址访问，并上传一个pbi文件

:::color4 需要用服务器的账号密码登录

:::

外网采用https访问，并在线预览pbi文件

:::color4 需要用服务器的账号密码登录
注意使用 https 需要先做域名解析

:::

使用 SSMS 连接报表服务器

连接报表服务器

:::color4 如果使用了自定义 form 登录，报表服务器就连不上了

:::

修改报表服务器的CustomHeaders 删掉X-Frame-Options

:::color4 这里很重要，如果这里没有设置，最后面在使用 iframe 嵌套的时候会提示

a frame because it set 'X-Frame-Options' to 'sameorigin

:::

修改前

 
   
    X-Frame-Options 
    (?(?=((?![?]).)*api.*|.*rs:embed=true.*|.*rc:toolbar=false.*)(^((?!(.+)((/api)|(/(.+)(rs:embed=true|rc:toolbar=false)))).*$))|(^(?!(http|https)://([^/]+)((/powerbi.*$)|(.*OpType=Calendar.*))))) 
    SAMEORIGIN 
   
   
    X-Content-Type-Options 
    .*((.js$)|(.css$)|(.html$)) 
  nosniff

修改后

X-Content-Type-Options.*((.js$)|(.css$)|(.html$))nosniff

嵌入

使用 iFrame 嵌入报表

将报表服务器嵌套到内部系统

:::color4 如果需要嵌套，pbi报表名字最好不要用中文，不然嵌套的url 就是这样

https://.../Reports/powerbi/SPC%E5%AE%9E%E9%AA%8C%E9%A1%B9%E7%9B%AE?rs:embed=true

:::

在访问嵌套页面的时候，会有一个登录窗口

登录之后的效果

自定义 Form 登录

:::info 因为Power BI 报表服务器不支持单点登录，为了解决这个登录问题，所以需要自定义 Form 登录

:::

在服务器上先创建一个 PBI 的管理账号

停止PBIRS

下载Form自定义登录demo，源文件在GitHub上，链接：https://github.com/Microsoft/Reporting-Services/tree/master/CustomSecuritySample。

用Visual Studio打开项目文件 CustomSecuritySample.sln 提示需要额外的组件，点击安装

安装组件

安装进度

安装完成之后，在打开项目，修改Logon.aspx代码

<%@ Page Language="C#" CodeBehind="Logon.aspx.cs" AutoEventWireup="false" Inherits="Microsoft.Samples.ReportingServices.CustomSecurity.Logon, Microsoft.Samples.ReportingServices.CustomSecurity" Culture="auto" UICulture="auto" %>



    SQL Server 2016 Reporting Services Samples

修改Logon.axps.cs代码

#region
// Copyright (c) 2016 Microsoft Corporation. All Rights Reserved.
// Licensed under the MIT License (MIT)
/*============================================================================
  File:     Logon.aspx.cs
  Summary:  The code-behind for a logon page that supports Forms
            Authentication in a custom security extension    
--------------------------------------------------------------------
  This file is part of Microsoft SQL Server Code Samples.
    
 This source code is intended only as a supplement to Microsoft
 Development Tools and/or on-line documentation. See these other
 materials for detailed information regarding Microsoft code 
 samples.

 THIS CODE AND INFORMATION ARE PROVIDED "AS IS" WITHOUT WARRANTY OF 
 ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO 
 THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
 PARTICULAR PURPOSE.
===========================================================================*/
#endregion

using System;
using System.Collections;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Web;
using System.Web.SessionState;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.HtmlControls;
using System.Data.SqlClient;
using System.Security.Cryptography;
using System.Web.Security;
using Microsoft.ReportingServices.Interfaces;
using Microsoft.Samples.ReportingServices.CustomSecurity.App_LocalResources;
using System.Globalization;

namespace Microsoft.Samples.ReportingServices.CustomSecurity
{
    public class Logon : System.Web.UI.Page
    {
        protected System.Web.UI.WebControls.Label LblUser;
        protected System.Web.UI.WebControls.TextBox TxtPwd;
        protected System.Web.UI.WebControls.TextBox TxtUser;
        protected System.Web.UI.WebControls.Button BtnRegister;
        protected System.Web.UI.WebControls.Button BtnLogon;
        protected System.Web.UI.WebControls.Label lblMessage;
        protected System.Web.UI.WebControls.Label Label1;
        protected System.Web.UI.WebControls.Label LblPwd;
        // 定义 isIframeRequest 为类级别字段
        private bool isIframeRequest;
        private void Page_Load(object sender, System.EventArgs e)
        {

            var request = HttpContext.Current.Request;
            string referer = request.UrlReferrer?.ToString();
            bool isEmpty = !string.IsNullOrEmpty(referer);
            isIframeRequest = isEmpty && referer.Contains("iframe"); // 判断是否存在关键字，根据实际调整
            if (isEmpty)
            {
                LblUser.Visible = false;
                TxtUser.Visible = false;
                LblPwd.Visible = false;
                TxtPwd.Visible = false;
                BtnRegister.Visible = false;
            }

        }

        #region Web Form Designer generated code
        override protected void OnInit(EventArgs e)
        {
            InitializeComponent();
            base.OnInit(e);
        }

        private void InitializeComponent()
        {
            this.BtnLogon.Click += new System.EventHandler(this.ServerBtnLogon_Click);
            this.BtnRegister.Click += new System.EventHandler(this.BtnRegister_Click);
            this.Load += new System.EventHandler(this.Page_Load);

        }
        #endregion

        [System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1031:DoNotCatchGeneralExceptionTypes")]
        private void BtnRegister_Click(object sender,
          System.EventArgs e)
        {
            string salt = AuthenticationUtilities.CreateSalt(5);
            string passwordHash =
               AuthenticationUtilities.CreatePasswordHash(TxtPwd.Text, salt);
            if (AuthenticationUtilities.ValidateUserName(TxtUser.Text))
            {
                try
                {
                    AuthenticationUtilities.StoreAccountDetails(
                       TxtUser.Text, passwordHash, salt);
                }
                catch (Exception ex)
                {
                    lblMessage.Text = string.Format(CultureInfo.InvariantCulture, ex.Message);
                }
            }
            else
            {

                lblMessage.Text = string.Format(CultureInfo.InvariantCulture,
                    Logon_aspx.UserNameError);
            }
        }

        [System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1031:DoNotCatchGeneralExceptionTypes")]
        private void ServerBtnLogon_Click(object sender, System.EventArgs e)
        {
            if (isIframeRequest)
            {
                // 自定义重定向，使用固定账号登录
                HandleIframeLogin();
            }
            else
            {
                // 默认重定向，使用账号密码登录
                HandleRegularLogin();
            }
        }

        private void HandleIframeLogin()
        {
            // 统一使用默认账号登录
            FormsAuthenticationTicket ticket = new FormsAuthenticationTicket(
                1,                              // 版本号
                "PBI",                          // 用户名
                DateTime.Now,                   // 创建时间
                DateTime.Now.AddMinutes(30),    // 过期时间
                false,                          // 是否持久化
                string.Empty,                   // 用户数据
                FormsAuthentication.FormsCookiePath);

            // 加密票据
            string encryptedTicket = FormsAuthentication.Encrypt(ticket);

            // 创建 Cookie
            HttpCookie authCookie = new HttpCookie(FormsAuthentication.FormsCookieName, encryptedTicket)
            {
                HttpOnly = true,
                Secure = true,                  // 必须通过 HTTPS 传输
                SameSite = SameSiteMode.None    // 设置 SameSite 属性
            };

            // 添加 Cookie 到响应
            Response.Cookies.Add(authCookie);

            // 获取默认的重定向路径
            string defaultRedirectPath = FormsAuthentication.GetRedirectUrl("PBI", false);

            // 在默认路径前加上域名
            string fullRedirectUrl = $"https://pbi.xxx.com{defaultRedirectPath}";

            // 使用完整的 URL 进行重定向
            Response.Redirect(fullRedirectUrl);
        }

        private void HandleRegularLogin()
        {
            bool passwordVerified = false;
            try
            {
                passwordVerified = AuthenticationUtilities.VerifyPassword(TxtUser.Text, TxtPwd.Text);
                if (passwordVerified)
                {
                    FormsAuthentication.RedirectFromLoginPage(TxtUser.Text, false);
                }
                else
                {
                    Response.Redirect("logon.aspx");
                }
            }
            catch (Exception ex)
            {
                lblMessage.Text = string.Format(CultureInfo.InvariantCulture, ex.Message);
                return;
            }

            if (passwordVerified)
            {
                // 用户已认证
                lblMessage.Text = string.Format(CultureInfo.InvariantCulture, Logon_aspx.LoginSuccess);
                BtnRegister.Enabled = false;
            }
            else
            {
                lblMessage.Text = string.Format(CultureInfo.InvariantCulture, Logon_aspx.InvalidUsernamePassword);
            }
        }
    }
}