> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-references/org/applications/add-gsa-application-registration.md).

# GSA アプリケーション登録を追加

Global Secure Access アプリケーションとそのアクセス グループを作成します

### 説明

Entra ID に Global Secure Access (GSA) アプリケーションを作成し、そのアプリケーション セグメント（宛先、ポート、プロトコル）とコネクタ グループ、さらに誰が使用できるかを制御するセキュリティ グループを追加します。アプリケーションがすでに存在する場合は、セグメント、グループ、割り当てのみが更新されます。作成前にすべて検証され、失敗した実行で作成されたオブジェクトは再び削除されます。

### 場所

組織 → アプリケーション → GSA アプリケーション登録を追加

**完全な Runbook 名**

rjgit-org\_applications\_add-GSA-application-registration

### 詳細

| プロパティ    | 値                                                                                        |
| -------- | ---------------------------------------------------------------------------------------- |
| バージョン    | 1.3.3                                                                                    |
| 必須モジュール  | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)</p> |
| スケジュール可能 | いいえ                                                                                      |

### アクセス許可

#### アプリケーションのアクセス許可

* **型**: Microsoft Graph
  * Application.ReadWrite.All
    * *アプリケーション テンプレートからアプリをインスタンス化し、onPremisesPublishing をパッチ適用し、アプリのセグメントを追加します*
  * Directory.ReadWrite.All
    * *App Proxy エンドポイントに必要です: コネクタ グループを読み取り、アプリの connectorGroup を割り当てます*
  * Group.ReadWrite.All
    * *アプリ用のアクセス セキュリティ グループを作成し、ロールバック時に削除します*
  * AppRoleAssignment.ReadWrite.All
    * */servicePrincipals/{id}/appRoleAssignedTo を介してアクセス グループをアプリに割り当てます*

### パラメーター

#### 名前

アプリケーションの基本名です。最終的な名前は prefix と名前を連結したものになります。たとえば GSA-MyApp です。

| プロパティ    | 値         |
| -------- | --------- |
| 必須       | true      |
| 既定値      |           |
| 型        | 文字列       |
| ポータルの表示名 | アプリケーション名 |

#### プレフィックス

名前の前に置かれるテキストです。prefix がハイフン、アンダースコア、またはスペースで終わる場合を除き、スペースが挿入されます。

| プロパティ    | 値                 |
| -------- | ----------------- |
| 必須       | true              |
| 既定値      |                   |
| 型        | 文字列               |
| ポータルの表示名 | アプリケーション名のプレフィックス |

#### groupPrefix

アプリケーションの prefix とは関係なく、アクセス グループ名の前に置かれるテキストです。通常は runbook のカスタマイズで事前設定されます。

| プロパティ    | 値                   |
| -------- | ------------------- |
| 必須       | false               |
| 既定値      | App - Entra - GSA - |
| 型        | 文字列                 |
| ポータルの表示名 | グループ名のプレフィックス       |

#### groupSuffix

アクセス グループ名の末尾に追加されるテキストです。例: " (users)"。不要な場合は空欄のままにします。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### applicationType

Enterprise App は新しい GSA アプリケーションを作成します。Quick Access App はその代わりに、Tenant の既存の Quick Access アプリにセグメントを追加します。

| プロパティ    | 値           |
| -------- | ----------- |
| 必須       | true        |
| 既定値      |             |
| 型        | 文字列         |
| ポータルの表示名 | アプリケーションの種類 |

**ポータル オプション**

| ポータル オプション    | 値              |
| ------------- | -------------- |
| エンタープライズ アプリ  | nonwebapp      |
| クイック アクセス アプリ | quickaccessapp |

#### connectorGroup

アプリケーションを公開するコネクタ グループです。使用可能なグループは runbook のカスタマイズで設定されます。

| プロパティ    | 値         |
| -------- | --------- |
| 必須       | false     |
| 既定値      |           |
| 型        | 文字列       |
| ポータルの表示名 | コネクタ グループ |

#### destinationHost

アプリケーションの場所: ホスト名（example.com）、単一 IP（192.168.0.1）、CIDR 範囲（192.168.0.1/24）、または IP 範囲（192.168.0.1..192.168.0.20）。

| プロパティ    | 値          |
| -------- | ---------- |
| 必須       | false      |
| 既定値      |            |
| 型        | 文字列        |
| ポータルの表示名 | 宛先ホストまたは範囲 |

#### destinationType

宛先の種類。宛先ホストの形式から自動的に判別されます。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### ports

公開するポート: 単一ポート（443）、複数（80,443）、または範囲（8000-8080）。

| プロパティ    | 値     |
| -------- | ----- |
| 必須       | false |
| 既定値      |       |
| 型        | 文字列   |
| ポータルの表示名 | ポート   |

#### protocol

TCP、UDP、または両方。

| プロパティ    | 値     |
| -------- | ----- |
| 必須       | false |
| 既定値      |       |
| 型        | 文字列   |
| ポータルの表示名 | プロトコル |

**ポータル オプション**

| ポータル オプション | 値       |
| ---------- | ------- |
| TCP        | tcp     |
| UDP        | udp     |
| TCP,UDP    | tcp,udp |

[Runbook リファレンスの概要に戻る](https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-references.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-references/org/applications/add-gsa-application-registration.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
