로그 지점

통합 버전: 16.0

사용 사례

활성 작업 실행 - 쿼리를 실행하여 엔티티에 관한 자세한 정보를 가져옵니다.

Google Security Operations에서 Logpoint 통합 구성

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

통합 매개변수

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

매개변수 표시 이름 유형 기본값 필수 항목 설명
IP 주소 문자열 https://x.x.x.x 예 Logpoint 인스턴스의 IP 주소입니다.
사용자 이름 문자열 해당 사항 없음 예 Logpoint 계정의 사용자 이름입니다.
보안 비밀 비밀번호 해당 사항 없음 예 Logpoint 계정의 보안 API 키
CA 인증서 파일 문자열 해당 사항 없음 No Base64로 인코딩된 CA 인증서 파일입니다.
SSL 확인 체크박스 선택 예 사용 설정하면 Logpoint 서버 연결에 대한 SSL 인증서가 유효한지 확인합니다.

작업

핑

설명

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

매개변수

해당 사항 없음

실행

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

작업 결과

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

작업이 실패하지 않거나 플레이북 실행을 중지하지 않아야 합니다.
성공한 경우: '제공된 연결 매개변수로 Logpoint 서버에 성공적으로 연결되었습니다.'

작업이 실패하고 플레이북 실행이 중지되어야 합니다.
실패한 경우: 'Logpoint 서버에 연결할 수 없습니다. 오류: {0}".format(exception.stacktrace)

 일반

쿼리 실행

설명

Logpoint에서 검색 쿼리를 실행합니다.

매개변수

매개변수 표시 이름 유형 기본값 필수 항목 설명
쿼리 문자열 해당 사항 없음 예 로그 지점에서 실행해야 하는 쿼리를 지정합니다.
기간 DDL

지난 24시간

가능한 값:
지난 1시간

지난 12시간

지난 24시간

지난 30일

지난 365일

커스텀

예 쿼리의 기간을 지정합니다. '맞춤'을 선택한 경우 시작 시간과 종료 시간도 제공해야 합니다.
시작 시간 문자열 해당 사항 없음 아니요

쿼리의 시작 시간을 지정합니다. 형식:

YYYY-MM-DDThh:mm:ssZ 또는 타임스탬프
종료 시간 문자열 해당 사항 없음 아니요

쿼리의 종료 시간을 지정합니다.형식:

YYYY-MM-DDThh:mm:ssZ 또는 타임스탬프 아무것도 제공되지 않으면 작업에서 현재 시간을 종료 시간으로 사용합니다.
Repos CSV 해당 사항 없음 아니요 저장소 이름을 쉼표로 구분된 목록으로 지정합니다. 아무것도 제공하지 않으면 작업이 모든 저장소에서 검색합니다.
반환할 최대 결과 수 정수 100 아니요 반환할 결과 수를 지정합니다.

실행

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

작업 결과

스크립트 결과
스크립트 결과 이름 값 옵션
is_success is_success=False
is_success is_success=True
JSON 결과
{
    "query_type": "simple",
    "rows": [
        {
            "msg": "2021-01-10 10:27:50 Benchmarker; reporting speed; service=norm_front; actual_mps=1; doable_mps=19096;",
            "log_ts": 1610274470,
            "actual_mps": "1",
            "doable_mps": "19096",
            "_type_str": "_tz device_name msg source_name col_type object norm_id service collected_at label device_ip
    _enrich_policy action _fromV550 repo_name logpoint_name",
    "device_name": "localhost",
            "_offset": 48317,
            "logpoint_name": "Logpoint",
            "action": "reporting speed",
            "repo_name": "_logpoint",
            "source_name": "/opt/immune/var/log/benchmarker/norm_front.log",
            "col_ts": 1610274470,
            "_tz": "UTC",
            "norm_id": "Logpoint",
            "_identifier": "0",
            "collected_at": "Logpoint",
            "device_ip": "127.0.0.1",
            "service": "norm_front",
            "_fromV550": "t",
            "_enrich_policy": "None",
            "_type_num": "actual_mps doable_mps col_ts sig_id log_ts _offset _identifier",
            "_type_ip": "device_ip",
            "sig_id": "10505",
            "col_type": "filesystem",
            "object": "Benchmarker",
            "_labels": [
                "Logpoint",
                "Benchmarker"
            ]
        }
    ],
    "version": 6,
    "extracted_terms": [],
    "time_range": [
        1609496280,
        1610274480
    ],
    "orig_search_id": "9acac4a0-e530-4a19-a446-e17d4d9f8aae",
    "success": true,
    "final": true,
    "totalPages": 1,
    "estim_count": 185003,
    "complete": true,
    "status": {
        "Logpoint": {
            "default": {
                "@class": "com.logpoint.libcommon.merger.api.SimpleStatus",
                "estim_count": 3,
                "final": true
            },
            "_logpoint": {
                "@class": "com.logpoint.libcommon.merger.api.SimpleStatus",
                "estim_count": 185000,
                "final": true
            },
            "LogSource1": {
                "@class": "com.logpoint.libcommon.merger.api.SimpleStatus",
                "estim_count": 0,
                "final": true
            },
            "_LogpointAlerts": {
                "@class": "com.logpoint.libcommon.merger.api.SimpleStatus",
                "estim_count": 0,
                "final": true
            }
        }
    }
}
케이스 월
결과 유형 값 / 설명 유형
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.
모든 요청에 대해 success == true인 경우 (is_success = true): 'Logpoint에서 쿼리를 실행하고 결과를 가져왔습니다.'

모든 요청의 success가 true이지만 결과가 없는 경우 (is_success=false): '제공된 쿼리에 대한 데이터를 찾을 수 없습니다.'

하나 이상의 요청에서 success == false인 경우 (is_success = false): '작업에서 Logpoint에서 쿼리를 실행하고 결과를 가져올 수 없습니다. 이유: {0}'.format(message)

비동기 메시지

'Logpoint에서 쿼리 처리가 완료되기를 기다리는 중'

작업이 실패하고 플레이북 실행을 중지해야 합니다.
잘못된 사용자 인증 정보, 서버 연결 없음과 같은 치명적인 오류가 발생한 경우: '질의 실행' 작업을 실행하는 중에 오류가 발생했습니다. 이유: {0}''.format(error.Stacktrace)

시간 초과인 경우:

'쿼리 실행' 작업을 실행하는 동안 오류가 발생했습니다. 이유: 작업 제한 시간이 초과되었습니다. 기간을 좁히거나 반환할 결과 수를 줄이세요.

하나 이상의 저장소를 찾을 수 없는 경우:

'Error executing action "Execute Query". 이유: 다음 저장소가 Logpoint에서 발견되지 않았습니다. {0} 모든 저장소를 사용할 수 있는지 확인하세요'.format(찾을 수 없는 저장소의 쉼표로 구분된 목록)

'맞춤'을 선택했지만 '시작 시간'이 제공되지 않은 경우:

'Error executing action "Execute Query". 이유: 기간에 '맞춤'을 선택한 경우 '시작 시간'을 제공해야 합니다.'

 일반
케이스 월 테이블

표 이름: '결과'

대답의 모든 열이 표 열로 사용됩니다.

 일반

엔티티 쿼리 실행

설명

엔티티를 기반으로 Logpoint에서 쿼리를 실행합니다. 현재 지원되는 항목 유형: 사용자, IP, 이메일 주소, URL, 파일 해시, 호스트 이름 참고: 이메일 주소는 이메일 주소 형식과 일치하는 사용자 엔티티입니다.

작업 매개변수 사용 방법

이 작업을 통해 항목과 관련된 정보를 쉽게 검색할 수 있습니다. 예를 들어 복잡한 쿼리 빌드 없이 제공된 해시에 영향을 받는 엔드포인트의 로그 양을 확인하려는 사용 사례를 해결할 수 있습니다.

Logpoint에서 이 문제를 해결하려면 다음 쿼리를 준비해야 합니다. ("device_ip"="10.0.0.1" or "device_ip"="10.0.0.2") and ("hash"="7694f4a66316e53c8cdd9d9954bd611d" or "hash"="8264ee52f589f4c0191aa94f87aa1aeb") | chart count() by device_ip

'엔티티 쿼리 실행' 작업을 사용하여 동일한 쿼리를 만들려면 다음과 같이 작업 매개변수를 작성해야 합니다.

쿼리 | chart count() by device_ip
IP 엔티티 키 device_ip
파일 해시 항목 키 해시
교차 항목 연산자 AND

다른 필드는 모두 비워 둘 수 있습니다.

제공된 해시의 영향을 받은 엔드포인트 수를 확인하는 것이 사용 사례인 경우 '엔티티 쿼리 실행'의 구성은 다음과 같습니다.

쿼리 | chart count() by device_ip
파일 해시 항목 키 해시

이 경우 '교차 항목 연산자'는 여러 '항목 키'가 제공될 때만 쿼리에 영향을 미치므로 영향을 미치지 않습니다.

매개변수

매개변수 표시 이름 유형 기본값 필수 항목 설명
쿼리 문자열 예 실행해야 하는 쿼리를 지정합니다. 자세한 내용은 작업 문서를 참고하세요.
기간 DDL

지난 24시간

가능한 값:
지난 1시간

지난 12시간

지난 24시간

지난 30일

지난 365일

커스텀

예 쿼리의 기간을 지정합니다. '맞춤'을 선택한 경우 시작 시간도 제공해야 합니다. 종료 시간은 기본적으로 현재 시간을 사용합니다.
시작 시간 문자열 아니요

쿼리의 시작 시간을 지정합니다. 형식:

YYYY-MM-DDThh:mm:ssZ 또는 타임스탬프
종료 시간 문자열 아니요

쿼리의 종료 시간을 지정합니다.형식:

YYYY-MM-DDThh:mm:ssZ 또는 타임스탬프 아무것도 제공되지 않으면 작업에서 현재 시간을 종료 시간으로 사용합니다.
Repos CSV 아니요 저장소 이름을 쉼표로 구분된 목록으로 지정합니다. 아무것도 제공하지 않으면 작업이 모든 저장소에서 검색합니다.
IP 엔티티 키 문자열 아니요 IP 엔티티와 함께 사용할 키를 지정합니다. 자세한 내용은 작업 문서를 참고하세요.
호스트 이름 항목 키 문자열 아니요 준비할 때 호스트 이름 엔티티와 함께 사용할 키를 지정합니다 . 자세한 내용은 작업 문서를 참고하세요.
파일 해시 항목 키 아니요 파일 해시 항목과 함께 사용할 키를 지정합니다. 자세한 내용은 작업 문서를 참고하세요.
사용자 항목 키 아니요 사용자 엔티티와 함께 사용할 키를 지정합니다. 자세한 내용은 작업 문서를 참고하세요.
URL 항목 키 아니요 URL 엔티티와 함께 사용할 키를 지정합니다. 자세한 내용은 작업 문서를 참고하세요.
이메일 주소 엔티티 키 아니요 이메일 주소 항목과 함께 사용할 키를 지정합니다. 자세한 내용은 작업 문서를 참고하세요.
항목이 충분하지 않으면 중지 체크박스 선택 예 사용 설정된 경우 지정된 '.. 항목 키'에 대해 모든 항목 유형을 사용할 수 있어야 작업이 실행됩니다. 예: 'IP 엔티티 키'와 '파일 해시 엔티티 키'가 지정되었지만 범위에 파일 해시가 없는 경우 이 매개변수가 사용 설정되면 작업에서 쿼리를 실행하지 않습니다.
교차 항목 연산자 DDL

또는

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

또는

AND

 예 서로 다른 항목 유형 간에 사용해야 하는 논리 연산자를 지정합니다.
반환할 최대 결과 수 정수 100 아니요 반환할 결과 수를 지정합니다.

실행

이 작업은 다음 항목에서 실행됩니다.

  • IP 주소
  • 호스트
  • 사용자
  • 해시
  • URL

작업 결과

스크립트 결과
스크립트 결과 이름 값 옵션
is_success is_success=False
is_success is_success=True
JSON 결과
{
    "query_type": "simple",
    "rows": [
        {
            "msg": "2021-01-10 10:27:50 Benchmarker; reporting speed; service=norm_front; actual_mps=1; doable_mps=19096;",
            "log_ts": 1610274470,
            "actual_mps": "1",
            "doable_mps": "19096",
            "_type_str": "_tz device_name msg source_name col_type object norm_id service collected_at label device_ip
    _enrich_policy action _fromV550 repo_name logpoint_name",
    "device_name": "localhost",
            "_offset": 48317,
            "logpoint_name": "Logpoint",
            "action": "reporting speed",
            "repo_name": "_logpoint",
            "source_name": "/opt/immune/var/log/benchmarker/norm_front.log",
            "col_ts": 1610274470,
            "_tz": "UTC",
            "norm_id": "Logpoint",
            "_identifier": "0",
            "collected_at": "Logpoint",
            "device_ip": "127.0.0.1",
            "service": "norm_front",
            "_fromV550": "t",
            "_enrich_policy": "None",
            "_type_num": "actual_mps doable_mps col_ts sig_id log_ts _offset _identifier",
            "_type_ip": "device_ip",
            "sig_id": "10505",
            "col_type": "filesystem",
            "object": "Benchmarker",
            "_labels": [
                "Logpoint",
                "Benchmarker"
            ]
        }
    ],
    "version": 6,
    "extracted_terms": [],
    "time_range": [
        1609496280,
        1610274480
    ],
    "orig_search_id": "9acac4a0-e530-4a19-a446-e17d4d9f8aae",
    "success": true,
    "final": true,
    "totalPages": 1,
    "estim_count": 185003,
    "complete": true,
    "status": {
        "Logpoint": {
            "default": {
                "@class": "com.logpoint.libcommon.merger.api.SimpleStatus",
                "estim_count": 3,
                "final": true
            },
            "_logpoint": {
                "@class": "com.logpoint.libcommon.merger.api.SimpleStatus",
                "estim_count": 185000,
                "final": true
            },
            "LogSource1": {
                "@class": "com.logpoint.libcommon.merger.api.SimpleStatus",
                "estim_count": 0,
                "final": true
            },
            "_LogpointAlerts": {
                "@class": "com.logpoint.libcommon.merger.api.SimpleStatus",
                "estim_count": 0,
                "final": true
            }
        }
    }
}
케이스 월
결과 유형 값 / 설명 유형
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.
모든 요청에 대해 success == true인 경우 (is_success = true): 'Logpoint에서 쿼리를 실행하고 결과를 가져왔습니다.'

모든 요청의 success가 true이지만 결과가 없는 경우 (is_success=false): '제공된 쿼리에 대한 데이터를 찾을 수 없습니다.'

하나 이상의 요청에서 success == false인 경우 (is_success = false): '작업에서 Logpoint에서 쿼리를 실행하고 결과를 가져올 수 없습니다. 이유: {0}'.format(message)

비동기 메시지

'Logpoint에서 쿼리 처리가 완료되기를 기다리는 중'

'항목이 충분하지 않으면 중지'가 사용 설정되어 있고 제공된 '항목 키'에 사용할 수 있는 항목 유형이 충분하지 않은 경우(is_success=false): 지정된 '.. 항목 키'에 제공된 항목 유형이 충분하지 않아 작업을 통해 쿼리를 빌드할 수 없습니다. '항목이 충분하지 않은 경우 중지' 매개변수를 사용 중지하거나 지정된 '.. 항목 키'마다 하나 이상의 항목을 제공하세요.

작업이 실패하고 플레이북 실행을 중지해야 합니다.
잘못된 사용자 인증 정보, 서버 연결 없음과 같은 치명적인 오류가 발생한 경우: '항목 쿼리 실행' 작업을 실행하는 중에 오류가 발생했습니다. 이유: {0}''.format(error.Stacktrace)

시간 초과인 경우:

'엔티티 쿼리 실행' 작업을 실행하는 동안 오류가 발생했습니다. 이유: 작업 제한 시간이 초과되었습니다. 기간을 좁히거나 반환할 결과 수를 줄이세요.

리포지토리를 하나 이상 찾을 수 없는 경우:
"Error executing action "Execute Entity Query". 이유: 다음 저장소가 Logpoint에서 발견되지 않았습니다. {0} 모든 저장소를 사용할 수 있는지 확인하세요'.format(찾을 수 없는 저장소의 쉼표로 구분된 목록)

'Entity' 키가 지정되지 않은 경우:

'엔티티 쿼리 실행' 작업을 실행하는 동안 오류가 발생했습니다. 이유: '.. Entity Key' 매개변수를 하나 이상 지정하세요.

'맞춤'을 선택했지만 '시작 시간'이 제공되지 않은 경우:

'Error executing action "Execute Entity Query". 이유: 기간에 '맞춤'을 선택한 경우 '시작 시간'을 제공해야 합니다.'

 일반

케이스 월 테이블

표 이름: '결과'

대답의 모든 열이 표 열로 사용됩니다.

 일반

저장소 나열

설명

로그 지점에서 사용 가능한 저장소를 나열합니다.

매개변수

매개변수 표시 이름 유형 기본값 필수 항목 설명
반환할 최대 저장소 수 정수 100 아니요 반환할 보고서 수를 지정합니다.

실행

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

작업 결과

스크립트 결과
스크립트 결과 이름 값 옵션
is_success is_success=False
is_success is_success=True
JSON 결과
{
    "success": true,
    "allowed_repos": [
        {
            "repo": "default",
            "address": "127.0.0.1:5504/default"
        },
        {
            "repo": "_logpoint",
            "address": "127.0.0.1:5504/_logpoint"
        },
        {
            "repo": "_LogpointAlerts",
            "address": "127.0.0.1:5504/_LogpointAlerts"
        },
        {
            "repo": "LogSource1",
            "address": "127.0.0.1:5504/LogSource1"
        }
    ],
    "logpoint": [
        {
            "name": "Logpoint",
            "ip": "127.0.0.1"
        }
    ]
}
케이스 월
결과 유형 값 / 설명 유형
출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.
성공 == true인 경우 (is_success = true): 'Logpoint에서 사용 가능한 저장소 쿼리를 가져왔습니다.'

작업이 실패하고 플레이북 실행을 중지해야 합니다.
잘못된 사용자 인증 정보, 서버 연결 없음과 같은 치명적인 오류가 발생한 경우: ''저장소 나열' 작업을 실행하는 중에 오류가 발생했습니다. 이유: {0}'.format(error.Stacktrace)

 일반
케이스 월 테이블

표 이름: '사용 가능한 저장소'

이름 - allowed_repos/repo

주소 - allowed_repos/address

 일반

Update Incident Status(인시던트 상태 업데이트)

설명

Logpoint에서 인시던트 상태를 업데이트합니다.

매개변수

매개변수 표시 이름 유형 기본값 필수 항목 설명
사고 ID 문자열 해당 사항 없음 예 업데이트할 인시던트의 ID를 지정합니다.
작업 DLL

닫기

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

해결

닫기

 예 인시던트의 조치를 지정합니다.

실행

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

작업 결과

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

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.
success== true인 경우 (is_success = true): 'Logpoint에서 ID가 {1}인 인시던트를 {0}했습니다.'.format(resolved/closed, incident_id)

success== false인 경우(is_success = true): 'Logpoint에서 ID가 {1}인 인시던트에 {0} 실패'.format(resolve/close, incident_id)

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

잘못된 사용자 인증 정보, 서버 연결 없음과 같은 치명적인 오류의 경우: ''인시던트 상태 업데이트' 작업 실행 중에 오류가 발생했습니다.' 이유: {0}'.format(error.Stacktrace)

 일반

커넥터

로그 지점 - 인시던트 커넥터

설명

Logpoint에서 인시던트를 가져옵니다.

Google SecOps에서 Logpoint - Incidents Connector 구성

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

커넥터 매개변수

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

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

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

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

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

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

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

정규식 패턴이 null이거나 비어 있거나 환경 값이 null인 경우 최종 환경 결과는 기본 환경입니다.
스크립트 제한 시간(초) 정수 180 예 현재 스크립트를 실행하는 Python 프로세스의 제한 시간 한도입니다.
IP 주소 문자열 https://x.x.x.x 예 Logpoint 인스턴스의 IP 주소입니다.
사용자 이름 문자열 해당 사항 없음 예 Logpoint 계정의 사용자 이름입니다.
보안 비밀 비밀번호 해당 사항 없음 예 Logpoint 계정의 보안 비밀입니다.
최대 이전 시간 정수 1 아니요 인시던트를 가져올 위치의 시간입니다.
가져올 가장 낮은 위험도 문자열 해당 사항 없음 아니요

가져올 인시던트의 가장 낮은 위험입니다. 가능한 값은 다음과 같습니다.

심각, 높음, 보통, 낮음
가져올 최대 인시던트 수 정수 10 아니요 커넥터 반복당 처리할 인시던트 수입니다.
허용 목록을 차단 목록으로 사용 체크박스 선택 해제 예 사용 설정하면 허용 목록이 차단 목록으로 사용됩니다.
SSL 확인 체크박스 선택 해제 예 사용 설정하면 Logpoint 서버 연결에 사용되는 SSL 인증서가 유효한지 확인합니다.
CA 인증서 파일 문자열 해당 사항 없음 No Base64로 인코딩된 CA 인증서 파일입니다.
프록시 서버 주소 문자열 해당 사항 없음 아니요 사용할 프록시 서버의 주소입니다.
프록시 사용자 이름 문자열 해당 사항 없음 아니요 인증할 프록시 사용자 이름입니다.
프록시 비밀번호 비밀번호 해당 사항 없음 아니요 인증할 프록시 비밀번호입니다.
사용자 필터 CSV 해당 사항 없음 아니요 이슈를 필터링하는 데 사용되는 사용자 이름의 쉼표로 구분된 목록입니다. 유효한 사용자가 만든 인시던트만 수집됩니다. 아무것도 제공되지 않으면 이 필터가 적용되지 않으며 커넥터는 모든 사용자의 인시던트를 수집합니다.

커넥터 규칙

프록시 지원

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

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