Qualys REST 메시지

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기3분

    • Qualys REST 메시지는 준수 데이터를 가져오기 위해 Qualys API 를 호출하는 데 사용됩니다.

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

    Qualys PC 정책 REST 메시지

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

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

    필수 매개변수입니다.
    상세 정보 모두

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

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

    Qualys PC 통제 REST 메시지

    Qualys PC 통제 REST 메시지는 Qualys에서 다른 통제 ID에 대한 준수 통제 정보를 검색합니다.

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

    필수 매개변수입니다.
    상세 정보 모두

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

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

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

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

    표 3. Qualys PC 정책 세부사항 REST 메시지 매개변수
    매개변수 값 설명
    작업 목록 요청 중인 작업의 유형을 나타냅니다.

    필수 매개변수입니다.
    show_user_controls 부울
    • XML 출력에 UDC(사용자 정의 컨트롤)를 포함하려면 1로 설정합니다.

    • 지정하지 않으면 UDC가 포함되지 않습니다.

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

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

    Qualys PC 결과 REST 메시지

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

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

    필수 매개변수입니다. 변경하지 않는 것이 좋습니다.
    show_extended_evidence 부울
    • 출력에 확장된 증거 정보를 표시하려면 1로 설정합니다.
    • 0으로 설정하거나 지정하지 않으면 확장된 증거 정보가 출력에 표시되지 않습니다.
    주:
    • 동일한 요청에서 show_extended_evidence=1 을 hide_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 메시지 매개변수
    매개변수 이름 값 설명
    evidenceRequired ${lastRunDatetime}
    • 기본값은 0이며, 이는 호스트 상태에 대한 증거 데이터가 검색되지 않음을 나타냅니다.
    • 증거 데이터를 검색하려면 값을 1로 설정합니다.
      주:
      값을 1로 변경하면 상태 데이터를 가져오는 데 필요한 시간이 늘어납니다.
    압축필수
    • 기본값은 1이며, 출력이 압축됨을 나타냅니다.
    • 데이터가 압축되지 않도록 하려면 값을 0으로 설정합니다.
      주:
      데이터를 압축하지 않으면 상태 데이터를 가져오는 데 필요한 시간이 늘어납니다.