Qualys-REST-Nachrichten

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 2 Minuten Lesedauer

    • Qualys-REST-Nachrichten werden verwendet, um die Qualys-API [ API aufzurufen und Compliance-Daten abzurufen.

    Die folgenden REST-Nachrichten sind im Lieferumfang des Basissystems enthalten.

    REST-Nachricht zu Qualys-PC-Richtlinien

    Die REST-Nachricht „Qualys PC-Richtlinien“ ruft Richtliniendaten von Qualys ab. Die Änderungen am Datensatz der REST-Nachrichtenmethode wirken sich auf die an Qualys gerichtete Anforderung zum Abrufen von Policeninformationen aus.

    Tabelle : 1. REST-Nachrichtenparameter für Qualys-PC-Richtlinien
    Parametername Wert Beschreibung
    Aktion Liste Gibt den Typ des angeforderten Vorgangs an.

    Erforderlicher Parameter.
    details Alle

    Gibt die Detailebene an, die für abgerufene Richtlinien angezeigt wird.

    Es ist sicher, entsprechend Ihren Anforderungen zu ändern.

    REST-Nachricht für Qualys PC-Steuerelemente

    Die REST-Nachricht Qualys-PC-Steuerungen ruft Informationen zu Compliancekontrollen für verschiedene Kontroll-IDs von Qualys ab.

    Tabelle : 2. REST-Nachrichtenparameter für Qualys PC-Steuerungen
    Parametername Wert Beschreibung
    Aktion Liste Gibt den Typ des angeforderten Vorgangs an.

    Erforderlicher Parameter.
    details Alle

    Gibt die Detailebene an, die für abgerufene Steuerungen angezeigt wird.

    Es ist sicher, entsprechend Ihren Anforderungen zu ändern.

    REST-Nachricht mit Detail zu Qualys-PC-Richtlinien

    Die REST-Nachricht Qualys PC Policies Detail ruft die vollständigen Richtliniendetails ab, z. B. Technologien und Abschnitte.

    Tabelle : 3. REST-Nachrichtenparameter für Qualys-PC-Richtliniendetails
    Parameter Wert Beschreibung
    Aktion Liste Gibt den Typ des angeforderten Vorgangs an.

    Erforderlicher Parameter.
    show_user_controls Boolean
    • Legen Sie den Wert auf 1 fest, um anwenderdefinierte Steuerungen (UDCs) in die XML-Ausgabe einzubeziehen.

    • Wenn nicht angegeben, werden UDCs nicht eingeschlossen.

    Dies ist ein optionaler Parameter. Es ist sicher, entsprechend Ihren Anforderungen zu ändern.
    show_appendix Boolean

    (Optional) Legen Sie den Wert auf 1 fest, um den Abschnitt „Anhang“ in der XML-Ausgabe anzuzeigen. Wenn nicht angegeben

    REST-Nachricht zu Qualys-PC-Ergebnissen

    Die REST-Nachricht Qualys PC-Ergebnisse ruft Compliance-Situationsdatensätze von Qualys ab.

    Tabelle : 4. REST-Nachrichtenparameter für Qualys PC-Ergebnisse
    Quellfeld Wert Beschreibung
    Aktion Liste Gibt den Typ des angeforderten Vorgangs an.

    Erforderlicher Parameter. Änderungen werden nicht empfohlen.
    show_extended_evidence Boolean
    • Legen Sie den Wert auf 1 fest, um die erweiterten Nachweisinformationen in der Ausgabe anzuzeigen.
    • Auf 0 festlegen oder wenn nicht angegeben, werden die erweiterten Nachweisinformationen nicht in der Ausgabe angezeigt.
    Hinweis:
    • Sie können „show_extended_evidence=1“ und „hide_evidence=1“ nicht in derselben Anforderung angeben. Dies führt zu einem Fehler. Der erweiterte Nachweis ist Teil der Nachweisdaten und wird nur angezeigt, wenn Nachweisdaten angezeigt werden.
    • Dieser Parameter ist nicht im Lieferumfang des Basissystems enthalten.
    Verursacher_des_Fehlers Boolean

    Wenn Sie „1“ bestehen, gibt Qualys die Fehlerursache zurück.

    Wenn Sie „0“ übergeben, gibt Qualys diese Attribute nicht zurück.

    Hinweis:
    Dieser Parameter ist nicht im Lieferumfang des Basissystems enthalten.
    policy_id Zeigt Informationsdatensätze zur Compliance-Situation für eine angegebene Richtlinie an. Eine gültige Richtlinien-ID ist erforderlich.
    details Alle

    Gibt die Detailebene an, die für abgerufene Positionen angezeigt wird.

    Es ist sicher, entsprechend Ihren Anforderungen zu ändern.
    show_remediation_info (Optional) Legen Sie den Wert auf 1 fest, um Korrekturinformationen in der XML- oder CSV-Ausgabe anzuzeigen. Standardmäßig enthält die Ausgabe keine Korrekturinformationen. Wenn nicht angegeben, werden die Korrekturinformationen nicht in die Ausgabe aufgenommen.

    REST-Nachricht für Integration des Qualys-PCRS-Richtlinienhosts

    Die Qualys-PCRS-Richtlinien-Host-Integration ruft Hostdaten von Qualys ab und verarbeitet sie in Ihrer -Instanz.

    Tabelle : 5. REST-Nachrichtenparameter für Integration des Qualys-PCRS-Richtlinien-Hosts
    Parametername Wert Beschreibung
    policyId ${lastRunDatetime}

    Richtlinien-IDs für die Compliance-Bewertung.

    Integration von Qualys PCRS-Testergebnissen

    Die Tabelle zeigt die Anforderungsparameter, die gesendet werden.

    Tabelle : 6. REST-Nachrichtenparameter für Integration von Qualys-PCRS-Testergebnissen
    Parametername Wert Beschreibung
    NachweisErforderlich ${lastRunDatetime}
    • Der Standardwert ist 0. Dies gibt an, dass keine Nachweisdaten für die Hoststellung abgerufen werden.
    • Legen Sie den Wert auf 1 fest, um die Nachweisdaten abzurufen.
      Hinweis:
      Wenn Sie den Wert in 1 ändern, erhöht sich die Zeit, die zum Abrufen von Statusdaten erforderlich ist.
    komprimierungErforderlich
    • Der Standardwert ist 1, was bedeutet, dass die Ausgabe komprimiert wird.
    • Legen Sie den Wert auf 0 fest, wenn die Daten nicht komprimiert werden sollen.
      Hinweis:
      Wenn Sie die Daten nicht komprimieren, dauert das Abrufen von Statusdaten länger.