> 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/implementacao/required-permissions.md).

# Permissões necessárias

Permissões do Microsoft Graph e do Azure necessárias para as aplicações do RealmJoin Portal para funcionalidades de autosserviço e administrativas.

O RealmJoin Portal consiste em vários apps que são usados para diferentes casos de uso.

## RealmJoin Portal

ID da aplicação: `b0130885-16be-4c6f-83de-5b1042b5d2e3`

Os utilizadores interagem com esta app para autoatendimento. Os administradores usam esta app para interagir com todos os recursos do RealmJoin Portal.

Todas as permissões a seguir são do tipo de permissão “**Delegado**” (= só pode operar quando um utilizador tem sessão iniciada interativamente). Além disso, esta app pode ser **com consentimento por utilizador** (= o consentimento do administrador é opcional).

Estas permissões são necessárias para a funcionalidade básica da app por utilizador.

### Permissões de API

As permissões a seguir são do tipo "Delegated" e são usadas principalmente para iniciar sessão no Portal.

| Reivindicação   | Permissão                                             |
| --------------- | ----------------------------------------------------- |
| User.Read       | Iniciar sessão e ler o perfil do utilizador           |
| perfil          | Ver o perfil básico dos utilizadores                  |
| email           | Ver o endereço de email dos utilizadores              |
| openid          | Iniciar sessão dos utilizadores                       |
| offline\_access | Manter acesso aos dados aos quais lhe concedeu acesso |

{% hint style="info" %}
Dependendo da forma como integrou o seu Tenant, poderá encontrar as permissões "RealmJoin Portal - Core Features" abaixo dentro da aplicação "RealmJoin Portal" ou na aplicação separada descrita abaixo.
{% endhint %}

A tabela seguinte reflete as permissões (tipo permissões de aplicação) se Administrative Units (AU) **não forem usadas**.

Algumas das permissões são necessárias para funcionalidades opcionais; contacte o seu agente de onboarding para adaptar o consentimento às suas necessidades.

| Reivindicação                                           | Permissão                                                                                                                                                                                                                           |
| ------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| AuditLog.Read.All                                       | Ler todos os dados do registo de auditoria                                                                                                                                                                                          |
| BitlockerKey.Read.All                                   | Ler todas as chaves do BitLocker                                                                                                                                                                                                    |
| Device.Read.All                                         | Ler todos os dispositivos                                                                                                                                                                                                           |
| DeviceLocalCredential.Read.All                          | Ler palavras-passe de credenciais locais do dispositivo                                                                                                                                                                             |
| DeviceManagementApps.ReadWrite.All                      | Ler e escrever apps do Microsoft Intune                                                                                                                                                                                             |
| DeviceManagementConfiguration.Read.All                  | Ler a configuração e as políticas dos dispositivos do Microsoft Intune                                                                                                                                                              |
| DeviceManagementConfiguration.ReadWrite.All (opcional)  | Ler e escrever a configuração e as políticas dos dispositivos do Microsoft Intune; necessário para [implementação de apps Android](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/android-apps-managed-google-play.md) |
| DeviceManagementManagedDevices.PrivilegedOperations.All | Executar ações remotas com impacto no utilizador em dispositivos Microsoft Intune                                                                                                                                                   |
| DeviceManagementManagedDevices.Read.All                 | Ler dispositivos do Microsoft Intune                                                                                                                                                                                                |
| DeviceManagementScripts.ReadWrite.All                   | Ler e escrever scripts do Microsoft Intune                                                                                                                                                                                          |
| DeviceManagementServiceConfig.Read.All                  | Ler a configuração do Microsoft Intune                                                                                                                                                                                              |
| Group.ReadWrite.All                                     | Ler e escrever todos os grupos                                                                                                                                                                                                      |
| GroupMember.ReadWrite.All                               | Ler e escrever todas as associações a grupos                                                                                                                                                                                        |
| LicenseAssignment.Read.All                              | Ler todas as atribuições de licenças                                                                                                                                                                                                |
| User.Read.All                                           | Ler os perfis completos de todos os utilizadores                                                                                                                                                                                    |
| WindowsUpdates.ReadWrite.All                            | Ler e escrever todas as definições de implementação de atualizações do Windows                                                                                                                                                      |
| AdministrativeUnit.Read.All (opcional)                  | Ler todas as unidades administrativas                                                                                                                                                                                               |

## RealmJoin Portal - Core Features

ID da aplicação: `61fcb903-2868-4c54-91cd-2716c62c5007`

Os administradores e utilizadores não interagem diretamente com esta app. Ela representa o backend do RealmJoin que interage com Entra ID e Intune.

Todas as ações acionadas por esta app são filtradas através do modelo interno de permissões (RBAC) do RealmJoin, que pode avaliar associações a grupos e funções do Entra.

Todas as permissões a seguir são do tipo de permissão “**Aplicação**” (= pode operar sem um utilizador com sessão iniciada) e tem como alvo [MS Graph API](https://docs.microsoft.com/en-us/graph/api/overview?view=graph-rest-1.0). Pode ler mais sobre as permissões individuais [aqui](https://docs.microsoft.com/en-us/graph/permissions-reference).

### Permissões de API

A tabela seguinte reflete as permissões (tipo permissões de aplicação) se Administrative Units (AU) **não forem usadas**.

Algumas das permissões são necessárias para funcionalidades opcionais; contacte o seu agente de onboarding para adaptar o consentimento às suas necessidades.

| Reivindicação                                           | Permissão                                                                         |
| ------------------------------------------------------- | --------------------------------------------------------------------------------- |
| AuditLog.Read.All                                       | Ler todos os dados do registo de auditoria                                        |
| BitlockerKey.Read.All                                   | Ler todas as chaves do BitLocker                                                  |
| Device.Read.All                                         | Ler todos os dispositivos                                                         |
| DeviceLocalCredential.Read.All                          | Ler palavras-passe de credenciais locais do dispositivo                           |
| DeviceManagementApps.ReadWrite.All                      | Ler e escrever apps do Microsoft Intune                                           |
| DeviceManagementConfiguration.Read.All                  | Ler a configuração e as políticas dos dispositivos do Microsoft Intune            |
| DeviceManagementManagedDevices.PrivilegedOperations.All | Executar ações remotas com impacto no utilizador em dispositivos Microsoft Intune |
| DeviceManagementManagedDevices.Read.All                 | Ler dispositivos do Microsoft Intune                                              |
| DeviceManagementScripts.ReadWrite.All                   | Ler e escrever scripts do Microsoft Intune                                        |
| DeviceManagementServiceConfig.Read.All                  | Ler a configuração do Microsoft Intune                                            |
| Group.ReadWrite.All                                     | Ler e escrever todos os grupos                                                    |
| GroupMember.ReadWrite.All                               | Ler e escrever todas as associações a grupos                                      |
| User.Read.All                                           | Ler os perfis completos de todos os utilizadores                                  |
| WindowsUpdates.ReadWrite.All                            | Ler e escrever todas as definições de implementação de atualizações do Windows    |
| AdministrativeUnit.Read.All (opcional)                  | Ler todas as unidades administrativas                                             |

## RealmJoin Portal - Security Features

ID da aplicação: `e5713826-15ee-4f6c-91ee-56cb1844e275`

Esta app é responsável pelas informações avançadas de segurança no ReamJoin Portal. Consulte o seu agente de onboarding para adaptar o consentimento às suas necessidades.

Todas as permissões a seguir usam a `WindowsDefenderATP` API.

### Permissões de API

| Reivindicação                   | Permissão                                                                  |
| ------------------------------- | -------------------------------------------------------------------------- |
| AdvancedQuery.Read.All          | Executar consultas avançadas                                               |
| Alert.Read.All                  | Ler todos os alertas                                                       |
| File.Read.All                   | Ler perfis de ficheiros                                                    |
| Ip.Read.All                     | Ler perfis de endereços IP                                                 |
| Machine.Read.All                | Ler todos os perfis de máquinas                                            |
| Score.Read.All                  | Ler a pontuação de Threat and Vulnerability Management                     |
| SecurityConfiguration.Read.All  | Ler todas as configurações de segurança                                    |
| SecurityRecommendation.Read.All | Ler as recomendações de segurança de Threat and Vulnerability Management   |
| Software.Read.All               | Ler informações de software de Threat and Vulnerability Management         |
| Ti.Read.All                     | Ler todos os IOCs                                                          |
| Url.Read.All                    | Ler perfis de URL                                                          |
| User.Read.All                   | Ler perfis de utilizador                                                   |
| Vulnerability.Read.All          | Ler informações de vulnerabilidades de Threat and Vulnerability Management |

## RealmJoin

ID da aplicação: `008c704d-20fe-4c15-bab0-c2e6f66a992c`

Esta app é responsável pela aplicação cliente (RealmJoin **Agente**).

Consulte o seu agente de onboarding para adaptar o consentimento às suas necessidades.

### Permissões de API

| Reivindicação   | Permissão                                        |
| --------------- | ------------------------------------------------ |
| Device.Read.All | Ler todos os dispositivos                        |
| Group.Read.All  | Ler todos os grupos                              |
| User.Read       | Iniciar sessão e ler o perfil do utilizador      |
| User.Read.All   | Ler os perfis completos de todos os utilizadores |


---

# 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/implementacao/required-permissions.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.
