Zum Inhalt

Servereinstellungen

Wenn Du den Offenen Web-Kalender auf das anpassen willst, das du brauchst, dann ist das gut möglich. Du kannst

  • Ändern, wie der Standard-Kalender aussieht.
  • Ändern, wie der Server funtioniert.

Den Standard-Kalender anpassen

The configuration of all calendars is rooted in the default_specification. All those values can be changed through a copy of this file hosted on the web through the calendar parameter specification_url. Each parameter should be documented in default_specification.

To modify all calendars hosted on your instance, use the OWC_SPECIFICATION environment variable. Calendars still override some values for their configuration. Those which they do not override are affected by the default specification. Not all values are exposed to the configuration page to be changed. Those values can still be changed in the specification_url and the query parameters.

Wahrscheinlich willst Du die folgenden Werte ändern.

title

Der Titel der Webseite.

language

Das ist die Standart-Sprache. Wenn Du die änderst, haben es Leute einfacher, die lokal mit dir arbeiten.

favicon

Das ist der Link zu dem Bild der Webseite.

source_code

Wenn DU Änderungen vorgenommen hast, bist du legal verpflichtet, diese den Besuchern der Webseite mitzuteilen. Bitte verändere den Link oder füge sie zum Hauptprojekt hinzu.

contributing

Wenn Du auf eine andere Seite verweisen magst, um zu Deinem Projekt beizutragen.

privacy_policy

Wenn Du diesen Dienst auf einem eigenen Server betreibst, dann kannst Du unsere Datenschutzerklärung verwenden.

Solltest Du DIch aus irgendeinem Grund entscheiden, personenbezogene Daten zu speichern, z.B. im HTTPS-Proxy die IP-Adressen, dann musst Du eine eigene Datenschutzerklärung erstellen. Du kannst darin die des Projektes verlinken.

Mehr Werte

There are loads more values that can be changed. Please refer to the default_specification. These values are all documented. Please use the OWC_SPECIFICATION environment variable to change them.

Siehe auch:

Den Server Anpassen

Umgebungsvariablen beeinflussen nur das Verhalten des Servers. Diese Umgebungsvariablen können für den Server verwendet werden:

ALLOWED_HOSTS

Standardwert: leer

The clients divided by comma that are allowed to access the Open Web Calendar. You will see this text if you try to access the service and you are not allowed:

Forbidden: You don’t have the permission to access the requested resource. It is either read-protected or not readable by the server.*

Examples:

  • permit only the same computer: ALLOWED_HOSTS=localhost
  • permit several hosts: ALLOWED_HOSTS=192.168.0.1,192.168.2,api.myserver.com
  • permit everyone to access the server (default): ALLOWED_HOSTS= or ALLOWED_HOSTS=*

This functionality is provided by flask-allowed-hosts.

PORT

Standardwert: 5000, im Docker-Container: 80

Der Netzwerk-Port auf dem der Dienst läuft.

Examples:

  • Den HTTP-Port nutzen: PORT=80

OWC_SPECIFICATION

OWC_SPECIFICATION is an optional environment variable.

  • It can be a path to a file containing valid YAML or JSON.
  • It can be a string containing valid YAML or JSON.

Setting OWC_SPECIFICATION allows you to replace default values for all calendars.

Note

New versions of the Open Web Calendar can add new configuration parameters. Placing your changes in this variable instead of changing the default_specification file will ensure that you do not break the Open Web Calendar in a future version.

In following example, the title for all calendars that do not set their own title will be changed.

OWC_SPECIFICATION='{"title": "calendar"}' gunicorn open_web_calendar:app

Siehe auch:

WORKERS

Standardwert: 4, nur im Docker-Container

Die Anzahl paralleler Arbeiter, um die Anfragen zu beantworten.

Examples:

  • Nutze nur einen Arbeiter: WORKERS=1

CACHE_REQUESTED_URLS_FOR_SECONDS

Standartwert: 600

Sekunden, die die Kalenderdateien zwischengespeichert werden, um Bandbreite und Verzögerung zu reduzieren.

Examples:

  • Schnelles Neuladen: CACHE_REQUESTED_URLS_FOR_SECONDS=10

APP_DEBUG

Standartwert: true, Werte true oder false, immer false im Docker-Container

Setze das Debug-Flag für die App.

Further Configuration

Der offene Web-Kalender nutzt Bibliotheken, mit denen das Verhalten weiter angepasst werden kann.

SSRF-Schutz druch einen Proxy

Der offene Web-Kalender kann genutzt werden, um das lokale Netz hinter einer Firewall zu scannen, siehe Issue 250. Dieser freie Zugang ist gewollt, um Kalender von überall anzuzeigen. Da requests genutzt wird, kann ein Proxy zwischengeschaltet werden. Das ist in der requests-Dokumentation bechrieben. Der Proxy kann dann das Filtern übernehmen.

export HTTP_PROXY="http://10.10.1.10:3128"
export HTTPS_PROXY="http://10.10.1.10:1080"
export ALL_PROXY="socks5://10.10.1.10:3434"

Siehe auch: