1. 数据传输安全
FacePick 非常重视数据安全与隐私保护。所有 API 请求必须使用 HTTPS 协议,确保数据在传输过程中不被窃取或篡改。示例端点:
# 生产环境示例端点(占位地址,接口尚未接入) https://api.demo.invalid/v1/
示例中的 https://api.demo.invalid 与 fp_demo_not_valid_… 均为占位演示值;复制示例不会执行任何网络请求。
- 不支持 HTTP 协议的请求,所有非 HTTPS 请求将被拒绝(按生产安全要求说明)。
- TLS 证书由受信任的 CA 签发,避免自签名证书带来的中间人风险。
本演示网站运行在本地 HTTP(http://127.0.0.1:3100)只是为了本地查看页面,不代表生产环境可以省略 HTTPS;真实接入必须全链路 HTTPS。
2. API Key 安全管理
请妥善保管您的 API Key,避免泄露。建议遵循以下安全规范:
不要将 API Key 提交到公共代码仓库(如 GitHub、GitLab)。
为不同的应用或环境使用独立的 API Key,便于权限管理与风险隔离。
在生产环境中使用环境变量管理密钥,不写死在代码里。
设置最小权限原则,仅开通必要的权限。
定期轮换 API Key,降低长期泄露风险。
如发现泄露,请立即在控制台中停用并重新生成。
真实私密 Key 只由服务端保存:不嵌入浏览器、不提交代码仓库、不写日志。浏览器端调用应通过自己的服务端转发请求。
3. 请求签名验证
为防止请求被篡改,建议使用请求签名(X-FacePick-Signature)进行身份验证。示例代码(演示 secret,参考结构):
import hmac, hashlib, time
secret = b"fp_demo_webhook_secret_not_valid" # 演示 secret
timestamp = str(int(time.time()))
message = f"{timestamp}\n{request_body}"
signature = hmac.new(secret, message.encode(), hashlib.sha256).hexdigest()
headers = {
"X-FacePick-Signature": signature,
"X-Timestamp": timestamp,
}示例中的 https://api.demo.invalid 与 fp_demo_not_valid_… 均为占位演示值;复制示例不会执行任何网络请求。
签名示例是参考结构,不等于本工程已有验签、防重放、审计或合规认证:当前未部署任何真实签名/验签能力,生产接入时以正式协议为准。
4. 数据合规与隐私保护
- 在使用 FacePick API 时,请遵守《数据隐私政策》及相关法律法规,确保用户数据的合法、合规使用。
- 采集与处理人脸相关数据前应取得用户明确同意,并按最小必要原则使用。
- 本页为演示说明:本工程未接入真实隐私政策页面、合规认证或数据审计能力。