无需登录 · 本页不含 Token / 密钥明文

金縢 对接说明

加密密钥库(金縢 / jinteng)。客户端用 URL + API Token 对接;项目 / git / CI / agent 里只写密钥名,用 jinteng run 在运行时注入。

当前服务地址https://jinteng.ninja-sin.tech
本说明https://jinteng.ninja-sin.tech/ 或 https://jinteng.ninja-sin.tech/docs
Token 不会显示在本页。 在服务端读取:Docker 用 docker compose -f deploy/docker-compose.yml exec jinteng cat /data/token; 二进制部署用 cat ~/.jinteng/token(或 $JINTENG_DIR/token)。

1. 客户端环境变量

export JINTENG_URL='https://jinteng.ninja-sin.tech'
export JINTENG_TOKEN='<从服务端 token 文件粘贴>'

jinteng list

2. 推荐:运行时注入(不明文进仓库)

jinteng run \
  -e OPENAI_API_KEY=openai/key \
  -e DATABASE_URL=db/url \
  -- your-dev-server

流程:CLI 调用 POST /v1/resolve → 值只进入子进程环境变量 → 磁盘项目目录不落明文。

3. HTTP API

方法路径说明
GET/healthz探活,无需 Token
GET/v1/secrets列出名称(无明文)
GET/v1/secrets/{name}取单个值
PUT/v1/secrets/{name}写入 {"value","note"}
DELETE/v1/secrets/{name}删除
POST/v1/resolve批量解析 {"refs":["a","b"]}

鉴权头:Authorization: Bearer <token> 或 X-Jinteng-Token: <token>

4. 安全注意