# Definir ou remover MFA do telemóvel

### Descrição

Adiciona, atualiza ou remove o método de autenticação por telemóvel do utilizador. Este runbook gere números de telefone como fatores MFA normais (verificação por chamada/texto). Importante: a API phoneMethods do Microsoft Graph não oferece uma forma de adicionar um número de telefone como "apenas MFA" sem desencadear uma tentativa automática de registo de Início de Sessão por SMS. Se o utilizador estiver ativado pela Política de Métodos de Autenticação do Tenant para Início de Sessão por SMS, o Graph tentará automaticamente registar o número para Início de Sessão por SMS após criar ou atualizar o método de telefone. Se o número já estiver a ser utilizado por outro utilizador para Início de Sessão por SMS, o Graph devolve um conflito 409 com o código de erro "phoneNumberNotUnique". No entanto, o próprio método de telefone (para MFA normal) é normalmente criado ou atualizado com êxito apesar deste erro. A propriedade smsSignInState é só de leitura e não pode ser controlada através do pedido de criação/atualização. O Início de Sessão por SMS só pode ser gerido explicitamente através dos endpoints separados enableSmsSignIn e disableSmsSignIn. Este runbook verifica o estado real após esses erros e reporta sucesso se o método MFA tiver sido atribuído, com um aviso sobre o conflito de Início de Sessão por SMS. Se a atribuição tiver falhado de facto, pesquisa o utilizador que detém o número.

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

### 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 utilizador de destino.

| Propriedade       | Valor                |
| ----------------- | -------------------- |
| Obrigatório       | verdadeiro           |
| Valor predefinido |                      |
| Tipo              | Cadeia de caracteres |

#### phoneNumber

Número de telemóvel no formato internacional E.164 (por exemplo, +491701234567).

| Propriedade       | Valor                |
| ----------------- | -------------------- |
| Obrigatório       | verdadeiro           |
| Valor predefinido |                      |
| Tipo              | Cadeia de caracteres |

#### Remover

"Definir/Atualizar Método MFA do Telemóvel" (valor final: $false) ou "Remover Método MFA do Telemóvel" (valor final: $true) podem ser selecionados como ação a executar. Se definido como true, o runbook removerá o método MFA do telemóvel do utilizador. Se definido como false, adicionará ou atualizará o método MFA do telemóvel com o número de telefone fornecido.

| Propriedade       | Valor    |
| ----------------- | -------- |
| Obrigatório       | falso    |
| Valor predefinido | Falso    |
| Tipo              | Booleano |

#### NotifyUser

Quando ativado, envia um e-mail de notificação ao utilizador de destino a informar que o respetivo método MFA do telemóvel foi adicionado ou removido por um administrador. O valor predefinido é desativado.

| 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 a partir da definição de Tenant do RealmJoin RJReport.EmailSender.

| Propriedade       | Valor                |
| ----------------- | -------------------- |
| Obrigatório       | falso                |
| Valor predefinido |                      |
| Tipo              | Cadeia de caracteres |

#### ServiceDeskDisplayName

Nome de apresentação do Service Desk para informações de contacto do utilizador (opcional). Obtido a partir da definição de Tenant do RealmJoin RJReport.ServiceDesk\_DisplayName.

| Propriedade       | Valor                |
| ----------------- | -------------------- |
| Obrigatório       | falso                |
| Valor predefinido |                      |
| Tipo              | Cadeia de caracteres |

#### ServiceDeskEmail

Endereço de e-mail do Service Desk para informações de contacto do utilizador (opcional). Obtido a partir da definição de Tenant do RealmJoin RJReport.ServiceDesk\_EMail.

| Propriedade       | Valor                |
| ----------------- | -------------------- |
| Obrigatório       | falso                |
| Valor predefinido |                      |
| Tipo              | Cadeia de caracteres |

#### ServiceDeskPhone

Número de telefone do Service Desk para informações de contacto do utilizador (opcional). Obtido a partir da definição de Tenant do RealmJoin RJReport.ServiceDesk\_Phone.

| Propriedade       | Valor                |
| ----------------- | -------------------- |
| Obrigatório       | falso                |
| Valor predefinido |                      |
| Tipo              | Cadeia de caracteres |

#### LanguageOverride

Substitui o idioma usado para o e-mail de notificação. Os valores aceites são 'DE' (alemão) ou 'EN' (inglês). Se for deixado em branco, o idioma é determinado automaticamente com base na localização de utilização do utilizador de destino.

| Propriedade       | Valor                |
| ----------------- | -------------------- |
| Obrigatório       | falso                |
| Valor predefinido |                      |
| Tipo              | Cadeia de caracteres |

[Voltar à visão geral da referência de Runbook](/pt/automacao/runbooks/runbook-references.md)


---

# Agent Instructions: 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=<question>
```

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.
