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

# Self-Service-Portal

Das RealmJoin Self-Service-Portal (SSP) ist eine zentrale webbasierte Oberfläche, die die Lücke zwischen IT-Administration und Autonomie der Endbenutzer überbrückt.\
Durch die transparente Darstellung der RealmJoin-Umgebung können Benutzer ihre eigenen Geräte, Software und Identitätsattribute verwalten und so die Anzahl der standardmäßigen IT-Support-Tickets reduzieren.

* **Öffentliche Zugriffs-URL:** [portal.realmjoin.com](https://portal.realmjoin.com)
* **Authentifizierung:** Integriert über Entra ID (Single Sign-On).

***

## Benutzerprofil-Dashboard

Nach erfolgreicher Authentifizierung präsentiert das Portal ein benutzerzentriertes Dashboard. Diese Ansicht ist darauf ausgelegt, sofortige Transparenz über den digitalen Fußabdruck des Benutzers innerhalb der Unternehmensumgebung zu bieten.

#### Benutzeridentitäts-Seitenleiste (links)

Die dauerhafte Seitenleiste auf der linken Seite des Dashboards bietet zusammengefasste Objektdetails, darunter:

* **Benutzerprinzipalname (UPN):** Die primäre Identitätszeichenfolge.
* **Abteilung/Standort:** Aus dem Identitätsanbieter abgerufene Metadaten.
* **Identitäts-GUIDs:** Eindeutige Kennungen, die für die Fehlersuche im Backend verwendet werden.

#### Primäre Datenobjekte

Die Hauptoberfläche zeigt fünf Hauptkategorien an:

* **Geräte:** Eine umfassende Liste der dem Benutzer zugewiesenen Hardware.
* **Gruppen:** Echtzeit-Einblick in Entra-ID-Gruppenmitgliedschaften, sodass Benutzer ihre Zugriffsrechte überprüfen können.
* **Teams:** Eine Liste von Microsoft Teams, in denen der Benutzer aktives Mitglied oder Besitzer ist.
* **App-Rollen:** Spezifische Berechtigungen oder Rollen auf Anwendungsebene, die dem Benutzerprofil zugewiesen sind.
* **Proxy-Adressen**: Liste aller Proxy-Adressen des Benutzers.

<figure><img src="/files/e25c8feba2d29c3fded60a01e1456b39a448a3f2" alt=""><figcaption><p>Benutzerprofilübersicht</p></figcaption></figure>

### Geräteansicht

Durch Klicken auf ein Windows-Gerät wird der Benutzer zur [**Gerätedetailansicht**](https://docs.realmjoin.com/ugd-management/user-list/device-details). Dieser Abschnitt ist der Kern der Self-Service-Fehlerbehebung.

#### Gerätesteuerungs-Seitenleiste

Diese Seitenleiste konzentriert sich auf das jeweilige Hardware-Asset:

* **Metadaten:** Zeigt Gerätename, Hardware-Flags (z. B. Autopilot-Status), Entra-Besitzer und Intune-/RJ-Geräte-IDs an.
* **Synchronisierungsaktion:**
  * **Synchronisieren**: Löst das Intune-MDM (Mobile Device Management)-Check-in sowie den lokalen RealmJoin-Agenten aus, um die neuesten Konfigurationen und App-Zuweisungen abzurufen und gegebenenfalls Protokolldateien hochzuladen.
  * **Defender-Scan**: Startet den Defender-Scan des Geräts. Nur mit der RealmJoin-Administratorrolle verfügbar.

#### **Übersichts-Tab**

Die Startseite für Gerätedetails. Sie bietet:

* **Verwaltung lokaler Administratoren:** Wenn der Benutzer für [selfLAPS](https://docs.realmjoin.com/realmjoin-agent/realmjoin-client/local-admin-password-solution-laps#support-account)freigeschaltet ist, kann mit der Funktion ein temporäres Support-Administratorkonto oder ein dauerhaftes Administratorkonto für das Gerät angefordert werden.
* **Gruppen:** Alle Gruppenmitgliedschaften des Geräts
* **Installierte Software:** Liste der auf dem Gerät gefundenen Anwendungen. Glossar:
  * **Choco:** Installiert mit der Chocolatey-Engine, z. B. über RealmJoin.
  * **APPX:** Moderne Windows-Anwendungen (Windows Store-/UWP-Pakete).
  * **Win32:** „Klassische“ Windows-Anwendungen (installiert über .exe oder .msi).
  * **Abonniert:** Die aktuell verfügbare Version im zentralen Anwendungs-Paket-Repository.
  * **Bereitgestellt:** Die Version des Pakets, die zuletzt auf dieses bestimmte Gerät übertragen/ausgeführt wurde.
  * **Installiert:** Die aktuell tatsächlich auf dem lokalen Dateisystem erkannte Version.
  * **Gefunden:** Auf dem Gerät erkannte Anwendungen, die nicht über Intune oder RealmJoin bereitgestellt wurden (d. h. per Sideloading oder manuell installiert).
  * **Nicht installiert:** Ein verfügbares Softwarepaket, das zugewiesen, aber auf dem Gerät noch nicht ausgeführt wurde.
  * **Nutzung**: Zeigt die Häufigkeit von Anwendungsstarts an (sofern Telemetriedaten verfügbar sind).

<figure><img src="/files/d1beefa462bacc07089bca26b59bdc9da7a36971" alt=""><figcaption><p>Geräteübersicht</p></figcaption></figure>

#### **App-Katalog-Tab**

Der App-Katalog dient als moderner, webbasierter Ersatz für das alte RealmJoin-Infobereichmenü.

* **Visuelle Oberfläche:** Ein übersichtliches, rasterbasiertes Layout aller Softwarepakete, die dem Benutzer/Gerät als verfügbar zugewiesen sind.
* **Benutzeraktionen:**
  * **Installieren:** Eine neue Softwareinstallation starten.
  * **Aktualisieren:** Eine vorhandene Anwendung auf die neueste verfügbare Version aktualisieren.
  * **Neu installieren:** Ein Softwarepaket reparieren oder zurücksetzen.
* **Technische Ausführung:** Wenn auf eine Aktion geklickt wird, wird ein Befehl an den **RealmJoin-Agent**. Der Agent startet das Installationsprogramm sofort auf dem lokalen System.

<figure><img src="/files/95d750bd40d4344de28ebf4c105ea0781e295075" alt=""><figcaption><p>App-Katalog für Self-Service</p></figcaption></figure>

Der Self-Service-App-Katalog verwendet den RealmJoin [benutzerdefinierten Protokoll](https://docs.realmjoin.com/dev-reference/custom-protocol) um den lokal installierten RealmJoin-Agenten zu starten und den Benutzerklick zu imitieren, wodurch die Installation der zugewiesenen Paketkonfiguration auf dem Gerät ausgelöst wird.

{% hint style="warning" %}
Die Self-Service-Anwendungsinstallation über den App-Katalog ist **nur für die Bereitstellung mit dem RealmJoin-Agenten und für Pakete verfügbar, die im App Store aufgeführt sind**.\
Da die Installation direkt auf dem verwendeten Gerät ausgeführt wird, können administrative Konten keine Installationen auf anderen Geräten starten.
{% endhint %}

Für die erste Installation in jeder aktiven Sitzung auf dem Gerät wird dem Benutzer ein Bestätigungsdialog angezeigt, um unerwünschte oder versehentliche Installationen zu verhindern.

<figure><img src="/files/838fed682e8af6eb832744a78c0a5da9a88af08f" alt=""><figcaption><p>Warnungsdialog</p></figcaption></figure>

{% hint style="warning" %}
**Hinweis:** Nach der Ausführung kann die Statusaktualisierung (z. B. von "Installing" zu "Success") aufgrund der Rückmeldung des Agents an das Portal um einige Sekunden verzögert sein.
{% endhint %}

{% hint style="info" %}
Um das Starten des RJ-Agents durch das RealmJoin-Portal aus Microsoft Edge automatisch zuzulassen (blendet den Dialog "This site is trying to open..." aus), können Sie die folgende Richtlinie verwenden: [Definieren Sie eine Liste von Protokollen, die von aufgeführten Ursprüngen aus eine externe Anwendung ohne Benutzerabfrage starten können](https://learn.microsoft.com/en-us/deployedge/microsoft-edge-browser-policies/autolaunchprotocolsfromorigins)

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

{% endhint %}

#### Zugriff mit einem Klick: Self-Service-Portal aus dem Infobereich

Der App-Katalog kann direkt aus dem Infobereichsmenü und optional aus dem Windows-Startmenü geöffnet werden, ohne manuelle Link-Konfiguration.

* Aktivieren Sie die [`AppCatalog.Enabled`](https://docs.realmjoin.com/ugd-management/user-and-group-settings/additional-settings#appcatalog-feature) Einstellung, um einen **App-Katalog** Eintrag zum RealmJoin-Infobereichsmenü hinzuzufügen, der die App-Katalog-Seite des Geräts im App-Modus von Microsoft Edge öffnet (ein schlichtes Fenster ohne Rahmen).
* Aktivieren Sie zusätzlich `AppCatalog.CreateStartMenuShortcut` um auch eine benutzerspezifische Startmenü-Verknüpfung ("App Catalog") zu erstellen, die dieselbe Seite öffnet, sodass sie über die Startsuche gefunden oder an die Taskleiste angeheftet werden kann.
* Verwenden Sie [`AppCatalog.Ui.DisplayName`](https://docs.realmjoin.com/ugd-management/user-and-group-settings/additional-settings#appcatalog-feature) um den Eintrag im Infobereichsmenü (und die Startmenü-Verknüpfung) umzubenennen, wenn die Standardbezeichnung "App Catalog" nicht zu Ihren Namenskonventionen passt.

Beide Einträge lösen beim Start dynamisch das aktuelle Gerät und den angemeldeten Benutzer auf, sodass sie auf allen mit Entra verbundenen Geräten ohne gerätespezifische Anpassung funktionieren.

***

## Self-Service-Formulare

Das Portal kann so konfiguriert werden, dass interaktive Formulare bereitgestellt werden. Diese ermöglichen es Benutzern, bestimmte Änderungen anzufordern, ihre eigenen Metadaten zu aktualisieren oder automatisierte Backend-Skripte auszulösen.

[Mehr über Self-Service-Formulare erfahren](https://docs.realmjoin.com/realmjoin-settings/self-service-forms)

<figure><img src="/files/d411b91567b874ac0b00c3a261faa69f98ca5d00" alt=""><figcaption><p>Self-Service-Formulare</p></figcaption></figure>

## Anwendungs-Paketierungsanfragen

Benutzer können neue Anwendungspakete anfordern, die noch nicht im offiziellen Katalog enthalten sind.

* **Berechtigungsbasiert:** Diese Option erscheint nur, wenn dem Benutzer die erforderlichen Berechtigungen im RealmJoin-Backend gewährt wurden.

[Mehr über Paketierungsanfragen erfahren](https://docs.realmjoin.com/app-management/packages/packaging-requests)

<figure><img src="/files/71bf20b94cbe7f5abec1cebfc973f6fdf09befe7" alt=""><figcaption><p>Paketanforderungsformular</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/de/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.
