> 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

Añade o actualiza el teléfono móvil de este usuario como método 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, entonces se genera una advertencia; por lo general, el método MFA sigue configurá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 del usuario

Este runbook puede enviar opcionalmente un correo electrónico de notificación al usuario de destino informándole de que su método MFA de teléfono móvil fue agregado, actualizado o eliminado por un administrador. Para habilitarlo, debe activar la notificación al 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 relacionada con el envío de correo electrónico

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` configuración del Tenant.

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

Consulte la [documentación de configuración de informes de RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para obtener detalles sobre todas las configuraciones disponibles.

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

### 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 método solo para 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 mediante la directiva de métodos de autenticación del tenant, Graph intenta ese registro justo después de crear o actualizar el método de teléfono. 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 por lo general el método de teléfono para MFA normal se crea o actualiza de todos modos.

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

### Ubicación

Usuario → Seguridad → 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 conflictivo de inicio de sesión por SMS*
  * User.Read.All
    * *Resuelve el usuario de destino y lee en lote 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 por teléfono móvil del usuario*
  * Mail.Send *(opcional — característica: informe por correo electrónico)*
    * *Envía por correo al usuario que un administrador cambió su teléfono MFA cuando NotifyUser está habilitado*
  * Organization.Read.All *(opcional — característica: notificación por correo electrónico)*
    * *Lee el nombre para mostrar 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. Establecido por el portal a partir del usuario seleccionado.

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

#### phoneNumber

Número en formato E.164, como +491701234567.

| Propiedad                      | Valor                    |
| ------------------------------ | ------------------------ |
| Requerido                      | verdadero                |
| Valor predeterminado           |                          |
| Tipo                           | Cadena                   |
| Nombre para mostrar del portal | Número de teléfono móvil |

#### Quitar

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

| Propiedad                      | Valor    |
| ------------------------------ | -------- |
| Requerido                      | falso    |
| Valor predeterminado           | Falso    |
| Tipo                           | Booleano |
| Nombre para mostrar del portal | Acción   |

**Opciones del portal**

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

#### NotifyUser

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

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

#### EmailFrom

Dirección del remitente del correo de notificación. 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) |

#### ServiceDeskDisplayName

Nombre de la mesa de servicio que se muestra en el correo. Se toma de la configuración del tenant RJReport.ServiceDesk\_DisplayName.

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

#### ServiceDeskEmail

Dirección de correo electrónico de la mesa de servicio que se muestra en el correo. Se toma de la configuración del tenant RJReport.ServiceDesk\_EMail.

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

#### ServiceDeskPhone

Número de teléfono de la mesa de servicio que se muestra en el correo. Se toma de la configuración del tenant RJReport.ServiceDesk\_Phone.

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

#### ServiceDeskPortalUrl

Enlace al portal de la mesa de servicio que se muestra en el correo. Se toma de la configuración del tenant RJReport.ServiceDesk\_PortalUrl.

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

#### ServiceDeskTicketUrl

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

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

#### LanguageOverride

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

| Propiedad            | Valor                                                       |
| -------------------- | ----------------------------------------------------------- |
| Requerido            | falso                                                       |
| Valor predeterminado |                                                             |
| Tipo                 | Cadena                                                      |
| 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/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.