第29章 Business Central のグループ、ロール、およびユーザーの Security Management REST API

手順

1. [GET] /groups など、要求の送信先に適した API エンドポイント を特定し、Business Central からグループを取得します。

2. REST クライアントまたは curl ユーティリティーで、/groups への GET 要求に以下のコンポーネントを記入します。ご自分のユースケースに合わせて、要求詳細を調整します。

   REST クライアントの場合:

   • Authentication: admin ロールを持つ Business Central ユーザーのユーザー名とパスワードを入力します。

   • HTTP Headers: 以下のヘッダーを設定します。

     • Accept: application/json
   • HTTP method: GET に設定します。
   • URL: Security Management REST API ベース URL とエンドポイントを入力します。たとえば、http://localhost:8080/business-central/rest/groups となります。

   curl ユーティリティーの場合:

   • -u: admin ロールを持つ Business Central ユーザーのユーザー名とパスワードを入力します。

   • -H: 以下のヘッダーを設定します。

     • Accept: application/json
   • -X: GET に設定します。
   • URL: Security Management 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 Server の応答を確認します。

   サーバー応答の例 (JSON):

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

4. REST クライアントまたは curl ユーティリティーで、/users/{userName}/groups への POST 要求を以下のコンポーネントで送信し、ユーザーに割り当てられたグループを更新します。ご自分のユースケースに合わせて、要求詳細を調整します。

   REST クライアントの場合:

   • Authentication: admin ロールを持つ Business Central ユーザーのユーザー名とパスワードを入力します。

   • HTTP Headers: 以下のヘッダーを設定します。

     • Accept: application/json
     • Content-Type: application/json
   • HTTP method: POST に設定します。
   • URL: Security Management REST API ベース URL とエンドポイントを入力します。たとえば、http://localhost:8080/business-central/rest/users/newUser/groups となります。
   • 要求のボディ: 新規グループ用の ID データを含む JSON 要求のボディを追加します。

   [
     "newGroup"
   ]

   curl ユーティリティーの場合:

   • -u: admin ロールを持つ Business Central ユーザーのユーザー名とパスワードを入力します。

   • -H: 以下のヘッダーを設定します。

     • Accept: application/json
     • Content-Type: application/json
   • -X: POST に設定します。
   • URL: Security Management REST API ベース URL とエンドポイントを入力します。たとえば、http://localhost:8080/business-central/rest/users/newUser/groups となります。
   • -d: 新規グループ用の ID データを含む 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 Server の応答を確認します。

   サーバー応答の例 (JSON):

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

   要求エラーが発生した場合は、返されたエラーコードメッセージを確認して、それに応じて要求を調整します。