> 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/es/automatizacion/runbooks/runbook-references/org/applications/add-gsa-application-registration.md).
# Agregar registro de aplicación de GSA
Crear una aplicación de Global Secure Access con su grupo de acceso
### Descripción
Crea una aplicación de Global Secure Access (GSA) en Entra ID con su segmento de aplicación (destino, puertos, protocolo) y grupo de conectores, además de un Security Group que controla quién puede usarla. Si la aplicación ya existe, solo se actualizan el segmento, el grupo y la asignación. Todo se valida antes de crear nada, y los objetos creados en una ejecución fallida se eliminan nuevamente.
### Ubicación
Organización → Aplicaciones → Agregar registro de aplicación GSA
**Nombre completo del runbook**
rjgit-org\_applications\_add-GSA-application-registration
### Detalles
| Propiedad | Valor |
| ------------------ | ---------------------------------------------------------------------------------------- |
| Versión | 1.3.3 |
| Módulos requeridos | RealmJoin.RunbookHelper (>= 0.8.10)
Microsoft.Graph.Authentication (>= 2.41.2)
|
| Programable | no |
### Permisos
#### Permisos de aplicación
* **Tipo**: Microsoft Graph
* Application.ReadWrite.All
* *Instancia la aplicación a partir de la plantilla de la aplicación, actualiza onPremisesPublishing y agrega segmentos de aplicación*
* Directory.ReadWrite.All
* *Requerido por los endpoints de App Proxy: lee los grupos de conectores y asigna el connectorGroup de la aplicación*
* Group.ReadWrite.All
* *Crea el Security Group de acceso para la aplicación y lo elimina durante la reversión*
* AppRoleAssignment.ReadWrite.All
* *Asigna el grupo de acceso a la aplicación mediante /servicePrincipals/{id}/appRoleAssignedTo*
### Parámetros
#### name
Nombre base de la aplicación. El nombre final es prefijo más nombre, por ejemplo GSA-MyApp.
| Propiedad | Valor |
| ------------------------------ | ----------------------- |
| Requerido | verdadero |
| Valor predeterminado | |
| Tipo | Cadena |
| Nombre para mostrar del portal | Nombre de la aplicación |
#### prefix
Texto que se coloca delante del nombre. Se inserta un espacio a menos que el prefijo termine con un guion, guion bajo o espacio.
| Propiedad | Valor |
| ------------------------------ | ----------------------------------- |
| Requerido | verdadero |
| Valor predeterminado | |
| Tipo | Cadena |
| Nombre para mostrar del portal | Prefijo del nombre de la aplicación |
#### groupPrefix
Texto que se coloca delante del nombre del grupo de acceso, independientemente del prefijo de la aplicación. Normalmente se preconfigura en la personalización del runbook.
| Propiedad | Valor |
| ------------------------------ | ---------------------------- |
| Requerido | falso |
| Valor predeterminado | App - Entra - GSA - |
| Tipo | Cadena |
| Nombre para mostrar del portal | Prefijo del nombre del grupo |
#### groupSuffix
Texto que se añade al nombre del grupo de acceso, por ejemplo " (usuarios)". Déjelo vacío si no desea ninguno.
| Propiedad | Valor |
| -------------------- | ----------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) |
#### applicationType
Aplicación empresarial crea una nueva aplicación GSA. La aplicación de acceso rápido agrega el segmento a la aplicación de acceso rápido existente del Tenant, en su lugar.
| Propiedad | Valor |
| ------------------------------ | ------------------ |
| Requerido | verdadero |
| Valor predeterminado | |
| Tipo | Cadena |
| Nombre para mostrar del portal | Tipo de aplicación |
**Opciones del portal**
| Opción del portal | Valor |
| --------------------------- | -------------- |
| Aplicación empresarial | nonwebapp |
| Aplicación de acceso rápido | quickaccessapp |
#### connectorGroup
Grupo de conectores que publica la aplicación. Los grupos disponibles se configuran en la personalización del runbook.
| Propiedad | Valor |
| ------------------------------ | ------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Nombre para mostrar del portal | Grupo de conectores |
#### destinationHost
Dónde reside la aplicación: un nombre de host (example.com), una única IP (192.168.0.1), un rango CIDR (192.168.0.1/24) o un rango de IPs (192.168.0.1..192.168.0.20).
| Propiedad | Valor |
| ------------------------------ | ----------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Nombre para mostrar del portal | Host o rango de destino |
#### destinationType
Tipo de destino, derivado automáticamente del formato del host de destino.
| Propiedad | Valor |
| -------------------- | ----------------------------------------------------------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Oculto en el portal | sí (preconfigurado mediante la personalización del runbook) |
#### ports
Puertos a publicar: un solo puerto (443), varios (80,443) o un rango (8000-8080).
| Propiedad | Valor |
| ------------------------------ | ------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Nombre para mostrar del portal | Puertos |
#### protocol
TCP, UDP o ambos.
| Propiedad | Valor |
| ------------------------------ | --------- |
| Requerido | falso |
| Valor predeterminado | |
| Tipo | Cadena |
| Nombre para mostrar del portal | Protocolo |
**Opciones del portal**
| Opción del portal | Valor |
| ----------------- | ------- |
| TCP | tcp |
| UDP | udp |
| TCP,UDP | tcp,udp |
[Volver a la vista general de referencia del runbook](/es/automatizacion/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/es/automatizacion/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.