文档中心

全栈可观测平台

自定义看板

自定义看板内嵌

全栈可观测平台支持将自定义看板内嵌至外部系统的自建 Web 页面，您可以在外部系统中免密登录自定义看板并进行相关操作。本文介绍如何将自定义看板嵌入到外部系统。

背景信息

控制台内嵌功能基于安全令牌服务 STS 实现自定义身份代理，您可向 IAM 用户授予相关数据和页面的访问权限，并以该用户身份通过 STS 服务生成临时访问凭证和临时登录 Token。访问内嵌的自定义看板页面时，系统将通过 URL 中封装的临时登录 Token 进行鉴权，实现免密登录。

操作步骤

步骤一：创建 IAM 角色并授予权限

IAM 角色是一种虚拟用户，无永久访问凭证。本步骤基于账号为例，其他创建方式请参考角色管理。后续您可通过 IAM 角色将账号内的特定访问权限授予受信任的用户，该用户获得授权后可扮演该角色，从而访问账号内的资源。

通过主账号登录访问控制 IAM 控制台。

在左侧导航栏中选择角色管理。

单击新建角色，配置选择信任身份类型为账号，选择身份为当前账号，然后单击下一步。

配置角色信息，完成后单击下一步。

选择包含 APMPlusServerReadOnlyAccess 的权限策略，单击提交。

说明

本步骤需为 IAM 角色授予系统默认权限 APMPlusServerReadOnlyAccess 。授权后，该 IAM 角色具备所有 APMPlus 资源和页面的只读访问权限。您也可以根据业务需求，创建自定义权限策略。具体步骤请参见配置 IAM 权限。

返回角色列表，单击创建完成的角色名称，前往角色详情页查看并记录“角色 TRN”信息。

步骤二：创建 IAM 用户

IAM 用户是一种实体身份类型，拥有确定的身份 ID 和身份凭证、独立的登录密码和访问密钥。该用户用于扮演步骤一中创建的 IAM 角色，从而获取临时安全令牌。本步骤以通过用户名创建为例，其他创建方式请参考用户管理。

在左侧导航栏中，选择用户管理 > 用户。

单击新建用户，选择通过用户名创建。

配置用户名，并在登录设置中勾选编程访问。然后单击下一步。

在权限设置步骤，单击下一步。

在审阅步骤，确认用户名信息，单击提交。

步骤三：授予 IAM 用户扮演 IAM 角色的权限

完成此授权后，IAM 用户才能扮演 IAM 角色去获取 IAM 角色的临时安全令牌，并访问 IAM 角色权限范围内的资源。

此环节的授权包括以下两部分，均为必选设置。

为 IAM 角色设置信任策略。

创建 IAM 角色时，默认的可信实体为火山引擎账号，您需要修改 IAM 角色的信任策略，将 Principal 中的账号配置修改为您在步骤二中创建的 IAM 用户，表示该 IAM 角色可以被指定的 IAM 用户扮演。

为 IAM 用户授予 STSAssumeRoleAccess 权限策略。

为 IAM 用户授予 STSAssumeRoleAccess 权限策略后，您才能使用 IAM 用户的访问密钥调用 AssumeRole 接口申请临时安全令牌。

修改 IAM 角色的信任策略

在左侧导航栏中，选择角色管理。

在角色列表中，单击步骤一中创建角色的名称，进入角色详情页面。

选择信任关系页签，单击编辑信任策略。修改信任策略中的 IAM 字段，并单击保存。

将 trn 中默认指定的 root 改为 user/${IAMUserName}，例如 user/user-demo。以下述信任策略为例，该策略表示此 IAM 角色可以被火山引擎账号 21000**** 下的 IAM 用户 user-demo 扮演。

{
"Statement": [
{
"Effect": "Allow",
"Action": [
"sts:AssumeRole"
],
"Principal": {
"IAM": [
"trn:iam::21000****:user/user-demo"
]
}
}
]
}

为 IAM 用户授予 STSAssumeRoleAccess 权限

在左侧导航栏中，选择用户管理 > 用户。

在用户列表中，单击步骤二中创建用户的名称，进入用户详情页面。

选择权限页签，单击添加权限。

在权限列表中，选择STSAssumeRoleAccess权限，单击提交。

步骤四：调用 AssumeRole 获取临时安全令牌

注意

AssumeRole 接口不支持通过火山引擎账号调用，请使用 IAM 子用户调用。

IAM 用户将通过扮演 IAM 角色来调用安全令牌服务的 AssumeRole 接口，并获取 IAM 角色的临时安全令牌。临时安全令牌包括临时访问密钥（AccessKeyId、SecretAccessKey）和临时登录 Token（SessionToken）。

请求示例如下，其中参数 RoleTrn 应指定为步骤一创建的 IAM 角色的 TRN。

返回结果示例如下，其中AccessKeyId、SecretAccessKey和SessionToken 为临时安全令牌。

步骤五：获取登录 Token

调用 STS 的接口 getSigninTokenWithSTS 获取登录 Token，请求中需要传入步骤四中获取的临时安全令牌。

注意

通过登录 Token 完成一次登录后，登录 Token 随即失效，如果您刷新页面，则需要重新请求获取登录 Token。

请求示例如下：

请求参数说明如下：

参数	说明
accessKeyId	步骤四中通过 AssumeRole 获取的临时 AccessKeyId。
secretAccessKey	步骤四中通过 AssumeRole 获取的临时 SecretAccessKey。
sessionToken	步骤四中通过 AssumeRole 获取的临时 SessionToken。
sessionDuration	登录态的持续时长，超期后需要重新登录。单位为秒，取值为 900~43200。

返回结果如下，其中 SigninToken 字段即为登录使用的 Token。

步骤六：获取自定义看板的 dashboard_id

登录全栈可观测平台控制台，在左侧导航栏选择自定义看板。

单击目标自定义看板名称前往详情页面，浏览器地址栏 URL 中的看板 ID 段即为 dashboard_id。

步骤七：构建内嵌 URL

内嵌 URL 由嵌入域名、嵌入 Path 与嵌入 Query 参数拼接构成，请根据实际业务参数完成拼接。

嵌入域名

嵌入 Path

其中参数 dashboard_id 应指定为步骤六获取的自定义看板的 dashboard_id。

嵌入 Query 参数

可通过在 URL 中设置 Query 参数以控制内嵌页面的初始状态与筛选行为，参数说明及示例如下：

参数名	说明	示例
var-{变量名}	筛选项变量的初始值，{变量名} 需与看板配置中的变量名称保持一致。	?var-clusterId=1234&var-node=1.2.3.4?var-region=cn-beijing
hide_variables	需要隐藏的筛选项变量名。隐藏后仅界面不展示，筛选项的初始值仍然生效。	?hide_variables=ClusterId&hide_variables=Node
from、to	初始时间范围。支持毫秒级时间戳与相对时间表达式。	?from=1720000000000&to=1720003600000?from=now-1h&to=now
hiddenNavbarInFrame	控制是否隐藏火山引擎官方顶部导航栏。	?hiddenNavbarInFrame=true
skip_missing_value_fallback_variables	指定需要跳过变量值不存在时自动回退逻辑的变量名。建议与 hide_variables 保持一致，避免变量取值缺失时被系统自动改写。	?skip_missing_value_fallback_variables=ClusterId&skip_missing_value_fallback_variables=Node

嵌入完整 URL

内嵌 URL 为免密访问链接。其中 redirectURI 为目标自定义看板的内嵌页面地址，由嵌入域名、嵌入 Path 与嵌入 Query 参数拼接而成：

步骤八：在外部系统中嵌套页面

支持以 iFrame 方式将自定义看板嵌入到第三方自建 Web 页面中。其中 target_url 为步骤七中构建的完整 URL：

结果验证

使用步骤七构建的免密访问链接，可以正确访问目标自定义看板：

代码示例

以下提供完整的接口调用代码示例，包括获取临时安全令牌、获取登录 Token 和构建内嵌 URL。代码可直接复制使用，按实际业务参数替换占位变量即可。

Node.js

Python

最近更新时间：2026.07.22 16:08:36

这个页面对您有帮助吗？

有用

无用