如何编程构建GraphDB的认证请求头？

GraphDB的认证令牌是自定义格式，结构为 GDB <Base64编码的Payload>.<Base64编码的Signature>，以下是详细拆解和正确使用流程：

令牌结构拆解 #

• 固定前缀：必须以GDB 开头（注意后缀有空格）
• Payload部分：
  1. 构造包含两个字段的JSON对象：
     • username：你的GraphDB登录用户名
     • authenticatedAt：登录时刻的毫秒级时间戳（比如示例中的1732787032092，对应具体时间点的毫秒数）
  2. 将该JSON字符串做标准Base64编码（保留+、/和=补位，不要用URL安全的Base64变体），得到Payload的Base64串。
• Signature部分：
  这是GraphDB服务器用自身私有密钥，对原始Payload的JSON字符串（不是Base64编码后的内容）进行HMAC-SHA256签名，再将签名结果做标准Base64编码得到的串。

关键提示：不要自行构造令牌 #

客户端无法生成有效的Signature——因为GraphDB服务器的私有密钥是部署时的内部配置，不会对外暴露。正确的做法是通过官方登录接口获取合法令牌：

1. 发送POST请求到<GraphDB服务器地址>/webapi/login
2. 请求体以JSON格式传入账号密码：{"username":"admin","password":"your-password"}
3. 服务器响应的Authorization头会返回完整的GDB ...令牌
4. 后续所有需要认证的请求，将该令牌放入请求的Authorization头即可。

示例代码（Python） #

实现登录并获取令牌的简单示例：

import requests

graphdb_server = "http://your-graphdb-host:7200"
login_url = f"{graphdb_server}/webapi/login"
credentials = {"username": "admin", "password": "your-graphdb-password"}

# 发起登录请求
resp = requests.post(login_url, json=credentials)
resp.raise_for_status()

# 提取认证令牌
auth_token = resp.headers["Authorization"]

# 使用令牌访问需要认证的接口
headers = {"Authorization": auth_token}
repo_list_resp = requests.get(f"{graphdb_server}/webapi/repositories", headers=headers)
print(repo_list_resp.json())

内容的提问来源于stack exchange，提问作者Ian Piper