> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Server-Konfiguration ws_access.conf

> Die Apache-Zugriffskonfiguration des Shops: wo sie liegt, was typischerweise darin steht, welcher Bereich von einem Dienst verwaltet wird und worauf Sie beim Bearbeiten achten müssen.

Die Datei `ws_access.conf` ist die Zugriffskonfiguration des Webservers für Ihren Shop. Sie entspricht in ihren Möglichkeiten und in ihrer Syntax der verzeichnisbezogenen Konfigurationsdatei des Apache-Webservers, die dort üblicherweise `.htaccess` heißt.

> [!WARNING]
>
> Bearbeiten Sie diese Datei nur, wenn Sie über gute Apache-Kenntnisse verfügen.
>
> Falsche Einstellungen und Parameter können den Shop vollständig außer Funktion setzen.

Wegweiser: [404-Fehlerseite, Ladezeit und Verschlüsselung](https://dokumentation.websale.de/v8s/informationsseiten/404-fehlerseite.md)

## Wo die Datei liegt

Die Datei liegt im Wurzelverzeichnis des Shops. Ist ein Subshop vorhanden, liegt sie zusätzlich in dessen Unterverzeichnis, und die dortige Datei gilt für diesen Subshop.

Erreichbar ist sie ausschließlich per SFTP. Über den Online-Servicebereich lässt sie sich weder einsehen noch bearbeiten.

## Was typischerweise darin steht

Alles, was eine Apache-Zugriffskonfiguration kann, ist auch hier möglich. In der Praxis kommen drei Dinge am häufigsten vor:

| Einsatz | Anweisung |
| - | - |
| Eigenes Dokument für den Fehler 404 zuweisen | `ErrorDocument 404` |
| Browser-Caching je Dateityp steuern | `Expires` |
| Adressen umschreiben, etwa für SEO-URLs und Direktlinks | `RewriteRule` |

Die Datei beginnt mit `RewriteEngine on`, sobald sie Umschreibungsregeln enthält.

Wegweiser: [404-Fehlerseite](https://dokumentation.websale.de/v8s/informationsseiten/404-fehlerseite.md) erklärt die Zuweisung des Fehlerdokuments · [Ladezeit und Verschlüsselung](https://dokumentation.websale.de/v8s/seo/ladezeit-und-verschluesselung.md) erklärt die Caching-Einträge

## Der verwaltete Bereich für Direktlinks

Ein Teil der Datei gehört nicht Ihnen. Der Dienst für Direktlinks im Online-Servicebereich schreibt seine Umschreibungsregeln selbst in diese Datei, und zwar in einen eigenen Bereich, der durch zwei Kommentarzeilen begrenzt ist. Diese Marken tragen jeweils die Kennung des Subshops.

> [!WARNING]
>
> Lassen Sie diesen Bereich unangetastet. Der Dienst überschreibt ihn bei jeder Änderung vollständig, Ihre Eingriffe darin gehen also verloren.
>
> Umgekehrt gilt: Alles außerhalb der beiden Marken bleibt erhalten. Ihre eigenen Anweisungen sind dort sicher aufgehoben.

> [!NOTE]
>
> Fehlt eine der beiden Marken, hängt der Dienst den gesamten Bereich neu an das Dateiende an. Löschen Sie die Kommentarzeilen also nicht, auch wenn sie überflüssig aussehen.
>
> Wo der Dienst die Datei erwartet, steht in der Shopkonfiguration. Findet er sie dort nicht, meldet er einen Fehler und lässt sich nicht aufrufen. Wenden Sie sich in diesem Fall an die WEBSALE AG.

Wegweiser: [Link-Shortener](https://dokumentation.websale.de/v8s/funktionen-zur-shop-optimierung/link-shortener.md)

## Beim Bearbeiten beachten

> [!WARNING]
>
> Verwenden Sie einen Editor, der Unix-Zeilenumbrüche erzeugt, also reine LineFeed-Zeichen.
>
> Speichert Ihr Editor Windows-Zeilenumbrüche, sind Shops ohne SEO-URLs anschließend nicht mehr aufrufbar.

Legen Sie vor jeder Änderung eine Kopie der Datei an. Da ein Fehler den gesamten Shop unerreichbar machen kann, ist das Zurückspielen der alten Fassung der schnellste Weg zurück.

Prüfen Sie nach jeder Änderung nicht nur die Seite, die Sie ändern wollten, sondern auch den Aufruf der Startseite und einer Produktseite. Fehler in dieser Datei wirken sich auf das gesamte Verzeichnis aus, nicht nur auf die Adresse, für die eine Regel gedacht war.


## Related topics

- [Konfigurations-Typen](https://dokumentation.websale.de/v8s/grundlagen-konfiguration/konfigurations-typen.md)
- [Konfiguration: Grundlagen](https://dokumentation.websale.de/v8s/grundlagen-konfiguration/konfiguration-grundlagen.md)
- [$wsConfig - Konfiguration](https://dokumentation.websale.de/frontend/referenz/module/wsconfig.md)
- [404-Fehlerseite](https://dokumentation.websale.de/v8s/informationsseiten/404-fehlerseite.md)
- [Ladezeit und Verschlüsselung](https://dokumentation.websale.de/v8s/seo/ladezeit-und-verschluesselung.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.