> 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/user/security/set-or-remove-mobile-phone-mfa.md).

# Establecer o quitar MFA de teléfono móvil

Establecer o quitar el método MFA de teléfono móvil de este usuario

### Descripción

Agrega o actualiza el teléfono móvil de este usuario como método de MFA para llamadas y mensajes de texto, o lo elimina. Opcionalmente, el usuario recibe un correo electrónico sobre el cambio. Cuando el tenant permite el inicio de sesión por SMS, Microsoft también intenta registrar el número para ello. Si un número ya está siendo usado por otra persona, se produce una advertencia; normalmente el método de MFA sigue estableciéndose, y el runbook comprueba e informa del estado real. Los detalles sobre ese conflicto están en la documentación del runbook (docs.realmjoin.com).

### Activar notificación al usuario

Este runbook puede enviar opcionalmente un correo de notificación al usuario de destino informándole de que un administrador agregó, actualizó o eliminó su método de MFA de teléfono móvil. Para habilitar esto, debe activar la notificación de usuario en la personalización del runbook.

La configuración JSON para esto es la siguiente:

```json
"rjgit-user_security_set-or-remove-mobile-phone-mfa": {
    "parameters": {
        "UserId": {
            "Hide": true
        },
        "NotifyUser": {
            "Default": true,
            "Hide": true
        },
        "EmailFrom": {
            "Hide": true
        },
        "ServiceDeskDisplayName": {
            "Hide": true
        },
        "ServiceDeskEmail": {
            "Hide": true
        },
        "ServiceDeskPhone": {
            "Hide": true
        },
        "ServiceDeskPortalUrl": {
            "Hide": true
        },
        "ServiceDeskTicketUrl": {
            "Hide": true
        },
        "LanguageOverride": {
            "Hide": true
        },
        "CallerName": {
            "Hide": true
        }
    }
}
```

Para obtener más información sobre cómo personalizar runbooks, consulte la [Guía de personalización de runbooks](https://docs.realmjoin.com/automation/runbooks/runbook-customization).

### Configuración relativa al envío de correos electrónicos

Enviar un correo electrónico de notificación es opcional y solo ocurre cuando `NotifyUser` está habilitado. La dirección del remitente se toma de la `RJReport.EmailSender` de Tenant.

Este runbook envía correos electrónicos mediante la API de Microsoft Graph. Para enviar correos mediante Graph API, debes configurar una dirección de correo electrónico existente en la personalización del runbook.

Consulta la [documentación de configuración de informes de RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para conocer todos los ajustes disponibles.

#### Marca del correo electrónico

El correo electrónico del informe respeta las `RJReport.Branding.*` configuraciones opcionales de Tenant:

* **Imagen de cabecera y pie de página** – URLs 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).

### Conflictos de inicio de sesión por SMS

La API de métodos de teléfono de Microsoft Graph no ofrece ninguna forma de agregar un número de teléfono como un método solo de MFA sin que Microsoft también intente registrarlo para el inicio de sesión por SMS. Cuando el usuario está habilitado para el inicio de sesión por SMS por la directiva de métodos de autenticación del tenant, Graph intenta ese registro justo después de que el método de teléfono se crea o actualiza. Si otro usuario ya usa el número para el inicio de sesión por SMS, Graph responde con un `409 Conflict` y el código de error `phoneNumberNotUnique`, aunque el método de teléfono para la MFA normal suele crearse o actualizarse de todos modos.

Los `smsSignInState` la propiedad es de solo lectura y no puede establecerse en la solicitud de creación o actualización; el inicio de sesión por SMS solo puede activarse explícitamente a través de los endpoints separados de `enableSmsSignIn` y `disableSmsSignIn` endpoints. Por tanto, el runbook comprueba el estado real después de un error de ese tipo e informa de éxito con una advertencia cuando el método de MFA se asignó. Si la asignación realmente falló, busca al usuario que tiene el número y lo identifica en la salida.

### Ubicación

User → Security → Establecer o quitar MFA del teléfono móvil

**Nombre completo del runbook**

rjgit-user\_security\_set-or-remove-mobile-phone-MFA

### Detalles

| Propiedad          | Valor                                                                                    |
| ------------------ | ---------------------------------------------------------------------------------------- |
| Versión            | 2.3.0                                                                                    |
| 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
  * AuditLog.Read.All
    * *Consulta userRegistrationDetails para encontrar qué usuario posee un número en conflicto para inicio de sesión por SMS*
  * User.Read.All
    * *Resuelve el usuario de destino y lee por lotes los métodos de teléfono de otros usuarios para comprobaciones de conflictos*
  * UserAuthenticationMethod.ReadWrite.All
    * *Establece, actualiza o elimina el método de autenticación de teléfono móvil del usuario*
  * Mail.Send *(opcional — característica: informe por correo electrónico)*
    * *Envía un correo al usuario indicando que un administrador cambió su teléfono de MFA cuando NotifyUser está habilitado*
  * Organization.Read.All *(opcional — funcionalidad: notificación por correo electrónico)*
    * *Lee el nombre visible del Tenant para el correo de notificación cuando NotifyUser está habilitado*

### Parámetros

#### Id. de usuario

ID de objeto del usuario sobre el que actúa el runbook. Lo establece el portal a partir del usuario seleccionado.

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

#### phoneNumber

Número en formato E.164, por ejemplo +491701234567.

| Propiedad                        | Valor                    |
| -------------------------------- | ------------------------ |
| Obligatorio                      | true                     |
| Valor predeterminado             |                          |
| Tipo                             | Cadena                   |
| Nombre para mostrar en el portal | Número de teléfono móvil |

#### Quitar

Agregar o actualizar almacena el número como método de MFA para llamadas y mensajes de texto. Quitar lo elimina.

| Propiedad                        | Valor    |
| -------------------------------- | -------- |
| Obligatorio                      | falso    |
| Valor predeterminado             | Falso    |
| Tipo                             | Booleano |
| Nombre para mostrar en el portal | Acción   |

**Opciones del portal**

| Opción del portal                                   | Valor |
| --------------------------------------------------- | ----- |
| Agregar o actualizar este número como método de MFA | falso |
| Quitar el método de MFA del teléfono móvil          | true  |

#### NotifyUser

Si se envía un correo electrónico al usuario sobre el cambio. Preconfigurado en la personalización del runbook.

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

#### EmailFrom

Dirección del remitente del correo de notificación. Tomada de la configuración del Tenant RJReport.EmailSender.

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

#### BrandingHeaderImageUrl

Imagen de cabecera 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 la cabecera predeterminada de RealmJoin cuando está vacía.

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

#### BrandingFooterImageUrl

Imagen del 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ía.

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

#### BrandingFooterLink

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

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

#### BrandingTextColor

Color del 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                                                       |
| -------------------- | ----------------------------------------------------------- |
| Obligatorio          | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| Oculto en el portal  | sí (preestablecido mediante la personalización del runbook) |

#### ServiceDeskDisplayName

Nombre de la mesa de servicio mostrado en el correo. Tomado de la configuración del Tenant RJReport.ServiceDesk\_DisplayName.

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

#### ServiceDeskEmail

Dirección de correo electrónico de la mesa de servicio mostrada en el correo. Tomada de la configuración del Tenant RJReport.ServiceDesk\_EMail.

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

#### ServiceDeskPhone

Número de teléfono de la mesa de servicio mostrado en el correo. Tomado de la configuración del Tenant RJReport.ServiceDesk\_Phone.

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

#### ServiceDeskPortalUrl

Enlace al portal de la mesa de servicio mostrado en el correo. Tomado de la configuración del Tenant RJReport.ServiceDesk\_PortalUrl.

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

#### ServiceDeskTicketUrl

Enlace al ticket de esta solicitud, mostrado en el correo. Predefinido por ejecución o en la personalización del runbook; vacío significa que no hay enlace.

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

#### LanguageOverride

Fuerza el idioma del correo, DE o EN. Si está vacío, toma el idioma de la ubicación de uso del usuario. Predefinido en la personalización del runbook.

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

[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/user/security/set-or-remove-mobile-phone-mfa.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.
