DRM-X 6.0 鸽子和橄榄枝标志DRM-X 6.0文档
◎ 简体中文

创建服务器集成凭据

获取接入所需的 Environment ID、Site Key、Access Key 和 Content ID。凭据应保存在可信的后端服务器上。

查看 Markdown在线示例更新于 2026-10-21

在 DRM-X Web Player 中确认 Published 内容可以播放后,再创建这些凭据。它们允许您的后端为已获授权的观众请求播放,不能替代网站登录或打包加密配置。

创建播放 API 客户端#

  1. 选择环境。登录 DRM-X Console,选择包含 Published 内容的开发环境。
  2. 创建客户端。打开集成,为网站后端创建播放 API 客户端。仅授予 license-tokens:create 权限。
  3. 复制服务端配置值。将 Site ID、Site Key 和仅显示一次的 Access Key 保存在受保护的服务器配置中。Site ID 用于标识环境。从 Published 受保护文件中复制 Content ID。
  4. 配置并测试示例。使用适合您后端的套件。替换下方占位值,以及示例的登录和观看权限检查。确认有权限的观众能够播放,无权限的观众会被拒绝。
账户设置

获取快速入门所需的四项配置#

在 Console → Integrations 中创建用于播放的 API client,仅授予 license-tokens:create 权限。然后打开 Console → Package content,从状态为 Published 的加密内容中获取 Content ID。

找到集成所需的配置值

从 DRM-X Console 复制这些值。凭据应保留在服务器端。

  1. Environment ID / Site ID

    选择已发布视频所属的环境。

  2. Site Key / 客户端 ID

    复制播放 API 客户端的标识。

  3. Access Key

    首次显示时妥善保存此密钥,不要发送到浏览器。

  4. Content ID

    复制状态为 Published 的视频的 Content ID。

Access Keys 必须保存在服务器端。

直接在 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 TokenPackager 保存的配置或受保护的自动化环境
授权观众播放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。