> 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 grupo de seguridad 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 de nuevo.

### 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 | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)</p> |
| Programable        | no                                                                                       |

### Permisos

#### Permisos de aplicación

* **Tipo**: Microsoft Graph
  * Application.ReadWrite.All
    * *Instancia la aplicación a partir de la plantilla de aplicación, aplica un parche a onPremisesPublishing y agrega segmentos de aplicación*
  * Directory.ReadWrite.All
    * *Necesario para los endpoints de App Proxy: lee los grupos de conectores y asigna el connectorGroup de la aplicación*
  * Group.ReadWrite.All
    * *Crea el grupo de seguridad de acceso para la aplicación y lo elimina en la reversión*
  * AppRoleAssignment.ReadWrite.All
    * *Asigna el grupo de acceso a la aplicación a través de /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                   |
| -------------------------------- | ----------------------- |
| Obligatorio                      | true                    |
| Valor predeterminado             |                         |
| Tipo                             | Cadena                  |
| Nombre para mostrar en el portal | Nombre de la aplicación |

#### prefijo

Texto colocado delante del nombre. Se inserta un espacio a menos que el prefijo termine con un guion, guion bajo o espacio.

| Propiedad                        | Valor                               |
| -------------------------------- | ----------------------------------- |
| Obligatorio                      | true                                |
| Valor predeterminado             |                                     |
| Tipo                             | Cadena                              |
| Nombre para mostrar en el portal | Prefijo del nombre de la aplicación |

#### prefijo del grupo

Texto colocado delante del nombre del grupo de acceso, independientemente del prefijo de la aplicación. Por lo general, se preestablece en la personalización del runbook.

| Propiedad                        | Valor                        |
| -------------------------------- | ---------------------------- |
| Obligatorio                      | falso                        |
| Valor predeterminado             | App - Entra - GSA -          |
| Tipo                             | Cadena                       |
| Nombre para mostrar en el portal | Prefijo del nombre del grupo |

#### sufijo del grupo

Texto añadido al nombre del grupo de acceso, por ejemplo " (usuarios)". Déjelo vacío si no se desea ninguno.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Obligatorio          | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preestablecido mediante la personalización del runbook) |

#### applicationType

Enterprise App crea una nueva aplicación GSA. Quick Access App agrega el segmento a la aplicación Quick Access existente del Tenant, en su lugar.

| Propiedad                        | Valor              |
| -------------------------------- | ------------------ |
| Obligatorio                      | true               |
| Valor predeterminado             |                    |
| Tipo                             | Cadena             |
| Nombre para mostrar en el 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               |
| -------------------------------- | ------------------- |
| Obligatorio                      | falso               |
| Valor predeterminado             |                     |
| Tipo                             | Cadena              |
| Nombre para mostrar en el portal | Grupo de conectores |

#### destinationHost

Dónde reside la aplicación: un nombre de host (example.com), una sola IP (192.168.0.1), un intervalo CIDR (192.168.0.1/24) o un rango de IP (192.168.0.1..192.168.0.20).

| Propiedad                        | Valor                   |
| -------------------------------- | ----------------------- |
| Obligatorio                      | falso                   |
| Valor predeterminado             |                         |
| Tipo                             | Cadena                  |
| Nombre para mostrar en el portal | Host o rango de destino |

#### destinationType

Tipo de destino, derivado automáticamente del formato del host de destino.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Obligatorio          | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preestablecido mediante la personalización del runbook) |

#### puertos

Puertos que publicar: un solo puerto (443), varios (80,443) o un intervalo (8000-8080).

| Propiedad                        | Valor   |
| -------------------------------- | ------- |
| Obligatorio                      | falso   |
| Valor predeterminado             |         |
| Tipo                             | Cadena  |
| Nombre para mostrar en el portal | Puertos |

#### protocolo

TCP, UDP o ambos.

| Propiedad                        | Valor     |
| -------------------------------- | --------- |
| Obligatorio                      | falso     |
| Valor predeterminado             |           |
| Tipo                             | Cadena    |
| Nombre para mostrar en el portal | Protocolo |

**Opciones del portal**

| Opción del portal | Valor   |
| ----------------- | ------- |
| TCP               | tcp     |
| UDP               | udp     |
| TCP, UDP          | tcp,udp |

[Volver al resumen de referencia de Runbook](https://docs.realmjoin.com/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=<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.
