---
title: "KeyHelp: Als Admin in den Kundenbereich wechseln und Anmelde-URLs für den Support nutzen"
date: 2026-10-01T16:20:05+02:00
modified: 2026-11-08T22:37:35+01:00
category: linux
type: how_to
author: Marcel Schönfelder
canonical: https://s-edv.com/anleitungen/keyhelp-admin-kundenbereich-wechseln-login-url-support
keywords:
  - KeyHelp
  - Webhosting
  - Linux
  - Server-Sicherheit
  - Support
reading_time: 8
---

# KeyHelp: Als Admin in den Kundenbereich wechseln und Anmelde-URLs für den Support nutzen

Viele Support-Anfragen lassen sich nur klären, wenn Sie sehen, was der Kunde sieht: eine Domain, die im Kundenbereich anders aussieht als erwartet, ein Postfach, das angeblich fehlt, eine Einstellung, die der Kunde nicht findet. Das Passwort des Kunden brauchen Sie dafür nicht. KeyHelp bietet zwei Wege in ein Kundenkonto: den Wechsel aus der Kundenliste im Administratorbereich und eine Anmelde-URL, die der Befehl `keyhelp login` auf der Konsole erzeugt. Diese Anleitung zeigt beide Wege, wie sie protokolliert werden, wie lange eine Anmelde-URL gilt und welche Sicherheitsfolgen Sie kennen sollten. Sie richtet sich an Administratoren, die Kunden auf einem eigenen KeyHelp-Server betreuen. Als Beispiel dient KeyHelp 26.1.1 unter Debian 12. Die Grundinstallation beschreibt die Anleitung [KeyHelp installieren und absichern](https://s-edv.com/anleitungen/keyhelp-installieren-absichern-eigener-server).

**Kurzfassung:** In „Benutzerverwaltung“ › „Kundenkonten“ wechselt das Symbol „Als dieser Benutzer anmelden“ ohne Passwort in den Kundenbereich, zurück geht es über „Zurück zum Administrator“. Auf der Konsole erzeugt `keyhelp login kunde1` eine Anmelde-URL, die 60 Minuten gilt und in diesem Zeitraum mehrfach funktioniert. Beide Wege umgehen die Zwei-Faktor-Authentifizierung des Kunden. Im Ereignis-Protokoll des Kunden erscheinen Änderungen, die Sie als Administrator vornehmen, unter seinem Benutzernamen. Behandeln Sie Anmelde-URLs deshalb wie Passwörter.

## Voraussetzungen

- [ ] KeyHelp 26.1.1 auf Debian 12, eingerichtet nach [KeyHelp installieren und absichern](https://s-edv.com/anleitungen/keyhelp-installieren-absichern-eigener-server).
- [ ] Ein Kundenkonto, im Beispiel `kunde1` (Max Mustermann) mit Domain `kunde1.example.de` und Postfach `info@kunde1.example.de`. Wie Sie Kunden anlegen, zeigt [KeyHelp: Kunden anlegen und Kontingente festlegen](https://s-edv.com/anleitungen/keyhelp-kunden-anlegen-kontingente-speicher-traffic-domains).
- [ ] Ein Administratorkonto im Panel. Für den Weg über die Konsole zusätzlich SSH-Zugang als root.

## Schritt 1: Aus der Kundenliste in den Kundenbereich wechseln

Öffnen Sie „Benutzerverwaltung“ › „Kundenkonten“. In der Spalte „Aktionen“ stehen drei Symbole: der Stift („Bearbeiten“), ein Anmeldesymbol („Als dieser Benutzer anmelden“) und der rote Mülleimer („Löschen“). Auch ein Klick auf den Benutzernamen selbst führt zum Wechsel, beide Links zeigen auf dieselbe Adresse.

![KeyHelp-Kundenliste mit kunde1 und eingeblendetem Hinweis Als dieser Benutzer anmelden über dem Anmeldesymbol](https://s-edv.com/uploads/2026/10/10d8161ef699299801597886093aaeef15bc22107c8be81e83d9f330aeffe10b-1024.png)
*Das mittlere Symbol in der Spalte „Aktionen“ öffnet den Kundenbereich ohne Passwort*

Nach dem Klick lädt KeyHelp im selben Tab das Dashboard des Kunden. Die Kopfzeile zeigt links „Kundenbereich“, rechts den Namen und Benutzernamen des Kunden und davor den Link „Zurück zum Administrator“. Sie sehen nun genau die Menüs, die der Kunde sieht, also nur die Bereiche, die seine Berechtigungen freigeben. Zum Beispiel fehlt der „DNS-Editor“, wenn dieses Recht für `kunde1` nicht aktiv ist. Wie Sie Rechte gezielt vergeben, beschreibt [KeyHelp: Berechtigungen für Kunden gezielt freigeben](https://s-edv.com/anleitungen/keyhelp-berechtigungen-kunden-dns-editor-ssh-datenbank-fernzugriff).

![KeyHelp-Kundenbereich von kunde1 mit dem Link Zurück zum Administrator in der Kopfzeile](https://s-edv.com/uploads/2026/10/2895353c2135e860b9e553e6dd1e50b77ed8ffb3ccbdac251563c6a946f1ffc2-1024.png)
*Nach dem Wechsel: Kundenbereich mit dem Rückweg „Zurück zum Administrator“*

> **Prüfen:** Die Adresse im Browser endet auf `index.php?page=client_dashboard`, und in der Kopfzeile steht „Kundenbereich“. Im Ereignis-Protokoll des Administrators erscheint der Eintrag „Admin keyadmin logged in as client kunde1.“

## Schritt 2: Sauber zurückwechseln

Klicken Sie nach der Prüfung auf „Zurück zum Administrator“. KeyHelp bringt Sie ohne neue Anmeldung in die Kundenliste zurück. Verwenden Sie nicht „Abmelden“ im Kundenbereich. Das beendet die gesamte Sitzung mit der Meldung „Sie haben sich erfolgreich abgemeldet.“, auch die des Administrators. Sie müssen sich danach neu anmelden.

Die Knowledge Base von Keyweb beschreibt das Symbol noch so, dass es eine Sitzung des Kunden „in einem neuen Browserfenster / Tab“ öffnet. In KeyHelp 26.1.1 ist das nicht mehr so: Der Wechsel ersetzt die Administratoransicht im aktuellen Tab. Parallel in Admin- und Kundenbereich arbeiten können Sie in einem Browser also nicht.

> **Prüfen:** Nach „Zurück zum Administrator“ endet die Adresse auf `page=admin_accounts_client`, und die Kopfzeile zeigt wieder „Administrations-Bereich“.

## Schritt 3: Anmelde-URL auf der Konsole erzeugen

Seit Version 22.1 enthält KeyHelp das Kommandozeilenwerkzeug `keyhelp`. Der Unterbefehl `login` erzeugt laut Keyweb eine URL, mit der Sie sich „ohne vorherige Eingabe eines Passworts oder Benutzernames“ in ein Konto Ihrer Wahl einloggen. Ohne Benutzernamen gilt die URL für den ersten Hauptadministrator. Das ist der Notfallweg, wenn Sie Ihr Admin-Passwort nicht mehr haben oder die Panel-Anmeldung klemmt.

```bash
keyhelp login kunde1
```

Die Ausgabe enthält zwei Zeilen, eine mit dem Hostnamen und eine mit der IP-Adresse des Servers, jeweils nach dem Muster `https://server.example.de/index.php?sso_request=…&sso_token=…`. Öffnen Sie eine der beiden Adressen im Browser, idealerweise in einem privaten Fenster, damit Ihre Admin-Sitzung bestehen bleibt. Ein unbekannter Benutzername endet mit „User not found.“

Technisch legt KeyHelp für jede URL einen Eintrag in der Tabelle `users_single_sign_on` an. Gespeichert werden der Benutzer, eine Anfrage-ID, ein bcrypt-Hash des Tokens und der Zeitpunkt. Das Token selbst liegt nicht im Klartext in der Datenbank.

```bash
$ mysql keyhelp -e "SELECT id, id_user, created_at FROM users_single_sign_on ORDER BY id DESC LIMIT 3"
$ mysql keyhelp -e "SELECT date, message FROM event_logs ORDER BY id DESC LIMIT 3"
```

Im Protokoll stehen „SSO login token generated for user kunde1.“ mit dem Kanal „KeyHelp CLI“ und danach „User kunde1 logged in via Single-Sign-On.“

> **Prüfen:** Nach dem Aufruf landet der Browser im Dashboard des Kunden. Die Prüfung auf der Konsole:

## Schritt 4: Gültigkeit der Anmelde-URL kennen

Wie lange eine solche URL funktioniert, steht nicht in der Konsolenhilfe, wohl aber in der API-Beschreibung, die KeyHelp unter `/home/keyhelp/www/keyhelp/api/openapi.json` mitliefert: „The generated URL has a validity period of 60 minutes.“ Eine URL funktioniert nach 55 Minuten noch, nach 61 Minuten kommt „Die Anmelde-URL ist ungültig oder ist abgelaufen.“

Wichtiger für die Praxis: Innerhalb dieser 60 Minuten ist die URL kein echter Einmal-Login. So lässt sich dieselbe URL mehrfach hintereinander einlösen, jedes Mal mit einer neuen Sitzung, und mehrere parallel erzeugte URLs gelten gleichzeitig. Der Datenbankeintrag bleibt nach dem Einlösen bestehen. Wer eine solche URL per Chat oder Ticket weitergibt, gibt also für bis zu eine Stunde einen vollständigen Zugang zum Konto weiter.

> **Prüfen:** Rufen Sie eine erzeugte URL zweimal in zwei privaten Fenstern auf. Kommen Sie beide Male ins Dashboard, verhält sich Ihr Server wie hier beschrieben. Nach Ablauf der Stunde muss die Meldung „Die Anmelde-URL ist ungültig oder ist abgelaufen.“ erscheinen.

## Schritt 5: Protokolle lesen und Spuren richtig deuten

Beide Wege hinterlassen Einträge unter „Systemstatus“ › „Ereignis-Protokolle“. Suchen Sie dort nach „logged in“. Der Wechsel aus der Kundenliste erscheint als „Admin keyadmin logged in as client kunde1.“ mit dem Administrator als Benutzer, die Konsolen-URL als „User kunde1 logged in via Single-Sign-On.“

![KeyHelp-Ereignis-Protokolle des Administrators mit Einträgen Admin keyadmin logged in as client kunde1 und User kunde1 logged in via Single-Sign-On](https://s-edv.com/uploads/2026/10/90233e42ad049d9a9289c6822109cfc14c5a2198d9f454397ebbe39213f562b1-1024.png)
*Im Admin-Protokoll ist erkennbar, wer wann in welches Kundenkonto gewechselt ist*

Im Protokoll des Kunden sieht das anders aus. Der Kunde findet seine Einträge im Kundenbereich unter „Protokolle“ › „Ereignis-Protokolle“. Den Wechsel des Administrators zeigt diese Liste nicht. Speichert der Administrator im Kundenbereich etwas, etwa eine Domain, steht dort „Domain kunde1.example.de (#2) updated.“ mit dem Benutzer `kunde1`. Für den Kunden sieht es so aus, als hätte er die Änderung selbst gemacht.

![KeyHelp-Ereignis-Protokolle im Kundenbereich mit der Änderung einer Domain unter dem Benutzer kunde1](https://s-edv.com/uploads/2026/10/8be4f4200dd0924017ee655995355b76b25f32051593e35ed25472bef7e8438f-1024.png)
*Kundenansicht: Die Änderung des Administrators erscheint unter dem Benutzernamen des Kunden*

Dokumentieren Sie Änderungen im Kundenbereich deshalb zusätzlich im Ticket, mit Uhrzeit. Bei Rückfragen gleichen Sie den Zeitpunkt mit dem Eintrag „Admin keyadmin logged in as client kunde1.“ im Admin-Protokoll ab.

> **Prüfen:** Nach einem Wechsel mit einer Teständerung muss das Admin-Protokoll den Wechsel zeigen und das Kundenprotokoll die Änderung unter dem Kundennamen.

## Typische Fehler

### „Die Anmelde-URL ist ungültig oder ist abgelaufen.“

Diese Meldung erscheint zum Beispiel in drei Fällen: wenn die 60 Minuten vorbei waren, wenn das Token in der URL nicht stimmte, etwa durch einen abgeschnittenen Link aus einem Mailprogramm, und wenn beim Kunden die Berechtigung „Control Panel-Zugriff“ abgeschaltet war. Im letzten Fall hilft keine neue URL. Prüfen Sie zuerst im Reiter „Berechtigungen“ des Kunden, ob „Control Panel-Zugriff“ aktiv ist.

### Kunde ohne Panelzugang lässt sich trotzdem öffnen

Der Wechsel aus der Kundenliste funktioniert auch bei abgeschaltetem „Control Panel-Zugriff“. Der Kunde selbst bekommt beim Anmelden mit Passwort nur „Die Kombination aus Benutzernamen und Passwort ist falsch.“, obwohl das Passwort stimmte. Für den Support ist der Wechsel damit der einzige Weg in solche Konten. Rechnen Sie aber damit, dass Kunden ohne Panelzugang eine irreführende Fehlermeldung sehen.

### Nach dem Abmelden ist auch die Admin-Sitzung weg

Wer im Kundenbereich auf „Abmelden“ klickt, beendet die gemeinsame Sitzung. Nutzen Sie immer „Zurück zum Administrator“.

### „Ihr Konto wurde gesperrt.“

Bei einem gesperrten Kundenkonto endet auch die Konsolen-URL mit dieser Meldung. Sperren und Entsperren erklärt [KeyHelp: Kundenkonten zeitgesteuert sperren und löschen](https://s-edv.com/anleitungen/keyhelp-kundenkonto-zeitgesteuert-sperren-loeschen-vertragsende).

## Häufige Fragen

### Merkt der Kunde, dass ich in seinem Konto war?

Nur eingeschränkt. Hat der Kunde in seinem Profil „Anmeldebenachrichtigung senden“ aktiviert, bekommt er bei der Konsolen-URL eine E-Mail „Login-Benachrichtigung für Konto kunde1“ mit Datum, IP-Adresse und User-Agent. Beim Wechsel aus der Kundenliste kommt keine solche Mail, und auch die Spalte „Letzter Login“ in der Kundenliste ändert sich nicht.

### Hilft die Zwei-Faktor-Authentifizierung des Kunden gegen diese Zugänge?

Nein. Mit aktivierter Zwei-Faktor-Authentifizierung verlangt die normale Anmeldung den „Authentifizierungscode“. Sowohl der Wechsel aus der Kundenliste als auch die Konsolen-URL führen aber direkt ins Dashboard. Der Schutz dieser Wege hängt damit allein an Ihrem Admin-Konto und am root-Zugang des Servers.

### Kann ich Anmelde-URLs auch automatisiert erzeugen?

Die REST-API beschreibt dafür die Endpunkte `/login/{id}` und `/login/name/{name}` mit einem optionalen Parameter `page` für die Zielseite. Wie Sie die API einrichten, zeigt [KeyHelp-REST-API nutzen](https://s-edv.com/anleitungen/keyhelp-rest-api-kunden-domains-postfaecher-automatisieren).

## Fazit

Für den Support ist der Wechsel aus der Kundenliste der richtige Weg: ein Klick, kein Passwort, ein klarer Eintrag im Admin-Protokoll. Die Konsolen-URL ist das Werkzeug für Notfälle und für Fälle, in denen Sie gerade keine Admin-Sitzung haben. Beide Wege sind mächtig, weil sie Passwort und Zwei-Faktor-Code des Kunden übergehen. Schützen Sie deshalb Ihr Admin-Konto besonders gut, dokumentieren Sie Änderungen im Kundenkonto selbst und behandeln Sie jede erzeugte URL eine Stunde lang wie ein Passwort.

## Weiterführende Anleitungen und Quellen

- [KeyHelp installieren und absichern](https://s-edv.com/anleitungen/keyhelp-installieren-absichern-eigener-server)
- [KeyHelp: Berechtigungen für Kunden gezielt freigeben](https://s-edv.com/anleitungen/keyhelp-berechtigungen-kunden-dns-editor-ssh-datenbank-fernzugriff)
- [KeyHelp-REST-API nutzen: Kunden, Domains und Postfächer per Skript anlegen](https://s-edv.com/anleitungen/keyhelp-rest-api-kunden-domains-postfaecher-automatisieren)
- [Keyweb: KeyHelp 22.1, Erweiterung der Kommandozeilenfunktionalität](https://www.keyweb.de/de/keyhelp/entwicklung/keyhelp-neuigkeiten/keyhelp-22-1)
- [KeyHelp Knowledge Base: Benutzer-Account Übersicht](https://kb.keyhelp.de/doc-127.html)
