M3U8高级鉴权改写
更新时间：2025-08-21
概述
开启M3U8鉴权改写功能后，CDN节点将对HLS协议中的M3U8文件进行标准加密改写。该功能在M3U8文件的#EXT-X-KEXT加密标签后增加加密参数（加密算法标识符、密钥URI地址以及身份认证鉴权参数），当客户端接收到被改写的M3U8文件以后，将会使用带鉴权参数的密钥URI来发起请求，从CDN节点获取到密钥以后将会使用对应的加密算法和密钥来解密TS文件。即通过M3U8高级鉴权改写功能，实现对HLS数据访问过程的加密保护。
HLS协议
HLS（HTTP Live Streaming）是苹果公司提出的基于HTTP的流媒体传输协议，其核心机制是将视频流切分为TS（Transport Stream）格式的分片文件，并通过M3U8索引文件实现播放控制。工作流程中三个关键环节：1. 视频编码层按固定时长生成TS分片；2. 服务端同步创建包含TS地址及编解码参数的M3U8动态索引；3. 客户端通过HTTP协议优先获取并解析M3U8文件，依据播放进度按需请求TS分片完成流媒体传输。该架构依托标准HTTP基础设施，实现自适应码率切换与动态内容分发。
HLS基本字段：
- #EXTM3U：M3U8文件头，必须放在第一行。
- #EXT-X-VERSION：M3U8版本号。
- #EXT-X-TARGETDURATION：每个分片TS的最大的时长； #EXT-X-TARGETDURATION:15 ，表示每个分片的最大时长是10秒。
- #EXT-X-KEY：是否加密解析。例如：#EXT-X-KEY:METHOD=AES-128,URI="https://drm.media.baidubce.com/v1/tokenVideoKey?videoKeyId=job-pa2tcenf11x9u56u" 加密算法是AES-128，密钥通过请求 https://drm.media.baidubce.com/v1/tokenVideoKey?videoKeyId=job-pa2tcenf11x9u56u 来获取，密钥请求回来以后存储在本地，并用于解密后续下载的TS视频文件。如果 key 为 "URI"，在value（去掉引号后）后拼接："&token=${token}&open"如果 key 为 "KEYFORMAT"，则可忽略。
- #EXTINF：extra info，分片TS的信息，如时长，带宽等；一般情况下是 #EXTINF:
,[ ] 后面可以跟其他的信息，逗号之前是当前分片的TS时长。分片时长要小于 #EXT-X-TARGETDURATION 定义的值。</li> </ul> <h2 id="技术原理"><a href="#%E6%8A%80%E6%9C%AF%E5%8E%9F%E7%90%86" aria-label="技术原理 permalink" class="anchor"><svg aria-hidden="true" focusable="false" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>技术原理</h2> <p>1.客户端向CDN节点发起对M3U8文件的访问请求，例如："<a href="https://drm.media.baidubce.com/v1/tokenVideoKey?videoKeyId=job-pa2tcenf11x9u56u%22%E3%80%82" target="_blank" rel="nofollow noopener noreferrer">https://drm.media.baidubce.com/v1/tokenVideoKey?videoKeyId=job-pa2tcenf11x9u56u"。</a></p> <p>2.CDN节点对客户端的访问请求进行校验，校验通过。</p> <p>3.CDN节点从源站下载原始M3U8文件，并缓存原始M3U8文件。</p> <p>4.CDN节点对原始M3U8文件的#EXT-X-KEY标签进行改写，增加加密方式、密钥URI和鉴权参数，例如：#EXT-X-KEY:METHOD=AES-128,URI="<a href="https://drm.media.baidubce.com/v1/tokenVideoKey?videoKeyId=job-pa2tcenf11x9u56u%22%E3%80%82" target="_blank" rel="nofollow noopener noreferrer">https://drm.media.baidubce.com/v1/tokenVideoKey?videoKeyId=job-pa2tcenf11x9u56u"。</a></p> <p>5.CDN节点将改写后的M3U8文件返回给客户端。</p> <p>6.客户端解析改写后的M3U8文件，拿到密钥URI地址<a href="https://drm.media.baidubce.com/v1/tokenVideoKey?videoKeyId=job-pa2tcenf11x9u56u%EF%BC%8C%E5%B9%B6%E5%8F%91%E8%B5%B7%E8%AE%BF%E9%97%AE%E8%AF%B7%E6%B1%82%E3%80%82" target="_blank" rel="nofollow noopener noreferrer">https://drm.media.baidubce.com/v1/tokenVideoKey?videoKeyId=job-pa2tcenf11x9u56u，并发起访问请求。</a></p> <p>7.CDN节点收到客户端请求，鉴权通过之后，将key文件返回给客户端。</p> <p>8.客户端继续解析改写后的M3U8文件，从CDN节点下载其中的TS视频文件。</p> <p>9.客户端使用key文件内的密钥和前面#EXT-X-KEY标签内定义的加密算法来解密TS视频文件。</p> <h2 id="操作步骤"><a href="#%E6%93%8D%E4%BD%9C%E6%AD%A5%E9%AA%A4" aria-label="操作步骤 permalink" class="anchor"><svg aria-hidden="true" focusable="false" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>操作步骤</h2> <ol> <li>登录CDN管理控制台，在左侧导航栏，点击域名管理。</li> <li>进入域名管理页面，点击目标域名操作列的管理。</li> <li>进入“CDN域名详情”页，在页面上方导航栏选择访问控制页签。</li> <li>进入访问控制页面，打开M3U8高级鉴权改写开关。</li> </ol> <p><img src="https://bce.bdstatic.com/doc/bce-doc/CDN/jietu-1747642237556_5638192.png" alt="jietu-1747642237556.png"></p> <h2 id="注意事项"><a href="#%E6%B3%A8%E6%84%8F%E4%BA%8B%E9%A1%B9" aria-label="注意事项 permalink" class="anchor"><svg aria-hidden="true" focusable="false" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>注意事项</h2> <ol> <li>请求必须包含 key 为 "baidu-drm-token" 的query</li> <li>响应的前 7个字节 必须为 "#EXTM3U"</li> <li>原始响应（渲染之前） conent-length 必须小于等于 32MB</li> </ol> <h2 id="改写示意"><a href="#%E6%94%B9%E5%86%99%E7%A4%BA%E6%84%8F" aria-label="改写示意 permalink" class="anchor"><svg aria-hidden="true" focusable="false" height="16" version="1.1" viewBox="0 0 16 16" width="16"><path fill-rule="evenodd" d="M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"></path></svg></a>改写示意</h2> <p><strong>请求 </strong></p> <p>GET /some-file.m3u8?baidu-drm-token=097ac58526f073864769cd9d726016010ec0066e1fadba1bcb0e71dbf73cda88_eeb8d4ecb89f4f5f88761b640a2151b4_1704038399_dcedc005-e7ea-4461-81b6-fe616c9b60af</p> <p><strong>原始响应为</strong></p> <p>#EXTM3U</p> <p>#EXT-X-VERSION:3</p> <p>#EXT-X-TARGETDURATION:15</p> <p>#EXT-X-KEY:METHOD=AES-128,URI="<a href="https://drm.media.baidubce.com/v1/tokenVideoKey?videoKeyId=job-pa2tcenf11x9u56u%22,IV=0x84ffcdcfe76b8b6f4f726496fa2550e1,KEYFORMAT=media-drm-token" target="_blank" rel="nofollow noopener noreferrer">https://drm.media.baidubce.com/v1/tokenVideoKey?videoKeyId=job-pa2tcenf11x9u56u",IV=0x84ffcdcfe76b8b6f4f726496fa2550e1,KEYFORMAT=media-drm-token</a></p> <p>#EXTINF:14.280000, index.m3u8.0.ts</p> <p>#EXT-X-KEY:METHOD=AES-128,URI="<a href="https://drm.media.baidubce.com/v1/tokenVideoKey?videoKeyId=job-pa2tcenf11x9u56u%22,IV=0x84ffcdcfe76b8b6f4f726496fa2550e1,KEYFORMAT=media-drm-token" target="_blank" rel="nofollow noopener noreferrer">https://drm.media.baidubce.com/v1/tokenVideoKey?videoKeyId=job-pa2tcenf11x9u56u",IV=0x84ffcdcfe76b8b6f4f726496fa2550e1,KEYFORMAT=media-drm-token</a></p> <p>#EXTINF:9.280000, index.m3u8.1.ts</p> <p><strong>改写后的响应为</strong></p> <p>#EXTM3U</p> <p>#EXT-X-VERSION:3</p> <p>#EXT-X-TARGETDURATION:15 #EXT-X-KEY:METHOD=AES-128,URI="<a href="https://drm.media.baidubce.com/v1/tokenVideoKey?videoKeyId=job-pa2tcenf11x9u56u&token=097ac58526f073864769cd9d726016010ec0066e1fadba1bcb0e71dbf73cda88_eeb8d4ecb89f4f5f88761b640a2151b4_1704038399_dcedc005-e7ea-4461-81b6-fe616c9b60af&open%22,IV=0x84ffcdcfe76b8b6f4f726496fa2550e1" target="_blank" rel="nofollow noopener noreferrer">https://drm.media.baidubce.com/v1/tokenVideoKey?videoKeyId=job-pa2tcenf11x9u56u&token=097ac58526f073864769cd9d726016010ec0066e1fadba1bcb0e71dbf73cda88_eeb8d4ecb89f4f5f88761b640a2151b4_1704038399_dcedc005-e7ea-4461-81b6-fe616c9b60af&open",IV=0x84ffcdcfe76b8b6f4f726496fa2550e1</a></p> <p>#EXTINF:14.280000, index.m3u8.0.ts</p> <p>#EXT-X-KEY:METHOD=AES-128,URI="<a href="https://drm.media.baidubce.com/v1/tokenVideoKey?videoKeyId=job-pa2tcenf11x9u56u&token=097ac58526f073864769cd9d726016010ec0066e1fadba1bcb0e71dbf73cda88_eeb8d4ecb89f4f5f88761b640a2151b4_1704038399_dcedc005-e7ea-4461-81b6-fe616c9b60af&open%22,IV=0x84ffcdcfe76b8b6f4f726496fa2550e1" target="_blank" rel="nofollow noopener noreferrer">https://drm.media.baidubce.com/v1/tokenVideoKey?videoKeyId=job-pa2tcenf11x9u56u&token=097ac58526f073864769cd9d726016010ec0066e1fadba1bcb0e71dbf73cda88_eeb8d4ecb89f4f5f88761b640a2151b4_1704038399_dcedc005-e7ea-4461-81b6-fe616c9b60af&open",IV=0x84ffcdcfe76b8b6f4f726496fa2550e1</a></p> <p>#EXTINF:9.280000, index.m3u8.1.ts</p></div><div id="post__special-keyword-modal" class="post__special-keyword-modal" style="left:0;top:0;display:none"><p class="post__keyword-content"></p><p><a class="post__keyword-jump" target="_blank" rel="norefrence" data-track-category="CDN文档详情页"></a></p><span class="post__keyword-bar"></span></div><div class="image-viewer hide"><div class="close-button"><svg viewBox="0 0 40 40"><path d="M10,10 L30,30 M30,10 L10,30"></path></svg></div><img src="" style="left:0px;top:0px;width:0;height:0;max-width:0;max-heigth:0"/></div></div><div class="post-turner-wrapper"><a class="post-turner post-turner--prev" href="/zh/doc/CDN/s/ujwvyeo0t-intl"><div class="post-turner__desc">上一篇</div><div class="post-turner__link">高级鉴权</div></a><a class="post-turner post-turner--next" href="/zh/doc/CDN/s/Ukvvrucns-intl"><div class="post-turner__desc">下一篇</div><div class="post-turner__link">远程鉴权</div></a></div></div></div></div><div class="doc-scroll-top"><svg width="1em" height="1em" viewBox="0 0 20 20" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"><g stroke="none" stroke-width="1" fill="none" fill-rule="evenodd"><g transform="translate(-1749, -808)"><g transform="translate(1734, 793)"><g transform="translate(15, 15)"><rect x="0" y="0" width="20" height="20"></rect><g transform="translate(4.5, 2)" stroke="currentColor" stroke-linecap="round" stroke-width="1.4"><line x1="5.50380417" y1="3.7701157" x2="5.50380417" y2="16"></line><polyline stroke-linejoin="round" points="0 8.98627675 5.5 3.72601719 11 8.98627675"></polyline><line x1="0" y1="0.219177482" x2="11" y2="0.219177482"></line></g></g></g></g></g></svg></div></div></div></div><script id="gatsby-script-loader">/*<![CDATA[*/window.pagePath="/0maur5g9o-intl";/*]]>*/</script><script id="gatsby-chunk-mapping">/*<![CDATA[*/window.___chunkMapping={"app":["/app-03890e73393922e852da.js"],"component---src-templates-acg-portal-intl-template-tsx":["/component---src-templates-acg-portal-intl-template-tsx-dd78c0eb828598cad2b6.js"],"component---src-pages-index-js":["/component---src-pages-index-js-e8810f5fe9f88bb5de67.js"]};/*]]>*/</script><script src="https://bce.bdstatic.com/p3m/bce-doc-zh/online/CDN/zh/doc/CDN/s/webpack-runtime-b4c539dff9bee7f07c07.js" async=""></script><script src="https://bce.bdstatic.com/p3m/bce-doc-zh/online/CDN/zh/doc/CDN/s/app-03890e73393922e852da.js" async=""></script><script src="https://bce.bdstatic.com/p3m/bce-doc-zh/online/CDN/zh/doc/CDN/s/styles-35735d9c21ee340f90a7.js" async=""></script><script src="https://bce.bdstatic.com/p3m/bce-doc-zh/online/CDN/zh/doc/CDN/s/commons-906549efb7b88d28b701.js" async=""></script><script src="https://bce.bdstatic.com/p3m/bce-doc-zh/online/CDN/zh/doc/CDN/s/component---src-templates-acg-portal-intl-template-tsx-dd78c0eb828598cad2b6.js" async=""></script></body></html>