Regelsystem: Difference between revisions

From WaveCDN Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(17 intermediate revisions by the same user not shown)
Line 1: Line 1:
== Abarbeiten der Regeln ==
Das Regelsystem ist auf größtmögliche Flexbilität ausgelegt. Man kann zwar sehr viele verschiedene Anforderungen realisieren, dennoch ist es nicht möglich alle Wünsche bis ins kleinste Detail abzudecken. Aus dem Grund bieten wir über unseren Support die Möglichkeit, weitergehende Regeln intern konfigurieren zu lassen. Damit ist (fast) alles möglich.


Die Regeln werden sequenziell von oben nach unten abgearbeitet. Bei bestimmten Regeln ist es möglich vorhergehende zu überschreiben. Bei Details hilft unser Support gerne weiter.
== Abarbeitung der Regeln ==


== Dokumentation der Regeln ==
Die Regeln werden sequenziell von oben nach unten abgearbeitet. Erst nachdem alle Regeln abgearbeitet wurden, wird das Regelwerk angewendet.
 
== Überschreiben vorhergehender Regeln ==
 
Mit bestimmten Regeln ist es möglich vorhergehende zu überschreiben. Das trifft auf folgende Kombinationen zu:
 
* Allow Access und Deny Access
* Keep Set-Cookie und Remove Set-Cookie
* Pass to origin und Do not pass to origin
* Keep all cookies, Remove all cokies, Keep single cookie und Remove single cookie
 
== Dokumentation wichtiger Regeln ==


Die wichtigsten Regeln sollen kurz erläutert werden. Insbesondere auf die Relevanz in Hinblick auf das Caching soll eingegangen werden.
Die wichtigsten Regeln sollen kurz erläutert werden. Insbesondere auf die Relevanz in Hinblick auf das Caching soll eingegangen werden.


{| class="wikitable"
{| class="table-wavecdn" cellspacing="0"
!Regel
!Regel
!Kontext
!Kontext
!Erläuterung
!style="width:700px"|Erläuterung
|-
| style="white-space:nowrap" |Max-Age
| style="white-space:nowrap" |Cachen einer Ressource
|WaveCDN erhält in bestimmten Situationen Ressourcen des Origins. Wenn bei der Ressource die Voraussetzungen für das Caching erfüllt sind, muss entschieden werden, wie lange die Ressource im Cache gültig ist. Durch die Max-Age-Regel wird genau diese Gültigkeit definiert. Sofern Informationen vom Origin über die Gültigkeitsdauer der Ressource vorliegen (Expires oder Cache-Control-Max-Age-Header), hat diese im Webpanel definierte Regel Vorrang.
|-
| style="white-space:nowrap" |Allow access
| style="white-space:nowrap" |Anfrage vom Webuser an WaveCDN
|Erlaubt den Zugriff auf eine angefragte Ressource.
|-
| style="white-space:nowrap" |Deny access
| style="white-space:nowrap" |Anfrage vom Webuser an WaveCDN
|Verbietet den Zugriff auf eine angefragte Ressource. Es wird der HTTP-Statuscode "403 Access Denied" zurückgeliefert.
|-
| style="white-space:nowrap" |Keep all cookies
| style="white-space:nowrap" |Anfrage vom Webuser an WaveCDN
|Wenn der Webuser eine Anfrage an WaveCDN schickt, dann kann in der Anfrage ein Cookie-Header enthalten sein. Diese Regeln sorgt dafür, alle Cookies im Cookie-Header erhalten bleiben.
|-
| style="white-space:nowrap" |Remove all cookies
| style="white-space:nowrap" |Anfrage vom Webuser an WaveCDN
|Wenn der Webuser eine Anfrage an WaveCDN schickt, dann kann in der Anfrage ein Cookie-Header enthalten sein. Diese Regeln entfernt alle im Cookie-Header enthaltenen Cookies.
|-
| style="white-space:nowrap" |Keep single cookie
| style="white-space:nowrap" |Anfrage vom Webuser an WaveCDN
|Wenn der Webuser eine Anfrage an WaveCDN schickt, dann kann in der Anfrage ein Cookie-Header enthalten sein. Diese Regeln sorgt dafür, dass ein bestimmter Cookie mit angegebenem Namen im Cookie-Header erhalten bleibt.
|-
|-
| style="white-space:nowrap" |Remove Cookie
| style="white-space:nowrap" |Remove single cookie
| style="white-space:nowrap" |Anfrage vom Webuser an WaveCDN
| style="white-space:nowrap" |Anfrage vom Webuser an WaveCDN
|Wenn der Webuser eine Anfrage an WaveCDN schickt, dann kann in der Anfrage ein Cookie-Header enthalten sein. Diese Regeln entfernt den Cookie-Header.
|Wenn der Webuser eine Anfrage an WaveCDN schickt, dann kann in der Anfrage ein Cookie-Header enthalten sein. Diese Regeln entfernt einen bestimmten Cookie mit angegebenem Namen aus dem Cookie-Header.
|-
|-
| style="white-space:nowrap" |Remove Set-Cookie
| style="white-space:nowrap" |Remove Set-Cookie
| style="white-space:nowrap" |Antwort vom Origin an WaveCDN
| style="white-space:nowrap" |Antwort vom Origin an WaveCDN
|Wenn WaveCDN eine bestimmte Ressource nicht im Cache hat, wird der Origin befragt. Der Origin antwortet mit der Ressource. In der Antwort wird durch diese Regel der Set-Cookie-Header entfernt.
|Der Origin kann bei der Antwort einen Set-Cookie-Header mitschicken, um beim Webuser einen Cookie zu setzen. Die Regel entfernt diesen Header. Es wird also kein Cookie beim Webuser gesetzt.
|-
|-
| style="white-space:nowrap" |Max-Age
| style="white-space:nowrap" |Cache with cookies
| style="white-space:nowrap" |Cachen einer Ressource  
| style="white-space:nowrap" |Cachen einer Ressource
|WaveCDN erhält in bestimmten Situationen Ressourcen des Origins. Wenn bei der Ressource die Voraussetzungen für das Caching erfüllt sind, muss entschieden werden, wie lange die Ressource im Cache gültig ist. Durch die Max-Age-Regel wird genau diese Gültigkeit definiert. Sofern Informationen vom Origin über die Gültigkeitsdauer der Ressource vorliegen (Expires oder Cache-Control-Max-Age-Header), hat die Regel im Webpanel Vorrang.
|Angenommen der Webuser schickt eine Anfrage mit Cookies an WaveCDN. Normalerweise würde WaveCDN die Anfrage nicht cachen, weil der Cookie dafür sorgt, dass die Voraussetzungen für das Caching nicht erfüllt sind. Die Regel sorgt dafür, dass die Anfrage trotzdem in den Cache aufgenommen wird. Ferner wird der Cookie mit in die Berechnung des Cache Keys aufgenommen. Die Regel wird nach den Cookie-Manipulationsregeln angewendet.
|-
|-
| style="white-space:nowrap" |Cache with Cookies
| style="white-space:nowrap" |Do not cache with cookies
| style="white-space:nowrap" |Cachen einer Ressource
| style="white-space:nowrap" |Cachen einer Ressource
|Angenommen der Webuser schickt eine Anfrage mit Cookies an WaveCDN. Dann muss WaveCDN diese Anfrage in bestimmten Situationen an den Origin weiterleiten, zum Beispiel wenn die angefragte Ressource nicht im Cache ist. Wenn WaveCDN die Ressource dann vom Origin erhält, dann würde sie normalerweise nicht gecached werden, weil sie Cookies enthält (siehe Voraussetzungen für das Caching). Die Regel "Cache with Cookies" gibt die Anweisung die Ressource trotzdem in den Cache aufzunehmen. Zugleich wird für die Partitionierung des Caches der Cookie-Header mit einbezogen.
|Setzt eine vorher definierte Regel "Cache with cookies" außer Kraft.
|}
|}

Latest revision as of 13:04, 8 January 2014

Das Regelsystem ist auf größtmögliche Flexbilität ausgelegt. Man kann zwar sehr viele verschiedene Anforderungen realisieren, dennoch ist es nicht möglich alle Wünsche bis ins kleinste Detail abzudecken. Aus dem Grund bieten wir über unseren Support die Möglichkeit, weitergehende Regeln intern konfigurieren zu lassen. Damit ist (fast) alles möglich.

Abarbeitung der Regeln

Die Regeln werden sequenziell von oben nach unten abgearbeitet. Erst nachdem alle Regeln abgearbeitet wurden, wird das Regelwerk angewendet.

Überschreiben vorhergehender Regeln

Mit bestimmten Regeln ist es möglich vorhergehende zu überschreiben. Das trifft auf folgende Kombinationen zu:

  • Allow Access und Deny Access
  • Keep Set-Cookie und Remove Set-Cookie
  • Pass to origin und Do not pass to origin
  • Keep all cookies, Remove all cokies, Keep single cookie und Remove single cookie

Dokumentation wichtiger Regeln

Die wichtigsten Regeln sollen kurz erläutert werden. Insbesondere auf die Relevanz in Hinblick auf das Caching soll eingegangen werden.

Regel Kontext Erläuterung
Max-Age Cachen einer Ressource WaveCDN erhält in bestimmten Situationen Ressourcen des Origins. Wenn bei der Ressource die Voraussetzungen für das Caching erfüllt sind, muss entschieden werden, wie lange die Ressource im Cache gültig ist. Durch die Max-Age-Regel wird genau diese Gültigkeit definiert. Sofern Informationen vom Origin über die Gültigkeitsdauer der Ressource vorliegen (Expires oder Cache-Control-Max-Age-Header), hat diese im Webpanel definierte Regel Vorrang.
Allow access Anfrage vom Webuser an WaveCDN Erlaubt den Zugriff auf eine angefragte Ressource.
Deny access Anfrage vom Webuser an WaveCDN Verbietet den Zugriff auf eine angefragte Ressource. Es wird der HTTP-Statuscode "403 Access Denied" zurückgeliefert.
Keep all cookies Anfrage vom Webuser an WaveCDN Wenn der Webuser eine Anfrage an WaveCDN schickt, dann kann in der Anfrage ein Cookie-Header enthalten sein. Diese Regeln sorgt dafür, alle Cookies im Cookie-Header erhalten bleiben.
Remove all cookies Anfrage vom Webuser an WaveCDN Wenn der Webuser eine Anfrage an WaveCDN schickt, dann kann in der Anfrage ein Cookie-Header enthalten sein. Diese Regeln entfernt alle im Cookie-Header enthaltenen Cookies.
Keep single cookie Anfrage vom Webuser an WaveCDN Wenn der Webuser eine Anfrage an WaveCDN schickt, dann kann in der Anfrage ein Cookie-Header enthalten sein. Diese Regeln sorgt dafür, dass ein bestimmter Cookie mit angegebenem Namen im Cookie-Header erhalten bleibt.
Remove single cookie Anfrage vom Webuser an WaveCDN Wenn der Webuser eine Anfrage an WaveCDN schickt, dann kann in der Anfrage ein Cookie-Header enthalten sein. Diese Regeln entfernt einen bestimmten Cookie mit angegebenem Namen aus dem Cookie-Header.
Remove Set-Cookie Antwort vom Origin an WaveCDN Der Origin kann bei der Antwort einen Set-Cookie-Header mitschicken, um beim Webuser einen Cookie zu setzen. Die Regel entfernt diesen Header. Es wird also kein Cookie beim Webuser gesetzt.
Cache with cookies Cachen einer Ressource Angenommen der Webuser schickt eine Anfrage mit Cookies an WaveCDN. Normalerweise würde WaveCDN die Anfrage nicht cachen, weil der Cookie dafür sorgt, dass die Voraussetzungen für das Caching nicht erfüllt sind. Die Regel sorgt dafür, dass die Anfrage trotzdem in den Cache aufgenommen wird. Ferner wird der Cookie mit in die Berechnung des Cache Keys aufgenommen. Die Regel wird nach den Cookie-Manipulationsregeln angewendet.
Do not cache with cookies Cachen einer Ressource Setzt eine vorher definierte Regel "Cache with cookies" außer Kraft.