> 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. Veja [Agendamento](/pt/automatizacao/runbooks/scheduling.md) para obter detalhes sobre como configurar os agendamentos do 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 passkey ou a aplicação Microsoft Authenticator. Os utilizadores que perdem o respetivo método seguro são removidos. 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 em self-service. Uma execução de teste mostra apenas as alterações, e o relatório pode ser enviado por email ou disponibilizado como uma ligação de transferência. Os detalhes sobre as opções estão na documentação do runbook (docs.realmjoin.com).
### Como funciona
O runbook lê o relatório de registo dos métodos de autenticação do Entra ID [relatório de registo dos métodos de autenticação](https://learn.microsoft.com/en-us/graph/api/authenticationmethodsroot-list-userregistrationdetails) (`userRegistrationDetails`) e espelha o grupo de destino em relação a todos os **utilizadores membros** que reúnam os requisitos:
* Um utilizador reúne os requisitos quando pelo menos um dos respetivos métodos registados está no conjunto configurado de **seguro** .
* Em **modo estrito** (`SecureOnly`), o utilizador também não pode ter qualquer método do conjunto **inseguro** registado — um utilizador com passkey que também mantenha um fator SMS não reúne os requisitos.
* Os utilizadores que reúnem os requisitos e ainda não são membros do grupo são adicionados; os membros que já não reúnem os requisitos são removidos (sincronização por espelhamento).
* Os utilizadores convidados nunca são adicionados nem removidos. Os membros do grupo que não são utilizadores (dispositivos, principais de serviço, 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 | Predefinição | Valores abrangidos |
| ------------------------------------ | ------------ | ------------------------------------------------------------------------------------ |
| Passkeys / chaves de segurança FIDO2 | ativado | `fido2SecurityKey`, `passKeyDeviceBound`, `passKeyDeviceBoundAuthenticator` |
| Credenciais de plataforma | ativado | `windowsHelloForBusiness`, `passKeyDeviceBoundWindowsHello`, `macOsSecureEnclaveKey` |
| Aplicação Microsoft Authenticator | ativado | `microsoftAuthenticatorPush`, `microsoftAuthenticatorPasswordless` |
| OTP de software | desativado | `softwareOneTimePasscode` |
| OTP de hardware | desativado | `hardwareOneTimePasscode` |
| Autenticação baseada em certificado | ativado | `certificateBasedAuthentication` |
### Modo estrito (SecureOnly)
Com o modo estrito ativado, os utilizadores com qualquer um dos seguintes métodos inseguros integrados nunca reúnem os requisitos:
`mobilePhone`, `alternateMobilePhone`, `officePhone`, `email`, `securityQuestion`
Se um método acabar nos conjuntos seguro e inseguro (apenas possível através dos parâmetros de substituição), o conjunto inseguro prevalece — esses utilizadores nunca reúnem os requisitos no modo estrito. O runbook avisa sobre isso ao arrancar.
### Exclusões
Os utilizadores excluídos nunca reúnem os requisitos, independentemente dos respetivos 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 que têm uma função de diretório do Entra ID são excluídos. Isto abrange:
* **Atribuições de função ativas** (`roleManagement/directory/roleAssignments`)
* **Atribuições elegíveis para PIM** (`roleManagement/directory/roleEligibilitySchedules`, requer Entra ID P2 — sem P2, o runbook recorre às atribuições ativas e regista um aviso)
* **Grupos atribuíveis a funções**: grupos que detêm uma função são expandidos para os respetivos membros de utilizador transitivos
Contexto: quando o grupo de destino impulsiona **SSPR** e a política de administrador do SSPR está desativada, os administradores do grupo ainda assim teriam de registar um segundo fator assim que fossem necessários dois métodos de SSPR. Manter os administradores fora do grupo evita isso.
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 de utilizador transitivos do grupo configurado são excluídos — destinado a contas que nunca devem ser geridas por esta sincronização, como **contas break glass** 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)
Os utilizadores individuais podem ser excluídos diretamente através do seletor de vários utilizadores — para exclusões pontuais em que não compensa manter um grupo de exclusão dedicado. A lista aceita IDs de objeto de utilizador **IDs de objeto** e **nomes principais de utilizador** (UPNs). As entradas que não possam ser resolvidas (por exemplo, uma conta eliminada) geram um aviso e são ignoradas, pelo que uma entrada desatualizada nunca interrompe uma sincronização agendada.
#### Manter exclusões através da Personalização do Runbook (sem os seletores)
Ambos os parâmetros de exclusão podem ser pré-configurados centralmente através de [Personalização do Runbook baseada em JSON](https://docs.realmjoin.com/automation/runbooks/runbook-customization#json-based-customizing) (portal RealmJoin: **Definições** → **Personalizações do Runbook**) — útil quando as exclusões são fixas para o tenant e não devem ser escolhidas 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** usa um único grupo **ID de objeto** (GUID) como uma string simples — copie-o da página de visão geral do grupo no centro de administração do Entra ou no portal RealmJoin.
* **ExcludeUserIds** usa um JSON **array de strings**; cada entrada pode ser um utilizador **ID de objeto** ou um **UPN**. As entradas são limpas e deduplicadas; o runbook resolve-as ao arrancar.
* **Recomendado:** quando as exclusões são mantidas através da Personalização do Runbook, defina também `"Hide": true` na opção (como no exemplo acima). Isto remove-a completamente do formulário de arranque, pelo que as exclusões configuradas centralmente não podem ser substituídas na interface ao iniciar ou agendar o runbook. Sem `Ocultar`, os valores configurados apenas aparecem pré-preenchidos e ainda podem ser alterados aí.
### Referência de classificação de métodos
Use os valores exatos do Graph desta tabela ao construir 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 de plataforma (ativado) |
| `passKeyDeviceBoundWindowsHello` | Passkey no Windows Hello | Seguro | Credenciais de plataforma (ativado) |
| `macOsSecureEnclaveKey` | Credencial de plataforma para macOS | Seguro | Credenciais de plataforma (ativado) |
| `microsoftAuthenticatorPush` | Microsoft Authenticator (notificação por push) | Seguro | Aplicação Microsoft Authenticator (ativado) |
| `microsoftAuthenticatorPasswordless` | Microsoft Authenticator (início de sessão no telemóvel sem palavra-passe) | 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 certificado | Seguro | Autenticação baseada em certificado (ativado) |
| `mobilePhone` | Telefone (SMS / chamada de voz) | Inseguro | lista insegura integrada |
| `alternateMobilePhone` | Telefone alternativo (chamada de voz) | Inseguro | lista insegura integrada |
| `officePhone` | Telefone do escritório (chamada de voz) | Inseguro | lista insegura integrada |
| `email` | Email (apenas SSPR) | Inseguro | lista insegura integrada |
| `securityQuestion` | Perguntas de segurança (apenas SSPR) | Inseguro | lista insegura integrada |
| `temporaryAccessPass` | Temporary Access Pass | Neutro | nunca reúne os requisitos, nunca desqualifica |
Os valores desconhecidos ou futuros do Graph são tratados como neutros, salvo se forem 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 separada por vírgulas de `methodsRegistered` valores que definem o conjunto seguro. Quando definido, **todos** os comutadores dos grupos de métodos são ignorados. Exemplo: `fido2SecurityKey,passKeyDeviceBound,passKeyDeviceBoundAuthenticator,windowsHelloForBusiness`
* **UnsecureMethodsOverride** — lista separada por vírgulas que substitui a lista insegura integrada. Avaliado apenas no modo estrito. Exemplo: `mobilePhone,alternateMobilePhone,officePhone,email,securityQuestion,softwareOneTimePasscode`
Os valores desconhecidos geram um aviso, mas continuam a ser avaliados, pelo que os futuros valores do Graph podem ser usados antes de esta documentação ser atualizada.
### Relatório por email e ligações de transferência
Opcionalmente, pode ser entregue um relatório detalhado — especialmente útil para rever a primeira execução, idealmente em conjunto com o modo de execução de teste:
* **Enviar relatório por email** (`SendEmail`, desativado por predefinição): envia o relatório para os destinatários configurados. O campo do destinatário só aparece quando o email está ativado. 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 ligações de transferência de ficheiros** (`CreateDownloadLink`, desativado por predefinição): carrega os ficheiros do relatório para um Azure Storage Account e devolve ligações de transferência com tempo limitado (usa as `RJReport.StorageAccount.*` definições do tenant).
Os ficheiros do relatório só são gerados quando pelo menos uma das duas opções está ativada. O relatório é composto por:
* **mfa-secure-users-group-sync-changes.csv** - todas as alterações executadas (ou, em execução de teste, pendentes) com detalhes dos 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/inseguro, elegibilidade, motivo da exclusão e associação ao grupo
* **mfa-secure-users-group-sync-report.xlsx** - os mesmos dados num livro 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 limite de 2,5 MB, o email é enviado com apenas o livro Excel anexado (que contém os dados completos em formato comprimido) e uma nota a explicar a omissão; uma tentativa de envio de tamanho total falhada também é repetida automaticamente apenas com o livro de trabalho. O carregamento para a ligação de transferência inclui sempre todos os ficheiros, independentemente do tamanho.
#### 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).
### Notas e limitações
* O relatório de registo requer uma **licença Entra ID P1 ou P2** .
* As atribuições de funções elegíveis para PIM (exclusão de administradores) requerem uma **licença Entra ID P2** — sem ela, apenas as atribuições de funções ativas são excluídas.
* O relatório não inclui **utilizadores desativados** ou eliminados temporariamente — essas contas são removidas do grupo na execução seguinte.
* Os dados do relatório podem ficar atrás de alterações recentes no 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 gravações em lote no grupo, com novas tentativas automáticas em caso de limitação.
### Agendamento
A sincronização é idempotente — um único agendamento recorrente (por exemplo, diário) mantém o grupo atualizado, e novas execuções após falhas parciais autocorrigem-se. Recomendação: execute uma vez com **Execução de teste (WhatIf)** ativada e reveja a saída do trabalho antes de agendar o runbook em modo ativo.
### Localização
Organização → Segurança → Sincronizar utilizadores seguros de MFA para o grupo (Agendado)
**Nome completo do Runbook**
rjgit-org\_security\_sync-MFA-secure-users-to-group\_scheduled
### Detalhes
| Propriedade | Valor |
| ------------------- | ------------------------------------------------------------------------------------------------------------------ |
| Versão | 1.5.0 |
| Módulos necessários | RealmJoin.RunbookHelper (>= 0.8.10)
Microsoft.Graph.Authentication (>= 2.41.2)
Az.Accounts (>= 5.5.2)
|
| Agendável | sim |
### Permissões
#### Permissões da aplicação
* **Tipo**: Microsoft Graph
* AuditLog.Read.All
* *Lê userRegistrationDetails para avaliar os métodos MFA registados de cada utilizador*
* Group.Read.All
* *Lê os grupos de destino e de exclusão e os respetivos membros transitivos utilizadores*
* RoleManagement.Read.Directory
* *Lê as atribuições de funções e os esquemas de elegibilidade para excluir utilizadores administradores quando ExcludeAdmins está ativado*
* GroupMember.ReadWrite.All
* *Adiciona e remove utilizadores no grupo de destino através de chamadas em lote /groups/{id}/members/$ref*
* User.Read.All
* *Resolve principais de função de administrador e entradas de ExcludeUserIds em objetos de utilizador*
* Organization.Read.All
* *Lê /organization para obter o nome do tenant para a folha de rosto do relatório e no email*
* Mail.Send *(opcional — funcionalidade: Relatório por email)*
* *Envia o email do relatório através de Send-RjReportEmail 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 já não reúnem os requisitos são removidos.
| Propriedade | Valor |
| -------------------------- | -------------------- |
| Obrigatório | verdadeiro |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Nome de exibição do portal | Grupo de destino |
#### IncludePasskeys
Passkeys e chaves de segurança FIDO2, que são resistentes a phishing, contam como seguros.
| Propriedade | Valor |
| -------------------------- | -------------------------------------------- |
| Obrigatório | falso |
| Valor predefinido | Verdadeiro |
| Tipo | Booleano |
| Nome de exibição do portal | Passkeys e chaves FIDO2 contam como seguros? |
#### IncludePlatformCredentials
Windows Hello for Business e credenciais de plataforma macOS contam como seguros.
| Propriedade | Valor |
| -------------------------- | ------------------------------------------------- |
| Obrigatório | falso |
| Valor predefinido | Verdadeiro |
| Tipo | Booleano |
| Nome de exibição do portal | As credenciais de plataforma contam como seguras? |
#### IncludeMicrosoftAuthenticator
A aplicação Microsoft Authenticator, com início de sessão por push ou sem palavra-passe, conta como segura.
| Propriedade | Valor |
| -------------------------- | -------------------------------------------- |
| Obrigatório | falso |
| Valor predefinido | Verdadeiro |
| Tipo | Booleano |
| Nome de exibição do portal | O Microsoft Authenticator conta como seguro? |
#### IncludeSoftwareOtp
Os códigos únicos baseados em tempo de aplicações autenticadoras contam como seguros.
| Propriedade | Valor |
| -------------------------- | ------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | Falso |
| Tipo | Booleano |
| Nome de exibição do portal | O OTP de software conta como seguro? |
#### IncludeHardwareOtp
Os tokens de palavra-passe única de hardware contam como seguros.
| Propriedade | Valor |
| -------------------------- | ---------------------------------------------- |
| Obrigatório | falso |
| Valor predefinido | Falso |
| Tipo | Booleano |
| Nome de exibição do 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 predefinido | Verdadeiro |
| Tipo | Booleano |
| Nome de exibição do portal | A autenticação baseada em certificado conta como segura? |
#### SecureOnly
Modo estrito: os utilizadores que também tenham um método de telefone, email ou pergunta de segurança registado nunca reúnem os requisitos, mesmo com um método seguro.
| Propriedade | Valor |
| -------------------------- | ------------- |
| Obrigatório | falso |
| Valor predefinido | Falso |
| Tipo | Booleano |
| Nome de exibição do portal | Modo estrito? |
#### SecureMethodsOverride
Lista personalizada de nomes de métodos que contam como seguros, separados por vírgulas. Quando definida, as alternâncias de métodos individuais são ignoradas. Pré-configurada na personalização do runbook; os nomes dos métodos estão listados na documentação do runbook.
| Propriedade | Valor |
| -------------------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Nome de exibição do portal | Métodos seguros personalizados |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### UnsecureMethodsOverride
Lista personalizada de nomes de métodos que contam como inseguros no modo estrito, separados por vírgulas. Pré-configurada na personalização do runbook.
| Propriedade | Valor |
| -------------------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Nome de exibição do portal | Métodos inseguros personalizados |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### ExcludeAdmins
Os utilizadores com uma função de diretório do Entra ID, ativa ou elegível, nunca reúnem os requisitos e são removidos do grupo. Útil quando o grupo impulsiona a reposição de palavra-passe em self-service.
| Propriedade | Valor |
| -------------------------- | ------------------------ |
| Obrigatório | falso |
| Valor predefinido | Verdadeiro |
| Tipo | Booleano |
| Nome de exibição do portal | Excluir administradores? |
#### ExcludeGroupId
Os membros deste grupo, por exemplo contas break glass ou contas de serviço, nunca reúnem os requisitos e são removidos do grupo de destino. Deixe vazio para nenhum.
| Propriedade | Valor |
| -------------------------- | -------------------- |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Nome de exibição do portal | Grupo de exclusão |
#### ExcludeUserIds
Utilizadores que nunca reúnem os requisitos e são removidos do grupo de destino. Podem ser selecionados vários.
| Propriedade | Valor |
| -------------------------- | ---------------------- |
| Obrigatório | falso |
| Valor predefinido | @() |
| Tipo | String\[] |
| Nome de exibição do portal | Utilizadores excluídos |
#### WhatIfMode
Regista apenas quais utilizadores seriam adicionados ou removidos sem alterar o grupo.
| Propriedade | Valor |
| -------------------------- | ------------------ |
| Obrigatório | falso |
| Valor predefinido | Falso |
| Tipo | Booleano |
| Nome de exibição do portal | Execução de teste? |
#### SendEmail
Enviar o relatório por email após a execução.
| Propriedade | Valor |
| -------------------------- | --------------------------- |
| Obrigatório | falso |
| Valor predefinido | Falso |
| Tipo | Booleano |
| Nome de exibição do portal | Enviar relatório por email? |
**Opções do portal**
| Opção do portal | Valor |
| ---------------------------------- | ---------- |
| Sim - enviar o relatório por email | verdadeiro |
| Não - não enviar email | falso |
#### EmailTo
Enviar o relatório para estes endereços. Separe vários com vírgulas; cada destinatário recebe um email separado.
| Propriedade | Valor |
| -------------------------- | ------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Nome de exibição do portal | Endereço(s) de email do(s) destinatário(s) |
#### EmailFrom
Endereço do remetente do email do relatório. Obtido 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) |
#### ReportFileFormat
Entregar o relatório como CSV, como uma pasta de trabalho do Excel ou ambos.
| Propriedade | Valor |
| -------------------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | CSV e XLSX |
| Tipo | Cadeia de caracteres |
| Nome de exibição do portal | Formato do ficheiro do relatório |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
**Opções do portal**
| Opção do portal | Valor |
| --------------- | ----------- |
| CSV e XLSX | CSV e XLSX |
| Apenas CSV | Apenas CSV |
| Apenas XLSX | Apenas XLSX |
#### CreateDownloadLink
Também carregue o relatório e devolva uma ligação de download que expira após alguns dias.
| Propriedade | Valor |
| -------------------------- | ------------------------------ |
| Obrigatório | falso |
| Valor predefinido | Falso |
| Tipo | Booleano |
| Nome de exibição do portal | Criar uma ligação de download? |
**Opções do portal**
| Opção do portal | Valor |
| ------------------------------------------------------------- | ---------- |
| Sim - carregar o relatório e devolver uma ligação de download | verdadeiro |
| Não - não criar uma ligação de download | falso |
#### ContainerName
Contentor de armazenamento para o qual os ficheiros do relatório são carregados. Definir por runbook.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | sync-mfa-secure-users-to-group |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### ResourceGroupName
Grupo de recursos da conta de armazenamento para carregamentos do relatório. Obtido a partir da definição de tenant RJReport.StorageAccount.ResourceGroup.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### StorageAccountName
Conta de armazenamento para carregamentos do relatório. Obtida a partir da definição de tenant RJReport.StorageAccount.StorageAccountName.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | |
| Tipo | Cadeia de caracteres |
| Oculto no portal | sim (predefinido através da personalização do runbook) |
#### LinkExpiryDays
Número de dias que uma ligação de download permanece válida. Obtido a partir da definição de tenant RJReport.StorageAccount.LinkExpiryDays.
| Propriedade | Valor |
| ----------------- | ------------------------------------------------------ |
| Obrigatório | falso |
| Valor predefinido | 6 |
| Tipo | Int32 |
| 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/org/security/sync-mfa-secure-users-to-group_scheduled.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.