> 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/pt/automatizacao/runbooks/runbook-references/user/security/set-or-remove-mobile-phone-mfa.md). # Definir ou remover MFA de telefone móvel Definir ou remover o método de MFA de telefone móvel deste utilizador ### Descrição Adiciona ou atualiza o telemóvel deste utilizador como método MFA para chamadas e mensagens de texto, ou remove-o. Opcionalmente, o utilizador recebe um e-mail sobre a alteração. Quando o Tenant permite início de sessão por SMS, a Microsoft também tenta registar o número para isso. Um número já utilizado por outra pessoa gera então um aviso; o método MFA normalmente ainda fica definido, e o runbook verifica e comunica o estado real. Os detalhes desse conflito estão na documentação do runbook (docs.realmjoin.com). ### Ativar notificação do utilizador Este runbook pode, opcionalmente, enviar um e-mail de notificação ao utilizador de destino, informando-o de que o método MFA do seu telemóvel foi adicionado, atualizado ou removido por um administrador. Para ativar isto, precisa de ativar a notificação do utilizador na personalização do runbook. A configuração JSON para isto é a seguinte: ```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 mais informações sobre como personalizar runbooks, consulte o [Guia de Personalização de Runbooks](https://docs.realmjoin.com/automation/runbooks/runbook-customization). ### Configuração relativa ao envio de emails O envio de um e-mail de notificação é opcional e só acontece quando `NotifyUser` está ativado. O endereço do remetente é obtido a partir da `RJReport.EmailSender` Tenant. Este runbook envia emails utilizando a API do Microsoft Graph. Para enviar emails através da Graph API, é necessário configurar um endereço de email existente na personalização do runbook. Consulte a [documentação das definições de relatório do RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) para obter detalhes sobre todas as definições disponíveis. #### Branding do email O email do relatório respeita as definições opcionais de `RJReport.Branding.*` do Tenant: * **Imagem do cabeçalho e do rodapé** – URLs HTTPS públicas, PNG/JPEG/GIF, máx. 200 KB cada * **Ligação no rodapé** – destino da imagem do rodapé * **Cor de destaque e do texto** – valores hexadecimais de 6 dígitos, por exemplo `#0052cc` Quando estas definições não estão configuradas, são utilizadas as imagens e cores predefinidas do RealmJoin. Uma imagem que não possa ser transferida ou validada, ou um valor de cor inválido, nunca impede o email do relatório – é utilizada em vez disso a predefinição correspondente. Instruções de configuração e requisitos da imagem: [Branding do email](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional). ### Conflitos de início de sessão por SMS A API de métodos de telefone do Microsoft Graph não oferece qualquer forma de adicionar um número de telefone como um método apenas MFA sem que a Microsoft também tente registá-lo para início de sessão por SMS. Quando o utilizador é ativado para início de sessão por SMS pela política de métodos de autenticação do Tenant, o Graph tenta esse registo logo após o método de telefone ser criado ou atualizado. Se outro utilizador já usar o número para início de sessão por SMS, o Graph responde com um `409 Conflict` e o código de erro `phoneNumberNotUnique`, embora o método de telefone para MFA normal normalmente ainda seja criado ou atualizado na mesma. O `smsSignInState` a propriedade é apenas de leitura e não pode ser definida no pedido de criação ou atualização; o início de sessão por SMS só pode ser alterado explicitamente através dos `enableSmsSignIn` e `disableSmsSignIn` endpoints separados. O runbook, portanto, verifica o estado real após esse erro e comunica êxito com um aviso quando o método MFA foi atribuído. Se a atribuição realmente falhou, procura o utilizador que detém o número e identifica-o na saída. ### Localização Utilizador → Segurança → Definir ou Remover MFA do Telemóvel **Nome completo do Runbook** rjgit-user\_security\_set-or-remove-mobile-phone-MFA ### Detalhes | Propriedade | Valor | | ------------------- | ---------------------------------------------------------------------------------------- | | Versão | 2.3.0 | | Módulos necessários |

RealmJoin.RunbookHelper (>= 0.8.10)
Microsoft.Graph.Authentication (>= 2.41.2)

| | Agendável | não | ### Permissões #### Permissões da aplicação * **Tipo**: Microsoft Graph * AuditLog.Read.All * *Consulta userRegistrationDetails para descobrir que utilizador detém um número em conflito para início de sessão por SMS* * User.Read.All * *Resolve o utilizador de destino e lê em lote os métodos de telefone dos outros utilizadores para verificações de conflito* * UserAuthenticationMethod.ReadWrite.All * *Define, atualiza ou remove o método de autenticação por telemóvel do utilizador* * Mail.Send *(opcional — funcionalidade: Relatório por email)* * *Envia um e-mail ao utilizador a informar que um administrador alterou o seu telefone MFA quando NotifyUser está ativado* * Organization.Read.All *(opcional — funcionalidade: notificação por e-mail)* * *Lê o nome de apresentação do Tenant para o e-mail de notificação quando NotifyUser está ativado* ### Parâmetros #### ID do utilizador ID de objeto do utilizador sobre o qual o runbook atua. Definido pelo portal com base no utilizador selecionado. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | verdadeiro | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### phoneNumber Número no formato E.164, como +491701234567. | Propriedade | Valor | | -------------------------- | -------------------- | | Obrigatório | verdadeiro | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Nome de exibição do portal | Número de telemóvel | #### Remover Adicionar ou atualizar armazena o número como o método MFA para chamadas e mensagens de texto. Remover apaga-o. | Propriedade | Valor | | -------------------------- | -------- | | Obrigatório | falso | | Valor predefinido | Falso | | Tipo | Booleano | | Nome de exibição do portal | Ação | **Opções do portal** | Opção do portal | Valor | | -------------------------------------------------- | ---------- | | Adicionar ou atualizar este número como método MFA | falso | | Remover o método MFA do telemóvel | verdadeiro | #### NotifyUser Se o utilizador é notificado por e-mail sobre a alteração. Predefinido na personalização do runbook. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | Falso | | Tipo | Booleano | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### EmailFrom Endereço do remetente do e-mail de notificação. Obtido a partir da definição do Tenant RJReport.EmailSender. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### BrandingHeaderImageUrl Imagem de cabeçalho do email do relatório (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Obtida da definição do Tenant RJReport.Branding.HeaderImageUrl; é utilizado o cabeçalho predefinido do RealmJoin quando estiver vazio. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### BrandingFooterImageUrl Imagem de rodapé do email do relatório (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Obtida da definição do Tenant RJReport.Branding.FooterImageUrl; é utilizado o rodapé predefinido do RealmJoin quando estiver vazio. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### BrandingFooterLink Ligação por trás da imagem de rodapé do email do relatório. Obtida da definição do Tenant RJReport.Branding.FooterLink; realmjoin.com é utilizado quando estiver vazio. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### BrandingAccentColor Cor de destaque do email do relatório como um valor hexadecimal de 6 dígitos. Obtida da definição do Tenant RJReport.Branding.AccentColor; é utilizado o valor predefinido do RealmJoin quando estiver vazio ou inválido. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### BrandingTextColor Cor do texto do email do relatório como um valor hexadecimal de 6 dígitos. Obtida da definição do Tenant RJReport.Branding.TextColor; é utilizado o valor predefinido do RealmJoin quando estiver vazio ou inválido. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### ServiceDeskDisplayName Nome do service desk mostrado no e-mail. Obtido a partir da definição do Tenant RJReport.ServiceDesk\_DisplayName. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### ServiceDeskEmail Endereço de e-mail do service desk mostrado no e-mail. Obtido a partir da definição do Tenant RJReport.ServiceDesk\_EMail. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### ServiceDeskPhone Número de telefone do service desk mostrado no e-mail. Obtido a partir da definição do Tenant RJReport.ServiceDesk\_Phone. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### ServiceDeskPortalUrl Ligação para o portal do service desk mostrada no e-mail. Obtida a partir da definição do Tenant RJReport.ServiceDesk\_PortalUrl. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### ServiceDeskTicketUrl Ligação para o ticket deste pedido, mostrada no e-mail. Predefinida por execução ou na personalização do runbook; vazio significa sem ligação. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | #### LanguageOverride Força o idioma do e-mail, DE ou EN. Vazio escolhe o idioma a partir da localização de utilização do utilizador. Predefinido na personalização do runbook. | Propriedade | Valor | | ----------------- | ------------------------------------------------------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | Cadeia de caracteres | | Oculto no portal | sim (predefinido através da personalização do runbook) | [Voltar à visão geral da referência do Runbook](/pt/automatizacao/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/pt/automatizacao/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 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.