创建服务器集成凭据
获取接入所需的 Environment ID、Site Key、Access Key 和 Content ID。凭据应保存在可信的后端服务器上。
在 DRM-X Web Player 中确认 Published 内容可以播放后,再创建这些凭据。它们允许您的后端为已获授权的观众请求播放,不能替代网站登录或打包加密配置。
创建播放 API 客户端#
获取快速入门所需的四项配置#
在 Console → Integrations 中创建用于播放的 API client,仅授予 license-tokens:create 权限。然后打开 Console → Package content,从状态为 Published 的加密内容中获取 Content ID。
找到集成所需的配置值
从 DRM-X Console 复制这些值。凭据应保留在服务器端。
- Environment ID / Site ID
选择已发布视频所属的环境。
- Site Key / 客户端 ID
复制播放 API 客户端的标识。
- Access Key
首次显示时妥善保存此密钥,不要发送到浏览器。
- Content ID
复制状态为 Published 的视频的 Content ID。
直接在 PHP 服务端代码中配置
return [
'platformApi' => 'https://api6.drm-x.com',
'siteId' => 'your-development-environment-uuid',
'siteKey' => 'drmx_your_environment_scoped_client_id',
'accessKey' => 'paste-your-one-time-access-key',
'applicationId' => 'customer-php-website',
'content' => [
'id' => 'your-published-content-id',
'title' => 'Your protected title',
'type' => 'vod',
],
'licensePolicyTemplate' => 'multi-tier-standard',
'licensePolicy' => null,
'licenseDeliveryMode' => 'direct-token',
];
下载的快速入门示例无需设置环境变量即可运行。示例注释中还提供了适用于正式部署的配置方式,可通过环境变量或安全凭据存储注入配置。
不要将这些凭据随客户端发布不要将 Site Key 或 Access Key 写入 HTML、JavaScript、APK、IPA、应用资源、移动应用的 CI 变量、URL、日志、分析数据或可下载的配置文件。
为每个应用或后端服务创建独立的 API client。这样,更换或撤销某项凭据时,不会影响其他接入。
区分打包加密凭据与播放凭据#
| 用途 | 配置值 | 使用位置 |
|---|---|---|
| 打包加密并发布 | Site ID, Packager Access Key, Packager KMS Token | Packager 保存的配置或受保护的自动化环境 |
| 授权观众播放 | Site ID, Site Key, Access Key | 仅限您经过身份验证的后端 |
| 播放一个已授权项目 | 短期有效的 DRM License Token 和 Contract v1 | 播放器,通过返回的受限路由访问 |
Packager KMS Token 不能替代播放 Access Key。观众的 DRM License Token 不能用于发布内容。集成时使用开发环境凭据,并将生产环境凭据单独管理。轮换或撤销已泄露的凭据,并更新受影响的应用。
先在已登录的 Web Player 中验证 Published Content ID,然后在后端套件中配置同一环境和可信的 Content ID。
DRM-X 6.0