集成指南 › Backbone Fabric Controller (BFC) API 参考指南 › 详细的 API 文档 › 身份验证

身份验证

使用 BFC API 之前，您必须创建身份验证会话。 可以通过将用户名和密码发布到所需 BFC API 版本的登录资源来创建会话。 如果用户名和密码有效，则会返回会话 ID（必须在授权头中为每个 BFC API 调用进行传递）。 在没有活动的情况下，会话在 30 分钟内保持有效。 除非包含头 X-CA-FC-runningClock 且值为 true，否则 BFC 的每个请求将会重置会话超时。 这对执行无人值守轮询调用 BFC 的客户端非常有用。 客户端可通过将会话 ID 发布到注销资源来终止会话。

创建会话

POST  BFC/1.0/login

头

Content-Type:application/json

参数

有效负载是具有两个字段的 JSON 对象：username 和 password。

用户名

如果用户名不是合格的承租人，则会假定核心承租人。 当前，核心承租人是 BFC 中唯一可用的承租人。

例如 joe（或 core/joe）

password

用户的密码。

例如 MyPassword

{"username":"joe","password":"MyPassword"}

结果

返回的有效负载是表示会话 ID 的 JSON 字符串。 例如：

"2f9b84766cdacd376125c7d57aaf6aa7"

结束会话

POST/BFC//logout 

头

Content-Type:application/json

授权：您的会话 ID

参数

您的会话 ID