---
title: "KeyHelp: Verzeichnisschutz mit Passwort für Staging-Seiten und Admin-Bereiche einrichten"
date: 2026-10-01T21:23:57+02:00
modified: 2026-11-09T13:06:38+01:00
category: linux
type: how_to
author: Marcel Schönfelder
canonical: https://s-edv.com/anleitungen/keyhelp-verzeichnisschutz-passwort-staging-admin-bereich
keywords:
  - KeyHelp
  - Apache
  - Verzeichnisschutz
  - Basic Auth
  - Sicherheit
  - Webhosting
reading_time: 8
---

# KeyHelp: Verzeichnisschutz mit Passwort für Staging-Seiten und Admin-Bereiche einrichten

Eine neue Website liegt schon auf dem Server, soll aber noch nicht öffentlich sein. Oder ein Kunde hat ein selbst gebautes Admin-Tool im Webspace, das niemand außer ihm aufrufen darf. Für solche Fälle bietet KeyHelp im Kundenbereich den „Verzeichnisschutz“: Ein Ordner unterhalb von `/www` fragt dann im Browser nach Benutzername und Passwort. Diese Anleitung zeigt, wie Sie den Schutz anlegen, mehrere Benutzer zulassen und Ausnahmen setzen, welche Apache-Konfiguration KeyHelp dafür schreibt und wo die Grenzen liegen. Die Prüfung mit `curl` zeigt eine Schwachstelle bei den Ausnahmen in der beschriebenen Konfiguration. Grundlage ist ein KeyHelp-Server wie in [KeyHelp installieren und absichern](https://s-edv.com/anleitungen/keyhelp-installieren-absichern-eigener-server).

**Kurzfassung:** Den Schutz legen Sie im Kundenbereich unter „Sicherheit“, „Verzeichnisschutz“ mit „Verzeichnisschutz hinzufügen“ an. KeyHelp schreibt dafür keine `.htaccess` in den Ordner, sondern einen `<Directory>`-Block mit `AuthType Basic` in die Apache-Konfiguration des Kunden und eine Passwortdatei unter `/etc/apache2/keyhelp/htpasswd/`. Im Test lieferte der Ordner danach auf allen Domains des Kunden 401 ohne und 200 mit Passwort. Weitere Benutzer für denselben Ordner sind eigene Einträge. Vorsicht bei „Ausnahmen definieren“: In KeyHelp 26.1.1 ließ sich der Schutz eines Ordners mit Ausnahme im Test über einen angehängten Query-String umgehen.

## Voraussetzungen

- [ ] **KeyHelp-Server**, getestet mit KeyHelp 26.1.1 (Build 3698) auf Debian 12.15.
- [ ] **Kundenzugang** mit Webspace, im Beispiel der Kunde `kunde1` mit der Domain `kunde1.example.de`.
- [ ] **Ein Ordner unter `/www`**, im Beispiel `/www/staging/` für eine Testseite und `/www/admin/` für ein internes Werkzeug.
- [ ] **SSH-Zugang als root**, wenn Sie die erzeugte Konfiguration wie hier nachprüfen wollen. Für die Einrichtung selbst ist er nicht nötig.

## Schritt 1: Verzeichnisschutz anlegen

Im Kundenbereich finden Sie unter „Sicherheit“ den Menüpunkt „Verzeichnisschutz“. Die Seite erklärt den Zweck selbst: „Verwenden Sie diese für administrative Bereiche oder Seiten, auf die die Öffentlichkeit keinen Zugriff haben soll.“ Mit „Verzeichnisschutz hinzufügen“ öffnet sich das Formular.

- **„Verzeichnis“:** Der Pfad steht relativ zu `/www`. Sie tippen ihn ein oder wählen ihn mit „Durchsuchen...“. Die [KeyHelp-Dokumentation](https://kb.keyhelp.de/article/verzeichnisschutz-anlegen-21.html) nennt diesen Button noch „Verzeichnisexplorer öffnen“, in Version 26.1.1 heißt er „Durchsuchen...“. Laut Hinweis gilt: „Wenn das angegebene Verzeichnis nicht existiert, wird es automatisch erstellt.“ Das hat im Test funktioniert, der Ordner `/www/admin/` entstand beim Speichern.
- **„Titel des geschützten Bereichs“:** optional. Apache sendet den Text als Realm im Header `WWW-Authenticate` mit, laut KeyHelp-Dokumentation wird er im Loginfenster des Browsers angezeigt.
- **„Benutzername“ und „Passwort“:** Pflichtfelder. „Generieren“ erzeugt einen Passwortvorschlag.

Wir haben für `/staging` den Benutzer `vorschau` mit dem Titel „Staging kunde1“ angelegt. Die Bestätigung lautete: „Der Verzeichnisschutz für das Verzeichnis /www/staging/ wurde erfolgreich angelegt und steht in wenigen Augenblicken zur Verfügung.“ Der Schutz greift nicht sofort. 20 Sekunden nach dem Speichern war im Test noch keine Passwortdatei vorhanden, beim nächsten Blick gut eine Minute nach dem Speichern schon.

```bash
$ curl -s -D - -o /dev/null --resolve kunde1.example.de:80:127.0.0.1 http://kunde1.example.de/staging/ | grep -i "^HTTP\|WWW-Authenticate"
```

```powershell
HTTP/1.1 401 Unauthorized
WWW-Authenticate: Basic realm="Staging kunde1"
```

> Prüfen Sie mit `curl`, ob der Ordner ohne Anmeldung gesperrt ist. Auf einem Server mit öffentlichem DNS lassen Sie `--resolve` weg.

## Schritt 2: Was KeyHelp technisch einrichtet

Laut [KeyHelp-Dokumentation](https://kb.keyhelp.de/article/verzeichnisschutz-anlegen-21.html) erfolgt die Steuerung über die Konfigurationsdatei der Domain im Webserver, im Verzeichnis wird „keine .htaccess bzw. .htpasswd“ angelegt. Im Test lag im Ordner `staging` tatsächlich nur die eigene `index.html`. Stattdessen hängt KeyHelp an die Apache-Konfiguration des Kunden in `/etc/apache2/keyhelp/vhosts/kunde1.conf` einen Abschnitt an:

Datei: `/etc/apache2/keyhelp/vhosts/kunde1.conf`

```plaintext
# Directory protection
<Directory "/home/users/kunde1/www/staging/">
    AuthType Basic
    AuthName "Staging kunde1"
    AuthUserFile "/etc/apache2/keyhelp/htpasswd/.htpasswd_kunde1_9d5476f7
    <RequireAny>
        Require valid-user
    </RequireAny>
</Directory>
```

Der Block steht nicht in einem einzelnen VirtualHost, sondern gilt für das Verzeichnis. Deshalb wirkt er auf alle Domains, die auf diesen Webspace zeigen. Im Test galt der Schutz gleichermaßen für `kunde1.example.de`, `www.kunde1.example.de` und die System-Domain `kunde1.server.example.de`. Die Passwortdatei liegt außerhalb des Webspace `/home/users/kunde1/www/`, gehört `www-data` und ist nur für diesen lesbar (die Namen der Passwortdateien sind in dieser Anleitung gekürzt):

Ausgabe:

```plaintext
-rwx------ 1 www-data www-data   70 Oct  1 18:21 .htpasswd_kunde1_9d5476f7
```

Das Passwort steht darin als bcrypt-Hash, erkennbar am Präfix `$2y$` (laut [Apache-Dokumentation](https://httpd.apache.org/docs/2.4/misc/password_encryptions.html)):

```plaintext
vorschau
$2y$10$
```

```plaintext
== kunde1.example.de
ohne Login: 401
falsches Passwort: 401
richtiges Passwort: 200
== www.kunde1.example.de
ohne Login: 401
falsches Passwort: 401
richtiges Passwort: 200
== kunde1.server.example.de
ohne Login: 401
falsches Passwort: 401
richtiges Passwort: 200
Startseite ohne Login: 200
```

Fehlversuche protokolliert Apache im Fehlerprotokoll der Domain, im Test `/home/users/kunde1/logs/kunde1.example.de/error.log`:

```plaintext
[Thu Oct 01 18:21:57.624077 2026] [auth_basic:error] [pid 1582:tid 1636] [client 127.0.0.1:54600] AH01617: user vorschau: authentication failure for "/staging/": Password Mismatch
```

> **Prüfen:** Rufen Sie den Ordner einmal mit falschem und einmal mit richtigem Passwort ab. Das Passwort übergeben Sie mit `-u benutzer:passwort`. Unser Testlauf über alle drei Domains.

## Schritt 3: Mehrere Benutzer für einen Ordner

Pro Eintrag gibt es genau einen Benutzernamen. Für einen zweiten Zugang, etwa für eine Agentur, legen Sie einen weiteren Verzeichnisschutz für denselben Ordner an. Das beschreibt auch die Keyweb-Dokumentation so. Im Test haben wir für `/staging` zusätzlich den Benutzer `redaktion` angelegt. KeyHelp schrieb ihn in dieselbe Passwortdatei, der `<Directory>`-Block blieb einer. Für `/admin` entstand eine eigene Datei:

```plaintext
== /etc/apache2/keyhelp/htpasswd/.htpasswd_kunde1_01266630
vorschau
== /etc/apache2/keyhelp/htpasswd/.htpasswd_kunde1_9d5476f7
vorschau
redaktion
```

Die Liste zeigt jede Kombination aus Benutzer und Ordner als eigene Zeile. In der Spalte „S“ zeigen alle Einträge ein grünes Symbol, das graue Warndreieck neben `/www/admin/` bedeutet laut Tooltip: „Für dieses Verzeichnis sind Ausnahmen definiert worden.“

![KeyHelp-Kundenbereich Verzeichnisschutz mit drei Einträgen: vorschau für /www/admin/ mit Warndreieck für Ausnahmen, redaktion und vorschau für /www/staging/](https://s-edv.com/uploads/2026/10/fce8967e7db16b6cecd310de869d59b37ff9608ed5e6597e7d1e795179818e08-1024.png)
*Jeder Benutzer eines geschützten Ordners ist ein eigener Eintrag*

Einen einzelnen Zugang entziehen Sie, indem Sie seinen Eintrag mit dem Papierkorb löschen. KeyHelp verlangt dabei die Checkbox „Bestätigung“ und meldete danach „Die folgenden Elemente wurden gelöscht.“ Der Benutzer verschwand aus der Passwortdatei, die anderen blieben:

```plaintext
/staging/ als redaktion nach Löschen: 401
/staging/ als vorschau: 200
```

> **Prüfen:** Nach dem Anlegen oder Löschen meldet sich jeder Benutzer einmal an. Ein gelöschter Benutzer erscheint im Fehlerprotokoll als `user redaktion not found`.

## Schritt 4: Passwort ändern und Ausnahmen setzen

Das Stiftsymbol öffnet den Eintrag zum Bearbeiten. Die Passwortfelder sind dort keine Pflichtfelder mehr: „Lassen Sie das Feld leer, um das aktuelle Passwort beizubehalten.“ Unter „Ausnahmen definieren“ können Sie URL-Pfade freigeben, die trotz Schutz erreichbar bleiben sollen, etwa eine Schnittstelle, die ein externer Dienst ohne Passwort aufruft. KeyHelp erklärt dazu: „Geben Sie die Pfade so ein, wie sie in der Domain-URL erscheinen.“

![KeyHelp-Formular Verzeichnisschutz bearbeiten mit Verzeichnis /www/admin/, aufgeklappten Ausnahmen mit /admin/api/, Titel Adminbereich, Benutzer vorschau und leeren Passwortfeldern](https://s-edv.com/uploads/2026/10/da85050608ad7e9c61be206c01b1e27a57d887ae396a0c67fcb9ef11443c4c1d-1024.png)
*Ausnahmen geben URL-Pfade innerhalb des geschützten Ordners frei*

Für `/admin` mit der Ausnahme `/admin/api/` schrieb KeyHelp diesen Block:

```plaintext
<Directory "/home/users/kunde1/www/admin/">
    AuthType Basic
    AuthName "Adminbereich"
    AuthUserFile "/etc/apache2/keyhelp/htpasswd/.htpasswd_kunde1_01266630
    <RequireAny>
        Require expr %{REQUEST_URI} =~ m#/admin/api/.*?#
        Require expr %{THE_REQUEST} =~ m#/admin/api/.*?#
        Require valid-user
    </RequireAny>
</Directory>
```

Die Ausnahme selbst funktioniert:

```plaintext
/admin/ ohne Login: 401
/admin/api/ ohne Login: 200
```

Die beiden regulären Ausdrücke sind aber nicht am Anfang verankert. `REQUEST_URI` ist laut [Apache-Dokumentation](https://httpd.apache.org/docs/2.4/expr.html) der Pfad ohne Query-String, `THE_REQUEST` dagegen die komplette Anfragezeile (etwa „GET /index.html HTTP/1.1“), zu der auch ein angehängter Query-String gehört. Wir haben deshalb eine Datei `/admin/intern.html` ohne Passwort abgerufen und den Ausnahmepfad nur als Parameter angehängt:

```plaintext
/admin/intern.html: 401
/admin/intern.html?x=/admin/api/: 200
/admin/intern.html#/admin/api/: 401
geheim
```

Mit dem angehängten `?x=/admin/api/` lieferte Apache den Inhalt der eigentlich geschützten Datei aus. Nach unserer Analyse greift hier die unverankerte `THE_REQUEST`-Regel. In KeyHelp 26.1.1 schützt der Verzeichnisschutz einen Ordner mit eingetragener Ausnahme also nicht zuverlässig. Unsere Empfehlung: Keine Ausnahmen für Ordner mit sensiblen Inhalten. Ohne Ausnahme schrieb KeyHelp im Test nur `Require valid-user` in den Block (siehe `/staging` oben). Legen Sie öffentlich nötige Pfade wie eine API stattdessen in einen eigenen Ordner außerhalb des geschützten Bereichs.

> **Prüfen:** Rufen Sie nach dem Setzen einer Ausnahme eine geschützte Datei mit dem Ausnahmepfad als Query-String auf, wie oben gezeigt. Erwartet ist 401. Bekommen Sie 200, ist der Ordner offen.

## Typische Fehler

**„Die geforderte Passwort-Komplexität wurde nicht erfüllt.“** Das Passwort muss laut Meldung mindestens 12 Zeichen lang sein und Klein- und Großbuchstaben sowie eine Ziffer enthalten. Die Meldung kam im Test auch bei leerem Passwort. Der Button „Generieren“ erzeugt einen passenden Vorschlag.

![KeyHelp-Fehlermeldung Die geforderte Passwort-Komplexität wurde nicht erfüllt mit den Regeln mindestens 12 Zeichen, Kleinbuchstabe, Großbuchstabe und Ziffer über dem Formular Verzeichnisschutz](https://s-edv.com/uploads/2026/10/680ed713c5ed80d7b88a6501472a3b1c2c2e810b1655864c6acf59beeaaccadf-1024.png)
*KeyHelp prüft die Passwortregeln erst beim Speichern*

**„Das von Ihnen eingegebene Passwort stimmt nicht mit der Passwortbestätigung überein.“** Beide Passwortfelder müssen gleich sein. Kopieren Sie einen generierten Vorschlag in beide Felder.

**„Die Kombination aus Benutzernamen und Pfad existiert bereits.“** Für denselben Ordner gibt es den Benutzer schon. Ändern Sie dessen Passwort über das Stiftsymbol, statt einen neuen Eintrag anzulegen.

**Ordner bleibt direkt nach dem Speichern offen.** Der Hintergrunddienst braucht einen Moment. Warten Sie die Meldung „steht in wenigen Augenblicken zur Verfügung“ ab und prüfen Sie nach gut einer Minute erneut.

**Pfad mit `..` eingegeben.** Den Pfad `/../etc` hat KeyHelp im Test als `/www/./etc/` gespeichert und den Ordner `etc` innerhalb von `/www` angelegt. Außerhalb von `/www` entstand im Test kein Ordner, ein Tippfehler erzeugt aber einen neuen Ordner.

## Häufige Fragen

### Kann ich zusätzlich eine eigene .htaccess verwenden?

Ja. Die Kundenkonfiguration erlaubt mit `AllowOverride AuthConfig` eigene Regeln. Im Test führte eine `.htaccess` mit `Require all denied` im geschützten Ordner zu 403 statt 401.

### Werden Fehlversuche gesperrt?

Im Test nicht. Wir haben sieben falsche Passwörter gesendet und nur weiter 401 erhalten, die Fail2Ban-Liste enthielt keine Regel für Apache-Anmeldungen:

```plaintext
401 401 401 401 401 401 401
`- Jail list:	kh-database, kh-dovecot, kh-ftp, kh-phpmyadmin, kh-postfix, kh-postfix-sasl, kh-roundcube, kh-snappymail, sshd
```

Ein langes, generiertes Passwort ist deshalb wichtig.

### Ist das Passwort ohne SSL geschützt?

`AuthType Basic` überträgt das Passwort laut [Apache-Dokumentation](https://httpd.apache.org/docs/2.4/howto/auth.html) unverschlüsselt vom Client zum Server, sofern die Verbindung nicht per SSL verschlüsselt ist. Unsere Testdomain hatte kein Zertifikat, HTTPS leitete per 302 auf HTTP um. Richten Sie vorher ein Zertifikat ein, siehe [SSL-Zertifikate in KeyHelp](https://s-edv.com/anleitungen/keyhelp-ssl-zertifikate-lets-encrypt-eigene-ueberwachen).

### Hält der Schutz Suchmaschinen fern?

Ein Crawler bekommt wie jeder Besucher ohne Passwort den Status 401 und damit keinen Inhalt zu sehen. Eine Zugriffssperre ist keine Zusage, dass Suchmaschinen die URL aus ihrem Index entfernen.

## Fazit

Der Verzeichnisschutz von KeyHelp ist für Staging-Seiten und interne Ordner schnell eingerichtet und technisch sauber umgesetzt: Die Regeln stehen in der Apache-Konfiguration, die Passwörter als bcrypt-Hash außerhalb des Webspace, und der Schutz greift für alle Domains des Kunden. Mehrere Zugänge sind eigene Einträge und lassen sich einzeln entziehen. Die Ausnahmefunktion sollten Sie dagegen meiden, solange sie per Query-String umgangen werden kann. Kombinieren Sie den Schutz immer mit einem SSL-Zertifikat und langen, generierten Passwörtern.

## Weiterführende Anleitungen und Quellen

- [KeyHelp installieren und absichern](https://s-edv.com/anleitungen/keyhelp-installieren-absichern-eigener-server)
- [KeyHelp: SSL-Zertifikate mit Let's Encrypt einrichten und überwachen](https://s-edv.com/anleitungen/keyhelp-ssl-zertifikate-lets-encrypt-eigene-ueberwachen)
- [KeyHelp: Zusätzliche Apache-Anweisungen für Header, Rewrite und Caching](https://s-edv.com/anleitungen/keyhelp-zusaetzliche-apache-anweisungen-header-rewrite-caching)
- [KeyHelp Knowledge Base: Verzeichnisschutz anlegen](https://kb.keyhelp.de/article/verzeichnisschutz-anlegen-21.html)
- [Keyweb: KeyHelp, alle Funktionen im Überblick](https://www.keyweb.de/de/keyhelp/keyhelp/alle-funktionen-im-ueberblick)
- [Apache-Dokumentation: mod_auth_basic](https://httpd.apache.org/docs/2.4/mod/mod_auth_basic.html)
- [Linux-Server mit UFW und Fail2ban absichern](https://s-edv.com/anleitungen/linux-server-absichern-ufw-fail2ban)
