Qualys-REST-Nachrichten

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 2 Minuten Lesedauer

    • Qualys-REST-Nachrichten werden verwendet, um Aufrufe an die Qualys-APIzu senden, um die Compliance-Daten abzurufen.

    Die folgenden REST-Nachrichten werden mit dem Basissystem geliefert.

    Qualys PC-Richtlinien-REST-Nachricht

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

    Tabelle : 1. Qualys PC-Richtlinien REST-Nachrichtenparameter
    Parametername Wert Beschreibung
    Aktion Liste Gibt die Art des angeforderten Vorgangs an.

    Erforderlicher Parameter.
    details Alle

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

    Es ist sicher, gemäß Ihren Anforderungen zu ändern.

    Qualys PC steuert die REST-Nachricht

    Die REST-Nachricht von Qualys PC Controls ruft Compliance-Kontrollinformationen für verschiedene Kontroll-IDs aus Qualys ab.

    Tabelle : 2. Qualys PC steuert REST-Nachrichtenparameter
    Parametername Wert Beschreibung
    Aktion Liste Gibt die Art des angeforderten Vorgangs an.

    Erforderlicher Parameter.
    details Alle

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

    Es ist sicher, gemäß Ihren Anforderungen zu ändern.

    Qualys PC-Richtliniendetail-REST-Nachricht

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

    Tabelle : 3. Qualys PC-Richtliniendetail-REST-Nachrichtenparameter
    Parameter Wert Beschreibung
    Aktion Liste Gibt die Art des angeforderten Vorgangs an.

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

    • Wenn nicht angegeben, sind UDCs nicht enthalten.

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

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

    Qualys PC-Ergebnisse REST-Nachricht

    Die REST-Nachricht Qualys PC-Ergebnisse ruft Datensätze zur Compliance-Situation aus Qualys ab.

    Tabelle : 4. Qualys PC-Ergebnisse REST-Nachrichtenparameter
    Quellfeld Wert Beschreibung
    Aktion Liste Gibt die Art 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.
    • Wenn der Wert auf 0 festgelegt ist oder nicht angegeben ist, werden die erweiterten Nachweisinformationen nicht in der Ausgabe angezeigt.
    Hinweis:
    • Sie können show_extended_evidence=1 nicht in derselben Anforderung wie hide_evidence=1 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.
    „cause_of_failure“ Boolean

    Wenn Sie '1' übergeben, 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 Datensätze mit Informationen 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 Status angezeigt wird.

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

    REST-Nachricht für Qualys PCRS-Richtlinienhostintegration

    Die Qualys PCRS-Richtlinienhostintegration ruft Hostdaten aus Qualys ab und verarbeitet sie in Ihrer Instanz.

    Tabelle : 5. Qualys PCRS-Richtlinienhostintegration REST-Nachrichtenparameter
    Parametername Wert Beschreibung
    policyId ${lastRunDatetime}

    Richtlinien-IDs für die Compliance-Auswertung.

    Integration von Qualys PCRS-Testergebnissen

    Die Tabelle zeigt die gesendeten Anforderungsparameter.

    Tabelle : 6. Qualys PCRS-Testergebnisintegration REST-Nachrichtenparameter
    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 auf 1 ändern, erhöht sich die Zeit, die zum Abrufen von Statusdaten erforderlich ist.
    komprimiertErforderlich
    • Der Standardwert ist 1, was angibt, dass die Ausgabe komprimiert wird.
    • Legen Sie den Wert auf 0 fest, wenn die Daten nicht komprimiert werden sollen.
      Hinweis:
      Wenn die Daten nicht komprimiert werden, erhöht sich die Zeit, die zum Abrufen von Statusdaten erforderlich ist.