> 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 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 que os utilizadores gerenciem 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 de Controlo do Perfil do Utilizador

Após a 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 gerais do objeto, incluindo:

* **Nome Principal do Utilizador (UPN):** A cadeia de caracteres principal de identidade.
* **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 apresenta 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 em que 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>Visão geral do perfil do utilizador</p></figcaption></figure>

### Vista do dispositivo

Ao clicar num dispositivo Windows, o utilizador é direcionado para a [**vista de detalhes 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 de autoatendimento.

#### Barra lateral de controlo do dispositivo

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

* **Metadados:** Apresenta o Nome do Dispositivo, Sinais de Hardware (por exemplo, estado do Autopilot), proprietário Entra e IDs de 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**: Iniciar a análise do Defender no dispositivo. Disponível apenas com a função de administrador do RealmJoin.

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

A página de destino para 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 temporária de administrador de suporte ou uma conta de administrador persistente para o dispositivo.
* **Grupos:** Todas as associações do dispositivo a grupos
* **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 de aplicações.
  * **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.
  * **Apparated:** Aplicações detetadas no dispositivo que não foram implementadas via Intune ou RealmJoin (ou seja, sideloaded ou instaladas 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 de aplicações (quando os dados de telemetria estão disponíveis).

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

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

O Catálogo de Aplicações serve como uma substituição moderna, baseada na web, do antigo menu de bandeja RealmJoin.

* **Interface visual:** Uma disposiçã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, um comando é enviado para o **Agent do RealmJoin**. 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 utiliza 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 de autoatendimento através do Catálogo de Aplicações está **disponível apenas para implementação através do agente RealmJoin e dos pacotes listados na App Store**.\
Como 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 uma caixa de diálogo de confirmação para evitar instalações indesejadas ou acidentais.

<figure><img src="/files/a43a006bd6797a8b6dde11e6459f4ba386412a46" alt=""><figcaption><p>Caixa de diálogo de aviso</p></figcaption></figure>

{% hint style="warning" %}
**Observação:** 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, enquanto o agente comunica de volta ao portal.
{% endhint %}

{% hint style="info" %}
Para permitir automaticamente que o portal RealmJoin invoque o agente RJ a partir do Microsoft Edge (ocultando a caixa de diálogo "Este site está a tentar abrir..."), pode usar a seguinte política: [Defina uma lista de protocolos que podem iniciar uma aplicação externa a partir de origens listadas sem pedir confirmação 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 Catálogo de Aplicações 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 **Catálogo de Aplicações** entrada ao menu da bandeja 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 também criar um atalho do 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 fixado 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 bandeja (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 momento do arranque, pelo que funcionam em todos os dispositivos associados ao Entra ID sem personalização por dispositivo.

***

## Formulários de Autosserviço

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="/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 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="/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.
