你可能不知道敏感信息硬编码在程序中会带来多大的麻烦。
我曾经写过一个用 Python 发送 html 邮件及附件的程序,分享在了网络上,里面的收件人没有做隐藏处理,用的是我自己最常用的邮箱。然后,苦恼随之而来:我会不停的收到测试邮件(垃圾邮件)。问了其中一个发件人才知道有培训机构用这个教学,学员什么都不改直接运行,于是我就不停的收到邮件。
这点麻烦与泄漏密码相比,还是小的。就有人不小心把含有用户名密码的程序上传到开源网站上。
解决这个问题,就需要让敏感信息和程序代码解耦,敏感信息放在一个文件中,程序代码放在另一个文件中,发布程序上避免上传敏感信息。通常来说,有两种方式:
1、配置文件。
你可以使用标准库 configparser[1] 来解析配置文件。好处就是你不仅可以读取配置文件,还可以更新配置文件。
比如有这样的一个 example.ini 配置文件:
[DEFAULT]
ServerAliveInterval = 45
Compression = yes
CompressionLevel = 9
ForwardX11 = yes
[bitbucket.org]
User = hg
[topsecret.server.com]
Port = 50022
ForwardX11 = no
然后就可以这样来读取:
config = configparser.ConfigParser()
config.read('example.ini')
print(config['bitbucket.org']['User'])
你还可以使用一个 python 文件来当配置文件,最优雅的方式就是模仿 Django,搞一个默认的 settings.py,和用户自定义的 settings.py 用户自定义的配置可以覆盖默认的配置。这种方式非常简单,没有记忆负担,就像写 Python 代码一样。
2、环境变量。
环境变量(environment variables)是指在操作系统中用来指定操作系统运行环境的一些参数,比如说安装 Python 的过程中是否需要将 Python 可执行程序添加到 Path 中,这个 Path 就是一个环境变量。
在 Linux 或 Mac 中,可以这样打印一个环境变量:
echo $PATH
我们也可以把敏感信息写在操作系统的环境变量中,然后用 Python 读取它:
>>> import os
>>> os.environ["HOME"]
'/Users/aaron'
>>> os.getenv("HOME1111",'/home/aaron')
'/home/aaron'
>>> api_key = os.getenv("SECRET_API_KEY", "Not Exists")
但是这样做有缺点,你需要先 export key = value 来先设置一个环境变量,或者需要先去 .bashrc、.zshrc 等配置文件去添加你需要的环境变量,如果名称相同,可能会影响其他程序用到的同名环境变量。
毕竟优雅的方式就是在项目目录中新建一个 .env 的环境变量配置文件,写入自己的配置信息,比如 .env 文件:
PROJECT_ID = "project_id"
API_KEY = "api_key"
然后借助于三方库 dotenv:
pip install python-dotenv
然后就可以这样读取它:
import os
from dotenv import load_dotenv
# load_dotenv 将会查找一个 .env 文件,一旦找到,就会加载到环境变量中
load_dotenv()
PROJECT_ID = os.getenv("PROJECT_ID")
API_KEY = os.getenv("API_KEY")
而且这种方式不会影响其他任何程序。还有一点需要注意的是要把 .env 添加到你的 .gitignore。
如果你想对 .env 文件进行命名,也是可以的,比如说 dev.env,那么可以这样写:
from dotenv import dotenv_values
config = dotenv_values("dev.env")
config.get("PROJECT_ID")
甚至多个 env 文件也可以:
import os
from dotenv import dotenv_values
config = {
**dotenv_values(".env.shared"), # load shared development variables
**dotenv_values(".env.secret"), # load sensitive variables
**os.environ, # override loaded values with environment variables
}
更多用法请参考python-dotenv[2]
最后
本文介绍了配置文件和环境变量两种避免硬编码敏感信息的方法,在发布程序时注意对保护敏感信息,加入 .gitignore。