大屏监控 Metabase 集成到 C# 项目

集成 Metabase 的方法与实践

随着数据驱动决策的普遍性，数据可视化平台如 Metabase 变得越来越重要。Metabase 是一个开源的商业智能工具，可以轻松地帮助用户分析和可视化数据。本文将详细介绍如何在 C# 项目中集成 Metabase，并提供详细的代码示例。

集成概述

Metabase 比较适合的场景包括：

1、基于SSO的完整集成（支持下钻），在打开报表时完成用户在主系统跟报表系统的单点登录，需付费实现JWT集成；

2、按照静态嵌入方式，实现基于密钥的集成，此方案较公开分享方式更加安全，但由于未实现单点登录，无法使用下钻功能。

通常，嵌入是通过在您的网站中iframe内显示Metabase URL来实现的。**静态嵌入**（或签名嵌入）是一个使用签名JSON Web Token (JWT) 进行保护的Metabase URL的iframe。只有当请求提供在您的应用程序和Metabase之间共享的密钥进行签名的JWT时，Metabase才会加载URL。JWT还包含一个资源引用，例如仪表板ID，以及任何锁定参数的值。

您不能将静态嵌入与行和列安全、钻取一起使用，并且由于签名JWT不会创建用户会话（服务器端会话），因此用户特定数据不会捕获在使用情况分析中。有关这些功能，请参阅嵌入式分析JS。

但是，您可以通过锁定参数来限制特定人员或群组的静态嵌入数据。

集成代码

 以下是针对embed封装的console代码，需要添加Newtonsoft.Json、System.IdentityModel.Tokens.Jwt两个Nuget包。

using System;
using System.IdentityModel.Tokens.Jwt;
using System.Security.Claims;
using System.Text;
using Microsoft.IdentityModel.Tokens;
using Newtonsoft.Json.Linq;

class JwtGenerator
{
    private const string MetabaseSiteUrl = "http://127.0.0.1:8080";
    private const string MetabaseSecretKey = "15c2ed06f625d42a24369ba7840ee77da5891d853c654787af998de41ec0f10b";

    static void Main(string[] args)
    {
        int dashboardId = 1;
        try
        {
            Console.WriteLine(GenerateDashboardUrl(dashboardId));
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.ToString());
        }
    }

    public static string GenerateDashboardUrl(int dashboardId)
    {
        // 生成HMAC-SHA256密钥
        var keyBytes = Encoding.UTF8.GetBytes(MetabaseSecretKey);
        var securityKey = new SymmetricSecurityKey(keyBytes);
        var signingCredentials = new SigningCredentials(securityKey, SecurityAlgorithms.HmacSha256);

        // 构建JWT声明
        var claims = new[]
        {
            // 嵌套resource声明（转换为JSON对象）
            new Claim("resource",
                JObject.FromObject(new { dashboard = dashboardId }).ToString(),
                JsonClaimValueTypes.Json),
            // 空参数声明
            new Claim("params", "{}", JsonClaimValueTypes.Json)
        };

        // 配置Token参数
        var tokenDescriptor = new JwtSecurityToken(
            claims: claims,
            expires: DateTime.UtcNow.AddMinutes(60), // 60分钟有效期，可按需调整
            signingCredentials: signingCredentials
        );

        // 生成Token字符串
        var tokenHandler = new JwtSecurityTokenHandler();
        string token = tokenHandler.WriteToken(tokenDescriptor);

        // 拼接Metabase嵌入式URL
        return $"{MetabaseSiteUrl}/embed/dashboard/{token}?bordered=true&titled=false";
    }
}