浏览文档 +

推送加密

通常,Breeze、Apple 和 Google 在投递时能看到通知的文字。开启加密后,由你的脚本加密内容,只有你的 iPhone 能解密。格式与 Bark 兼容。

设置密钥#

在 App 中打开“设置 → 加密”,选择:

设置 选项
算法 AES-128、AES-192 或 AES-256,密钥分别为 16、24、32 个字符
模式 GCM(推荐)、CBC 或 ECB
IV GCM 为 12 个字符,CBC 为 16 个字符,ECB 不需要

在 App 中生成密钥并复制到脚本里,除此之外密钥不会离开手机。App 还会给出一条可直接运行的命令,用来发送加密测试通知。

发送加密通知#

  1. 把参数写成 JSON,例如 {"title":"Server","body":"Disk usage is above 90%"}。
  2. 用你的密钥和 IV 加密这段 JSON,再做 Base64 编码。GCM 模式需要先把 16 字节的 tag 拼接在密文末尾再编码。
  3. 把结果作为 ciphertext 发送。如果每条消息使用不同的 IV,也一并发送 iv。
cURL / Bash
KEY='YOUR_32_CHARACTER_KEY'   # AES-256
IV='YOUR_16_CHAR_IV'           # CBC
JSON='{"title":"Server","body":"Disk usage is above 90%"}'

CIPHERTEXT=$(printf '%s' "$JSON" | openssl enc -aes-256-cbc \
  -K "$(printf '%s' "$KEY" | xxd -p -c 256)" \
  -iv "$(printf '%s' "$IV" | xxd -p -c 256)" | base64 | tr -d '\n')

curl https://push.breezelabs.dev/v1/send \
  -H 'Authorization: Bearer YOUR_KEY' \
  --data-urlencode "ciphertext=$CIPHERTEXT" \
  --data-urlencode "iv=$IV"

使用 Python 和 AES-GCM:

python
import base64, json, os
from cryptography.hazmat.primitives.ciphers.aead import AESGCM

key = b'YOUR_32_CHARACTER_KEY'
iv = os.urandom(6).hex().encode()          # 12 characters, new for every message
payload = json.dumps({'title': 'Server', 'body': 'Disk usage is above 90%'}).encode()
ciphertext = base64.b64encode(AESGCM(key).encrypt(iv, payload, None)).decode()
# Send {"ciphertext": ciphertext, "iv": iv.decode()} to /v1/send

哪些内容仍然可见#

放在 ciphertext 之外的参数(例如 group 或 sound)对服务可见。请把所有私密内容放进加密的 JSON。如果密钥或 IV 不匹配,手机会显示“Decryption failed”而不是内容。

加密目前只支持 iPhone。Android 暂不支持,会返回 HTTP 422。