> 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/connecting-azure-automation.md).

# Conectando Azure Automation

Conecta una cuenta de Azure Automation a RealmJoin Portal con el módulo de PowerShell de RealmJoin, para que RealmJoin pueda implementar, ejecutar y supervisar runbooks en tu Tenant.

## Resumen

Para permitir que RealmJoin Portal entregue [runbooks](https://docs.realmjoin.com/es/automatizacion/runbooks.md) para automatizar tareas diarias, debes conectar una [Azure Automation](https://learn.microsoft.com/en-us/azure/automation/overview) Cuenta. Actúa como el host de tus runbooks y proporciona los [permisos](https://docs.realmjoin.com/es/automatizacion/connecting-azure-automation/azure-ad-roles-and-permissions.md) que los runbooks necesitan para funcionar en tu entorno.

La cuenta de automatización se configura con la [módulo PowerShell de RealmJoin](https://docs.realmjoin.com/es/despliegue/onboarding-realmjoin-portal/advanced-setup.md). El Portal genera para ti un comando listo para copiar — no hay ningún registro de aplicación que crear ni ningún secreto de cliente que administrar.

{% hint style="info" %}
¿Ya están configurados los runbooks para tu Tenant con la versión heredada de **RealmJoin Runbook Management** registro de aplicación? Entonces consulta [Cambio a la aplicación administrada de RealmJoin](https://docs.realmjoin.com/es/automatizacion/connecting-azure-automation/managed-app-migration.md). Conserva tu cuenta de automatización y tus runbooks, y elimina el secreto de cliente por Tenant.
{% endhint %}

## Consideraciones

De la cuenta de automatización [Identidad administrada](https://learn.microsoft.com/en-us/azure/active-directory/managed-identities-azure-resources/overview) requiere amplios [permisos](https://docs.realmjoin.com/es/automatizacion/connecting-azure-automation/azure-ad-roles-and-permissions.md) en tu entorno, como la capacidad de modificar objetos de grupo o de usuario en Entra ID o de administrar buzones en Exchange Online. Limita el acceso administrativo a esta cuenta para evitar el uso indebido de estos privilegios.

Al usar una cuenta de automatización existente, ten en cuenta que RealmJoin Portal crea, actualiza y elimina automáticamente los runbooks procedentes del [repositorio en línea compartido de runbooks](https://github.com/realmjoin/realmjoin-runbooks). Es posible que esta funcionalidad no sea compatible con una cuenta de automatización existente. Si no estás seguro, recomendamos crear una cuenta de automatización de Azure dedicada para los runbooks de RealmJoin — algo que el comando de configuración hace por ti.

## Qué despliega la configuración

Al ejecutar el comando de configuración se crea:

* Los **RealmJoin Azure Resources** Service Principal en tu tenant de Entra ID (si aún no existe)
* Un **cuenta de automatización** con una identidad administrada asignada por el sistema, en la región del grupo de recursos — o tu cuenta de automatización existente, si indicas una
* **Contributor** para el Service Principal de RealmJoin, con ámbito en esa cuenta de automatización, para que RealmJoin pueda sincronizar e iniciar runbooks
* Los **permisos de aplicación** para la identidad administrada que incluye el módulo — Microsoft Graph, Office 365 Exchange Online, Windows Defender ATP y SharePoint Online

RealmJoin se autentica frente a Azure con su propia aplicación multitenant. No se crea ningún registro de aplicación ni ningún secreto de cliente en tu Tenant, y RealmJoin no recibe permisos fuera de esa cuenta de automatización.

{% hint style="warning" %}
De la identidad administrada **roles de directorio de Entra ID** — Intune Administrator, Exchange Administrator, User Administrator, etc. — se **no** asignan mediante el comando de configuración. Aun así, deben concederse por separado; consulta [Concesión de roles y permisos](https://docs.realmjoin.com/es/automatizacion/connecting-azure-automation/azure-ad-roles-and-permissions.md#granting-roles-and-permissions). Sin ellos, gran parte de los runbooks compartidos no funcionará.
{% endhint %}

## Requisitos previos

### En el Portal de RealmJoin

* Un rol que concede acceso al área de Configuración (`CanReadSettingsDetails`, consulta [Permisos disponibles](https://docs.realmjoin.com/es/administracion-y-configuracion/permission/custom-roles/available-permissions.md)). La página de configuración genera el comando de configuración, incluido un token de incorporación de corta duración.

### En Azure

* Una suscripción de Azure y un **grupo de recursos existente** para desplegar en — el módulo no crea el grupo de recursos. Se recomienda un grupo de recursos separado para la cuenta de automatización.
* Opcionalmente, una cuenta de automatización existente. Si no indicas una, se crea una para ti.

### En la máquina que ejecuta PowerShell

* **PowerShell 5.1** o posterior (Windows PowerShell o PowerShell 7)
* Acceso a la [PowerShell Gallery](https://www.powershellgallery.com/packages/RealmJoin) para instalar el módulo RealmJoin
* Los `Az.Accounts`, `Az.Resources` y `Az.Automation` módulos — el módulo RealmJoin los instala automáticamente en las versiones fijadas, para el usuario actual

### Permisos de la cuenta con la que inicias sesión

* **Microsoft Entra ID:** permiso para crear Service Principals **y para conceder permisos de aplicación** — la configuración asigna roles de aplicación de Graph, Exchange, Defender y SharePoint a la identidad administrada. En la práctica, esto significa *Global Administrator* o *Privileged Role Administrator*.
* **Suscripción de Azure:** permiso para implementar en el grupo de recursos **y** para crear asignaciones de roles en él — por ejemplo *Owner*, o *Contributor* combinado con *User Access Administrator* / *Role Based Access Control Administrator*.
* El inicio de sesión se realiza a través de `Connect-AzAccount`, que usa la aplicación de primera parte **Azure PowerShell** . Los tenants que restringen el consentimiento del usuario pueden necesitar conceder primero consentimiento de administrador a esa aplicación.

{% hint style="warning" %}
Ejecuta el comando en una **recién abierta, local** sesión de PowerShell y evita **Azure Cloud Shell**. El módulo RealmJoin requiere versiones exactas de los `módulos Az.*` módulos. Si ya hay cargada otra versión en la sesión — que suele ser el caso en Cloud Shell — el módulo se detiene con un conflicto de versiones que solo puede resolverse abriendo una nueva sesión.
{% endhint %}

## Configuración

{% stepper %}
{% step %}

#### Prepara el grupo de recursos

En el Azure Portal, crea o selecciona el grupo de recursos que debe contener la cuenta de automatización. Anota su nombre y el ID de la suscripción en la que reside.

Si quieres usar un **workspace existente** cuenta de automatización, anota también su nombre.
{% endstep %}

{% step %}

#### Copia el comando desde RealmJoin Portal

En el RealmJoin Portal, ve a **Settings → Runbooks** (<https://portal.realmjoin.com/settings/runbooks-configuration>).

La página indica que la configuración de runbooks se administra mediante el módulo de PowerShell de RealmJoin y muestra un bloque de comandos. Usa el **botón Copiar** para copiarlo.

```powershell
$latest = [version](Find-Module RealmJoin -Repository PSGallery -ErrorAction Stop).Version
if (-not (Get-Module -ListAvailable RealmJoin | Where-Object Version -ge $latest)) {
    Install-Module RealmJoin -Force -AllowClobber -ErrorAction Stop
}
Import-Module RealmJoin -Force
Set-RJAutomationAccount -Token "<Token>" 6>&1
```

{% hint style="info" %}
**Acerca de `6>&1`:** estos comandos informan de su progreso en el flujo de información de PowerShell. La `6>&1` redirección muestra esa salida en la consola — sin ella no verás ningún mensaje de progreso.
{% endhint %}
{% endstep %}

{% step %}

#### Agrega los parámetros de destino

`Set-RJAutomationAccount` necesita saber dónde implementar. Completa la última línea antes de ejecutarlo:

```powershell
Set-RJAutomationAccount -ResourceGroupName "rg-realmjoin" -SubscriptionId "<SubscriptionId>" -Token "<Token>" 6>&1
```

* `-ResourceGroupName` es obligatorio. Si lo omites, PowerShell te lo solicitará.
* `-SubscriptionId` es opcional — sin él, se usa la suscripción de tu contexto actual de Azure, y se te pide elegir si hay varias disponibles.
* `-AutomationAccountName` es opcional. Pásalo para definir el nombre de una nueva cuenta de automatización o para usar una **workspace existente** cuenta; de lo contrario, se crea una nueva con un nombre generado.

{% hint style="warning" %}
Apuntar el comando a una cuenta de automatización existente también establece las configuraciones que RealmJoin espera en ella: una identidad administrada asignada por el sistema, el SKU Basic y el acceso a red público. Comprueba si eso se ajusta a tus requisitos antes de reutilizar una cuenta.
{% endhint %}
{% endstep %}

{% step %}

#### Ejecuta el comando

Pega el bloque en una nueva sesión de PowerShell y ejecútalo. El token es válido durante aproximadamente una hora — si ha caducado, vuelve a cargar la página de configuración y copia el comando de nuevo.

Se te pedirá iniciar sesión con `Connect-AzAccount`. Si tu cuenta tiene acceso a varios tenants o suscripciones, el módulo te pedirá que elijas.

El despliegue se ejecuta en tres pasos — Service Principal, cuenta de automatización, permisos — y muestra cada recurso a medida que se crea. Una sola ejecución suele tardar unos minutos.

{% hint style="info" %}
¿Quieres ver primero qué ocurriría? Añade `-WhatIf` para obtener una vista previa What-If de Azure Resource Manager. Ten en cuenta que iniciar sesión e instalar los `módulo Az` módulos sigue ocurriendo, porque la vista previa necesita ambas cosas.
{% endhint %}

{% hint style="info" %}
**Cerrar sesión después:** el inicio de sesión de Azure sigue activo después de que el comando haya terminado. Cuando hayas terminado, ejecuta `Disconnect-AzAccount` para cerrar la sesión activa.
{% endhint %}
{% endstep %}

{% step %}

#### Asigna los roles de Entra ID a la identidad administrada

La configuración concede a la identidad administrada sus permisos de aplicación, pero no sus roles de directorio de Entra ID. Asígnalos ahora — consulta [Concesión de roles y permisos](https://docs.realmjoin.com/es/automatizacion/connecting-azure-automation/azure-ad-roles-and-permissions.md#granting-roles-and-permissions) la lista actual y un script que lo hace.

El ID de objeto de la identidad administrada se muestra en el Azure Portal en la cuenta de automatización, en Account Settings > Identity.

<figure><img src="https://3832142177-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2F4ecZSM3NW9PWJJlaNmR4%2Fimage.png?alt=media&amp;token=e5d5b56b-50f3-4f35-a41b-7cb4230dd3f3" alt=""><figcaption><p>Identidad administrada de la cuenta de automatización</p></figcaption></figure>
{% endstep %}

{% step %}

#### Verifica en el Portal e inicia la primera sincronización

Vuelve a **Settings → Runbooks** y selecciona **Actualizar**. RealmJoin detecta la nueva configuración e inicia la importación inicial de runbooks. Deja la página abierta hasta que se complete la sincronización.

La suscripción, el grupo de recursos, el nombre de la cuenta de automatización y la ubicación ahora se muestran solo lectura en **Conexión de Azure** — a partir de ahora las mantiene el módulo de PowerShell.
{% endstep %}
{% endstepper %}

## Configuraciones que administras en el Portal

Dos configuraciones siguen siendo editables en **Settings → Runbooks** después de la configuración:

* **Rama** — la rama del [repositorio compartido de runbooks](https://github.com/realmjoin/realmjoin-runbooks) que quieres seguir. La configuración lo establece en `production`, que es la opción correcta salvo que tengas un motivo para desviarte.
* **Habilitar la sincronización de Hybrid Runbook Worker** y el grupo de workers a usar, consulta [Hybrid Runbook Worker](https://docs.realmjoin.com/es/automatizacion/runbooks/hybrid-runbook-worker.md). El grupo debe estar registrado en la cuenta de automatización antes de que pueda seleccionarse aquí.

Guardar cualquiera de los dos desencadena una sincronización de runbooks.

Si más adelante encuentras problemas de configuración o de permisos, el **Mostrar cmdlet** botón bajo Conexión de Azure vuelve a mostrar el comando — volver a ejecutarlo es seguro y solo aplica lo que falta.

## Configuración heredada (app registration por Tenant)

{% hint style="warning" %}
La configuración siguiente crea una **RealmJoin Runbook Management** registro de aplicación con un secreto de cliente en tu Tenant. Solo se documenta como referencia para tenants que se configuraron así en el pasado. No la uses para nuevas configuraciones — sigue la [Configuración](#setup) anterior, o [para cambiar una configuración existente a la aplicación administrada](https://docs.realmjoin.com/es/automatizacion/connecting-azure-automation/managed-app-migration.md).
{% endhint %}

<details>

<summary>Mostrar la configuración heredada</summary>

En este camino, la cuenta de automatización se creó manualmente en el Azure Portal, sus permisos se asignaron con dos scripts externos, y RealmJoin se autenticó con un registro de aplicación y un secreto de cliente por Tenant.

**Parte 1 — Crear una cuenta de automatización de Azure**

1. Ve a tu [Azure Portal > Automation Accounts](https://portal.azure.com/#create/Microsoft.AutomationAccount) y crea una nueva cuenta de automatización.
2. En la pestaña Basics, elige tu suscripción, grupo de recursos, nombre de la cuenta de automatización y región.
3. En la pestaña Advanced, asegúrate de que System Assigned Managed Identity esté habilitada.
4. Selecciona Review + Create y crea tu cuenta de automatización.
5. Ve al grupo de recursos que contiene la cuenta de automatización y, en la pestaña IAM, asigna la cuenta de automatización como Contributor.

![Creación de la cuenta de automatización](https://3832142177-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FqjBLc2zH3XCCqfAViEsU%2Fimage.png?alt=media\&token=257816e0-eb8a-478c-973f-fb288324d8c8)

![Habilitar la identidad administrada asignada por el sistema](https://3832142177-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FM9N3OxNzrzQXFxSaKIpP%2Fimage.png?alt=media\&token=1e7c4d5b-d604-415b-89e0-4816a7f04a26)

**Parte 2 — Asignar permisos a la cuenta de automatización**

Los permisos de la identidad administrada no se pueden conceder a través del Azure Portal. Los [approle-and-directoryrole-granter](https://github.com/Workplace-Foundation/approle-and-directoryrole-granter) scripts asignan tanto los permisos de aplicación como los roles de Entra ID a partir de los archivos JSON publicados en el [repositorio de runbooks](https://github.com/realmjoin/realmjoin-runbooks/tree/production/docs/other/json):

```powershell
. .\GrantAppPermToEntApp.ps1 -enterpriseAppObjId "<ManagedIdentityObjectId>" -permissionsTemplate .\AllRealmJoinRunbooks_collected_permissions.json
. .\AssignAzureADRoleToEntApp.ps1 -objectId "<ManagedIdentityObjectId>" -rolesTemplate .\AllRealmJoinRunbooks_collected_rbacroles.json
```

**Parte 3 — Crear el Service Principal para RealmJoin**

En el Portal, en Settings > Runbooks, primero se introdujeron el Tenant ID, el Subscription ID y el Resource Group; luego la página mostró un fragmento de Azure CLI para ejecutar, que creó el **RealmJoin Runbook Management** registro de aplicación con permisos de Contributor en el grupo de recursos:

```
az provider register --namespace Microsoft.Automation
az ad sp create-for-rbac -n "RealmJoin Runbook Management" --role contributor --scopes /subscriptions/<SubscriptionId>/resourceGroups/<ResourceGroup>
```

**Parte 4 — Completar el asistente**

De vuelta en el Portal, el `appId` y `password` de esa salida se introdujeron junto con el nombre de la cuenta de automatización, la rama del repositorio compartido de runbooks (`production`) y la ubicación de la cuenta de automatización. Guardar inició la importación inicial de runbooks.

![Conexión de cuenta de automatización en RealmJoin Portal](https://3832142177-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FA0X3M2c9d13pxVt87Pf8%2Fimage.png?alt=media\&token=8e2f2b18-c3b1-4704-8cc8-eb4d43297dd1)

</details>


---

# 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/connecting-azure-automation.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.
