> 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/security/sync-mfa-secure-users-to-group_scheduled.md).

# Sincronizar usuarios seguros de MFA con el grupo programado

Mantener un grupo poblado con usuarios que registraron un método seguro de MFA

{% hint style="info" %}
Este es un runbook programado. Está diseñado para ejecutarse según una programación recurrente en lugar de activarse para un único objeto. Véase [Programación](/es/automatizacion/runbooks/scheduling.md) para obtener detalles sobre cómo configurar las programaciones del runbook.
{% endhint %}

### Descripción

Mantiene un grupo de Entra ID sincronizado con los usuarios que registraron al menos un método de autenticación seguro, como una clave de acceso o la aplicación Microsoft Authenticator. Los usuarios que pierden su método seguro se eliminan. Los administradores, un grupo de exclusión y usuarios individuales pueden quedar excluidos, por ejemplo cuando el grupo controla el restablecimiento de contraseña de autoservicio. Una ejecución de prueba solo muestra los cambios, y el informe puede enviarse por correo electrónico o proporcionarse mediante un enlace de descarga. Los detalles sobre las opciones están en la documentación del runbook (docs.realmjoin.com).

### Cómo funciona

El runbook lee el Entra ID [informe de registro de métodos de autenticación](https://learn.microsoft.com/en-us/graph/api/authenticationmethodsroot-list-userregistrationdetails) (`userRegistrationDetails`) y refleja el grupo de destino frente a todos los **usuarios miembros** que cumplen los requisitos:

* Un usuario cumple los requisitos cuando al menos uno de sus métodos registrados está en el conjunto configurado de **seguro** .
* En **modo estricto** (`SecureOnly`), un usuario además no debe tener registrado ningún método del conjunto **no seguro** registrado: un usuario con clave de acceso que además conserva un factor SMS no cumple los requisitos.
* Los usuarios que cumplen los requisitos y que aún no son miembros del grupo se agregan; los miembros que ya no cumplen se eliminan (sincronización espejo).
* Los usuarios invitados nunca se agregan ni se eliminan. Los miembros de grupos que no son usuarios (dispositivos, service principals, grupos anidados) nunca se tocan.

El grupo de destino debe ser administrado exclusivamente por este runbook.

### Grupos de métodos seguros

Cada interruptor controla qué `methodsRegistered` valores cuentan como seguros:

| Interruptor                                  | Predeterminado | Valores cubiertos                                                                    |
| -------------------------------------------- | -------------- | ------------------------------------------------------------------------------------ |
| Claves de acceso / claves de seguridad FIDO2 | activado       | `fido2SecurityKey`, `passKeyDeviceBound`, `passKeyDeviceBoundAuthenticator`          |
| Credenciales de plataforma                   | activado       | `windowsHelloForBusiness`, `passKeyDeviceBoundWindowsHello`, `macOsSecureEnclaveKey` |
| Aplicación Microsoft Authenticator           | activado       | `microsoftAuthenticatorPush`, `microsoftAuthenticatorPasswordless`                   |
| OTP de software                              | desactivado    | `softwareOneTimePasscode`                                                            |
| OTP de hardware                              | desactivado    | `hardwareOneTimePasscode`                                                            |
| Autenticación basada en certificados         | activado       | `certificateBasedAuthentication`                                                     |

### Modo estricto (SecureOnly)

Con el modo estricto activado, los usuarios con cualquiera de los siguientes métodos inseguros integrados nunca cumplen los requisitos:

`mobilePhone`, `alternateMobilePhone`, `officePhone`, `email`, `securityQuestion`

Si un método termina estando en el conjunto seguro y en el conjunto inseguro (solo posible mediante los parámetros de anulación), gana el inseguro: esos usuarios nunca cumplen los requisitos en modo estricto. El runbook advierte sobre esto al iniciarse.

### Exclusiones

Los usuarios excluidos nunca cumplen los requisitos independientemente de sus métodos registrados: nunca se agregan al grupo de destino y se eliminan si ya son miembros. El informe por usuario muestra el motivo en la columna `ExclusionReason` .

#### Excluir usuarios administradores (`ExcludeAdmins`, activado de forma predeterminada)

Los usuarios que tienen un rol de directorio de Entra ID quedan excluidos. Esto abarca:

* **Asignaciones de roles activas** (`roleManagement/directory/roleAssignments`)
* **Asignaciones elegibles para PIM** (`roleManagement/directory/roleEligibilitySchedules`, requiere Entra ID P2: sin P2 el runbook recurre a las asignaciones activas y registra una advertencia)
* **Grupos asignables a roles**: los grupos que tienen un rol se expanden a sus miembros de usuario transitivos

Contexto: cuando el grupo de destino impulsa **SSPR** y la directiva del administrador de SSPR está deshabilitada, los administradores del grupo seguirían obligados a registrar un segundo factor una vez que se requieran dos métodos de SSPR. Mantener a los administradores fuera del grupo evita esto.

Esta opción requiere el permiso adicional de Graph `RoleManagement.Read.Directory` para la identidad administrada.

#### Grupo de exclusión (`ExcludeGroupId`, opcional)

Los miembros de usuario transitivos del grupo configurado quedan excluidos: pensado para cuentas que nunca deben ser administradas por esta sincronización, como **cuentas de emergencia** o **cuentas de servicio**. Se respetan los grupos anidados. El grupo de exclusión no debe ser el propio grupo de destino.

#### Usuarios excluidos individualmente (`ExcludeUserIds`, opcional)

Los usuarios individuales pueden excluirse directamente mediante el selector de varios usuarios: para exclusiones puntuales en las que no merece la pena mantener un grupo de exclusión dedicado. La lista acepta **identificadores de objeto** y **nombres principales de usuario** (UPN). Las entradas que no se pueden resolver (p. ej., una cuenta eliminada) registran una advertencia y se ignoran, por lo que una entrada obsoleta nunca rompe una sincronización programada.

#### Mantener exclusiones mediante la Personalización del runbook (sin los selectores)

Ambos parámetros de exclusión pueden preconfigurarse de forma central mediante la [Personalización del runbook basada en JSON](https://docs.realmjoin.com/automation/runbooks/runbook-customization#json-based-customizing) (portal RealmJoin: **Configuración** → **Personalizaciones del runbook**) — útil cuando las exclusiones están fijas para el tenant y no deben seleccionarse manualmente cada vez que se inicia o programa el runbook:

```json
{
    "Runbooks": {
        "rjgit-org_security_sync-mfa-secure-users-to-group_scheduled": {
            "Parameters": {
                "ExcludeGroupId": {
                    "DefaultValue": "00000000-0000-0000-0000-000000000000",
                    "Hide": true
                },
                "ExcludeUserIds": {
                    "DefaultValue": [
                        "11111111-1111-1111-1111-111111111111",
                        "breakglass@contoso.com"
                    ],
                    "Hide": true
                }
            }
        }
    }
}
```

* **ExcludeGroupId** toma un único grupo **identificador de objeto** (GUID) como una cadena simple; cópielo desde la página general del grupo en el centro de administración de Entra o en el portal RealmJoin.
* **ExcludeUserIds** toma un JSON **matriz de cadenas**; cada entrada puede ser un usuario **identificador de objeto** o un **UPN**. Las entradas se recortan y se deduplican; el runbook las resuelve al iniciarse.
* **Recomendado:** cuando las exclusiones se mantienen mediante la personalización del runbook, configure también `"Hide": true` en el parámetro (como en el ejemplo anterior). Esto lo elimina por completo del formulario de inicio, de modo que las exclusiones configuradas centralmente no puedan sobrescribirse en la interfaz al iniciar o programar el runbook. Sin `Ocultar`, los valores configurados solo aparecen precompletados y aún pueden cambiarse allí.

### Referencia de clasificación de métodos

Use los valores exactos de Graph de esta tabla al crear las cadenas de anulación separadas por comas:

| `methodsRegistered` valor            | Nombre descriptivo                                                   | Clasificación | Cubierto por el interruptor (predeterminado)    |
| ------------------------------------ | -------------------------------------------------------------------- | ------------- | ----------------------------------------------- |
| `fido2SecurityKey`                   | clave de seguridad FIDO2                                             | Seguro        | Claves de acceso / FIDO2 (activado)             |
| `passKeyDeviceBound`                 | Clave de acceso (vinculada al dispositivo)                           | Seguro        | Claves de acceso / FIDO2 (activado)             |
| `passKeyDeviceBoundAuthenticator`    | Clave de acceso en Microsoft Authenticator                           | Seguro        | Claves de acceso / FIDO2 (activado)             |
| `windowsHelloForBusiness`            | Windows Hello for Business                                           | Seguro        | Credenciales de plataforma (activado)           |
| `passKeyDeviceBoundWindowsHello`     | Clave de acceso en Windows Hello                                     | Seguro        | Credenciales de plataforma (activado)           |
| `macOsSecureEnclaveKey`              | Credencial de plataforma para macOS                                  | Seguro        | Credenciales de plataforma (activado)           |
| `microsoftAuthenticatorPush`         | Microsoft Authenticator (notificación push)                          | Seguro        | Aplicación Microsoft Authenticator (activado)   |
| `microsoftAuthenticatorPasswordless` | Microsoft Authenticator (inicio de sesión telefónico sin contraseña) | Seguro        | Aplicación Microsoft Authenticator (activado)   |
| `softwareOneTimePasscode`            | Token OATH de software (app TOTP)                                    | Seguro        | OTP de software (desactivado)                   |
| `hardwareOneTimePasscode`            | Token OATH de hardware                                               | Seguro        | OTP de hardware (desactivado)                   |
| `certificateBasedAuthentication`     | Autenticación basada en certificados                                 | Seguro        | Autenticación basada en certificados (activado) |
| `mobilePhone`                        | Teléfono (SMS / llamada de voz)                                      | No seguro     | lista integrada de elementos no seguros         |
| `alternateMobilePhone`               | Teléfono alternativo (llamada de voz)                                | No seguro     | lista integrada de elementos no seguros         |
| `officePhone`                        | Teléfono de oficina (llamada de voz)                                 | No seguro     | lista integrada de elementos no seguros         |
| `email`                              | Correo electrónico (solo SSPR)                                       | No seguro     | lista integrada de elementos no seguros         |
| `securityQuestion`                   | Preguntas de seguridad (solo SSPR)                                   | No seguro     | lista integrada de elementos no seguros         |
| `temporaryAccessPass`                | Temporary Access Pass                                                | Neutro        | nunca cumple los requisitos, nunca descalifica  |

Los valores desconocidos o futuros de Graph se tratan como neutros, a menos que se enumeren explícitamente en un parámetro de anulación.

### Parámetros de anulación

Ambos parámetros de anulación están ocultos de forma predeterminada y están pensados para la personalización del runbook de RealmJoin:

* **SecureMethodsOverride** — lista separada por comas de `methodsRegistered` valores que define el conjunto seguro. Cuando se establece, **todos** los interruptores de grupo de métodos se ignoran. Ejemplo: `fido2SecurityKey,passKeyDeviceBound,passKeyDeviceBoundAuthenticator,windowsHelloForBusiness`
* **UnsecureMethodsOverride** — lista separada por comas que reemplaza la lista integrada de no seguros. Solo se evalúa en modo estricto. Ejemplo: `mobilePhone,alternateMobilePhone,officePhone,email,securityQuestion,softwareOneTimePasscode`

Los valores desconocidos generan una advertencia, pero aun así se evalúan, por lo que los valores futuros de Graph pueden usarse antes de que esta documentación se actualice.

### Informe por correo electrónico y enlaces de descarga

Opcionalmente, se puede entregar un informe detallado, especialmente útil para revisar la primera ejecución (idealmente combinado con el modo de ejecución de prueba):

* **Enviar informe por correo electrónico** (`SendEmail`, desactivado de forma predeterminada): envía el informe a los destinatarios configurados. El campo de destinatario solo aparece cuando el correo electrónico está habilitado. Requiere la `RJReport.EmailSender` configuración del tenant (consulte la [documentación de configuración de informes de RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings)).
* **Crear enlaces de descarga de archivos** (`CreateDownloadLink`, desactivado de forma predeterminada): carga los archivos del informe en un Storage Account de Azure y devuelve enlaces de descarga con tiempo limitado (usa la `RJReport.StorageAccount.*` configuración del tenant).

Los archivos del informe solo se generan cuando al menos una de las dos opciones está habilitada. El informe consta de:

* **mfa-secure-users-group-sync-changes.csv** - todos los cambios realizados (o, en la ejecución de prueba, pendientes) con detalles por usuario de los métodos
* **mfa-secure-users-group-sync-all-users.csv** - la evaluación de cada usuario miembro: métodos registrados, clasificación seguro/no seguro, cumplimiento de requisitos, motivo de exclusión y pertenencia al grupo
* **mfa-secure-users-group-sync-report.xlsx** - los mismos datos en un libro de Excel con formato: una hoja de portada "Info" con los parámetros elegidos y los recuentos de resultados, una hoja de cálculo "Changes" (los usuarios agregados resaltados en verde, los eliminados en rojo) y una hoja de cálculo "All Users"

En tenants grandes, los archivos CSV sin procesar pueden superar el límite de tamaño de los archivos adjuntos del correo electrónico (Graph rechaza los correos en alrededor de 4 MB en total). Cuando los archivos CSV superan un presupuesto de 2.5 MB, el correo se envía con solo el libro de Excel adjunto (que contiene todos los datos en forma comprimida) y una nota que explica la omisión; un envío completo fallido también se reintenta automáticamente solo con el libro. La carga del enlace de descarga siempre incluye todos los archivos, independientemente del tamaño.

#### Marca del correo electrónico

El correo electrónico del informe tiene en cuenta la opción opcional `RJReport.Branding.*` del Tenant:

* **Imagen de encabezado y pie de página** – URL HTTPS públicas, PNG/JPEG/GIF, máx. 200 KB cada una
* **Enlace del pie de página** – destino de la imagen del pie de página
* **Color de acento y de texto** – valores hexadecimales de 6 dígitos, p. ej. `#0052cc`

Cuando estas configuraciones no están definidas, se usan los gráficos y colores predeterminados de RealmJoin. Una imagen que no se puede descargar o validar, o un valor de color no válido, nunca impide el correo electrónico del informe; en su lugar se usa el valor predeterminado correspondiente.

Instrucciones de configuración y requisitos de imagen: [Marca del correo electrónico](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).

### Notas y limitaciones

* El informe de registro requiere una **Entra ID P1 o P2** licencia.
* Las asignaciones de roles elegibles para PIM (exclusión de administradores) requieren una **Entra ID P2** licencia; sin ella, solo se excluyen las asignaciones de roles activas.
* El informe no incluye **deshabilitados** ni usuarios eliminados temporalmente: esas cuentas se eliminan del grupo en la siguiente ejecución.
* Los datos del informe pueden ir retrasados respecto de los cambios recientes de registro; un método recién registrado puede tardar un ciclo de sincronización en reflejarse.
* El runbook procesa tenants grandes (más de 20 000 usuarios) mediante lecturas paginadas del informe y escrituras de grupo por lotes con reintentos automáticos ante limitación de velocidad.

### Programación

La sincronización es idempotente: una única programación recurrente (p. ej., diaria) mantiene el grupo actualizado, y las reejecuciones tras fallos parciales se autocorrigen. Recomendación: ejecútelo una vez con **Ejecución de prueba (WhatIf)** activado y revise la salida del trabajo antes de programar el runbook en modo real.

### Ubicación

Organización → Seguridad → Sincronizar usuarios seguros de MFA con el grupo (programado)

**Nombre completo del runbook**

rjgit-org\_security\_sync-MFA-secure-users-to-group\_scheduled

### Detalles

| Propiedad          | Valor                                                                                                              |
| ------------------ | ------------------------------------------------------------------------------------------------------------------ |
| Versión            | 1.5.0                                                                                                              |
| Módulos requeridos | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)<br>Az.Accounts (>= 5.5.2)</p> |
| Programable        | sí                                                                                                                 |

### Permisos

#### Permisos de aplicación

* **Tipo**: Microsoft Graph
  * AuditLog.Read.All
    * *Lee userRegistrationDetails para evaluar los métodos de MFA registrados de cada usuario*
  * Group.Read.All
    * *Lee los grupos de destino y de exclusión, y sus miembros de usuario transitivos*
  * RoleManagement.Read.Directory
    * *Lee las asignaciones de roles y los programadores de elegibilidad para excluir a los usuarios administradores cuando ExcludeAdmins está habilitado*
  * GroupMember.ReadWrite.All
    * *Agrega y elimina usuarios en el grupo de destino mediante llamadas por lotes a /groups/{id}/members/$ref*
  * User.Read.All
    * *Resuelve los principales de rol de administrador y las entradas de ExcludeUserIds en objetos de usuario*
  * Organization.Read.All
    * *Lee /organization para obtener el nombre del tenant en la portada del informe y en el correo electrónico*
  * Mail.Send *(opcional — característica: informe por correo electrónico)*
    * *Envía el correo electrónico del informe mediante Send-RjReportEmail cuando está habilitada la generación de informes por correo electrónico*

### Parámetros

#### TargetGroupId

Grupo cuyos miembros son administrados por este runbook. Los miembros que ya no cumplen los requisitos se eliminan.

| Propiedad                      | Valor            |
| ------------------------------ | ---------------- |
| Requerido                      | verdadero        |
| Valor predeterminado           |                  |
| Tipo                           | Cadena           |
| Nombre para mostrar del portal | Grupo de destino |

#### IncludePasskeys

Las claves de acceso y las claves de seguridad FIDO2, que son resistentes al phishing, cuentan como seguras.

| Propiedad                      | Valor                                                          |
| ------------------------------ | -------------------------------------------------------------- |
| Requerido                      | falso                                                          |
| Valor predeterminado           | Verdadero                                                      |
| Tipo                           | Booleano                                                       |
| Nombre para mostrar del portal | ¿Las claves de acceso y las claves FIDO2 cuentan como seguras? |

#### IncludePlatformCredentials

Windows Hello for Business y las credenciales de plataforma de macOS cuentan como seguras.

| Propiedad                      | Valor                                                 |
| ------------------------------ | ----------------------------------------------------- |
| Requerido                      | falso                                                 |
| Valor predeterminado           | Verdadero                                             |
| Tipo                           | Booleano                                              |
| Nombre para mostrar del portal | ¿Las credenciales de plataforma cuentan como seguras? |

#### IncludeMicrosoftAuthenticator

La aplicación Microsoft Authenticator, con inicio de sesión mediante push o sin contraseña, cuenta como segura.

| Propiedad                      | Valor                                        |
| ------------------------------ | -------------------------------------------- |
| Requerido                      | falso                                        |
| Valor predeterminado           | Verdadero                                    |
| Tipo                           | Booleano                                     |
| Nombre para mostrar del portal | ¿Microsoft Authenticator cuenta como seguro? |

#### IncludeSoftwareOtp

Los códigos de un solo uso basados en tiempo de las aplicaciones autenticadoras cuentan como seguros.

| Propiedad                      | Valor                                |
| ------------------------------ | ------------------------------------ |
| Requerido                      | falso                                |
| Valor predeterminado           | Falso                                |
| Tipo                           | Booleano                             |
| Nombre para mostrar del portal | ¿OTP de software cuenta como seguro? |

#### IncludeHardwareOtp

Los tokens de contraseña de un solo uso de hardware cuentan como seguros.

| Propiedad                      | Valor                                             |
| ------------------------------ | ------------------------------------------------- |
| Requerido                      | falso                                             |
| Valor predeterminado           | Falso                                             |
| Tipo                           | Booleano                                          |
| Nombre para mostrar del portal | ¿Los tokens OTP de hardware cuentan como seguros? |

#### IncludeCertificateBasedAuth

El inicio de sesión con un certificado, por ejemplo desde una tarjeta inteligente, cuenta como seguro.

| Propiedad                      | Valor                                                        |
| ------------------------------ | ------------------------------------------------------------ |
| Requerido                      | falso                                                        |
| Valor predeterminado           | Verdadero                                                    |
| Tipo                           | Booleano                                                     |
| Nombre para mostrar del portal | ¿La autenticación basada en certificados cuenta como segura? |

#### SecureOnly

Modo estricto: los usuarios que también tienen registrado un método de teléfono, correo electrónico o pregunta de seguridad nunca cumplen los requisitos, incluso con un método seguro.

| Propiedad                      | Valor           |
| ------------------------------ | --------------- |
| Requerido                      | falso           |
| Valor predeterminado           | Falso           |
| Tipo                           | Booleano        |
| Nombre para mostrar del portal | ¿Modo estricto? |

#### SecureMethodsOverride

Lista personalizada de nombres de métodos que cuentan como seguros, separados por comas. Cuando se establece, los interruptores de métodos individuales se ignoran. Preconfigurado en la personalización del runbook; los nombres de los métodos se enumeran en la documentación del runbook.

| Propiedad                      | Valor                                                       |
| ------------------------------ | ----------------------------------------------------------- |
| Requerido                      | falso                                                       |
| Valor predeterminado           |                                                             |
| Tipo                           | Cadena                                                      |
| Nombre para mostrar del portal | Métodos seguros personalizados                              |
| Oculto en el portal            | sí (preconfigurado mediante la personalización del runbook) |

#### UnsecureMethodsOverride

Lista personalizada de nombres de métodos que cuentan como no seguros en modo estricto, separados por comas. Preconfigurado en la personalización del runbook.

| Propiedad                      | Valor                                                       |
| ------------------------------ | ----------------------------------------------------------- |
| Requerido                      | falso                                                       |
| Valor predeterminado           |                                                             |
| Tipo                           | Cadena                                                      |
| Nombre para mostrar del portal | Métodos no seguros personalizados                           |
| Oculto en el portal            | sí (preconfigurado mediante la personalización del runbook) |

#### ExcludeAdmins

Los usuarios con un rol de directorio de Entra ID, activo o elegible, nunca cumplen los requisitos y se eliminan del grupo. Útil cuando el grupo controla el restablecimiento de contraseña de autoservicio.

| Propiedad                      | Valor                     |
| ------------------------------ | ------------------------- |
| Requerido                      | falso                     |
| Valor predeterminado           | Verdadero                 |
| Tipo                           | Booleano                  |
| Nombre para mostrar del portal | ¿Excluir administradores? |

#### ExcludeGroupId

Los miembros de este grupo, por ejemplo cuentas de emergencia o cuentas de servicio, nunca cumplen los requisitos y se eliminan del grupo de destino. Déjelo vacío si no desea ninguno.

| Propiedad                      | Valor              |
| ------------------------------ | ------------------ |
| Requerido                      | falso              |
| Valor predeterminado           |                    |
| Tipo                           | Cadena             |
| Nombre para mostrar del portal | Grupo de exclusión |

#### ExcludeUserIds

Usuarios que nunca cumplen los requisitos y se eliminan del grupo de destino. Se pueden seleccionar varios.

| Propiedad                      | Valor              |
| ------------------------------ | ------------------ |
| Requerido                      | falso              |
| Valor predeterminado           | @()                |
| Tipo                           | Cadena\[]          |
| Nombre para mostrar del portal | Usuarios excluidos |

#### WhatIfMode

Solo registra qué usuarios se agregarían o eliminarían sin cambiar el grupo.

| Propiedad                      | Valor                 |
| ------------------------------ | --------------------- |
| Requerido                      | falso                 |
| Valor predeterminado           | Falso                 |
| Tipo                           | Booleano              |
| Nombre para mostrar del portal | ¿Ejecución de prueba? |

#### SendEmail

Envíe el informe por correo electrónico después de la ejecución.

| Propiedad                      | Valor                                   |
| ------------------------------ | --------------------------------------- |
| Requerido                      | falso                                   |
| Valor predeterminado           | Falso                                   |
| Tipo                           | Booleano                                |
| Nombre para mostrar del portal | ¿Enviar informe por correo electrónico? |

**Opciones del portal**

| Opción del portal                            | Valor     |
| -------------------------------------------- | --------- |
| Sí: enviar el informe por correo electrónico | verdadero |
| No: no enviar un correo electrónico          | falso     |

#### EmailTo

Envía el informe a estas direcciones. Separe varias con comas; cada destinatario recibe un correo electrónico independiente.

| Propiedad                      | Valor                                                |
| ------------------------------ | ---------------------------------------------------- |
| Requerido                      | falso                                                |
| Valor predeterminado           |                                                      |
| Tipo                           | Cadena                                               |
| Nombre para mostrar del portal | Dirección(es) de correo electrónico del destinatario |

#### EmailFrom

Dirección del remitente del correo electrónico del informe. Se toma de la configuración del Tenant RJReport.EmailSender.

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

#### BrandingHeaderImageUrl

Imagen de encabezado del correo electrónico del informe (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Se toma de la configuración del Tenant RJReport.Branding.HeaderImageUrl; se usa el encabezado predeterminado de RealmJoin cuando está vacío.

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

#### BrandingFooterImageUrl

Imagen de pie de página del correo electrónico del informe (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Se toma de la configuración del Tenant RJReport.Branding.FooterImageUrl; se usa el pie de página predeterminado de RealmJoin cuando está vacío.

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

#### BrandingFooterLink

Enlace asociado a la imagen de pie de página del correo electrónico del informe. Se toma de la configuración del Tenant RJReport.Branding.FooterLink; realmjoin.com se usa cuando está vacío.

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

#### BrandingAccentColor

Color de acento del correo electrónico del informe como valor hexadecimal de 6 dígitos. Se toma de la configuración del Tenant RJReport.Branding.AccentColor; se usa el valor predeterminado de RealmJoin cuando está vacío o es inválido.

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

#### BrandingTextColor

Color de texto del correo electrónico del informe como valor hexadecimal de 6 dígitos. Se toma de la configuración del Tenant RJReport.Branding.TextColor; se usa el valor predeterminado de RealmJoin cuando está vacío o es inválido.

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

#### ReportFileFormat

Entrega el informe como CSV, como un libro de Excel o ambos.

| Propiedad                      | Valor                                                       |
| ------------------------------ | ----------------------------------------------------------- |
| Requerido                      | falso                                                       |
| Valor predeterminado           | CSV y XLSX                                                  |
| Tipo                           | Cadena                                                      |
| Nombre para mostrar del portal | Formato del archivo del informe                             |
| Oculto en el portal            | sí (preconfigurado mediante la personalización del runbook) |

**Opciones del portal**

| Opción del portal | Valor      |
| ----------------- | ---------- |
| CSV y XLSX        | CSV y XLSX |
| Solo CSV          | Solo CSV   |
| Solo XLSX         | Solo XLSX  |

#### CreateDownloadLink

También carga el informe y devuelve un enlace de descarga que expira después de unos días.

| Propiedad                      | Valor                         |
| ------------------------------ | ----------------------------- |
| Requerido                      | falso                         |
| Valor predeterminado           | Falso                         |
| Tipo                           | Booleano                      |
| Nombre para mostrar del portal | ¿Crear un enlace de descarga? |

**Opciones del portal**

| Opción del portal                                       | Valor     |
| ------------------------------------------------------- | --------- |
| Sí - cargar el informe y devolver un enlace de descarga | verdadero |
| No - no crear un enlace de descarga                     | falso     |

#### ContainerName

Contenedor de almacenamiento al que se cargan los archivos del informe. Se configura por runbook.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Requerido            | falso                                                       |
| Valor predeterminado | sync-mfa-secure-users-to-group                              |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preconfigurado mediante la personalización del runbook) |

#### ResourceGroupName

Grupo de recursos de la Storage Account para las cargas del informe. Obtenido de la configuración del Tenant RJReport.StorageAccount.ResourceGroup.

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

#### StorageAccountName

Storage Account para las cargas del informe. Obtenido de la configuración del Tenant RJReport.StorageAccount.StorageAccountName.

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

#### LinkExpiryDays

Número de días que un enlace de descarga permanece válido. Obtenido de la configuración del Tenant RJReport.StorageAccount.LinkExpiryDays.

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Requerido            | falso                                                       |
| Valor predeterminado | 6                                                           |
| Tipo                 | Int32                                                       |
| Oculto en el portal  | sí (preconfigurado mediante la personalización del runbook) |

[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/security/sync-mfa-secure-users-to-group_scheduled.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.
