> 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 に name を加えたものです。たとえば GSA-MyApp です。

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

#### プレフィックス

name の前に付けるテキストです。prefix がハイフン、アンダースコア、またはスペースで終わらない限り、スペースが挿入されます。

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

#### グループ接頭辞

application prefix とは独立して、アクセス グループ名の前に付けるテキストです。通常は runbook のカスタマイズであらかじめ設定されています。

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

#### グループ接尾辞

アクセス グループ名の末尾に追加するテキストです。たとえば「 (users)」です。追加しない場合は空欄にします。

| プロパティ    | 値                         |
| -------- | ------------------------- |
| 必須       | false                     |
| 既定値      |                           |
| 種類       | 文字列                       |
| ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) |

#### applicationType

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

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

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

| ポータル オプション       | 値              |
| ---------------- | -------------- |
| Enterprise App   | nonwebapp      |
| Quick Access App | 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

宛先の種類。destinationHost の形式から自動的に判定されます。

| プロパティ    | 値                         |
| -------- | ------------------------- |
| 必須       | false                     |
| 既定値      |                           |
| 種類       | 文字列                       |
| ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) |

#### ports

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

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

#### protocol

TCP、UDP、または両方。

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

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

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

[Runbook リファレンスの概要に戻る](/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.