> 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/org/security/sync-mfa-secure-users-to-group_scheduled.md).

# Sincronizar utilizadores seguros de MFA para um grupo agendado

Manter um grupo preenchido com utilizadores que registaram um método de MFA seguro

{% hint style="info" %}
Este é um runbook agendado. Ele foi projetado para ser executado em um agendamento recorrente, em vez de ser acionado para um único objeto. Consulte [Agendamento](https://docs.realmjoin.com/pt/automatizacao/runbooks/scheduling.md) para ver detalhes sobre como configurar agendamentos de runbook.
{% endhint %}

### Descrição

Mantém um grupo do Entra ID sincronizado com os utilizadores que registaram pelo menos um método de autenticação seguro, como uma chave de acesso ou a aplicação Microsoft Authenticator. Os utilizadores que perdem o respetivo método seguro são removidos, e os administradores, um grupo de exclusão e utilizadores individuais podem ser excluídos, por exemplo quando o grupo controla a reposição de palavra-passe self-service. Uma execução de teste mostra apenas as alterações, e cada execução escreve um resumo e as alterações como Output Data. O relatório pode ser enviado por email ou disponibilizado como um link de download. Os detalhes sobre as opções estão na documentação do runbook (docs.realmjoin.com).

### Como funciona

O runbook lê o Entra ID [relatório de registo de métodos de autenticação](https://learn.microsoft.com/en-us/graph/api/authenticationmethodsroot-list-userregistrationdetails) (`userRegistrationDetails`) e espelha o grupo de destino contra todos os **utilizadores membros** que cumprem os critérios:

* Um utilizador cumpre os critérios quando pelo menos um dos seus métodos registados está no conjunto **seguro** configurado.
* Em **modo rigoroso** (`SecureOnly`), o utilizador também não pode ter qualquer método do conjunto **não seguro** registado — um utilizador com passkey que também mantenha um fator SMS não cumpre os critérios.
* Os utilizadores que cumprem os critérios e que ainda não são membros do grupo são adicionados; os membros que deixam de cumprir os critérios são removidos (sincronização espelho).
* Os utilizadores convidados nunca são adicionados nem removidos. Os membros do grupo que não são utilizadores (dispositivos, Service Principals, grupos aninhados) nunca são alterados.

O grupo de destino deve ser gerido exclusivamente por este runbook.

### Grupos de métodos seguros

Cada alternância controla quais valores de `methodsRegistered` contam como seguros:

| Alternância                          | Padrão    | Valores abrangidos                                                                   |
| ------------------------------------ | --------- | ------------------------------------------------------------------------------------ |
| Passkeys / chaves de segurança FIDO2 | ativado   | `fido2SecurityKey`, `passKeyDeviceBound`, `passKeyDeviceBoundAuthenticator`          |
| Credenciais da plataforma            | ativado   | `windowsHelloForBusiness`, `passKeyDeviceBoundWindowsHello`, `macOsSecureEnclaveKey` |
| aplicação Microsoft Authenticator    | ativado   | `microsoftAuthenticatorPush`, `microsoftAuthenticatorPasswordless`                   |
| OTP de software                      | desligado | `softwareOneTimePasscode`                                                            |
| OTP de hardware                      | desligado | `hardwareOneTimePasscode`                                                            |
| Autenticação baseada em certificados | ativado   | `certificateBasedAuthentication`                                                     |

### Modo rigoroso (SecureOnly)

Com o modo rigoroso ativado, os utilizadores com qualquer um dos seguintes métodos não seguros incorporados nunca cumprem os critérios:

`mobilePhone`, `alternateMobilePhone`, `officePhone`, `email`, `securityQuestion`

Se um método acabar por ficar tanto no conjunto seguro como no conjunto não seguro (apenas possível através dos parâmetros de substituição), prevalece o não seguro — esses utilizadores nunca cumprem os critérios no modo rigoroso. O runbook avisa sobre isto no arranque.

### Exclusões

Os utilizadores excluídos nunca cumprem os critérios, independentemente dos métodos registados: nunca são adicionados ao grupo de destino e são removidos se já forem membros. O relatório por utilizador mostra o motivo na `ExclusionReason` coluna.

#### Excluir utilizadores administradores (`ExcludeAdmins`, ativado por predefinição)

Os utilizadores com uma função de diretório do Entra ID são excluídos. Isto inclui:

* **Atribuições de função ativas** (`roleManagement/directory/roleAssignments`)
* **Atribuições elegíveis para PIM** (`roleManagement/directory/roleEligibilitySchedules`, requer Entra ID P2 — quando o Graph reporta a licença em falta, o runbook recorre às atribuições ativas e regista um aviso; qualquer outro erro faz falhar o job antes de o grupo ser alterado)
* **Grupos atribuíveis a funções**: os grupos que detêm uma função são expandidos para os seus membros utilizadores transitivos

Contexto: quando o grupo de destino controla **SSPR** e a política de administrador do SSPR está desativada, os administradores do grupo continuariam a ser obrigados a registar um segundo fator assim que forem necessários dois métodos de SSPR. Manter os administradores fora do grupo evita isto.

Esta opção requer a permissão adicional do Graph `RoleManagement.Read.Directory` para a identidade gerida.

#### Grupo de exclusão (`ExcludeGroupId`, opcional)

Os membros utilizadores transitivos do grupo configurado são excluídos — destinado a contas que nunca devem ser geridas por esta sincronização, como **contas de emergência** ou **contas de serviço**. Os grupos aninhados são respeitados. O grupo de exclusão não pode ser o próprio grupo de destino.

#### Utilizadores excluídos individualmente (`ExcludeUserIds`, opcional)

Utilizadores individuais podem ser excluídos diretamente através do seletor multiutilizador — para exclusões pontuais em que não compensa manter um grupo de exclusão dedicado. A lista aceita **IDs de objeto** e **nomes principais de utilizador** (UPNs). As entradas não resolúveis (por exemplo, uma conta eliminada) registam um aviso e são ignoradas, pelo que uma entrada desatualizada nunca quebra uma sincronização agendada.

#### Manter exclusões através da Customização do Runbook (sem os seletores)

Ambos os parâmetros de exclusão podem ser predefinidos centralmente através de [Customização do Runbook baseada em JSON](https://docs.realmjoin.com/automation/runbooks/runbook-customization#json-based-customizing) (portal RealmJoin: **Configurações** → **Personalizações do Runbook**) — útil quando as exclusões são fixas para o tenant e não devem ser selecionadas manualmente sempre que o runbook é iniciado ou agendado:

```json
{
    "Runbooks": {
        "rjgit-org_security_sync-mfa-secure-users-to-group_scheduled": {
            "Parameters": {
                "ExcludeGroupId": {
                    "DefaultValue": "00000000-0000-0000-0000-000000000000",
                    "Hide": true
                },
                "ExcludeUserIds": {
                    "DefaultValue": [
                        "11111111-1111-1111-1111-111111111111",
                        "breakglass@contoso.com"
                    ],
                    "Hide": true
                }
            }
        }
    }
}
```

* **ExcludeGroupId** aceita um único grupo **ID de objeto** (GUID) como uma cadeia de texto simples — copie-o da página de visão geral do grupo no centro de administração do Entra ou no portal RealmJoin.
* **ExcludeUserIds** aceita uma matriz JSON de **cadeias de texto**; cada entrada pode ser um utilizador **ID de objeto** ou um **UPN**. As entradas são aparadas e deduplicadas; o runbook resolve-as no arranque.
* **Recomendado:** quando as exclusões são mantidas através da Customização do Runbook, defina também `"Hide": true` no parâmetro (como no exemplo acima). Isto remove-o completamente do formulário de arranque, pelo que as exclusões configuradas centralmente não podem ser substituídas na interface quando o runbook é iniciado ou agendado. Sem `Hide`, os valores configurados apenas aparecem previamente preenchidos e ainda podem ser alterados aí.

### Referência de classificação de métodos

Use os valores exatos do Graph desta tabela ao criar as cadeias de substituição separadas por vírgulas:

| `methodsRegistered` valor            | Nome amigável                                                             | Classificação | Abrangido pela alternância (predefinição)      |
| ------------------------------------ | ------------------------------------------------------------------------- | ------------- | ---------------------------------------------- |
| `fido2SecurityKey`                   | chave de segurança FIDO2                                                  | Seguro        | Passkeys / FIDO2 (ativado)                     |
| `passKeyDeviceBound`                 | Passkey (vinculada ao dispositivo)                                        | Seguro        | Passkeys / FIDO2 (ativado)                     |
| `passKeyDeviceBoundAuthenticator`    | Passkey no Microsoft Authenticator                                        | Seguro        | Passkeys / FIDO2 (ativado)                     |
| `windowsHelloForBusiness`            | Windows Hello for Business                                                | Seguro        | Credenciais da plataforma (ativado)            |
| `passKeyDeviceBoundWindowsHello`     | Passkey no Windows Hello                                                  | Seguro        | Credenciais da plataforma (ativado)            |
| `macOsSecureEnclaveKey`              | Credencial da plataforma para macOS                                       | Seguro        | Credenciais da plataforma (ativado)            |
| `microsoftAuthenticatorPush`         | Microsoft Authenticator (notificação push)                                | Seguro        | aplicação Microsoft Authenticator (ativado)    |
| `microsoftAuthenticatorPasswordless` | Microsoft Authenticator (início de sessão sem palavra-passe por telefone) | Seguro        | aplicação Microsoft Authenticator (ativado)    |
| `softwareOneTimePasscode`            | Token OATH de software (aplicação TOTP)                                   | Seguro        | OTP de software (desativado)                   |
| `hardwareOneTimePasscode`            | Token OATH de hardware                                                    | Seguro        | OTP de hardware (desativado)                   |
| `certificateBasedAuthentication`     | Autenticação baseada em certificados                                      | Seguro        | Autenticação baseada em certificados (ativado) |
| `mobilePhone`                        | Telefone (SMS / chamada de voz)                                           | Não seguro    | lista incorporada de não seguros               |
| `alternateMobilePhone`               | Telefone alternativo (chamada de voz)                                     | Não seguro    | lista incorporada de não seguros               |
| `officePhone`                        | Telefone Office (chamada de voz)                                          | Não seguro    | lista incorporada de não seguros               |
| `email`                              | Email (apenas SSPR)                                                       | Não seguro    | lista incorporada de não seguros               |
| `securityQuestion`                   | Perguntas de segurança (apenas SSPR)                                      | Não seguro    | lista incorporada de não seguros               |
| `temporaryAccessPass`                | Temporary Access Pass                                                     | Neutro        | nunca cumpre os critérios, nunca desqualifica  |

Os valores desconhecidos ou futuros do Graph são tratados como neutros, a menos que sejam explicitamente listados num parâmetro de substituição.

### Parâmetros de substituição

Ambos os parâmetros de substituição estão ocultos por predefinição e destinam-se à personalização do runbook RealmJoin:

* **SecureMethodsOverride** — lista de `methodsRegistered` valores separados por vírgulas que define o conjunto seguro. Quando definido, **todos** as alternâncias do grupo de métodos são ignoradas. Exemplo: `fido2SecurityKey,passKeyDeviceBound,passKeyDeviceBoundAuthenticator,windowsHelloForBusiness`
* **UnsecureMethodsOverride** — lista separada por vírgulas que substitui a lista incorporada de não seguros. Só é avaliada no modo rigoroso. Exemplo: `mobilePhone,alternateMobilePhone,officePhone,email,securityQuestion,softwareOneTimePasscode`

Os valores desconhecidos geram um aviso, mas continuam a ser avaliados, pelo que valores futuros do Graph podem ser utilizados antes de esta documentação ser atualizada.

### Dados de saída

Cada execução escreve os respetivos resultados no separador Output Data do portal RealmJoin, onde cada tabela pode ser exportada para o Excel:

* *Resumo* - a configuração escolhida e as contagens de resultados: entradas do relatório, utilizadores membros avaliados, utilizadores que cumprem os critérios, membros anteriores e os utilizadores adicionados e removidos (em modo de execução de teste, os utilizadores que seriam adicionados ou removidos; as adições e remoções falhadas são listadas separadamente). Um utilizador que já era membro conta como adicionado; um que já tinha desaparecido conta como removido.
* *Alterações* - cada utilizador adicionado ou removido do grupo (em modo de execução de teste, as alterações pendentes) com os detalhes de métodos por utilizador

*Alterações* tem as mesmas linhas e colunas que o ficheiro de relatório e a folha de cálculo com o mesmo nome. Uma execução sem alterações mostra uma linha de estado em vez da *Alterações* tabela. A avaliação de cada utilizador membro existe apenas nos ficheiros de relatório (*Todos os utilizadores*): uma linha por utilizador em cada execução tornaria demasiado grande a saída do job em tenants grandes.

### Entrega do relatório

O **Entrega do relatório** opção na caixa de diálogo de execução decide se o relatório também é entregue como ficheiros — especialmente útil para rever a primeira execução (idealmente combinada com o modo de execução de teste):

* *Apenas dados de saída* (predefinição): sem ficheiros de relatório, sem email.
* *Enviar também o relatório por e-mail*: envia o relatório para o(s) endereço(s) de email do destinatário, que passam então a ser um campo obrigatório. Requer a `RJReport.EmailSender` definição do tenant (ver a [documentação das definições de relatório do RealmJoin](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings)).
* *Criar também um link de download*: carrega os ficheiros de relatório para uma Storage Account do Azure e devolve links de download com tempo limitado (usa as `RJReport.StorageAccount.*` definições do tenant).
* *Enviar também por e-mail e ligação de download*: ambos.

Com email ou um link de download, **Formato do arquivo do relatório** seleciona ficheiros CSV, o livro do Excel ou ambos. A opção define os parâmetros ocultos `SendEmail` e `CreateDownloadLink`; os agendamentos e chamadas de API que passam estes parâmetros diretamente funcionam como antes.

Os agendamentos criados antes da **Entrega do relatório** opção existir mantêm a respetiva entrega. Quando tal agendamento é aberto para edição, a opção mostra *Apenas dados de saída* embora o email ou link de download armazenado continue ativo; selecione novamente a entrega antes de guardar, para que a caixa de diálogo corresponda ao que o agendamento faz.

Os ficheiros de relatório só são gerados quando é selecionado email ou um link de download. O relatório é composto por:

* **mfa-secure-users-group-sync-changes.csv** - todas as alterações efetuadas (ou, em execução de teste, pendentes) com os detalhes de métodos por utilizador
* **mfa-secure-users-group-sync-all-users.csv** - a avaliação de cada utilizador membro: métodos registados, classificação seguro/não seguro, qualificação, motivo de exclusão e pertença ao grupo
* **mfa-secure-users-group-sync-report.xlsx** - os mesmos dados num livro do Excel formatado: uma folha de rosto "Info" com os parâmetros escolhidos e as contagens de resultados, uma folha de cálculo "Changes" (utilizadores adicionados realçados a verde, removidos a vermelho) e uma folha de cálculo "All Users"

Em tenants grandes, os ficheiros CSV brutos podem exceder o limite de tamanho dos anexos de email (o Graph rejeita mensagens com cerca de 4 MB no total). Quando os ficheiros CSV excedem um orçamento de 2,5 MB, o email é enviado com apenas o livro do Excel anexado (que contém os dados completos em forma comprimida) e uma nota a explicar a omissão; um envio de tamanho total falhado também é novamente tentado automaticamente apenas com o livro. O carregamento do link de download inclui sempre todos os ficheiros, independentemente do tamanho.

#### Branding do e-mail

O e-mail do relatório respeita as `RJReport.Branding.*` definições opcionais do Tenant:

* **Imagem do cabeçalho e do rodapé** – URLs HTTPS públicas, PNG/JPEG/GIF, máx. 200 KB cada
* **Link do 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 usadas as imagens e cores padrão do RealmJoin. Uma imagem que não pode ser transferida ou validada, ou um valor de cor inválido, nunca impede o e-mail do relatório – em vez disso, é usado o padrão correspondente.

Instruções de configuração e requisitos de imagem: [Branding do e-mail](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).

### Observações e limitações

* O relatório de registo requer uma licença **Entra ID P1 ou P2** .
* As atribuições de função elegíveis para PIM (exclusão de administradores) requerem uma **licença Entra ID P2**  — sem ela, apenas as atribuições de função ativas são excluídas.
* Se a leitura de uma lista falhar (relatório de registo, atribuições de função, membros de um grupo atribuível a funções ou do grupo de exclusão, membros atuais do grupo de destino), o job falha antes de o grupo ser alterado, pelo que uma sincronização nunca é executada com dados incompletos.
* O relatório não inclui **desativados** ou utilizadores eliminados temporariamente — essas contas são removidas do grupo na execução seguinte.
* Os dados do relatório podem ficar atrasados em relação a alterações recentes de registo; um método recém-registado pode demorar um ciclo de sincronização a ser refletido.
* O runbook processa tenants grandes (20 mil+ utilizadores) através de leituras paginadas do relatório e escritas em lote no grupo com novas tentativas automáticas de limitação.

### Agendamento

A sincronização é idempotente — um único agendamento recorrente (por exemplo, diário) mantém o grupo atualizado, e as novas execuções após falhas parciais autocorrigem-se. Recomendação: execute uma vez com **Execução de teste (WhatIf)** ativado e reveja a saída do job antes de agendar o runbook em modo ativo.

### Localização

Organização → Segurança → Sincronizar Utilizadores Seguros MFA Para Grupo (Agendado)

**Nome completo do runbook**

rjgit-org\_security\_sync-MFA-secure-users-to-group\_scheduled

### Detalhes

| Propriedade         | Valor                                                                                                              |
| ------------------- | ------------------------------------------------------------------------------------------------------------------ |
| Versão              | 1.6.0                                                                                                              |
| Módulos necessários | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)<br>Az.Accounts (>= 5.5.2)</p> |
| Agendável           | sim                                                                                                                |

### Permissões

#### Permissões de aplicativo

* **Tipo**: Microsoft Graph
  * AuditLog.Read.All
    * *Lê userRegistrationDetails para avaliar os métodos MFA registados de cada utilizador*
  * Group.Read.All
    * *Lê o grupo de destino e os grupos de exclusão e os respetivos membros utilizadores transitivos*
  * GroupMember.ReadWrite.All
    * *Adiciona e remove utilizadores no grupo de destino através de chamadas /groups/{id}/members/$ref em lote*
  * Organization.Read.All
    * *Lê /organization para obter o nome do tenant na folha de rosto do relatório e no email*
  * RoleManagement.Read.Directory
    * *Lê as atribuições de função e os agendamentos de elegibilidade para excluir utilizadores administradores quando ExcludeAdmins está ativado*
  * User.Read.All
    * *Resolve os principals de função de administrador e as entradas de ExcludeUserIds em objetos de utilizador*
  * Mail.Send *(opcional — funcionalidade: Relatório por e-mail)*
    * *Envia o email do relatório através de Send-RjRbReportEmail quando o envio de relatórios por email está ativado*

### Parâmetros

#### TargetGroupId

Grupo cujos membros são geridos por este runbook. Os membros que deixam de cumprir os critérios são removidos.

| Propriedade                | Valor            |
| -------------------------- | ---------------- |
| Obrigatório                | verdadeiro       |
| Valor padrão               |                  |
| Tipo                       | Texto            |
| Nome de exibição no portal | Grupo de destino |

#### IncludePasskeys

Passkeys e chaves de segurança FIDO2, que são resistentes a phishing, contam como seguras.

| Propriedade                | Valor                                        |
| -------------------------- | -------------------------------------------- |
| Obrigatório                | falso                                        |
| Valor padrão               | Verdadeiro                                   |
| Tipo                       | Booleano                                     |
| Nome de exibição no portal | Passkeys e chaves FIDO2 contam como seguras? |

#### IncludePlatformCredentials

Windows Hello for Business e as credenciais da plataforma macOS contam como seguras.

| Propriedade                | Valor                                             |
| -------------------------- | ------------------------------------------------- |
| Obrigatório                | falso                                             |
| Valor padrão               | Verdadeiro                                        |
| Tipo                       | Booleano                                          |
| Nome de exibição no portal | As credenciais da plataforma contam como seguras? |

#### IncludeMicrosoftAuthenticator

A aplicação Microsoft Authenticator, com notificação push ou início de sessão sem palavra-passe, conta como segura.

| Propriedade                | Valor                                        |
| -------------------------- | -------------------------------------------- |
| Obrigatório                | falso                                        |
| Valor padrão               | Verdadeiro                                   |
| Tipo                       | Booleano                                     |
| Nome de exibição no portal | O Microsoft Authenticator conta como seguro? |

#### IncludeSoftwareOtp

Os códigos de utilização única baseados em tempo das aplicações autenticadoras contam como seguros.

| Propriedade                | Valor                                |
| -------------------------- | ------------------------------------ |
| Obrigatório                | falso                                |
| Valor padrão               | Falso                                |
| Tipo                       | Booleano                             |
| Nome de exibição no portal | A OTP de software conta como segura? |

#### IncludeHardwareOtp

Os tokens de palavra-passe de utilização única de hardware contam como seguros.

| Propriedade                | Valor                                          |
| -------------------------- | ---------------------------------------------- |
| Obrigatório                | falso                                          |
| Valor padrão               | Falso                                          |
| Tipo                       | Booleano                                       |
| Nome de exibição no portal | Os tokens OTP de hardware contam como seguros? |

#### IncludeCertificateBasedAuth

O início de sessão com um certificado, por exemplo de um cartão inteligente, conta como seguro.

| Propriedade                | Valor                                                     |
| -------------------------- | --------------------------------------------------------- |
| Obrigatório                | falso                                                     |
| Valor padrão               | Verdadeiro                                                |
| Tipo                       | Booleano                                                  |
| Nome de exibição no portal | A autenticação baseada em certificados conta como segura? |

#### SecureOnly

Modo rigoroso: os utilizadores que também tenham um método de telefone, email ou pergunta de segurança registado nunca cumprem os critérios, mesmo com um método seguro.

| Propriedade                | Valor          |
| -------------------------- | -------------- |
| Obrigatório                | falso          |
| Valor padrão               | Falso          |
| Tipo                       | Booleano       |
| Nome de exibição no portal | Modo rigoroso? |

#### SecureMethodsOverride

Lista personalizada de nomes de métodos que contam como seguros, separada por vírgulas. Quando definida, as alternâncias individuais de método são ignoradas. Predefinida na personalização do runbook; os nomes dos métodos estão listados na documentação do runbook.

| Propriedade                | Valor                                                   |
| -------------------------- | ------------------------------------------------------- |
| Obrigatório                | falso                                                   |
| Valor padrão               |                                                         |
| Tipo                       | Texto                                                   |
| Nome de exibição no portal | Métodos seguros personalizados                          |
| Oculto no portal           | sim (predefinido por meio da personalização do runbook) |

#### UnsecureMethodsOverride

Lista personalizada de nomes de métodos que contam como não seguros no modo rigoroso, separada por vírgulas. Predefinida na personalização do runbook.

| Propriedade                | Valor                                                   |
| -------------------------- | ------------------------------------------------------- |
| Obrigatório                | falso                                                   |
| Valor padrão               |                                                         |
| Tipo                       | Texto                                                   |
| Nome de exibição no portal | Métodos não seguros personalizados                      |
| Oculto no portal           | sim (predefinido por meio da personalização do runbook) |

#### ExcludeAdmins

Os utilizadores com uma função de diretório do Entra ID, ativa ou elegível, nunca cumprem os critérios e são removidos do grupo. Útil quando o grupo controla a reposição de palavra-passe self-service.

| Propriedade                | Valor                    |
| -------------------------- | ------------------------ |
| Obrigatório                | falso                    |
| Valor padrão               | Verdadeiro               |
| Tipo                       | Booleano                 |
| Nome de exibição no portal | Excluir administradores? |

#### ExcludeGroupId

Os membros deste grupo, por exemplo contas de emergência ou contas de serviço, nunca cumprem os critérios e são removidos do grupo de destino. Deixe em branco se não houver.

| Propriedade                | Valor             |
| -------------------------- | ----------------- |
| Obrigatório                | falso             |
| Valor padrão               |                   |
| Tipo                       | Texto             |
| Nome de exibição no portal | Grupo de exclusão |

#### ExcludeUserIds

Utilizadores que nunca cumprem os critérios e são removidos do grupo de destino. Podem ser selecionados vários.

| Propriedade                | Valor                  |
| -------------------------- | ---------------------- |
| Obrigatório                | falso                  |
| Valor padrão               | @()                    |
| Tipo                       | String\[]              |
| Nome de exibição no portal | Utilizadores excluídos |

#### WhatIfMode

Apenas regista quais os utilizadores que seriam adicionados ou removidos sem alterar o grupo.

| Propriedade                | Valor              |
| -------------------------- | ------------------ |
| Obrigatório                | falso              |
| Valor padrão               | Falso              |
| Tipo                       | Booleano           |
| Nome de exibição no portal | Execução de teste? |

#### SendEmail

Envia o relatório para o endereço de email do destinatário. Definido pela opção "Report delivery" no portal.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     | Falso                                                   |
| Tipo             | Booleano                                                |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### EmailTo

Envie o relatório para estes endereços. Separe vários com vírgulas; cada destinatário recebe um e-mail separado.

| Propriedade                | Valor                                                   |
| -------------------------- | ------------------------------------------------------- |
| Obrigatório                | falso                                                   |
| Valor padrão               |                                                         |
| Tipo                       | Texto                                                   |
| Nome de exibição no portal | Endereço(s) de e-mail do destinatário                   |
| Oculto no portal           | sim (predefinido por meio da personalização do runbook) |

#### EmailFrom

Endereço do remetente do e-mail do relatório. Obtido a partir da definição do Tenant RJReport.EmailSender.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### BrandingHeaderImageUrl

Imagem do cabeçalho do e-mail do relatório (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Obtida a partir da definição do Tenant RJReport.Branding.HeaderImageUrl; o cabeçalho padrão do RealmJoin é usado quando está vazio.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### BrandingFooterImageUrl

Imagem do rodapé do e-mail do relatório (URL HTTPS, PNG/JPEG/GIF, máx. 200 KB). Obtida a partir da definição do Tenant RJReport.Branding.FooterImageUrl; o rodapé padrão do RealmJoin é usado quando está vazio.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### BrandingFooterLink

Link por trás da imagem do rodapé do e-mail do relatório. Obtido a partir da definição do Tenant RJReport.Branding.FooterLink; realmjoin.com é usado quando está vazio.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### BrandingAccentColor

Cor de destaque do e-mail do relatório como um valor hexadecimal de 6 dígitos. Obtida a partir da definição do Tenant RJReport.Branding.AccentColor; o padrão do RealmJoin é usado quando está vazio ou inválido.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### BrandingTextColor

Cor do texto do e-mail do relatório como um valor hexadecimal de 6 dígitos. Obtida a partir da definição do Tenant RJReport.Branding.TextColor; o padrão do RealmJoin é usado quando está vazio ou inválido.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### ReportFileFormat

Entregue o relatório em CSV, como uma pasta de trabalho do Excel, ou ambos.

| Propriedade                | Valor                                                   |
| -------------------------- | ------------------------------------------------------- |
| Obrigatório                | falso                                                   |
| Valor padrão               | CSV e XLSX                                              |
| Tipo                       | Texto                                                   |
| Nome de exibição no portal | Formato do arquivo do relatório                         |
| Oculto no portal           | sim (predefinido por meio da personalização do runbook) |

**Opções do portal**

| Opção do portal | Valor        |
| --------------- | ------------ |
| CSV e XLSX      | CSV e XLSX   |
| Somente CSV     | Somente CSV  |
| Somente XLSX    | Somente XLSX |

#### CreateDownloadLink

Carrega também o relatório e devolve um link de download que expira após alguns dias. Definido pela opção "Report delivery" no portal.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     | Falso                                                   |
| Tipo             | Booleano                                                |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### ContainerName

Contêiner de armazenamento para o qual os arquivos do relatório são enviados. Definido por runbook.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     | sync-mfa-secure-users-to-group                          |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### ResourceGroupName

Grupo de recursos da Storage Account para uploads de relatórios. Obtido da configuração do Tenant RJReport.StorageAccount.ResourceGroup.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### StorageAccountName

Storage Account para uploads de relatórios. Obtida da configuração do Tenant RJReport.StorageAccount.StorageAccountName.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### SubscriptionId

ID da assinatura da Storage Account para uploads de relatórios. Obtido da configuração do Tenant RJReport.StorageAccount.SubscriptionId; quando vazio, é usada a assinatura na qual a identidade gerenciada entra.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     |                                                         |
| Tipo             | Texto                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

#### LinkExpiryDays

Número de dias que um link de download permanece válido. Obtido da configuração do Tenant RJReport.StorageAccount.LinkExpiryDays.

| Propriedade      | Valor                                                   |
| ---------------- | ------------------------------------------------------- |
| Obrigatório      | falso                                                   |
| Valor padrão     | 6                                                       |
| Tipo             | Int32                                                   |
| Oculto no portal | sim (predefinido por meio da personalização do runbook) |

[Voltar à visão geral da referência do runbook](https://docs.realmjoin.com/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/org/security/sync-mfa-secure-users-to-group_scheduled.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.
