用 O_EXCL 与 O_NOFOLLOW 安全创建临时文件:Python 实战与验证
用 O_EXCL 与 O_NOFOLLOW 安全创建临时文件
问题场景
临时文件常见写法是先拼路径,再 open(path, 'w')。如果候选路径位于共享目录,攻击者可预先放置符号链接,例如 candidate -> /etc/passwd。普通 open 会跟随最终符号链接,高权限进程就可能覆盖链接目标。即使文件名看起来随机,也不应把“检查路径是否存在”和“打开写入”拆成两步。
关键标志
O_CREAT:不存在则创建。O_EXCL:与O_CREAT同用,路径已存在则失败;对已存在的符号链接通常返回EEXIST,创建动作是原子的。O_NOFOLLOW:不跟随最终组件符号链接;在未使用O_EXCL的变体中会以ELOOP拒绝。0o600:仅所有者可读写;创建后再fchmod,避免 umask 影响。
注意:O_CREAT | O_EXCL 已经能拒绝已存在的路径,O_NOFOLLOW 是纵深防御,用来覆盖其他打开方式或后续代码被改写的风险。
可运行示例
以下代码在 Linux 上运行,使用临时目录做受控演示。普通 open 只写入受控的 target.txt;指向 /etc/passwd 的链接只用于验证安全函数拒绝,不对其执行写入。
import errno
import os
import secrets
import tempfile
def secure_open_write(path: str, data: bytes) -> None:
flags = os.O_WRONLY | os.O_CREAT | os.O_EXCL | os.O_NOFOLLOW
try:
fd = os.open(path, flags, 0o600)
except OSError as e:
if e.errno in (errno.ELOOP, errno.ENOTDIR):
raise RuntimeError(f'拒绝符号链接或非普通路径: {path}') from e
raise
try:
os.fchmod(fd, 0o600)
with os.fdopen(fd, 'wb') as f:
fd = -1
f.write(data)
f.flush()
os.fsync(f.fileno())
except BaseException:
if fd != -1:
try:
os.close(fd)
except OSError:
pass
try:
os.unlink(path)
except OSError:
pass
raise
def create_temp_file(directory: str, data: bytes, attempts: int = 16) -> str:
for _ in range(attempts):
path = os.path.join(directory, 'tmp-' + secrets.token_hex(8))
try:
secure_open_write(path, data)
except FileExistsError:
continue
return path
raise RuntimeError('无法获得唯一临时文件名')
if __name__ == '__main__':
base = tempfile.mkdtemp(prefix='secure-demo-')
target = os.path.join(base, 'target.txt')
with open(target, 'wb') as f:
f.write(b'ORIGINAL')
link = os.path.join(base, 'candidate')
os.symlink(target, link)
# 普通 open 跟随符号链接,写入的是 target.txt
with open(link, 'wb') as f:
f.write(b'OVERWRITTEN')
print('普通 open 跟随链接,target=', open(target, 'rb').read())
# 安全函数拒绝已存在的候选链接:通常是 EEXIST
try:
secure_open_write(link, b'SHOULD_NOT_WRITE')
except OSError as e:
print('安全函数拒绝候选链接:', type(e).__name__, e.errno)
# 指向 /etc/passwd 的链接只验证拒绝,不执行写入
danger = os.path.join(base, 'to-passwd')
os.symlink('/etc/passwd', danger)
try:
secure_open_write(danger, b'X')
except OSError as e:
print('指向 /etc/passwd 的链接被拒绝:', type(e).__name__, e.errno)
p = create_temp_file(base, b'hello')
mode = os.stat(p).st_mode & 0o777
print('created=', p, 'mode=', oct(mode), 'data=', open(p, 'rb').read())
运行与验证
保存为 secure_tmp.py,执行:
python3 secure_tmp.py
典型输出中应看到:普通 open 后 target 的内容变为 b'OVERWRITTEN';安全函数对候选链接和 /etc/passwd 链接均抛出 FileExistsError,因为 O_EXCL 在路径已存在时直接失败;新建文件权限为 0o600,内容为 b'hello'。不同系统的 errno 数值可能不同,以异常类型和错误信息为准。
还可以用 stat 检查权限:
stat -c '%a %F %n' /tmp/secure-demo-*/tmp-*
在支持的平台上,可用 strace -e openat python3 secure_tmp.py 观察打开标志中是否出现 O_CREAT|O_EXCL|O_NOFOLLOW。
与 tempfile.mkstemp 对照
tempfile.mkstemp() 同样使用 O_CREAT | O_EXCL 生成唯一名称,并在支持的平台加入 O_NOFOLLOW,返回已打开的文件描述符和路径,默认权限为 0o600。它更适合通用场景,能减少自己实现随机名、重试和平台差异的成本。若需要向文件写入,优先直接写返回的 fd,而不是关闭后再次按路径打开:
fd, path = tempfile.mkstemp(prefix='tmp-', dir=base)
try:
os.fchmod(fd, 0o600)
os.write(fd, b'hello')
finally:
os.close(fd)
本文函数返回的是关闭后的路径,调用方若之后再次按路径打开,仍可能遇到目录被替换的竞态。对安全性要求高的流程,应把 fd 继续传递使用,或使用 O_TMPFILE 配合链接操作。
边界与限制
O_NOFOLLOW只保护最终组件;父目录本身若是符号链接,仍可能被重定向。更强做法是先用O_DIRECTORY | O_NOFOLLOW打开可信目录,再通过dir_fd创建文件:
dir_fd = os.open(directory, os.O_RDONLY | os.O_DIRECTORY | os.O_NOFOLLOW)
try:
fd = os.open(name, flags, 0o600, dir_fd=dir_fd)
finally:
os.close(dir_fd)
- 共享目录应设置为仅所有者可写,或使用带粘滞位的目录;否则攻击者仍可通过预创建名称造成拒绝服务。
O_NOFOLLOW与dir_fd主要适用于 Unix/Linux;Windows 不支持同样的语义,应使用tempfile。- 网络文件系统对
O_EXCL的支持和语义可能不同,安全敏感场景应确认底层文件系统行为。 - 示例只验证打开与写入,不涉及密钥、账号等真实数据;实际系统应使用占位值并限制日志输出。
- 点赞
- 收藏
- 关注作者
评论(0)