> 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/fr/automatisation/runbooks/runbook-references/org/applications/add-gsa-application-registration.md).
# Ajouter l'enregistrement d'application Gsa
Créer une application Global Secure Access avec son groupe d'accès
### Description
Crée une application Global Secure Access (GSA) dans Entra ID avec son segment d'application (destination, ports, protocole) et son groupe de connecteurs, ainsi qu'un groupe de sécurité qui contrôle qui peut l'utiliser. Si l'application existe déjà, seuls le segment, le groupe et l'affectation sont mis à jour. Tout est validé avant toute création, et les objets créés lors d'une exécution en échec sont supprimés à nouveau.
### Emplacement
Organisation → Applications → Ajouter l'enregistrement d'application GSA
**Nom complet du runbook**
rjgit-org\_applications\_add-GSA-application-registration
### Détails
| Propriété | Valeur |
| -------------- | ---------------------------------------------------------------------------------------- |
| Version | 1.3.3 |
| Modules requis | RealmJoin.RunbookHelper (>= 0.8.10)
Microsoft.Graph.Authentication (>= 2.41.2)
|
| Planifiable | non |
### Autorisations
#### Autorisations d’application
* **Type**: Microsoft Graph
* Application.ReadWrite.All
* *Instancie l'application à partir du modèle d'application, met à jour onPremisesPublishing et ajoute des segments d'application*
* Directory.ReadWrite.All
* *Requis par les points de terminaison App Proxy : lit les groupes de connecteurs et attribue le connectorGroup de l'application*
* Group.ReadWrite.All
* *Crée le groupe de sécurité d'accès pour l'application et le supprime lors du retour arrière*
* AppRoleAssignment.ReadWrite.All
* *Attribue le groupe d'accès à l'application via /servicePrincipals/{id}/appRoleAssignedTo*
### Paramètres
#### nom
Nom de base de l'application. Le nom final est le préfixe plus le nom, par exemple GSA-MyApp.
| Propriété | Valeur |
| -------------------------- | -------------------- |
| Obligatoire | vrai |
| Valeur par défaut | |
| Type | Chaîne |
| Nom d’affichage du portail | Nom de l’application |
#### préfixe
Texte placé devant le nom. Un espace est inséré sauf si le préfixe se termine par un tiret, un trait de soulignement ou un espace.
| Propriété | Valeur |
| -------------------------- | ------------------------------- |
| Obligatoire | vrai |
| Valeur par défaut | |
| Type | Chaîne |
| Nom d’affichage du portail | Préfixe du nom de l'application |
#### préfixe du groupe
Texte placé devant le nom du groupe d'accès, indépendamment du préfixe de l'application. Généralement prédéfini dans la personnalisation du runbook.
| Propriété | Valeur |
| -------------------------- | --------------------------- |
| Obligatoire | faux |
| Valeur par défaut | Application - Entra - GSA - |
| Type | Chaîne |
| Nom d’affichage du portail | Préfixe du nom du groupe |
#### suffixe du groupe
Texte ajouté au nom du groupe d'accès, par exemple « (utilisateurs) ». Laissez vide s'il n'y en a pas.
| Propriété | Valeur |
| ---------------------- | -------------------------------------------------- |
| Obligatoire | faux |
| Valeur par défaut | |
| Type | Chaîne |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |
#### applicationType
Enterprise App crée une nouvelle application GSA. Quick Access App ajoute plutôt le segment à l'application Quick Access existante du locataire.
| Propriété | Valeur |
| -------------------------- | ------------------ |
| Obligatoire | vrai |
| Valeur par défaut | |
| Type | Chaîne |
| Nom d’affichage du portail | Type d'application |
**Options du portail**
| Option du portail | Valeur |
| ------------------------ | -------------- |
| Application d'entreprise | nonwebapp |
| Application Quick Access | quickaccessapp |
#### connectorGroup
Groupe de connecteurs qui publie l'application. Les groupes disponibles sont définis dans la personnalisation du runbook.
| Propriété | Valeur |
| -------------------------- | --------------------- |
| Obligatoire | faux |
| Valeur par défaut | |
| Type | Chaîne |
| Nom d’affichage du portail | Groupe de connecteurs |
#### destinationHost
Emplacement de l'application : un nom d'hôte (example.com), une adresse IP unique (192.168.0.1), une plage CIDR (192.168.0.1/24) ou une plage d'adresses IP (192.168.0.1..192.168.0.20).
| Propriété | Valeur |
| -------------------------- | ---------------------------- |
| Obligatoire | faux |
| Valeur par défaut | |
| Type | Chaîne |
| Nom d’affichage du portail | Hôte ou plage de destination |
#### destinationType
Type de destination, dérivé automatiquement du format de l'hôte de destination.
| Propriété | Valeur |
| ---------------------- | -------------------------------------------------- |
| Obligatoire | faux |
| Valeur par défaut | |
| Type | Chaîne |
| Masqué dans le portail | oui (prédéfini via la personnalisation du runbook) |
#### ports
Ports à publier : un seul port (443), plusieurs (80,443) ou une plage (8000-8080).
| Propriété | Valeur |
| -------------------------- | ------ |
| Obligatoire | faux |
| Valeur par défaut | |
| Type | Chaîne |
| Nom d’affichage du portail | Ports |
#### protocol
TCP, UDP ou les deux.
| Propriété | Valeur |
| -------------------------- | --------- |
| Obligatoire | faux |
| Valeur par défaut | |
| Type | Chaîne |
| Nom d’affichage du portail | Protocole |
**Options du portail**
| Option du portail | Valeur |
| ----------------- | ------- |
| TCP | tcp |
| UDP | udp |
| TCP,UDP | tcp,udp |
[Retour à l’aperçu de la référence du runbook](/fr/automatisation/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/fr/automatisation/runbooks/runbook-references/org/applications/add-gsa-application-registration.md?ask=&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.