Token发布
使用 Token 发布大屏
使用 Token 发布大屏,将可视化大屏的访问权限与您的权限体系进行集成。
开启 Token 验证并获取 SecretKey
在大屏发布时选择 Token 发布,此时您将获得该大屏的访问 URL 和 SecretKey。
您应当谨慎保管 SecretKey。
生成 Token 并拼接成完整 URL
EasyV 使用标准的 JSON Web Token 进行验证。
通过以下步骤可生成受 Token 验证防护的大屏 URL:
设置 Payload
Payload 中支持以下添加以下字段:
名称 | 类型 | 描述 | 是否必填 |
exp | number | URL 过期时间(时间戳)。若当前时间超出过期时间,则大屏不允许访问。EasyV 支持的最长过期时长为 24 小时。请确保您的服务器时间为东 8 区标准时间。 | 必填 |
limit | number | URL 允许的访问次数。若 URL 访问次数超过 limit 值,则大屏不允许访问。不填则不限制 URL 访问次数。 | 选填 |
使用 SecretKey 进行签名
使用 HMAC-SHA256 base64 对上一步中设置的 payload 进行签名,生成 JSON Web Token。
拼接 URL
将上一步生成的 Token 拼接到预览链接中。
在 URL 中添加 query 参数: _easyv_token=YourUniqueToken
示例代码:
Python
安装 jwt 依赖库:
pip install PyJWT
主要代码如下:
import jwt import time secretKey = 'YourSecretKey' baseShareUrl = 'https://easyv.dtstack.com/workspace/shareScreen/yourSreenId' payload = { "limit": 1, # 只允许访问一次 "exp": int(time.time()) + 30 * 60 # 30分钟过期 } token = jwt.encode(payload, secretKey, algorithm="HS256") URL = baseShareUrl + '?_easyv_token=' + token print("大屏链接: ", URL)
Java
配置 maven:
<dependency> <groupId>com.auth0</groupId> <artifactId>java-jwt</artifactId> <version>3.17.0</version> </dependency>
主要代码如下:
import com.auth0.jwt.JWT; import com.auth0.jwt.algorithms.Algorithm; import com.auth0.jwt.exceptions.JWTCreationException; import java.util.Date; public class Main { public static void main(String[] args) { String baseShareUrl = "https://easyv.dtstack.com/workspace/shareScreen/yourSreenId"; try { Algorithm algorithm = Algorithm.HMAC256("YourSecretKey"); String token = JWT.create() .withExpiresAt(new Date(System.currentTimeMillis() + 60 * 1000)) // 60秒后过期 .withClaim("limit", 1) // 限制使用1次 .sign(algorithm); String url = baseShareUrl + "?_easyv_token=" + token; System.out.println("大屏链接: " + url); } catch (JWTCreationException exception) { exception.printStackTrace(); } } }
Node.js
安装 jwt 依赖库:
npm install jsonwebtoken
主要代码如下:
const jwt = require('jsonwebtoken'); const secretKey = 'YourSecretKey'; const baseShareUrl = 'https://easyv.dtstack.com/workspace/shareScreen/yourSreenId'; const limit = 1; //只允许访问一次 const token = jwt.sign({ limit }, secretKey, { algorithm: 'HS256', expiresIn: '1h' }); const URL = `${baseShareUrl}?_easyv_token=${token}`; console.log('大屏链接: ', URL);
Go
安装 jwt 依赖库:
go get github.com/dgrijalva/jwt-go
主要代码如下:
package main import ( "github.com/dgrijalva/jwt-go" "time" ) const secretKey = `YourSecretKey` const baseShareUrl = `https://easyv.dtstack.com/workspace/shareScreen/yourSreenId` func main() { tokenMaker := jwt.New(jwt.GetSigningMethod("HS256")) tokenMaker.Claims = jwt.MapClaims{ "limit": 1, // 限制 URL 只允许访问一次 "exp": time.Now().Add(time.Hour * 2).Unix(), // 设置过期时间为 2 小时 } token, _ := tokenMaker.SignedString([]byte(secretKey)) url := baseShareUrl + `?_easyv_token=` + token print("大屏链接:", url) }