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 Security Group qui contrôle qui peut l’utiliser. Si l’application existe déjà, seul 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’inscription 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.9) Microsoft.Graph.Authentication (>= 2.39.0)
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

    • Affecte 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 underscore 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

prefixeDuGroupe

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

suffixeDuGroupe

Texte ajouté au nom du groupe d’accès, par exemple " (users)". Laissez vide si aucun.

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)

type d’application

L’Enterprise App crée une nouvelle application GSA. La 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 d’accès rapide	quickaccessapp

groupe de connecteurs

Groupe de connecteurs qui publie l’application. Les groupes disponibles sont configurés 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

hôte de destination

Emplacement de l’application : un nom d’hôte (example.com), une 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

type de destination

Type de destination, déterminé automatiquement à partir 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

protocole

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 à la vue d’ensemble de la référence du runbook