Qualys REST 메시지

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 5분

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

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

    Qualys PC 정책 REST 메시지

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

    통합 보안 노출 관리 v12.21.0 Qualys Integration for Security Operations 및 v30.3.0부터 API 버전이 버전 5.0으로 업데이트되었습니다.

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

    필수 매개변수입니다.
    세부사항 모두

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

    요구 사항에 따라 수정해도 안전합니다.

    Qualys PC 통제 REST 메시지

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

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

    필수 매개변수입니다.
    세부사항 모두

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

    요구 사항에 따라 수정해도 안전합니다.

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

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

    통합 보안 노출 관리 v12.21.0 Qualys Integration for Security Operations 및 v30.3.0부터 API 버전이 버전 5.0으로 업데이트되었습니다.

    표 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에서 호스트 데이터를 검색하고 인스턴스에서 처리합니다.

    통합 보안 노출 관리 v12.21.0 Qualys Integration for Security Operations 및 v30.3.0부터 API 버전이 버전 5.0으로 업데이트되었습니다.

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

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

    Qualys PCRS 테스트 결과 통합

    다음 테이블에는 전송된 요청 매개변수가 표시됩니다.

    통합 보안 노출 관리 v12.21.0 Qualys Integration for Security Operations 및 v30.3.0부터 API 버전이 버전 5.0으로 업데이트되었습니다.

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

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

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

    통합 보안 노출 관리 v12.21.0 Qualys Integration for Security Operations 및 v30.3.0부터 API 버전이 버전 5.0으로 업데이트되었습니다.

    표 7. Qualys 종합 PCRS 정책 호스트 통합 REST 메시지 매개변수
    policyId ${policyId} 준수 평가를 위한 정책 ID입니다.

    Qualys 종합 PCRS 테스트 결과 통합

    다음 테이블에는 전송된 요청 매개변수가 표시됩니다.

    통합 보안 노출 관리 v12.21.0 Qualys Integration for Security Operations 및 v30.3.0부터 API 버전이 버전 5.0으로 업데이트되었습니다.

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