第 29 章 Business Central 组、角色和用户的安全管理 REST API

流程

1. 识别您要向其发送 请求的相关 API 端点，如 [GET] /groups 来检索 Business Central 中的组。

2. 在 REST 客户端或 curl 实用程序中，输入到 /groups 的 GET 请求的以下组件。根据您的用例调整任何请求详情。

   对于 REST 客户端：

   • 身份验证 ：使用 admin 角色输入 Business Central 用户的用户名和密码。

   • HTTP Headers ：设置以下标头：

     • 接受:application/json
   • HTTP 方法 ：设置为 GET。
   • URL ：输入安全管理 REST API 基础 URL 和端点，如 http://localhost:8080/business-central/rest/groups。

   对于 curl 工具：

   • - U ：使用 admin 角色输入 Business Central 用户的用户名和密码。

   • - h : 设置以下标头：

     • 接受:application/json
   • -x ：设置为 GET。
   • URL ：输入安全管理 REST API 基础 URL 和端点，如 http://localhost:8080/business-central/rest/groups。

   curl -u 'baAdmin:password@1' -H "Accept: application/json" -X GET "http://localhost:8080/business-central/rest/groups"

3. 执行请求并查看 KIE 服务器响应。

   服务器响应示例(JSON)：

   [
     	{
   		"group1"
   	},
   	{
   		"group2"
   	}
   ]

4. 在 REST 客户端或 curl 实用程序中，发送另外一个带有以下组件的 API 请求，它向 /users/{userName}/groups 发送一个 POST 请求，以便更新为一个用户分配的组。根据您的用例调整任何请求详情。

   对于 REST 客户端：

   • 身份验证 ：使用 admin 角色输入 Business Central 用户的用户名和密码。

   • HTTP Headers ：设置以下标头：

     • 接受:application/json
     • Content-Type:application/json
   • HTTP 方法 ：设置为 POST。
   • URL ：输入安全管理 REST API 基础 URL 和端点，如 http://localhost:8080/business-central/rest/users/newUser/groups。
   • 请求正文 ：添加带有新组的标识数据的 JSON 请求正文：

   [
     "newGroup"
   ]

   对于 curl 工具：

   • - U ：使用 admin 角色输入 Business Central 用户的用户名和密码。

   • - h ：设置以下标头：

     • 接受:application/json
     • Content-Type:application/json
   • -x ：设置为 POST。
   • URL ：输入安全管理 REST API 基础 URL 和端点，如 http://localhost:8080/business-central/rest/users/newUser/groups。
   • -d ：添加一个 JSON 请求正文或文件(@file.json)，带有新组的标识数据：

   curl -u 'baAdmin:password@1' -H "Accept: application/json" -H "Content-Type: application/json" -X POST "http://localhost:8080/business-central/rest/users/newUser/groups" -d "["newGroup"]"

   curl -u 'baAdmin:password@1' -H "Accept: application/json" -H "Content-Type: application/json" -X POST "http://localhost:8080/business-central/rest/users/newUser/groups" -d @user-groups.json

5. 执行请求并查看 KIE 服务器响应。

   服务器响应示例(JSON)：

   {
     "status": "OK",
     "message": "Groups [newGroup] are assigned successfully to user wbadmin"
   }

   如果您遇到请求错误，请检查返回的错误消息并相应地调整您的请求。