Humio

통합 버전: 5.0

Google Security Operations에서 Humio 통합 구성

Google SecOps에서 통합을 구성하는 방법에 대한 자세한 내용은 통합 구성을 참고하세요.

통합 매개변수

다음 매개변수를 사용하여 통합을 구성합니다.

매개변수 표시 이름 유형 기본값 필수 항목 설명
API 루트 문자열 https://cloud.us.humio.com 예 Humio 인스턴스의 API 루트입니다.
API 토큰 비밀번호 해당 사항 없음 예 Humio 인스턴스의 API 토큰입니다.
SSL 확인 체크박스 선택 예 사용 설정한 경우 Humio 서버 연결에 대한 SSL 인증서가 유효한지 확인합니다.

사용 사례

  1. 저장소에서 이벤트 수집 실행
  2. 검색 수행

작업

핑

설명

Google Security Operations Marketplace 탭의 통합 구성 페이지에서 제공된 매개변수를 사용하여 Humio에 대한 연결을 테스트합니다.

매개변수

해당 사항 없음

실행

이 작업은 항목에서 실행되지 않거나 필수 입력 매개변수가 없습니다.

작업 결과

스크립트 결과
스크립트 결과 이름 값 옵션 예
is_success True/False is_success:False
케이스 월
결과 유형 값 / 설명 유형
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

성공한 경우: '제공된 연결 매개변수를 사용하여 Humio 서버에 성공적으로 연결되었습니다.'

작업이 실패하고 플레이북 실행을 중지합니다.

실패한 경우: 'Humio 서버에 연결할 수 없습니다. 오류: {0}".format(exception.stacktrace)

 일반

설명

Humio의 매개변수를 기반으로 이벤트를 검색합니다.

매개변수

매개변수 표시 이름 유형 기본값 필수 항목 설명
저장소 이름 문자열 해당 사항 없음 예 검색할 저장소의 이름을 지정합니다.
쿼리 필터 문자열 해당 사항 없음 아니요

검색 중에 실행해야 하는 쿼리를 지정합니다.

참고: 'head()' 및 'select()' 함수는 제공하면 안 됩니다.
기간 DDL

지난 1시간

가능한 값은 다음과 같습니다.

  • 지난 1시간
  • 지난 6시간
  • 지난 24시간
  • 지난주
  • 지난달
  • 커스텀
 No

결과 기간을 지정합니다.

'맞춤'을 선택한 경우 '시작 시간' 매개변수도 제공해야 합니다.
시작 시간 문자열 해당 사항 없음 No

결과 시작 시간을 지정합니다.

'기간' 매개변수에 '커스텀'을 선택한 경우 이 매개변수는 필수 항목입니다.

형식: ISO 8601
종료 시간 문자열 해당 사항 없음 No

결과 종료 시간을 지정합니다.

형식: ISO 8601.

아무것도 제공하지 않고 '기간' 매개변수에 '커스텀'을 선택하면 이 매개변수는 현재 시간을 사용합니다.
반환할 필드 CSV 해당 사항 없음 아니요

반환할 필드를 지정합니다.

아무것도 제공되지 않으면 작업에서 모든 필드를 반환합니다.
필드 정렬 문자열 해당 사항 없음 아니요

정렬에 사용해야 하는 매개변수를 지정합니다.

기본적으로 쿼리는 타임스탬프를 기준으로 데이터를 오름차순으로 정렬합니다.
정렬 필드 유형 DDL

문자열

가능한 값은 다음과 같습니다.

  • 문자열
  • 숫자
  • Hex
 아니요

정렬에 사용되는 필드의 유형을 지정합니다.

이 매개변수는 올바른 결과가 반환되도록 하는 데 필요합니다.
정렬 순서 DDL

ASC

가능한 값은 다음과 같습니다.

  • ASC
  • DESC
 No 정렬 순서를 지정합니다.
반환할 최대 결과 수 정수 50 아니요 반환할 결과 수를 지정합니다.

실행

이 작업은 항목에서 실행되지 않습니다.

작업 결과

스크립트 결과
스크립트 결과 이름 값 옵션 예
is_success True/False is_success:False
JSON 결과
[
  {
    "@timestamp": 1636028056292,
    "@rawstring": {
      "actor": {
        "ip": "31.43.227.151",
        "orgRoot": false,
        "organizationId": "z4ApqmrB7XbvsQB5E1muelI4WAKz4buZ",
        "proxyRequest": false,
        "type": "orgUser",
        "user": {
          "id": "MgPXnBAKQ4gCg25hW5jKhYTo",
          "isRoot": false,
          "username": "dana@example.com"
        }
      },
      "method": "google",
      "sensitive": false,
      "timestamp": "2021-11-04T12:14:16.292Z",
      "type": "user.signin"
    },
    "@id": "gZPMhXMMcScGXHwxZ7bRH6Ns_88_264_1636028056"
  },
  {
    "@timestamp": 1636028057934,
    "@rawstring": {
      "actor": {
        "ip": "31.43.227.151",
        "orgRoot": false,
        "organizationId": "z4ApqmrB7XbvsQB5E1muelI4WAKz4buZ",
        "proxyRequest": false,
        "type": "orgUser",
        "user": {
          "id": "MgPXnBAKQ4gCg25hW5jKhYTo",
          "isRoot": false,
          "username": "dana@example.com"
        }
      },
      "sensitive": false,
      "timestamp": "2021-11-04T12:14:17.934Z",
      "type": "notifications.user.create"
    },
    "@id": "lSLLg2gMDW8GwHtpZTGD8GU1_65_108_1636028057"
  }
]
케이스 월
결과 유형 값 / 설명 유형
결과 유형 값/설명 유형
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

결과가 하나 이상 발견된 경우 (is_success=true): 'Humio에서 '{query}' 쿼리의 결과를 성공적으로 반환했습니다."

결과가 없는 경우 (is_succees=true): 'Humio에서 '{query}' 쿼리에 대한 결과를 찾을 수 없습니다.'

작업이 실패하고 플레이북 실행을 중지합니다.

잘못된 사용자 인증 정보, 서버 연결 없음과 같은 치명적인 오류가 보고되는 경우: ''간단한 검색 실행' 작업 실행 중에 오류가 발생했습니다. 이유: {0}'.format(error.Stacktrace)

400 상태 코드가 보고된 경우: '간단한 검색 실행' 작업을 실행하는 중에 오류가 발생했습니다. 이유: {0}''.format(response)

404 상태 코드가 보고된 경우: '맞춤 검색 실행' 작업을 실행하는 중에 오류가 발생했습니다. 이유: {0}''.format(response)

 일반
케이스 월 이름: 결과 일반

설명

Humio에서 맞춤 쿼리를 사용하여 이벤트를 검색합니다.

매개변수

매개변수 표시 이름 유형 기본값 필수 항목 설명
저장소 이름 문자열 해당 사항 없음 예 검색할 저장소의 이름을 지정합니다.
쿼리 문자열 해당 사항 없음 예

Humio에서 실행해야 하는 쿼리를 지정합니다.

참고: 'head()' 함수는 이 문자열에 포함되지 않아야 합니다.
반환할 최대 결과 수 정수 50 아니요 반환할 결과 수를 지정합니다.

실행

이 작업은 항목에서 실행되지 않습니다.

작업 결과

스크립트 결과
스크립트 결과 이름 값 옵션 예
is_success True/False is_success:False
JSON 결과
[
  {
    "@timestamp": 1636028056292,
    "@rawstring": {
      "actor": {
        "ip": "31.43.227.151",
        "orgRoot": false,
        "organizationId": "z4ApqmrB7XbvsQB5E1muelI4WAKz4buZ",
        "proxyRequest": false,
        "type": "orgUser",
        "user": {
          "id": "MgPXnBAKQ4gCg25hW5jKhYTo",
          "isRoot": false,
          "username": "dana@example.com"
        }
      },
      "method": "google",
      "sensitive": false,
      "timestamp": "2021-11-04T12:14:16.292Z",
      "type": "user.signin"
    },
    "@id": "gZPMhXMMcScGXHwxZ7bRH6Ns_88_264_1636028056"
  },
  {
    "@timestamp": 1636028057934,
    "@rawstring": {
      "actor": {
        "ip": "31.43.227.151",
        "orgRoot": false,
        "organizationId": "z4ApqmrB7XbvsQB5E1muelI4WAKz4buZ",

              "proxyRequest": false,
        "type": "orgUser",
        "user": {
          "id": "MgPXnBAKQ4gCg25hW5jKhYTo",
          "isRoot": false,
          "username": "dana@example.com"
        }
      },
      "sensitive": false,
      "timestamp": "2021-11-04T12:14:17.934Z",
      "type": "notifications.user.create"
    },
    "@id": "lSLLg2gMDW8GwHtpZTGD8GU1_65_108_1636028057"
  }
]
케이스 월
결과 유형 값 / 설명 유형
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

결과를 하나 이상 찾은 경우 (is_success=true): 'Humio에서 '{query}' 쿼리의 결과를 성공적으로 반환했습니다.'

결과가 없는 경우 (is_succees=true): 'Humio에서 '{query}' 쿼리에 대한 결과를 찾을 수 없습니다.'

작업이 실패하고 플레이북 실행을 중지합니다.

잘못된 사용자 인증 정보, 서버 연결 없음과 같은 치명적인 오류가 보고되는 경우: ''맞춤 검색 실행' 작업 실행 중에 오류가 발생했습니다.' 이유: {0}'.format(error.Stacktrace)

400 상태 코드가 보고된 경우: '맞춤 검색 실행' 작업을 실행하는 동안 오류가 발생했습니다. 이유: {0}''.format(response)

404 상태 코드가 보고된 경우: '맞춤 검색 실행' 작업을 실행하는 중에 오류가 발생했습니다. 이유: {0}''.format(response)

 일반
케이스 월 이름: 결과 일반

커넥터

Humio - Events Connector(Humio - 이벤트 커넥터)

설명

Humio에서 저장소의 이벤트에 관한 정보를 가져옵니다.

Google SecOps에서 Humio - Events Connector 구성

Google SecOps에서 커넥터를 구성하는 방법에 대한 자세한 내용은 커넥터 구성을 참고하세요.

커넥터 매개변수

다음 매개변수를 사용하여 커넥터를 구성합니다.

매개변수 표시 이름 유형 기본값 필수 항목 설명
제품 필드 이름 문자열 제품 이름 예 제품 필드 이름을 가져오려면 소스 필드 이름을 입력합니다.
이벤트 필드 이름 문자열 event_field 예 이벤트 필드 이름을 가져오려면 소스 필드 이름을 입력합니다.
환경 필드 이름 문자열 "" 아니요

환경 이름이 저장된 필드의 이름을 설명합니다.

환경 필드를 찾을 수 없으면 환경이 기본 환경입니다.
환경 정규식 패턴 문자열 .* 아니요

'환경 필드 이름' 필드에 있는 값에서 실행할 정규식 패턴입니다.

기본값은 .*로서 모두 포착하고 변경되지 않은 값을 반환합니다.

사용자가 정규식 로직을 통해 환경 필드를 조작할 수 있도록 허용하는 데 사용됩니다.

정규식 패턴이 null이거나 비어 있거나 환경 값이 null인 경우 최종 환경 결과는 기본 환경입니다.
스크립트 제한 시간(초) 정수 360 예 현재 스크립트를 실행하는 Python 프로세스의 제한 시간 한도입니다.
API 루트 문자열 https://cloud.us.humio.com 예 Humio 인스턴스의 API 루트입니다.
API 토큰 비밀번호 해당 사항 없음 아니요 Humio 인스턴스의 API 토큰입니다.
저장소 이름 문자열 해당 사항 없음 예 결과에서 가져올 저장소의 이름입니다.
쿼리 문자열 해당 사항 없음 아니요 이벤트를 쿼리합니다. 참고: select() 및 head() 함수는 여기에 추가하면 안 됩니다.
알림 필드 이름 문자열 해당 사항 없음 아니요 경고 이름에 사용해야 하는 키의 이름입니다. 아무것도 제공되지 않거나 잘못된 값이 제공되면 커넥터는 'Humio Alert'를 대체로 사용합니다.
심각도 필드 이름 CSV 해당 사항 없음 예 심각도 매핑에 사용해야 하는 키의 쉼표로 구분된 목록입니다. 참고: 키에 'string' 값이 포함된 경우 '심각도 매핑 JSON'으로 매핑해야 합니다. 잘못된 키가 제공되면 '심각도 매핑 JSON' 매개변수의 '기본값'이 사용됩니다.
심각도 매핑 JSON JSON

{

"fieldName": {

"value_1": 100,

"value_2": 75,

"value_3": -1

},

'Default': 50

}

 예 매핑된 문자열 값이 있는 모든 키를 포함하는 JSON 객체입니다. 참고: 'Default' 키는 필수입니다.
최대 이전 시간 정수 1 No 이벤트를 가져올 위치의 시간입니다.
가져올 최대 이벤트 수 정수 20 아니요 커넥터 반복당 처리할 이벤트 수입니다.
허용 목록을 차단 목록으로 사용 체크박스 선택 예 사용 설정하면 허용 목록이 차단 목록으로 사용됩니다.
SSL 확인 체크박스 선택 예 사용 설정하면 Humio 연결에 사용되는 SSL 인증서가 유효한지 확인합니다.
프록시 서버 주소 문자열 해당 사항 없음 아니요 사용할 프록시 서버의 주소입니다.
프록시 사용자 이름 문자열 해당 사항 없음 아니요 인증할 프록시 사용자 이름입니다.
프록시 비밀번호 비밀번호 해당 사항 없음 아니요 인증할 프록시 비밀번호입니다.

커넥터 규칙

프록시 지원

커넥터가 프록시를 지원합니다.

도움이 더 필요하신가요? 커뮤니티 회원 및 Google SecOps 전문가로부터 답변을 받으세요.