将链路追踪控制台页面嵌入自建Web应用

教程概述

预期结果

参照本教程的方法进行实际操作后将实现以下效果：

• 可登录您的自有系统并浏览嵌入的应用列表、应用详情、调用查询等页面。
• 可隐藏链路追踪页面的顶部导航栏和左侧导航栏。
• 可通过访问控制RAM系统控制操作权限，例如将完整权限改为只读权限等。

访问流程

使用本教程所述方法访问链路追踪页面的流程如图所示。

准备工作：创建RAM用户并添加权限

首先使用阿里云账号创建RAM用户并为其添加调用STS服务扮演RAM角色的权限。

1. 登录RAM控制台，在左侧导航栏中选择人员管理 > 用户，并在用户页面上单击新建用户。
2. 在新建用户页面的用户账号信息区域框中，输入登录名称和显示名称。在访问方式区域框中，勾选编程访问，并单击确认。

   

   注意 RAM会自动为RAM用户创建AccessKey（API访问密钥）。出于安全考虑，RAM控制台只提供一次查看或下载AccessKeySecret的机会，即创建AccessKey时，因此请务必将AccessKeySecret记录到安全的地方。
3. 在手机验证对话框中单击获取验证码，并输入收到的手机验证码，然后单击确定。 创建的RAM用户显示在用户页面上，但此时没有任何权限。
4. 在用户页面上找到创建好的用户，单击操作列中的添加权限。
5. 在添加权限面板的选择权限区域框中，通过关键字搜索需要添加的权限策略AliyunSTSAssumeRoleAccess，并单击权限策略将其添加至右侧的已选择列表中，然后单击确定。

   

6. 在添加权限的授权结果页面上，查看授权信息摘要，并单击完成。

准备工作：创建RAM角色并添加权限

接下来创建RAM角色并为其添加访问链路追踪控制台的权限。上一步创建的RAM用户将会扮演该RAM角色访问链路追踪控制台。

1. 登录RAM控制台，在左侧导航栏中单击RAM角色管理，并在RAM角色管理页面上单击新建RAM角色。
2. 在新建RAM角色面板中执行以下操作并单击确定。
   1. 在选择类型页面的当前可信实体类型区域框中选择阿里云账号，并单击下一步。
   2. 在配置角色页面的角色名称文本框内输入RAM角色名称，并单击完成。
   3. 在创建完成页面上单击为角色授权。
3. 在添加权限面板的选择权限区域框中，通过关键字搜索需要添加的权限策略，并单击权限策略将其添加至右侧的已选择列表中，然后单击确定。

   

   • 如需添加链路追踪的完整权限，则添加AliyunTracingAnalysisFullAccess。
   • 如需添加链路追踪的只读权限，则添加AliyunTracingAnalysisReadOnlyAccess。
4. 在添加权限面板的授权结果页面上，查看授权信息摘要，并单击完成。

步骤一：获取临时AccessKey和Token

登录自建Web后，在Web服务端调用STS AssumeRole接口获取临时AccessKey和Token，即临时身份。请选择一种方式调用该接口：

• 通过OpenAPI在线调用。
• 通过Java示例调用。

请注意，在示例代码中，您首先需要将以下参数替换为真实的值。

String akId = "<accessKeyId>";
String ak = "<accessKeySecret>";
String roleArn = "<roleArn>";

其中，<accessKeyId>和<accessKeySecret>是准备工作中创建的RAM用户的AccessKeyId和AccessKeySecret。

<roleArn>是准备工作中创建的RAM角色的标识ARN，可在RAM控制台的RAM角色基本信息页面获取。

步骤二：获取登录Token

http://signin4service.aliyun.com/federation?Action=GetSigninToken
    &AccessKeyId=<STS返回的临时AccessKeyId>
    &AccessKeySecret=<STS返回的临时AccessKeySecret>
    &SecurityToken=<STS返回的安全Token>
    &TicketType=mini

步骤三：生成免登录链接

1. 在链路追踪控制台获取待嵌入的控制台页面链接。例如杭州地域的应用列表页面的链接为：

   https://tracing-analysis.console.aliyun.com/?hideTopbar=true&hideSidebar=true#/appList/cn-hangzhou

   说明 将hideTopbar设为true表示隐藏顶部导航栏，将hideSidebar设为true表示隐藏左侧导航栏。
2. 利用步骤二中获取到的登录Token与链路追踪控制台页面链接生成免登录访问链接。 请求样例：

   http://signin.aliyun.com/federation?Action=Login
       &LoginUrl=<登录失效跳转的地址，一般配置为自建Web配置302跳转的URL>
       &Destination=<链路追踪控制台页面链接>
       &SigninToken=<获取到的登录Token>