# カスタム ロール ## 概要 **カスタム ロール** RealmJoin Portal のオプション機能であり、追加の RealmJoin 内部ロールを作成できます。これらのロールにはきめ細かな / 個別の権限を割り当て、Entra グループまたは特定のユーザーに関連付けることができます。 {% hint style="info" %} カスタムロールが必要な場合は、 **RealmJoin サポートに有効化を依頼してください**. {% endhint %} Custom Roles は JSON として定義されます。RealmJoin Portal に含まれる JSON エディターは、構文チェックとハイライト表示を提供し、定義を Custom Roles JSON スキーマと照合して検証します。

Custom Roles JSON エディター

## エディターの使用 ### 構文チェック / エラー エディターは入力中に構文をチェックします。構文エラーが検出されると、エラーメッセージが **x 個のエラーを表示** とバグアイコンがの横に表示されます **保存。**

JSON エラーメッセージ/ボタン

このメッセージをクリックすると、エラーの詳細を確認できます。 ### 書式設定 をクリックすると、JSON を自動整形できます **書式設定** ページ右上隅で。

書式設定ボタン

### 自動補完 エディターは、スキーマから既知のキーワード（権限など）を自動補完として提案できます。

キーワードの自動補完

いつでも "Ctrl" + "Space" を押して自動補完を呼び出せます。 ## ルール ロールは、権限のペアと、その権限が付与されるユーザーおよび/またはグループとして記述されます。 ロールは、キーワードの下に配列（リスト）の一部として列挙されます **ルール**. ルールの例： ```json { "Rules": [ { "Name": "Default: Supporters can change primary user [27e589a7]", "Description": "Supporter グループのメンバーが RealmJoin 参加デバイスのプライマリユーザーを変更できるようにする既定のルールです。名前に含まれている ID はそのまま保持してください。", "Groups": [ "f31f5765-f56f-47fa-9248-ac2d77221634", "422e6b7c-bd99-4082-be1c-88cbc2bb2734" ], "Permissions": [ "CanChangeRealmJoinPrimaryUser" ] },{ "Name": "Allow John to add new Self Service Forms", "Users": [ "b31f5765-f56f-47fa-9248-ac2d77221622" ], "Permissions": [ "CanAddSelfServiceForms" ] } ] } ``` ### Name と Description **名前** は必須です、 **説明** は任意です。 どちらもプレーンテキストのフィールド（文字列）です。 ### アクセス許可 権限は、RealmJoin Portal における特定のアクションを識別する一意の文字列です。 **アクセス許可** は権限のリスト（配列）です。 参照 [利用可能な権限](/ja/realmjoin-she-ding/permission/custom-roles/available-permissions.md) 一般的な権限の一覧と説明については、 ### グループ Entra グループのオブジェクト ID のリスト（配列）です。指定された [permissions](#permissions) は、これらのグループのメンバーであるすべてのユーザーに割り当てられます。 ### ユーザー Entra ユーザーのオブジェクト ID のリスト（配列）です。指定された [permissions](#permissions) は、これらのユーザーに割り当てられます。 --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.realmjoin.com/ja/realmjoin-she-ding/permission/custom-roles.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.