> 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-permissions.md).

# Permisos de Runbook

Cómo conceder o denegar acceso a determinados runbooks.

{% embed url="<https://www.youtube.com/watch?v=bLi_k_Yzhyw>" %}

## Alcance

Esto aborda cómo conceder/denegar acceso a ciertos runbooks en un Tenant de Azure. Si busca respuestas sobre qué permisos de la API MS Graph se necesitan para ejecutar una cierta acción como runbook, eche un vistazo a nuestro [requisitos](https://docs.realmjoin.com/es/automatizacion/connecting-azure-automation/azure-ad-roles-and-permissions.md).

## Resumen

"Runbook Permissions" define la visibilidad de los runbooks para ciertos usuarios. Algunos runbooks también pueden bloquearse/ocultarse globalmente.

Como la [Personalizaciones del runbook](https://docs.realmjoin.com/es/automatizacion/runbooks/runbook-customization.md), la definición de estos permisos se realiza proporcionando una configuración con formato JSON como administrador de RealmJoin en el portal web de RealmJoin en <https://portal.realmjoin.com/settings/runbooks-permissions> .

### Acerca de esta guía

Daremos una breve descripción de la sintaxis y luego construiremos un ejemplo completo paso a paso. Siéntase libre de ir directamente al ejemplo completo y empezar desde [allí](#targetentitygroups).

## Sintaxis de configuración

### Nombres de runbooks

Los runbooks se referencian por sus nombres tal como se ven en la cuenta de Azure Automation, por ejemplo `rjgit-group_general_remove-group`.

Se pueden usar comodines ('\*') para coincidir con varios runbooks. Se pueden usar varios comodines en la misma cadena, por ejemplo `rjgit-*_security_*`. Esto incluiría todos los siguientes ejemplos:

* `rjgit-org_security_list-inactive-users`
* `rjgit-device_security_enable-or-disable-device`

El prefijo `rjgit-` denota runbooks que se importan desde nuestro repositorio público de GitHub. Los runbooks específicos del cliente no tienen prefijo, por ejemplo `user_userinfo_custom-runbook`

### Entra ID Groups

Los grupos de Entra ID se referenciarán usando su Object ID, como `91688d11-9a34-42cd-8d1e-ce617d6c1234`. Actualmente, solo se pueden usar grupos de seguridad.

## Estructura y ejemplo de JSON

Construiremos un ejemplo completo de configuración paso a paso.

Una configuración JSON consta de varias secciones, pero todas las secciones son opcionales y se pueden omitir.

Se permite agregar comentarios usando el prefijo "//".

### EnabledRunbookPatterns

Esta sección contiene una lista de runbooks permitidos para ser usados. Si se omite esta sección, todos los runbooks están habilitados/permitidos de forma predeterminada.

Si define esta sección, entonces solo los runbooks mencionados en esta sección podrán ser usados por cualquier rol / soporte y administrador.

#### Ejemplo

* Permitir solo ciertos runbooks individuales indicando su nombre completo

  `rjgit-group_general_remove-group`
* Permitir todos los runbooks relacionados con dispositivos de nuestro repositorio compartido

  `rjgit-device_*`
* Permitir todos los runbooks compartidos de usuario

  `rjgit-user_*`
* Permitir todos los runbooks relacionados con usuarios específicos del cliente (locales)

  `user_*`

Esto deja implícitamente fuera muchos runbooks basados en grupos y todos los basados en org. Tenga en cuenta.

```
{
  "EnabledRunbookPatterns": [
    "rjgit-group_general_remove-group",
    "rjgit-device_*",
    "rjgit-user_*",
    "user_*"
  ]
}
```

### DisabledRunbookPatterns

Una lista de runbooks que están globalmente deshabilitados / prohibidos. Si se omite esta sección o está vacía, todos los runbooks habilitados (proporcionados mediante [EnabledRunbookPatterns](#enabledrunbookpatterns)) pueden usarse.

Las entradas de esta sección tienen prioridad sobre las entradas en [EnabledRunbookPatterns ](#enabledrunbookpatterns)- los runbooks estarán ocultos/no podrán ser usados por nadie en este Tenant.

#### Ejemplo

Reutilizaremos la `EnabledRunbookPatterns` sección anterior.

* Deshabilitar todos los runbooks compartidos (`rjgit-`) en la `seguridad` categoría.

```
{
  "EnabledRunbookPatterns": [
    "rjgit-group_general_remove-group",
    "rjgit-device_*",
    "rjgit-user_*",
    "user_*"
  ],
  "DisabledRunbookPatterns": [
    "rjgit-*_security_*"
  ]
}
```

### Roles

En esta sección puede asignar una lista de runbooks a un grupo de Entra ID. Esto permite definir múltiples roles de soporte/operador en su Tenant.

Si se omite esta sección, todo el soporte y los administradores de RealmJoin tienen acceso a todos los runbooks indicados en las secciones anteriores.

{% hint style="warning" %}
Si está habilitado, todos los usuarios que no pertenezcan a un rol no verán ningún runbook.
{% endhint %}

#### Ejemplo

Continuando con lo que tenemos, creemos un rol de soporte de dispositivos `DeviceAdmin` y un rol de soporte de usuarios `UserAdmin`.

Aplicaremos esos roles a varios grupos de Entra ID y para cada rol daremos una lista de runbooks permitidos. Tenga en cuenta: esto restringirá el rol de soporte de usuarios a solo un pequeño conjunto de runbooks.

Añadamos comentarios ("//") junto al object id del grupo que ayuden al lector proporcionando los nombres de los grupos de Entra ID.

```json
{
  "EnabledRunbookPatterns": [
    "rjgit-group_general_remove-group",
    "rjgit-device_*",
    "rjgit-user_*",
    "user_*"
  ],
  "DisabledRunbookPatterns": [
    "rjgit-*_security_*"
  ],
  "Roles": {
    "DeviceAdmin": {
      "Groups": [
        "9cbfc0af-c217-41e9-b790-3043788f1234", // 1.er Grupo de soporte de dispositivos de AAD
        "5555c0af-c217-41e9-b790-3043788f1234"  // 2.º Grupo de soporte de dispositivos de AAD - otro equipo
      ],
      "AllowedRunbookPatterns": [
        "rjgit-device_*"
      ]
    },
    "UserAdmin": {
      "Groups": [
        "1234c0af-c217-41e9-b790-3043788f1234" // Grupo de soporte de usuarios de AAD
      ],
      "AllowedRunbookPatterns": [
        "rjgit-user_general_assign-or-unassign-license",
        "rjgit-user_mail_*",
        "user_*"
      ]
    }
  }
}
```

Ahora el `UserAdmin` rol puede:

* asignar licencias a todos los usuarios de su Tenant
* modificar las direcciones de correo electrónico de todos los usuarios de su Tenant

Los `DeviceAdmin` rol puede

* borrar cualquier dispositivo de su Tenant

### TargetEntityGroups

Quizá tenga algunos usuarios VIP cruciales. No debería ser posible que cualquier personal de soporte borre el dispositivo de un VIP o modifique la dirección de correo electrónico de un VIP. Podemos usar "targeting" para restringir roles sobre usuarios críticos a equipos dedicados.

Los "Devices" se dirigirán mediante su usuario principal/asignado, pero no mediante el objeto de dispositivo en Entra ID. Esto permite ceñirse a un modelo de grupos puramente basado en usuarios.

Suponemos que existen grupos de Entra ID que contienen usuarios VIP críticos. Usando esta sección, podemos delimitar cuidadosamente algunos roles y runbooks más críticos para estos grupos específicos de Entra ID (objetivos).

Obviamente, si omite esta sección, todos los usuarios/grupos/dispositivos de su Tenant se tratan por igual.

Si define TargetEntityGroups, no debería tener ningún impacto en ningún otro grupo no mencionado en la sección.

#### Ejemplo completo

Suponga el grupo `0000c0af-c217-41e9-b790-3043788f0000` es nuestro grupo de usuarios VIP.

Introducimos un nuevo grupo de Entra ID `4444c0af-c217-41e9-b790-3043788f4444` que contiene personal de soporte que ha sido aprobado para administrar usuarios VIP. Este personal de soporte también debería tener todos los demás permisos básicos de soporte, así que los agregaremos a los roles existentes.

"Restringir" un rol no otorgará nuevos roles a un miembro del soporte.

```json
{
  "EnabledRunbookPatterns": [
    "rjgit-group_general_remove-group",
    "rjgit-device_*",
    "rjgit-user_*",
    "user_*"
  ],
  "DisabledRunbookPatterns": [
    "rjgit-*_security_*"
  ],
  "Roles": {
    "DeviceAdmin": {
      "Groups": [
        "9cbfc0af-c217-41e9-b790-3043788f1234", // 1.er Grupo de soporte de dispositivos de AAD
        "5555c0af-c217-41e9-b790-3043788f1234"  // 2.º Grupo de soporte de dispositivos de AAD - otro equipo
        "4444c0af-c217-41e9-b790-3043788f4444"  // Soporte VIP
      ],
      "AllowedRunbookPatterns": [
        "rjgit-device_*"
      ]
    },
    "UserAdmin": {
      "Groups": [
        "1234c0af-c217-41e9-b790-3043788f1234", // Grupo de soporte de usuarios de AAD
        "4444c0af-c217-41e9-b790-3043788f4444"  // Soporte VIP
      ],
      "AllowedRunbookPatterns": [
        "rjgit-user_general_assign-or-unassign-license",
        "rjgit-user_mail_*",
        "user_*"
      ]
    }
  },
  "TargetEntityGroups": {
    "0000c0af-c217-41e9-b790-3043788f0000": {  // Usuarios VIP - ¡Trátelos con cuidado!
      "RestrictRoles": {
        "UserAdmin": [
          "4444c0af-c217-41e9-b790-3043788f4444" // Soporte VIP
        ],
        "DeviceAdmin": [
          "4444c0af-c217-41e9-b790-3043788f4444" // Soporte VIP
        ]
      }
    }
  }
}
```

#### **Ejemplo: restringir al personal de soporte de EE. UU. para que gestione solo usuarios de EE. UU.**

En este escenario, tenemos personal de soporte con base en EE. UU. que solo debería gestionar usuarios ubicados en EE. UU. Para hacer cumplir esta restricción:

* Cree una regla de permisos que explícitamente **deniega** a los soportes de EE. UU. la capacidad de ejecutar runbooks en **todos los usuarios**.
* Añada una regla de excepción que específicamente **permite** la ejecución de runbooks solo para **usuarios de EE. UU.**.

Esto garantiza que los soportes de EE. UU. tengan permisos estrictamente limitados a su público objetivo previsto (usuarios de EE. UU.) y evita interacciones accidentales con usuarios fuera de este ámbito.

**Implementación**

1. Se debe asignar un grupo de Entra de ejecutores de runbooks en el portal de RealmJoin
   1. Configuración > Permisos > Permisos de ejecutor de runbooks
   2. El grupo de Entra de los soportes de EE. UU. debe ser miembro del grupo de ejecutores de runbooks para permitir la operación general de runbooks en el portal de RealmJoin.
2. Agregar un nuevo rol en Configuración > Permisos de runbooks
   1. En la sección Roles, añada el rol USSupporters con su grupo de Entra (object ID del grupo)
   2. Añada AllowedRunbookPatterns para USSupporters
3. Modifique TargetEntityGroups
   1. El grupo All-Users debe restringir el rol USSupporters con un valor vacío (aquí no se añade ningún object ID de grupo de Entra). ¡Esto es una denegación implícita!
   2. El grupo US Users debe restringir el rol USSupporters al object ID del grupo de Entra de US Supporters

<figure><img src="https://3832142177-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FZ56Ipx6VuZDjIeZO2MTC%2Fimage.png?alt=media&amp;token=e3f5fe54-0d17-46f0-a106-f51d548bde64" alt=""><figcaption><p>Restringir al personal de soporte de EE. UU. para que gestione solo usuarios de EE. UU.</p></figcaption></figure>

A continuación, el ejemplo completo para este escenario:

```json
{
  // Permiso del portal:
  // Rol de ejecutor de runbooks: US Supporters

  // Membresías de grupo:
  // 3e1e7540-7f0c-483c-b9bf-500342e2467c: Todos los usuarios
  // c603278c-cc36-4661-bb7a-eecb7ab079f9: Soportes de EE. UU.
  // 0f76d01e-cc6b-4553-bf1d-e4ccedd9c824: Usuarios de EE. UU.

  "EnabledRunbookPatterns": [ // Habilitación general de runbooks de correo y seguridad
    "rjgit-*_mail_*",
    "rjgit-*security*"
  ],
  "DisabledRunbookPatterns": [
    "*password*"
  ],

  "Roles": {
    "USSupporters": {
      "Groups": [
        "c603278c-cc36-4661-bb7a-eecb7ab079f9" // Soportes de EE. UU.
      ],
      "AllowedRunbookPatterns": [ // runbooks permitidos para este rol - Soportes de EE. UU.
        "rjgit-user_*",
        "rjgit-device_*",
        "rjgit-group_*"
      ]
    }
  },
  
  "TargetEntityGroups": {
    "3e1e7540-7f0c-483c-b9bf-500342e2467c": { // Todos los usuarios
      "RestrictRoles": {
        "USSupporters": [
          // en general, no permita runbooks para ningún soporte de EE. UU.
        ]
      }
    },
    "0f76d01e-cc6b-4553-bf1d-e4ccedd9c824": { // Usuarios de EE. UU.
      "RestrictRoles": {
        "USSupporters": [
          "c603278c-cc36-4661-bb7a-eecb7ab079f9" // Soportes de EE. UU.
        ]
      }
    }
  }
}
```

### SchedulingEnabledRunbookPatterns

Esta sección contiene una lista de runbooks que se marcarán como "programables". RealmJoin Port permitirá asignar/administrar programaciones para estos runbooks. Consulte [Programación de Runbook](https://docs.realmjoin.com/es/automatizacion/runbooks/scheduling.md).

El siguiente ejemplo describe el comportamiento predeterminado si no se definen SchedulingEnabledRunbookPatterns:

```json
{
  "SchedulingEnabledRunbookPatterns": [
    "*_scheduled"
  ]
}
```

### SchedulingDisabledRunbookPatterns

Esta sección contiene una lista de runbooks que serán incluidos en la lista negra para no ser marcados como "programables". RealmJoin Port no permitirá asignar/administrar programaciones para estos runbooks. Consulte [Programación de Runbook](https://docs.realmjoin.com/es/automatizacion/runbooks/scheduling.md).

Un runbook presente tanto en SchedulingEnabledRunbookPatterns como en SchedulingDisabledRunbookPatterns **no** podrá programarse.

De forma predeterminada, no hay runbooks en la lista negra. El siguiente ejemplo solo demuestra la sintaxis:

```json
{
  "SchedulingDisabledRunbookPatterns": [
    "rjgit-user_*"
  ]
}
```


---

# 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-permissions.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.
