Dokumentation

Beliebige RFC-URL (HTTP, HTTPS usw.) testen

Antwortcode, Verbindungszeit, Übertragungszeit, Übereinstimmungen im Inhalt, Zertifikat gültig

URL

RFC-URL (HTTP, HTTPS usw.)

Benutzername

Geben Sie einen Benutzernamen ein, falls die URL eine Authentifizierung erfordert. Um zu testen, ob eine Webseite den in den spezifischen Feldern der SKOOR Engine festgelegten Benutzernamen und das Passwort akzeptiert, geben Sie die URL wie folgt ein:

http://<Benutzername>:<Passwort>@URL

Passwort

Geben Sie ein Passwort ein, falls die URL eine Authentifizierung erfordert.

Methode

Wählen Sie eine der folgenden Anfragemethoden aus:

GET (Standard)
PUT (Aktualisieren)
POST
DELETE

Wenn entweder „PUT“ oder „POST“ ausgewählt ist, wird ein zusätzliches Textfeld „Daten“ aktiviert.

Daten

Nur sichtbar, wenn die Methode „PUT“ oder „POST“ ausgewählt ist. Ermöglicht die Eingabe des Hauptteils der PUT-/POST-Anfrage.

Authentifizierung

Wählen Sie eine der folgenden Authentifizierungsarten aus:

Beliebig (von libcurl ausgewählt) (Standard)
Beliebig außer Basic
Basic
Digest
Digest mit IE-Variante
Negotiate (SPNEGO)
NTLM

Proxy-Adresse

Es ist möglich, eine URL über einen Proxy zu testen. Wenn dieses Feld verwendet wird, läuft die Anfrage über den Proxy. Anders als bei normalen HTTP-Anfragen wird die Zeit für den Verbindungsaufbau zum Proxy in diese Messung einbezogen. Die Gesamtzeit einschließlich des Herunterladens der Seite ist kürzer, wenn diese auf dem Proxy zwischengespeichert ist.

Proxy-Port

Proxy-Portnummer

Proxy-Benutzername

Proxy-Benutzernamen eingeben

Proxy-Passwort

Proxy-Passwort eingeben

Proxy-Authentifizierung

Wählen Sie die Art der Authentifizierung beim Proxy aus. Siehe den Abschnitt „Authentifizierungsparameter“ weiter oben.

Zeitlimit

Zeitlimit in Sekunden (Standardwert: 120 s), nach dessen Ablauf eine Warning-Meldung angezeigt wird, dass die Webseite nicht verfügbar ist

Inhaltsprüfung

Überprüfen Sie den Textinhalt des heruntergeladenen Dokuments. Reguläre Ausdrücke werden unterstützt.

Weiterleitungen verfolgen

Aktivieren Sie dieses Kontrollkästchen, wenn Weiterleitungen verfolgt werden sollen (bis zu 50 Weiterleitungen)

Ablaufdatum des Zertifikats anzeigen

Aktivieren Sie dieses Kontrollkästchen, um das Ablaufdatum des SSL-Zertifikats zu prüfen. Dadurch können Alarm Limits für eine bestimmte Anzahl von Tagen vor Ablauf der Zertifikate festgelegt werden.

Verbindungszeit
unterdrücken Übertragungszeit unterdrücken

Wenn eines dieser Kontrollkästchen aktiviert ist, werden die Verbindungszeit und/oder die Übertragungszeit der einzelnen Prüfungen nicht in der Datenbank gespeichert und ihre Werte sind im Abschnitt „Werte“ nicht mehr sichtbar. Ihre Werte stehen auch nicht mehr für die Festlegung von Alarm Limits zur Verfügung.

SSL/TLS-Version

Wählen Sie eine der folgenden Implementierungen aus:

Standard
TLSv1
SSLV2
SSLV3

Die Standardeinstellung hängt von der Konfiguration des Betriebssystems ab.

Peer überprüfen

Bei HTTPS-Verbindungen kann das Webserver-Zertifikat mit einer auf dem Kollektor gespeicherten Zertifikatsdatei verglichen werden. Aktivieren Sie diese Option, um zu überprüfen, ob das SSL-Zertifikat des Webservers authentisch ist, d. h., ob man darauf vertrauen kann, dass der Server tatsächlich derjenige ist, für den er sich laut Zertifikat ausgibt. Wenn dieses Feld aktiviert ist, muss die korrekte Zertifikatsdatei des Servers auf der SKOOR Engine gespeichert sein (siehe nächster Parameter „Zertifikatsdatei“). Das gespeicherte Zertifikat wird mit dem vom Server bei der Ausführung des HTTP-Jobs ausgestellten Zertifikat verglichen.

Zertifikatsdatei

Nur sichtbar, wenn der obige Parameter „Peer überprüfen“ auf „Zertifikat muss authentisch sein“ gesetzt ist. Geben Sie den Namen der Zertifikatsdatei (z. B. host.crt) ein, mit der das Zertifikat des Servers verglichen wird. Zertifikatsdateien müssen zunächst in das Verzeichnis /opt/eranger/collector/certificates der SKOOR Engine kopiert werden. Der Pfad kann durch Bearbeiten der Variablen `http_cert_path` in der Datei `eranger-Kollektor.cfg` geändert werden.

Host überprüfen

Nur sichtbar, wenn der obige Parameter „Peer überprüfen“ auf „Zertifikat muss authentisch sein“ gesetzt ist. Wählen Sie „Überprüfung muss erfolgreich sein“, um zu prüfen, ob der im Zertifikat des Servers angegebene Common Name (CN) mit der URL des Servers übereinstimmt.

HTTP-Header

Geben Sie beliebige HTTP-Header ein, die die SKOOR Engine mit der Anfrage senden soll. Dies ist vor allem nützlich, um die angeforderte Sprache der Webseite zu ändern oder den User-Agent zu ändern, mit dem sich die SKOOR Engine gegenüber dem Server identifiziert. Der Standard-User-Agent lautet: „SKOOR Engine Monitoring Agent“, sofern dieser Header nicht definiert ist. Der Wikipedia-Link direkt neben dem Eingabefeld für den Header führt zu der Wikipedia-Seite, auf der alle verfügbaren HTTP-Header beschrieben werden.

Inhalt in Datei speichern

Legen Sie einen Dateinamen fest, unter dem die Ausgabe der Anfrage gespeichert werden soll.

Es können Tags verwendet werden, zum Beispiel $DEVICE_ADDRESS$. Je nach Dateinamenerweiterung (.txt oder .html) rendert der Browser die Seite beim Klicken auf den Dateilink unterschiedlich. Die Angabe eines klar definierten Dateinamens ist praktisch, wenn die Ausgabe von einem nachfolgenden „parsefile“-Job analysiert wird. Wird dieses Feld leer gelassen, wird eine Ausgabedatei mit dem Namen <http_NNN_NNN.txt> erstellt, wobei N ganze Zahlen sind, die bei der Erstellung des Jobs zufällig generiert werden. Geben Sie nur den Dateinamen ohne jegliche Dateipfadkomponente an. Standardmäßig wird die Datei unter /var/opt/run/eranger/Kollektor/tmp gespeichert.

Antwortcode

Verwenden Sie den Antwortcode des Webservers als Alarm Limit. Übliche akzeptierte Rückgabecodes sind:

200 OK und 302 Found

Es kann jedoch auch jeder andere Wert überprüft werden.

Hier ist eine Liste der am häufigsten verwendeten Antwortcodes:

100 Continue

Dies bedeutet, dass der Server die Request-Header empfangen hat und der Client nun den Request-Body senden soll (im Falle einer Anfrage, bei der ein Body gesendet werden muss; zum Beispiel bei einer POST-Anfrage). Ist der Request-Body groß, ist es ineffizient, ihn an einen Server zu senden, wenn die Anfrage aufgrund ungeeigneter Header bereits abgelehnt wurde. Damit ein Server allein anhand der Anfrage-Header prüfen kann, ob die Anfrage akzeptiert werden könnte, muss ein Client in seiner ersten Anfrage den Header „Expect: 100-continue“ senden und prüfen, ob als Antwort der Statuscode 100 Continue empfangen wird, bevor er fortfährt (oder den Statuscode 417 Expectation Failed erhält und nicht fortfährt).

200 OK

Standardantwort auf erfolgreiche HTTP-Anfragen.

201 Created

Die Anfrage wurde erfüllt und führte zur Erstellung einer neuen Ressource.

202 Accepted

Die Anfrage wurde zur Bearbeitung angenommen, die Bearbeitung ist jedoch noch nicht abgeschlossen. Die Anfrage wird möglicherweise bearbeitet, möglicherweise aber auch nicht, da sie bei der tatsächlichen Bearbeitung abgelehnt werden könnte.

301 Dauerhaft verschoben

Diese und alle zukünftigen Anfragen sollten an die angegebene URL weitergeleitet werden

302 Gefunden

Dies ist der gängigste Weiterleitungscode, aber auch ein Beispiel dafür, dass die Praxis in der Branche im Widerspruch zum Standard steht. Die HTTP/1.0-Spezifikation verlangte vom Client, eine temporäre Weiterleitung durchzuführen (die ursprüngliche Beschreibung lautete „Moved Temporarily“), doch gängige Browser implementierten dies als 303 See Other. Daher wurden in HTTP/1.1 die Statuscodes 303 und 307 hinzugefügt, um zwischen den beiden Verhaltensweisen zu unterscheiden. Die Mehrheit der Webanwendungen und Frameworks verwendet jedoch nach wie vor den Statuscode 302, als wäre er der 303.

305 „Use Proxy“ (seit HTTP/1.1)

Viele HTTP-Clients (wie Mozilla und IE) verarbeiten Antworten mit diesem Statuscode nicht korrekt, vor allem aus Sicherheitsgründen.

307 Vorübergehende Umleitung

In diesem Fall sollte die Anfrage mit einer anderen URI wiederholt werden, zukünftige Anfragen können jedoch weiterhin die ursprüngliche URI verwenden. Im Gegensatz zu 303 sollte die Anfragemethode bei der erneuten Übermittlung der ursprünglichen Anfrage nicht geändert werden. So muss beispielsweise eine POST-Anfrage durch eine weitere POST-Anfrage wiederholt werden.

400 Ungültige Anfrage

Die Anfrage enthält eine fehlerhafte Syntax oder kann nicht ausgeführt werden.

401 Nicht autorisiert

Ähnlich wie 403 „Zugriff verweigert“, jedoch speziell für den Fall, dass eine Authentifizierung möglich ist, aber fehlgeschlagen ist oder noch nicht erfolgt ist. 

403 „Forbidden“

Die Anfrage war zulässig, doch der Server weigert sich, darauf zu antworten. Im Gegensatz zu einer 401-„Nicht autorisiert“-Antwort ändert eine Authentifizierung an dieser Situation nichts.

404 Nicht gefunden  

Die angeforderte Ressource konnte nicht gefunden werden.

405 Methode nicht zulässig

Eine Anfrage an eine Ressource erfolgte mit einer Anfragemethode, die von dieser Ressource nicht unterstützt wird; beispielsweise die Verwendung von GET für ein Formular, bei dem Daten per POST übermittelt werden müssen, oder die Verwendung von PUT für eine schreibgeschützte Ressource.

406 Nicht akzeptabel

407 Proxy-Authentifizierung erforderlich

408 Zeitüberschreitung bei der Anfrage

Der Client konnte die Anfrage nicht fortsetzen – außer beim Abspielen von Adobe-Flash-Videos, wo dies lediglich bedeutet, dass der Benutzer das Videofenster geschlossen oder zu einem anderen Video gewechselt hat.

409 Konflikt

410 Nicht mehr vorhanden

Zeigt an, dass die angeforderte Ressource nicht mehr verfügbar ist und auch nicht wieder verfügbar sein wird. Dieser Status sollte verwendet werden, wenn eine Ressource absichtlich entfernt wurde; in der Praxis wird jedoch oft stattdessen ein 404 Not Found ausgegeben.

411 Länge erforderlich

412 Vorbedingung nicht erfüllt

413 Anforderungsentität zu groß

414 Anfrage-URI zu lang

415 Nicht unterstützter Medientyp

416 Angeforderter Bereich nicht erfüllbar

Der Client hat einen Teil der Datei angefordert, aber der Server kann diesen Teil nicht bereitstellen (beispielsweise, wenn der Client einen Teil der Datei angefordert hat, der über das Ende der Datei hinausgeht).

417 Erwartung nicht erfüllt

421 Es gibt zu viele Verbindungen von Ihrer Internetadresse

422 Nicht verarbeitbare Entität

Die Anfrage war zwar korrekt aufgebaut, konnte jedoch aufgrund semantischer Fehler nicht weiterverarbeitet werden.

423 Gesperrt (WebDAV)

Die Ressource, auf die zugegriffen wird, ist gesperrt

424 Fehlgeschlagene Abhängigkeit (WebDAV)

Die Anfrage ist aufgrund eines Fehlers bei einer vorherigen Anfrage (z. B. einem PROPPATCH) fehlgeschlagen.

425 Ungeordnete Sammlung

In den Entwürfen zu „WebDAV Advanced Collections“ definiert, jedoch nicht im „Web Distributed Authoring and Versioning (WebDAV) Ordered Collections Protocol“ enthalten.

426 Upgrade erforderlich

Der Client sollte auf ... umsteigen.

449 Mit folgendem Versuch wiederholen

Eine Microsoft-Erweiterung: Die Anfrage sollte nach Durchführung der entsprechenden Maßnahme erneut versucht werden.

500 Interner Serverfehler

501 Nicht implementiert

502 Fehlerhaftes Gateway

503 Dienst nicht verfügbar

504 Gateway-Zeitüberschreitung

505 HTTP-Version wird nicht unterstützt

506 Variante wird ebenfalls ausgehandelt

507 Unzureichender Speicherplatz

509 Bandbreitenlimit überschritten

Dieser Statuscode wird zwar von vielen Servern verwendet, ist jedoch kein offizieller HTTP-Statuscode.

510 Nicht erweitert

Verbindungszeit

Zeit bis zum Aufbau der TCP-Verbindung zum Server (in ms). Der SSL-Handshake wird nicht mitgerechnet.

Übertragungszeit

Zeit bis zur Bereitstellung einer Webseite und zum Schließen der Verbindung (in ms)

Inhaltsübereinstimmungen

Legen Sie Grenzwerte fest, je nachdem, wie oft eine Zeichenfolge oder ein regulärer Ausdruck im
Inhalt der getesteten Webseite vorkommt

Gültigkeit des Zertifikats

Die Anzahl der Tage bis zum Ablauf des Remote-SSL-Zertifikats.

Fehlercode

Allgemeiner Job-Fehlercode (siehe Abschnitt „Job-Fehlercodes“)

http://$DEVICE_ADDRESS$

Aktivieren