> 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 ### Descripción Agrega, actualiza o elimina el método de autenticación del teléfono móvil del usuario. Este runbook administra los números de teléfono como factores MFA normales (verificación por llamada o SMS). Importante: la API phoneMethods de Microsoft Graph no ofrece una forma de agregar un número de teléfono como «solo MFA» sin desencadenar un intento automático de registro de inicio de sesión por SMS. Si el usuario está habilitado por la directiva de métodos de autenticación del tenant para el inicio de sesión por SMS, Graph intentará automáticamente registrar el número para el inicio de sesión por SMS después de crear o actualizar el método de teléfono. Si el número ya está siendo usado por otro usuario para el inicio de sesión por SMS, Graph devuelve un conflicto 409 con el código de error "phoneNumberNotUnique". Sin embargo, el propio método de teléfono (para MFA normal) normalmente se crea o actualiza correctamente a pesar de este error. La propiedad smsSignInState es de solo lectura y no puede controlarse mediante la solicitud de creación/actualización. El inicio de sesión por SMS solo puede administrarse explícitamente mediante los endpoints separados enableSmsSignIn y disableSmsSignIn. Este runbook verifica el estado real después de dichos errores e informa éxito si se asignó el método MFA, con una advertencia sobre el conflicto de inicio de sesión por SMS. Si la asignación realmente falló, busca al usuario que tiene el número. ### Activar notificación al usuario Este runbook puede enviar opcionalmente un correo electrónico de notificación al usuario de destino para informarle de que su método MFA del teléfono móvil fue agregado, actualizado o eliminado por un administrador. Para habilitar esto, debes 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 relacionada con el envío de correos electrónicos Enviar un correo 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 de Tenant. Este runbook envía correos electrónicos usando la API de Microsoft Graph. Para enviar correos electrónicos mediante Graph API, debes configurar una dirección de correo electrónico existente en la personalización del runbook. Consulta la [documentación de RealmJoin Report Settings](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para obtener más detalles. #### Branding del correo electrónico El correo electrónico del informe tiene en cuenta la configuración opcional `RJReport.Branding.*` de Tenant: una imagen de encabezado personalizada, una imagen de pie de página personalizada (URL HTTPS públicas, PNG/JPEG/GIF, máx. 200 KB cada una), un enlace personalizado en el pie de página y colores personalizados 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 de branding que no se pueda descargar o validar, o un valor de color que no sea un color hexadecimal válido, nunca impide el envío del correo del informe; en su lugar, se usa el valor predeterminado correspondiente. Consulta la [documentación de RealmJoin Report Settings](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para ver los detalles de configuración. ### 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 |

RealmJoin.RunbookHelper (>= 0.8.9)
Microsoft.Graph.Authentication (>= 2.39.0)

| | Programable | no | ### Notas Permisos (identidad administrada, aplicación): * UserAuthenticationMethod.ReadWrite.All - administrar métodos de autenticación por teléfono * User.Read.All - resolver el usuario de destino * Organization.Read.All - leer el nombre para mostrar del inquilino para el cuerpo del correo electrónico * Mail.Send - solo se requiere cuando NotifyUser está habilitado ### Permisos #### Permisos de aplicación * **Tipo**: Microsoft Graph * AuditLog.Read.All * *Consulta userRegistrationDetails para encontrar qué usuario tiene un número de inicio de sesión por SMS en conflicto* * User.Read.All * *Resuelve el usuario de destino y lee por lotes los métodos de teléfono de otros usuarios para comprobar conflictos* * UserAuthenticationMethod.ReadWrite.All * *Establece, actualiza o elimina el método de autenticación del teléfono móvil del usuario* * Mail.Send *(opcional — función: informe por correo electrónico)* * *Envía un correo al usuario indicando que un administrador cambió su teléfono MFA cuando NotifyUser está habilitado* * Organization.Read.All *(opcional — función: 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 de destino. | Propiedad | Valor | | -------------------- | -------------------------------------------------------- | | Requerido | true | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### phoneNumber Número de teléfono móvil en formato internacional E.164 (por ejemplo, +491701234567). | Propiedad | Valor | | -------------------------------- | ------------------------ | | Requerido | true | | Valor predeterminado | | | Tipo | Cadena | | Nombre para mostrar en el portal | Número de teléfono móvil | #### Quitar "Establecer/actualizar método MFA del teléfono móvil" (valor final: $false) o "Eliminar método MFA del teléfono móvil" (valor final: $true) se pueden seleccionar como acción a realizar. Si se establece en true, el runbook eliminará el método MFA del teléfono móvil para el usuario. Si se establece en false, agregará o actualizará el método MFA del teléfono móvil con el número de teléfono proporcionado. | Propiedad | Valor | | -------------------------------- | ------------------------------------------------ | | Requerido | falso | | Valor predeterminado | Falso | | Tipo | Booleano | | Nombre para mostrar en el portal | Agregar o eliminar método MFA del teléfono móvil | **Opciones del portal** | Opción del portal | Valor | | ------------------------------------------------------ | ----- | | Agregar este número como factor MFA del teléfono móvil | falso | | Eliminar este número / factor MFA del teléfono móvil | true | #### NotifyUser Cuando está habilitado, envía un correo electrónico de notificación al usuario de destino informándole de que su método MFA del teléfono móvil fue agregado o eliminado por un administrador. El valor predeterminado es deshabilitado. | Propiedad | Valor | | -------------------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | Falso | | Tipo | Booleano | | Nombre para mostrar en el portal | Notificar al usuario por correo electrónico | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### EmailFrom Dirección de correo del remitente para el correo de notificación opcional. Obtenida de la configuración de Tenant de RealmJoin RJReport.EmailSender. | Propiedad | Valor | | -------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### BrandingHeaderImageUrl URL HTTPS pública opcional de una imagen de encabezado personalizada (PNG/JPEG/GIF, máx. 200 KB) para el correo del informe. Procede de la configuración de Tenant RJReport.Branding.HeaderImageUrl. Cuando está vacía, se usa la imagen de encabezado predeterminada de RealmJoin. | Propiedad | Valor | | -------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### BrandingFooterImageUrl URL HTTPS pública opcional de una imagen de pie de página personalizada (PNG/JPEG/GIF, máx. 200 KB) para el correo del informe. Procede de la configuración de Tenant RJReport.Branding.FooterImageUrl. Cuando está vacía, se usa la imagen de pie de página predeterminada de RealmJoin. | Propiedad | Valor | | -------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### BrandingFooterLink URL opcional a la que enlaza la imagen del pie de página. Procede de la configuración de Tenant RJReport.Branding.FooterLink. Cuando está vacía, se usa el enlace predeterminado (). | Propiedad | Valor | | -------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### BrandingAccentColor Reemplazo opcional del color de acento (hex de 6 dígitos, p. ej. '#0052cc') para la plantilla del correo del informe. Procede de la configuración de Tenant RJReport.Branding.AccentColor. Cuando está vacío o es inválido, se usa el color de acento predeterminado de RealmJoin. | Propiedad | Valor | | -------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### BrandingTextColor Reemplazo opcional del color de texto (hex de 6 dígitos) para la plantilla del correo del informe. Procede de la configuración de Tenant RJReport.Branding.TextColor. Cuando está vacío o es inválido, se usa el color de texto predeterminado de RealmJoin. | Propiedad | Valor | | -------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### ServiceDeskDisplayName Nombre para mostrar de la Mesa de servicio para la información de contacto del usuario (opcional). Obtenido de la configuración de Tenant de RealmJoin RJReport.ServiceDesk\_DisplayName. | Propiedad | Valor | | -------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### ServiceDeskEmail Dirección de correo electrónico de la Mesa de servicio para la información de contacto del usuario (opcional). Obtenida de la configuración de Tenant de RealmJoin RJReport.ServiceDesk\_EMail. | Propiedad | Valor | | -------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### ServiceDeskPhone Número de teléfono de la Mesa de servicio para la información de contacto del usuario (opcional). Obtenido de la configuración de Tenant de RealmJoin RJReport.ServiceDesk\_Phone. | Propiedad | Valor | | -------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### ServiceDeskPortalUrl URL del portal de la Mesa de servicio para la información de contacto del usuario, mostrada como un enlace en el que se puede hacer clic (opcional). Obtenida de la configuración de Tenant de RealmJoin RJReport.ServiceDesk\_PortalUrl. | Propiedad | Valor | | -------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### ServiceDeskTicketUrl Enlace directo al ticket de la Mesa de servicio relacionado con esta solicitud, mostrado como un enlace en el que se puede hacer clic (opcional). Vacío de forma predeterminada, por lo que no se añade ningún enlace al ticket. | Propiedad | Valor | | -------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | #### LanguageOverride Sobrescribe el idioma usado para el correo de notificación. Los valores aceptados son 'DE' (alemán) o 'EN' (inglés). Si se deja vacío, el idioma se determina automáticamente según la ubicación de uso del usuario de destino. | Propiedad | Valor | | -------------------- | -------------------------------------------------------- | | Requerido | falso | | Valor predeterminado | | | Tipo | Cadena | | Oculto en el portal | sí (preestablecido mediante personalización del runbook) | [Volver a la vista general de la 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.realmjoin.com/es/automatizacion/runbooks/runbook-references/user/security/set-or-remove-mobile-phone-mfa.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.