Qualys REST 메시지

  • 릴리스 버전: Washingtondc
  • 업데이트 날짜 2024년 02월 01일
  • 읽기3분
  • Qualys REST 메시지는 규정 준수 데이터를 가져오기 위해 Qualys API 를 호출하는 데 사용됩니다.

    다음 REST 메시지는 기본 시스템과 함께 제공됩니다.

    Qualys PC 정책 REST 메시지

    Qualys PC 정책 REST 메시지는 Qualys에서 정책 데이터를 검색합니다. REST 메시지 메서드 기록에 대한 변경 내용은 정책 정보를 검색하기 위해 Qualys에 대한 요청에 영향을 줍니다.

    표 1. Qualys PC 정책 REST 메시지 매개변수
    매개변수 이름 설명
    작업 list 요청된 운영 유형을 나타냅니다.

    필수 매개 변수입니다.

    상세 정보 모두

    검색된 정책에 대해 표시되는 세부 정보 수준을 나타냅니다.

    귀하의 요구 사항에 따라 수정하는 것이 안전합니다.

    Qualys PC 통제 REST 메시지

    Qualys PC 컨트롤 REST 메시지는 Qualys의 여러 컨트롤 ID에 대한 준수 컨트롤 정보를 검색합니다.

    표 2. Qualys PC 통제 REST 메시지 매개변수
    매개변수 이름 설명
    작업 list 요청된 운영 유형을 나타냅니다.

    필수 매개 변수입니다.

    상세 정보 모두

    검색된 컨트롤에 대해 표시되는 세부 정보 수준을 나타냅니다.

    귀하의 요구 사항에 따라 수정하는 것이 안전합니다.

    Qualys PC 정책 상세 정보 REST 메시지

    Qualys PC 정책 세부 정보 REST 메시지는 기술 및 섹션과 같은 전체 정책 세부 정보를 검색합니다.

    표 3. Qualys PC 정책 상세 정보 REST 메시지 매개변수
    매개변수 설명
    작업 list 요청되는 작업의 유형을 나타냅니다.

    필수 매개 변수입니다.

    show_user_controls 부울
    • XML 출력에 UDC(사용자 정의 제어)를 포함하려면 1로 설정하십시오.
    • 지정하지 않으면 UDC가 포함되지 않습니다.

    선택적 매개 변수입니다. 귀하의 요구 사항에 따라 수정하는 것이 안전합니다.

    show_appendix 부울

    (선택 사항) XML 출력에 부록 섹션을 표시하려면 1로 설정합니다. 지정되지 않은 경우.

    Qualys PC 결과 REST 메시지

    Qualys PC 결과 REST 메시지는 Qualys에서 규정 준수 태세 기록을 검색합니다.

    표 4. Qualys PC 결과 REST 메시지 매개변수
    소스 필드 설명
    작업 list 요청된 운영 유형을 나타냅니다.

    필수 매개 변수입니다. 변경하지 않는 것이 좋습니다.

    show_extended_evidence 부울
    • 출력에 확장 증거 정보를 표시하려면 1로 설정합니다.
    • 0으로 설정하거나 지정되지 않은 경우 확장된 증거 정보가 출력에 표시되지 않습니다.
    주:
    • hide_evidence=1과 동일한 요청에서 show_extended_evidence=1을 지정할 수 없습니다. 이로 인해 오류가 발생합니다. 확장된 증거는 증거 데이터의 일부이며 증거 데이터가 표시되는 경우에만 표시됩니다.
    • 이 매개변수는 기본 시스템과 함께 제공되지 않습니다.
    cause_of_failure 부울

    '1'을 전달하면 Qualys가 실패 원인을 반환합니다.

    '0'을 전달하면 Qualys는 이러한 특성을 반환하지 않습니다.

    주:
    이 매개변수는 기본 시스템과 함께 제공되지 않습니다.
    policy_id 지정된 정책에 대한 규정 준수 태세 정보 기록을 표시합니다. 유효한 정책 ID가 필요합니다.
    상세 정보 모두

    검색된 자세에 대해 표시되는 상세 정보 수준을 나타냅니다.

    귀하의 요구 사항에 따라 수정하는 것이 안전합니다.

    show_remediation_info (선택 사항) XML 또는 CSV 출력에 정정 정보를 표시하려면 1로 설정합니다. 기본적으로 출력에는 정정 정보가 포함되지 않습니다. 지정하지 않으면 정정 정보가 출력에 포함되지 않습니다.

    Qualys PCRS 정책 호스트 통합 REST 메시지

    Qualys PCRS 정책 호스트 통합은 Qualys에서 호스트 데이터를 검색하여 인스턴스에서 처리합니다.

    표 5. Qualys PCRS 정책 호스트 통합 REST 메시지 매개 변수
    매개변수 이름 설명
    policyId ${lastRunDatetime}

    규정 준수 평가를 위한 정책 ID입니다.

    Qualys PCRS 테스트 결과 통합

    이 표에는 전송되는 요청 매개변수가 표시됩니다.

    표 6. Qualys PCRS 테스트 결과 통합 REST 메시지 매개변수
    매개변수 이름 설명
    증거필수 ${lastRunDatetime}
    • 기본값은 0이며, 이는 호스트 자세에 대한 증거 데이터가 검색되지 않음을 나타냅니다.
    • 증거 데이터를 검색하려면 값을 1로 설정합니다.
      주:
      값을 1로 변경하면 포스처 데이터를 가져오는 데 필요한 시간이 늘어납니다.
    compressionRequired
    • 기본값은 1이며, 이는 출력이 압축됨을 나타냅니다.
    • 데이터를 압축하지 않으려면 값을 0으로 설정합니다.
      주:
      데이터를 압축하지 않으면 상태 데이터를 가져오는 데 필요한 시간이 늘어납니다.