> 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/agente-realmjoin/client-menu/self-service-portal.md).

# Self Service Portal

O RealmJoin Self-Service Portal permite aos utilizadores gerir os seus dispositivos, software e atributos de identidade através de início de sessão único do Entra ID.

O Portal de Autoatendimento do RealmJoin (SSP) é uma interface central baseada na Web que faz a ponte entre a administração de TI e a autonomia do utilizador final.\
Ao fornecer uma visão transparente do ambiente RealmJoin, permite aos utilizadores gerir os seus próprios dispositivos, software e atributos de identidade, reduzindo o volume de tickets de suporte de TI padrão.

* **URL de acesso público:** [portal.realmjoin.com](https://portal.realmjoin.com)
* **Autenticação:** Integrado via Entra ID (Single Sign-On).

***

## Painel do Perfil do Utilizador

Após uma autenticação bem-sucedida, o portal apresenta um painel centrado no utilizador. Esta vista foi concebida para fornecer visibilidade imediata da pegada digital do utilizador no ambiente corporativo.

#### Barra lateral de identidade do utilizador (esquerda)

A barra lateral persistente no lado esquerdo do painel fornece detalhes de alto nível do objeto, incluindo:

* **Nome Principal do Utilizador (UPN):** A cadeia de identidade principal.
* **Departamento/Localização:** Metadados obtidos do fornecedor de identidade.
* **GUIDs de identidade:** Identificadores únicos usados para resolução de problemas no backend.

#### Objetos de dados principais

A interface principal mostra cinco categorias principais:

* **Dispositivos:** Uma lista abrangente de hardware atribuído ao utilizador.
* **Grupos:** Visibilidade em tempo real das associações a grupos do Entra ID, permitindo aos utilizadores verificar os seus níveis de acesso.
* **Teams:** Uma lista de Microsoft Teams nos quais o utilizador é membro ativo ou proprietário.
* **Funções de aplicação:** Permissões ou funções específicas ao nível da aplicação atribuídas ao perfil do utilizador.
* **Endereços de proxy**: Lista de todos os endereços de proxy do utilizador.

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FVPOLC4cYesf7H1xVKkYM%2F26-04-16-15_29_41_msedge.png?alt=media&amp;token=c1b4c0f0-3e15-4aee-91ee-a6868a3ac448" alt=""><figcaption><p>Visão geral do perfil do utilizador</p></figcaption></figure>

### Vista do dispositivo

Clicar num dispositivo Windows leva o utilizador para a [**vista detalhada do dispositivo**](https://docs.realmjoin.com/ugd-management/user-list/device-details). Esta secção é o núcleo da experiência de resolução de problemas em autoatendimento.

#### Barra lateral de controlo do dispositivo

Esta barra lateral concentra-se no ativo de hardware específico:

* **Metadados:** Mostra o nome do dispositivo, sinalizadores de hardware (por exemplo, estado do Autopilot), proprietário do Entra e IDs de dispositivo do Intune/RJ.
* **Ação de sincronização:**
  * **Sincronizar**: Aciona o check-in do Intune MDM (Mobile Device Management), bem como o agente local do RealmJoin, para obter as configurações mais recentes e as atribuições de aplicações e enviar ficheiros de registo, se aplicável.
  * **Análise do Defender**: Inicia a análise do Defender do dispositivo. Apenas disponível com a função de administrador do RealmJoin.

#### **Separador de visão geral**

A página inicial dos detalhes do dispositivo. Fornece:

* **Gestão de administrador local:** Se o utilizador estiver ativado para [selfLAPS](https://docs.realmjoin.com/realmjoin-agent/realmjoin-client/local-admin-password-solution-laps#support-account), a função permite solicitar uma conta de administrador de suporte temporária ou uma conta de administrador persistente para o dispositivo.
* **Grupos:** Todas as associações a grupos do dispositivo
* **Software instalado:** Lista de aplicações encontradas no dispositivo. Glossário:
  * **Choco:** Instalado usando o motor chocolatey, por exemplo via RealmJoin.
  * **APPX:** Aplicações modernas do Windows (pacotes da Windows Store / UWP).
  * **Win32:** Aplicações Windows "clássicas" (instaladas via .exe ou .msi).
  * **Subscritas:** A versão atual disponível no repositório central de pacotes de aplicações.
  * **Implantadas:** A versão do pacote que foi a última enviada/executada neste dispositivo específico.
  * **Instaladas:** A versão real atualmente detetada no sistema de ficheiros local.
  * **Detetadas:** Aplicações detetadas no dispositivo que não foram implantadas via Intune ou RealmJoin (ou seja, carregadas lateralmente ou instaladas manualmente).
  * **Não instaladas:** Um pacote de software disponível que foi atribuído, mas ainda não foi executado no dispositivo.
  * **Utilização**: Mostra a frequência de aberturas das aplicações (quando os dados de telemetria estão disponíveis).

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fxe9nDy1NUJoBDeA2z91a%2F26-04-16-15_31_46_msedge.png?alt=media&amp;token=1365f68d-d087-4c8e-b169-54c4d04d62a9" alt=""><figcaption><p>Visão geral do dispositivo</p></figcaption></figure>

#### **Separador Catálogo de Aplicações**

O Catálogo de Aplicações serve como um substituto moderno, baseado na Web, do menu da área de notificação legado do RealmJoin.

* **Interface visual:** Uma disposição limpa, em grelha, de todos os pacotes de software atribuídos como disponíveis para o utilizador/dispositivo.
* **Descrições:** Cada pacote mostra a sua descrição curta. Os administradores podem substituir a descrição fornecida com o pacote por um texto personalizado e amigável para o utilizador por Tenant, veja [Detalhes do Pacote](/pt/gestao-de-aplicacoes/packages/package-details.md#short-description).
* **Ações do utilizador:**
  * **Instalar:** Iniciar uma nova instalação de software.
  * **Atualizar:** Atualizar uma aplicação existente para a versão mais recente disponível.
  * **Reinstalar:** Reparar ou repor um pacote de software.
* **Execução técnica:** Quando uma ação é clicada, é enviado um comando para o **RealmJoin Agent**. O agente aciona o instalador imediatamente no sistema local.

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FlhEkE65W1XkbwJJ2yP4m%2F26-04-16-15_32_20_msedge.png?alt=media&amp;token=1eac1ed1-8494-4cae-add5-b492a850eb2a" alt=""><figcaption><p>Catálogo de Aplicações para autoatendimento</p></figcaption></figure>

O Catálogo de Aplicações de Autoatendimento usa o RealmJoin [protocolo personalizado](https://docs.realmjoin.com/dev-reference/custom-protocol) para iniciar o agente RealmJoin instalado localmente e imitar o clique do utilizador, o que aciona a instalação da configuração do pacote atribuída ao dispositivo.

{% hint style="warning" %}
A instalação de aplicações em autoatendimento através do Catálogo de Aplicações é **disponível apenas para implementação usando o agente RealmJoin e pacotes listados na Loja de Aplicações**.\
Uma vez que a instalação é executada diretamente no dispositivo em uso, não é possível que contas administrativas iniciem instalações noutros dispositivos.
{% endhint %}

Na primeira instalação em cada sessão ativa no dispositivo, é apresentado ao utilizador um diálogo de confirmação para evitar instalações indesejadas ou acidentais.

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FUmLnhNlJzddsQDBYjI9o%2Fimage.png?alt=media&amp;token=3220f671-8533-44e6-8994-f29ed6627227" alt=""><figcaption><p>Diálogo de aviso</p></figcaption></figure>

{% hint style="warning" %}
**Nota:** Após a execução, a atualização de estado (por exemplo, de "A instalar" para "Sucesso") pode ter uma ligeira latência de alguns segundos, à medida que o agente devolve informação ao portal.
{% endhint %}

{% hint style="info" %}
Para permitir que o portal RealmJoin acione o agente RealmJoin a partir do Microsoft Edge sem o diálogo "Este site está a tentar abrir...", permita o `realmjoin` protocolo com a política do Edge [`AutoLaunchProtocolsFromOrigins`](https://learn.microsoft.com/en-us/deployedge/microsoft-edge-browser-policies/autolaunchprotocolsfromorigins). Adicione-o ao perfil que o seu Tenant já usa para esta política, ou deixe que o agente RealmJoin o defina com [`Policies.EdgeAllowRealmJoinProtocol`](/pt/ugd-management/user-and-group-settings/additional-settings.md#edge-protocol-prompt-for-the-app-catalog), nunca ambos.

```
[ { "allowed_origins": [ "realmjoin.com" ], "protocol": "realmjoin" } ]
```

{% endhint %}

#### Acesso com um clique: Portal de Autoatendimento a partir da área de notificação

O Catálogo de Aplicações pode ser aberto diretamente a partir do menu da área de notificação e, opcionalmente, a partir do Menu Iniciar do Windows, sem qualquer configuração manual de links.

* Ative a [`AppCatalog.Enabled`](https://docs.realmjoin.com/ugd-management/user-and-group-settings/additional-settings#appcatalog-feature) definição para adicionar uma **Catálogo de Aplicações** entrada ao menu da área de notificação do RealmJoin, abrindo a página do Catálogo de Aplicações do dispositivo no modo de aplicação do Microsoft Edge (uma janela limpa, sem moldura).
* Além disso, ative `AppCatalog.CreateStartMenuShortcut` para criar também um atalho no Menu Iniciar por utilizador ("Catálogo de Aplicações") que abre a mesma página, para que possa ser encontrado através da pesquisa do Iniciar ou afixado na barra de tarefas.
* Use [`AppCatalog.Ui.DisplayName`](https://docs.realmjoin.com/ugd-management/user-and-group-settings/additional-settings#appcatalog-feature) para renomear a entrada do menu da área de notificação (e o atalho do Menu Iniciar) se a legenda predefinida "Catálogo de Aplicações" não se adequar às suas convenções de nomenclatura.

Ambas as entradas resolvem dinamicamente o dispositivo atual e o utilizador com sessão iniciada no arranque, pelo que funcionam em todos os dispositivos associados ao Entra sem personalização por dispositivo.

***

## Formulários de Autoatendimento

O portal pode ser configurado para alojar formulários interativos. Estes permitem que os utilizadores solicitem alterações específicas, atualizem os seus próprios metadados ou acionem scripts automatizados de backend.

[Saiba mais sobre Formulários de Autoatendimento](https://docs.realmjoin.com/realmjoin-settings/self-service-forms)

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FFzYhJ5v2pZwZeI8kw9sm%2Fimage.png?alt=media&amp;token=a6beaa43-c430-4989-9c3f-3da74b7c49b0" alt=""><figcaption><p>Formulários de autoatendimento</p></figcaption></figure>

## Pedidos de Empacotamento de Aplicações

Os utilizadores podem solicitar novos pacotes de aplicações que ainda não estão no catálogo oficial.

* **Baseado em permissões:** Esta opção só aparece se o utilizador tiver recebido as permissões necessárias no backend do RealmJoin.

[Saiba mais sobre Pedidos de Empacotamento](https://docs.realmjoin.com/app-management/packages/packaging-requests)

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FzDrutwbnNUZsoK2fE2QC%2Fimage.png?alt=media&amp;token=2fc39434-ff14-44d0-852c-35cf282a2c00" alt=""><figcaption><p>Formulário de pedido de pacote</p></figcaption></figure>

***


---

# 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/agente-realmjoin/client-menu/self-service-portal.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.
