Qualys-REST-Nachrichten

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 3 Minuten Lesedauer

    • Qualys-REST-Nachrichten werden verwendet, um Anrufe an Qualys zu tätigen API Zum Abrufen der Compliance-Daten.

    Die folgenden Rest-Nachrichten werden mit dem Basissystem geliefert.

    REST-Nachricht für 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 Anforderung an Qualys aus, Richtlinieninformationen abzurufen.

    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 Detailstufe an, die für abgerufene Richtlinien angezeigt wird.

    Ist es Sicher Zum Ändern gemäß Ihren Anforderungen.

    REST-Nachricht für Qualys PC Controls

    Die Rest-Nachricht Qualys PC Controls ruft Informationen zu Compliance-Steuerungen für verschiedene Steuerungs-IDs von Qualys ab.

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

    Erforderlicher Parameter.
    details Alle

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

    Ist es Sicher Zum Ändern gemäß Ihren Anforderungen.

    Qualys PC-Richtlinien – REST-Nachricht im Detail

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

    Tabelle : 3. Qualys-PC-Richtlinien – Details zu REST-Nachrichtenparametern
    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 aufzunehmen.

    • Wenn nicht angegeben, sind UDCs nicht enthalten.

    Dies ist ein optionaler Parameter. Ist es Sicher Zum Ändern gemäß Ihren Anforderungen.
    Show_appAppendix Boolean

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

    REST-Nachricht für Qualys-PC-Ergebnisse

    Die Rest-Nachricht Qualys PC-Ergebnisse ruft Compliance-Statusdatensä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 diese Option auf 1 fest, um die erweiterten Nachweisinformationen in der Ausgabe anzuzeigen.
    • Legen Sie den Wert auf 0 fest, oder wenn nicht angegeben, werden die erweiterten Nachweisinformationen nicht in der Ausgabe angezeigt.
    Hinweis:
    • Sie können nicht angeben Show_extended_evidence=1 In derselben Anforderung wie Hide_evidence=1 . 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.
    Ursache_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 Datensätze mit Informationen zur Compliance-Situation für eine angegebene Richtlinie an. Eine gültige Richtlinien-ID ist erforderlich.
    details Alle

    Gibt die Detailstufe an, die für angezeigt wird Haltungen Abgerufen.

    Es ist sicher, Änderungen gemäß Ihren Anforderungen vorzunehmen.
    Show_Remediation_info (Optional) auf 1 festlegen, 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 der Qualys PCRS-Richtlinie Host-Integration

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

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

    Richtlinien-IDs für die Compliance-Bewertung.

    Integration von Qualys PCRS-Testergebnissen

    Die Tabelle zeigt die gesendeten Anforderungsparameter.

    Tabelle : 6. REST-Nachrichtenparameter der Qualys PCRS-Testergebnisintegration
    Parametername Wert Beschreibung
    Nachweisangefordert ${lastRunDatetime}
    • Der Standardwert ist 0, was angibt, dass Nachweisdaten für die Host-Situation nicht abgerufen werden.
    • Legen Sie den Wert auf 1 fest, um die Nachweisdaten abzurufen.
      Hinweis:
      Wenn Sie den Wert in 1 ändern, wird die Zeit erhöht, die zum Abrufen von Positionsdaten erforderlich ist.
    Komprimierenangefordert
    • 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 Positionsdaten erforderlich ist.