1-2. 타 시스템 로그 조회_V2

개요

API version

2025-03-11

• 최초 등록

용도 및 설명

타 시스템 로그 조회 API (V2)

1. 사용자가 특정 기간 동안의 모든 로그 데이터를 요청
2. 서버는 로그 데이터를 검색하고 파일로 저장
3. 로그 데이터를 스트리밍 방식으로 수신

Request

URI

Methods	URL
POST	/v1/siems/externalSearchV2

URI Parameters

Name	Type	필수	Description

Request Headers

Name	Type	필수	Description
Referer	string	true	라이선스 등록 시 사용된 연동 서비스스 도메인

Request Body

Name	Type	필수	Description
From	timestamp	true	시작 타임스탬프
To	timestamp	true	종료 타임스탬프
License	string	true	라이선스 키

Response

성공 HTTP Status Code 200 Body (JSON 형식)

Name	Type	Description
Total	int	전체 결과 수
Items	[]map[string]interface	검색 결과 항목들

실패 HTTP Status Code

HTTP status code	HTTP 메시지	설명
400	Bad Request	요청 정보 오류
401	Unauthorized	권한 없음
403	Forbidden
404	Not Found
429	Request limit exceeded	요청 제한 초과
500	Internal Server Error	예외발생
61001	fail to search	검색 실패
61002	Referer does not match system domain	Referer와 SystemDomain 불일치
61003	JSON conversion error	JSON 변환 오류

Example

요청

POST /v1/siems/externalSearchV2
Referer: https://example.com/app
Content-Type: application/json; charset=utf-8

{
    "from": 1752764400000, //1704067200000
    "to": 1753455599999,
    "license": "HWIX-1DGC0-MKQ6-B2HAF"
}

응답

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

"total": 19106,
"items": [
    {
        "_id": "C13A2017E48DFAC1B395955464C94FC8AC7BCEA5D1C3BAE68278D24436E10F17",
        "category": 2,
        "crc32": 3392553545,
        "description": "Acquire user token",
        "detail": "{\"reqAppName\":\"hwsong\",\"reqAppId\":\"35233744-0029-4d83-b1c4-3366bd229b59\",\"userAgent\":{\"operatingSystemName\":\"Windows NT\",\"operatingSystemNameVersion\":\"Windows >=10\",\"agentName\":\"Edge\",\"agentVersion\":\"138\",\"deviceClass\":\"Desktop\",\"deviceName\":\"Desktop\",\"client\":null},\"grantType\":\"password\",\"email\":\"admin@socam.info\"}",
        "detail1000": {
            "email": "admin@socam.info",
            "grantType": "password",
            "reqAppId": "35233744-0029-4d83-b1c4-3366bd229b59",
            "reqAppName": "hwsong",
            "userAgent": {
                "agentName": "Edge",
                "agentVersion": "138",
                "deviceClass": "Desktop",
                "deviceName": "Desktop",
                "operatingSystemName": "Windows NT",
                "operatingSystemNameVersion": "Windows >=10"
            }
        },
        "docId": "",
        "errorCode": 0,
        "errorDetail": {},
        "event": "POST_COMMON_OAUTH_TOKEN",
        "events": "AcquireToken",
        "id": "42323E0DF32E6FDFD957E2CC393D42E192D799F53E39239842DC484AFEAA6650",
        "inserttime": "2025-07-25 02:32:47.688",
        "ip": "10.14.10.20",
        "level": 3,
        "logLevel": "INFO",
        "logType": "USER",
        "serviceCode": 1000,
        "serviceHostname": "cloud-oauth-service-549f7db694-g9g92",
        "serviceId": "cloud-oauth-service",
        "serviceName": "IdGP",
        "sort": [
            1753410767688,
            "C13A2017E48DFAC1B395955464C94FC8AC7BCEA5D1C3BAE68278D24436E10F17"
        ],
        "tenantId": "3CJ55MSE-xLO7Sxt4-qUBKzbcs-XP2cgGEq",
        "time": 1753410767688,
        "traceId": "1000-2f5e3a5a-012c-4a17-b91c-b763af113cd9",
        "userId": "admin@socam.info"
    }, .... + 19000