> 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/automacao/runbooks/runbook-references/user/security/set-or-remove-mobile-phone-mfa.md). # Definir ou remover MFA por telemóvel ### Descrição Adiciona, atualiza ou remove o método de autenticação por telefone móvel do usuário. Este runbook gerencia números de telefone como fatores MFA regulares (verificação por chamada/texto). Importante: a API phoneMethods do Microsoft Graph não oferece uma maneira de adicionar um número de telefone como "somente MFA" sem acionar uma tentativa automática de registro no SMS Sign-In. Se o usuário estiver habilitado pela Política de Métodos de Autenticação do Tenant para SMS Sign-In, o Graph tentará automaticamente registrar o número para SMS Sign-In após criar ou atualizar o método de telefone. Se o número já estiver sendo usado por outro usuário para SMS Sign-In, o Graph retornará um 409 Conflict com o código de erro "phoneNumberNotUnique". No entanto, o próprio método de telefone (para MFA regular) normalmente é criado ou atualizado com sucesso, apesar desse erro. A propriedade smsSignInState é somente leitura e não pode ser controlada por meio da solicitação de criação/atualização. O SMS Sign-In só pode ser gerenciado explicitamente pelos endpoints separados enableSmsSignIn e disableSmsSignIn. Este runbook verifica o estado real após esses erros e informa sucesso se o método MFA tiver sido atribuído, com um aviso sobre o conflito de SMS Sign-In. Se a atribuição realmente falhar, ele procura o usuário que possui o número. ### Localização Usuário → Segurança → Definir ou Remover MFA de Telefone Móvel **Nome completo do runbook** rjgit-user\_security\_set-or-remove-mobile-phone-mfa ### Permissões #### Permissões da aplicação * **Tipo**: Microsoft Graph * AuditLog.Read.All * User.Read.All * UserAuthenticationMethod.ReadWrite.All * Mail.Send ### Parâmetros #### UserId ID do objeto do usuário de destino. | Propriedade | Valor | | ----------------- | ------ | | Obrigatório | true | | Valor predefinido | | | Tipo | String | #### phoneNumber Número de telemóvel em formato internacional E.164 (por exemplo, +491701234567). | Propriedade | Valor | | ----------------- | ------ | | Obrigatório | true | | Valor predefinido | | | Tipo | String | #### Remover "Set/Update Mobile Phone MFA Method" (valor final: $false) ou "Remove Mobile Phone MFA Method" (valor final: $true) podem ser selecionados como ação a executar. Se definido como true, o runbook removerá o método MFA de telefone móvel para o usuário. Se definido como false, ele adicionará ou atualizará o método MFA de telefone móvel com o número de telefone fornecido. | Propriedade | Valor | | ----------------- | -------- | | Obrigatório | falso | | Valor predefinido | Falso | | Tipo | Booleano | #### NotifyUser Quando habilitado, envia um e-mail de notificação ao usuário de destino informando que o método MFA de telefone móvel foi adicionado ou removido por um administrador. O padrão é desabilitado. | Propriedade | Valor | | ----------------- | -------- | | Obrigatório | falso | | Valor predefinido | Falso | | Tipo | Booleano | #### EmailFrom Endereço de e-mail do remetente para o e-mail de notificação opcional. Obtido da definição de Tenant RealmJoin RJReport.EmailSender. | Propriedade | Valor | | ----------------- | ------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | String | #### ServiceDeskDisplayName Nome de exibição do Service Desk para informações de contato do usuário (opcional). Obtido da definição de Tenant RealmJoin RJReport.ServiceDesk\_DisplayName. | Propriedade | Valor | | ----------------- | ------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | String | #### ServiceDeskEmail Endereço de e-mail do Service Desk para informações de contato do usuário (opcional). Obtido da definição de Tenant RealmJoin RJReport.ServiceDesk\_EMail. | Propriedade | Valor | | ----------------- | ------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | String | #### ServiceDeskPhone Número de telefone do Service Desk para informações de contato do usuário (opcional). Obtido da definição de Tenant RealmJoin RJReport.ServiceDesk\_Phone. | Propriedade | Valor | | ----------------- | ------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | String | #### LanguageOverride Substitui o idioma usado para o e-mail de notificação. Os valores aceitos são 'DE' (alemão) ou 'EN' (inglês). Se deixado em branco, o idioma é determinado automaticamente com base na localização de uso do usuário de destino. | Propriedade | Valor | | ----------------- | ------ | | Obrigatório | falso | | Valor predefinido | | | Tipo | String | [Voltar à visão geral da referência do runbook](/pt/automacao/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: ``` GET https://docs.realmjoin.com/pt/automacao/runbooks/runbook-references/user/security/set-or-remove-mobile-phone-mfa.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.