OBS 预签名链接打不开:先按这个顺序排,别先改桶策略
OBS 预签名链接打不开:先按这个顺序排,别先改桶策略
10 月 27 日我在论坛答过一帖:桶不想公开读,就用预签名 URL 临时授权下载,桶保持私有,链接到期失效。帖子底下后来有人追问的其实是另一回事——链接签出来了,点开却是 403。预签名 URL 的 403 特别容易让人走偏,第一反应是去改桶策略、改 CORS,改了一圈发现链接还是 403,因为问题根本不在桶策略那一层。签出来的链接能不能打开,取决于签的时候那几个字段和用的时候那几个字段是不是同一套。按下面这个顺序排,大部分 403 在前三步就定位了。
先看报错原文,403 后面跟的那串码才是线索
OBS 返回的 403 不是一句话,body 里一般带着错误码和一段说明。先把 body 原文贴出来看,别只看浏览器地址栏的 403。
SignatureDoesNotMatch:签名算出来对不上。用的时候传的字段和签的时候不一致,这是最常见的,下面几节全是它的变种。AccessDenied:签名验过了,但签发用的 AK 没有这个对象的读权限,或者桶策略显式拒绝了。先查 AK 的权限,别动签名代码。RequestTimeTooSkewed:请求时间与服务端时间差超过允许值,时钟问题,见最后一节。- 链接直接过期:
ExpiredToken或提示过期,说明有效期给短了,或者签发机器的时钟本来就偏了,见有效期那一节。
先分清是哪一类,再动手。签名不对就去对字段,权限不够就去查 AK,混在一起改,改对了也不知道是哪一下起的作用。
第一步:方法、对象名、有效期,签什么用什么
预签名 URL 锁死三样东西,改一样就验签失败。
方法锁死:签的是 GET,下载就只能 GET。有人签完 GET,下载工具却先发一个 HEAD 去探文件大小,HEAD 不在签名里,直接 403。浏览器直接点链接一般是 GET,但加上下载器、加上某些会预检的客户端,方法就可能变了。先确认实际发出去的方法和签的方法一致。
对象名锁死:签的是 internal/report.pdf,实际请求就必须是同一个 key,多一个斜杠、少一个斜杠都不行。对象名里有中文、空格、+ 号这类字符时尤其容易出事:签的时候编了一次码,传的时候浏览器或 SDK 又编了一次,服务端解出来就不是签的那个 key 了。排查办法是把签发时用的原始 key 和实际请求 URL 里解码后的 key 并排贴出来,逐字符对。中文对象名先用英文 key 复现一遍,能打开就说明问题在编码这一层,不在权限。
有效期按秒算,1 秒到 7 天(604800 秒)。临时给合作方下载,3600 秒(1 小时)一般够用。有效期是从签发时刻开始算,不是从对方点开链接开始算——签完放了两小时才发出去,1 小时的链接发出去就是过期的。签发动作要放在对方点「下载」的那一刻由后端现场签,不要提前批量签好存着。
第二步:请求头里多带的东西,签的时候有没有
这是最隐蔽的一类。签名算的是签发时声明的那套请求要素,实际请求多带一个签过的头、少带一个签过的头,都会对不上。
典型的是 Content-Type。上传场景(PUT 签名)里,签的时候声明了 Content-Type: application/pdf,实际上传时客户端没带这个头,或者带成了 application/octet-stream,签名就失效。反过来也一样:签的时候没声明,上传时浏览器自动补了一个,照样失效。做法是签发和上传两边把头对齐,写死同一份,不确定的头就不要放进签名。
还有一类是网关、CDN 或下载工具在中间改写了请求:加了 Range 头做断点续传、改了 Host、把查询参数重新排序或又编了一次码。直连 OBS 源站能打开、走 CDN 就 403,先怀疑这一层:拿直连链接和 CDN 链接的实际请求报文对比,看哪个字段被改了。定位到改写方之前,不要先去轮换 AK,那是兜底手段,不是排查手段。
第三步:AK 的权限和状态,签名验过之后才轮到它
签名验过了、方法对象都对了,还 403,就查签发用的那把 AK。
先查三件事:这把 AK 是不是还在用,有没有被停用或删除;它对应的 IAM 用户有没有这个桶这个对象的读权限(obs:object:GetObject);桶策略里有没有显式拒绝(Deny 优先于 Allow,IAM 给了读权限也白搭)。10 月 27 日那帖里我写过一条纪律:别拿主账号的 AK/SK 签,单独建一个 IAM 用户,只给这一个桶的读权限,再用它的 AK/SK 签。这条纪律在这里还有个排查上的好处——权限面小,查起来快;拿主账号签,出问题要排的面就大得多。
如果怀疑 AK 本身也漏了,轮换是兜底:把签发那把 AK 换掉,用它签过的所有链接全部失效。代价是所有在用的链接一起断,所以只在确认泄露时用,不要把它当成常规排查步骤。
第四步:区域和 endpoint,签发和访问要在同一套
AK/SK 本身不分区,但签名里隐含了 endpoint。签发时用的 endpoint 是 obs.cn-north-4.myhuaweicloud.com,实际访问却走了另一个区域的域名,或者反过来,签名就对不上。SDK 初始化时 endpoint、区域、桶名三处要和签发时一致,跨区域复制过去的桶、换了区域的域名,都要重新签。
命令行临时验证时,obsutil 的 sign 和实际下载走同一套 endpoint 配置,别签发用一套配置、下载用另一套。正式用走后端 SDK,endpoint 和 AK/SK 从环境变量读,不要写死在代码里发给对方:
res = obs_client.createSignedUrl(method='GET', bucketName='your-bucket', objectKey='internal/report.pdf', expires=3600)
print(res['signedUrl'])
第五步:时钟偏了,签名在服务端看来就是过期或未生效
签发机器的时钟比服务端快,链接还没到对方手里,在服务端看来有效期已经过了一截;慢太多,请求时间偏差超过允许值,直接报时间偏差错误。先对时,签发机器跑 NTP,偏差压到秒级。容器、函数实例这类时钟不一定准的环境,尤其要先查这一项——它引起的 403 看起来毫无规律,时好时坏,因为偏差本身在漂。
泄露了怎么止损,还是那三层
单个预签名 URL 本身没有「吊销」按钮,止损按代价从轻到重:改对象名或移到新前缀,旧链接签的是旧对象名,立刻 403,这是最快的一招,适合单个文件泄露;下次签短一点,比如 600 秒,泄露窗口就小;怀疑 AK 本身也漏了,才轮换 AK,代价是所有在用的链接一起断。
平时就两条:有效期按需给最短的,别图省事签 7 天;签发的 AK 单独建、权限最小,别拿主账号的签。链接打不开时,先看报错原文,再按方法、对象名、有效期、请求头、AK 权限、区域 endpoint、时钟这个顺序往下排,排到哪一步对上了,就停在那一步改那一处。
- 点赞
- 收藏
- 关注作者
评论(0)