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

# Portal de self-service

O Portal de Autoatendimento do RealmJoin (SSP) é uma interface web central que faz a ponte entre a administração de TI e a autonomia do utilizador final.\
Ao proporcionar uma vista 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:** Integrada via Entra ID (Single Sign-On).

***

## Painel do perfil do utilizador

Após 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 extraídos do fornecedor de identidade.
* **GUIDs de identidade:** Identificadores únicos usados para resolução de problemas no backend.

#### Objetos de dados principais

A interface principal exibe cinco categorias principais:

* **Dispositivos:** Uma lista abrangente do hardware atribuído ao utilizador.
* **Grupos:** Visibilidade em tempo real das associações a grupos Entra ID, permitindo aos utilizadores verificar os seus níveis de acesso.
* **Teams:** Uma lista de Microsoft Teams dos 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 proxy**: Lista de todos os endereços proxy do utilizador.

<figure><img src="/files/42713bbc4c89a48a64a233736b35bc8ebdfed5bd" alt=""><figcaption><p>Vista geral do perfil do utilizador</p></figcaption></figure>

### Vista do dispositivo

Ao clicar num dispositivo Windows, o utilizador é encaminhado 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 foca-se no ativo de hardware específico:

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

#### **Separador de vista geral**

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

* **Gestão de administradores locais:** 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 (Windows Store / pacotes UWP).
  * **Win32:** Aplicações "clássicas" do Windows (instaladas via .exe ou .msi).
  * **Subscrito:** A versão atual disponível no repositório central de pacotes da aplicação.
  * **Implementado:** A versão do pacote que foi enviada/executada por último neste dispositivo específico.
  * **Instalado:** A versão real atualmente detetada no sistema de ficheiros local.
  * **Detetadas:** Aplicações detetadas no dispositivo que não foram implementadas via Intune ou RealmJoin (ou seja, instaladas por sideload ou manualmente).
  * **Não instalado:** Um pacote de software disponível que foi atribuído, mas ainda não foi executado no dispositivo.
  * **Utilização**: Apresenta a frequência de lançamentos da aplicação (quando os dados de telemetria estão disponíveis).

<figure><img src="/files/857eb93a942f4970e94c0288e097a0e939c1bc5f" alt=""><figcaption><p>Vista geral do dispositivo</p></figcaption></figure>

#### **Separador do catálogo de aplicações**

O App Catalog serve como uma substituição moderna, baseada na web, para o menu da bandeja legado do RealmJoin.

* **Interface visual:** Uma apresentação limpa, em grelha, de todos os pacotes de software atribuídos como disponíveis ao utilizador/dispositivo.
* **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 imediatamente o instalador no sistema local.

<figure><img src="/files/5b4a3cf6841d5aedf78491b94f4fe5e1c8bb49b4" 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ído no dispositivo.

{% hint style="warning" %}
A instalação de aplicações em autoatendimento através do App Catalog é **apenas disponível para implementação usando o agente RealmJoin e pacotes listados na App Store**.\
Uma vez que a instalação é executada diretamente no dispositivo em utilização, 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="/files/a43a006bd6797a8b6dde11e6459f4ba386412a46" 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 comunica de volta ao portal.
{% endhint %}

{% hint style="info" %}
Para permitir automaticamente que o portal RealmJoin acione o agente RJ a partir do Microsoft Edge (ocultando o diálogo "Este site está a tentar abrir..."), pode usar a seguinte política: [Definir uma lista de protocolos que podem iniciar uma aplicação externa a partir das origens listadas sem pedir ao utilizador](https://learn.microsoft.com/en-us/deployedge/microsoft-edge-browser-policies/autolaunchprotocolsfromorigins)

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

{% endhint %}

#### Acesso com um clique: Portal de autoatendimento a partir da bandeja

O App Catalog pode ser aberto diretamente a partir do menu da bandeja e, opcionalmente, a partir do Menu Iniciar do Windows, sem qualquer configuração manual de ligação.

* Ative a [`AppCatalog.Enabled`](https://docs.realmjoin.com/ugd-management/user-and-group-settings/additional-settings#appcatalog-feature) definição para adicionar uma entrada **App Catalog** ao menu da bandeja RealmJoin, abrindo a página App Catalog 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 do Menu Iniciar por utilizador ("App Catalog") que abre a mesma página, para que possa ser encontrado através da pesquisa do Iniciar ou afixado na barra de tarefas.

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

***

## Formulários de autoatendimento

O portal pode ser configurado para alojar formulários interativos. Estes permitem aos utilizadores solicitar alterações específicas, atualizar os seus próprios metadados ou acionar scripts automatizados no backend.

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

<figure><img src="/files/a9756c8f2b1a0999fbab5cf84bafcfa103cde9ac" 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 se encontram no catálogo oficial.

* **Baseado em permissões:** Esta opção só aparece se ao utilizador tiverem sido concedidas as permissões necessárias no backend RealmJoin.

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

<figure><img src="/files/1ff2277acf6245f5dfa76bd36870872f4de37ad4" 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.realmjoin.com/pt/realmjoin-agent/client-menu/self-service-portal.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
