Alle geltenden WAF-Regeln einer Subdomain auflisten¶

Note

Die Antwort fasst die WAF-Regeln aller Ebenen in einer Liste zusammen. Sie ersetzt die getrennten Anfragen für Subdomain-, Domain- und Tag-Regeln.

Senden einer GET-Anfrage an den Endpunkt /domain/{id}/waf-rules/list.

Beschreibung¶

Mit der List-Combined-WAF-Rules-Anfrage rufen Sie eine Liste aller WAF-Regeln ab, die für eine Subdomain einer Domain der Organisation gelten.

Die Liste enthält die WAF-Regeln der Subdomain, die allgemeinen WAF-Regeln der Domain sowie die WAF-Regeln der Tags, die der Subdomain oder der Domain zugeordnet sind. Das System sortiert die Regeln nach ihrer Ebene und innerhalb einer Ebene nach dem Wert des Attributs sort.

Voraussetzungen¶

Werte der Anfrage: Domain-ID {id}

Objekte: keine

Anfrage¶

Um eine Liste aller geltenden WAF-Regeln abzurufen, fügen Sie die Domain-ID {id} dem Pfad der Anfrage hinzu.

Mit der List-Combined-WAF-Rules-Anfrage filtern Sie die Ausgabe, indem Sie dem Pfad der Anfrage die folgenden Parameter hinzufügen:

Parameter	Beschreibung	Werte
`subDomain`	Gibt zusätzlich die WAF-Regeln dieser Subdomain und der ihr zugeordneten Tags zurück. Ohne diesen Parameter enthält die Liste ausschließlich die Regeln auf Domain-Ebene.	eine Zeichenkette
`page`	Legt die Seite der Ergebnisliste fest.	`integer`
`pageSize`	Legt die Anzahl der Einträge pro Seite fest. Der Wert `-1` gibt alle Einträge in einer Antwort zurück.	`integer`

Als Ergebnis erhalten Sie ein oder mehrere Objekte CombinedWafRuleVO mit den angefragten Informationen.

Das Objekt CombinedWafRuleVO enthält alle Attribute des Objekts WafRuleVO und zusätzlich das folgende Attribut:

Attribut	Beschreibung	Werte
`ruleLevel`	Die Ebene, auf der die WAF-Regel definiert ist.	`1` -> Regel der Subdomain `2` -> Regel der Domain `3` -> Regel eines Tags der Subdomain `4` -> Regel eines Tags der Domain `5` -> Regel eines Myra-Tags der Subdomain `6` -> Regel eines Myra-Tags der Domain

Welche Informationen das Objekt WafRuleVO liefert und welche Attribute die Objekte WafActionVO und WafConditionVO enthalten, beschreibt der Abschnitt Alle WAF-Regeln aller Subdomains auflisten.

Beispiel¶

Beispiel-Antwort:

[
  {
    "objectType": "string",
    "id": 0,
    "modified": "string",
    "created": "string",
    "comment": "string",
    "ruleType": "string",
    "ruleLevel": 0,
    "name": "string",
    "description": "string",
    "logIdentifier": "string",
    "template": true,
    "subDomainName": "string",
    "vhostId": 0,
    "tagId": 0,
    "direction": "string",
    "uuid": "string",
    "processNext": true,
    "sync": true,
    "actions": [
      {
        "objectType": "string",
        "id": 0,
        "name": "string",
        "type": "string",
        "availablePhases": 0,
        "customKey": "string",
        "value": "string"
      }
    ],
    "conditions": [
      {
        "objectType": "string",
        "id": 0,
        "name": "string",
        "key": "string",
        "value": "string",
        "matchingType": "string",
        "availablePhases": 0,
        "alias": "string"
      }
    ],
    "sort": 0,
    "copiedFrom": 0,
    "expireDate": "string",
    "enabled": true
  }
]

Antworten¶

Die folgenden Antworten sind möglich:

STATUSCODE	BESCHREIBUNG
200	Die Anfrage war erfolgreich.
400	Die Anfrage war nicht erfolgreich. Die Anfrage war fehlerhaft oder es fehlen Informationen.
401	Die Anfrage war nicht erfolgreich, da die Authentifizierung fehlerhaft war.
403	Die Anfrage war nicht erfolgreich, da die erforderlichen Berechtigungen fehlen.