# 정책 설정 이벤트

<mark style="background-color:green;">GET</mark> `https://openapi.exosp.com/audit/v2/admin/policy-setting`

정책 설정 이벤트를 조회하는 API 입니다.

### Query Parameters

<table><thead><tr><th>항목</th><th width="203.77734375">타입</th><th>설명</th></tr></thead><tbody><tr><td>offset<mark style="color:red;">*</mark></td><td>int</td><td><strong>((현재 페이지 번호 -1)*tableSize)</strong> 현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.</td></tr><tr><td>tableSize<mark style="color:red;">*</mark></td><td>int</td><td><strong>페이지 사이즈</strong></td></tr><tr><td>timezone</td><td>string</td><td><strong>응답 데이터 타임존</strong><a href="https://en.wikipedia.org/wiki/List_of_tz_database_time_zones">https://en.wikipedia.org/wiki/List_of_tz_database_time_zones</a> 에서 TZ identifier 참고기본값 : UTC</td></tr><tr><td>sortType<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 정렬 유형 (제어 시각 기준)</strong><br>ASC : 오름차순, DESC : 내림차순</td></tr></tbody></table>

### Response Schema

<table><thead><tr><th width="162">항목</th><th width="115">타입</th><th>설명</th></tr></thead><tbody><tr><td>code</td><td>int</td><td><p><strong>응답 처리 결과 코드</strong> </p><p>0 : 성공, 1 : 실패</p></td></tr><tr><td>message</td><td>string</td><td><p><strong>응답 처리 결과 메세지</strong></p><p>success : 성공, 그 외 : 실패</p></td></tr><tr><td>body</td><td>object</td><td><a data-mention href="#body">#body</a></td></tr></tbody></table>

#### **body 상세**

<table><thead><tr><th width="164">항목</th><th width="115">타입</th><th>설명</th></tr></thead><tbody><tr><td>total</td><td>int</td><td><strong>전체 레코드 수</strong></td></tr><tr><td>searchDate</td><td>string</td><td><strong>조회날짜</strong></td></tr><tr><td>data</td><td>array</td><td><a data-mention href="#data">#data</a></td></tr></tbody></table>

#### data **상세**

<table><thead><tr><th width="181">항목</th><th width="92.80859375">타입</th><th>설명</th></tr></thead><tbody><tr><td>name</td><td>string</td><td><strong>사용자 이름</strong></td></tr><tr><td>email</td><td>string</td><td><strong>사용자 메일</strong></td></tr><tr><td>departmentFull</td><td>string</td><td><strong>그룹 전체 경로</strong></td></tr><tr><td>policyType</td><td>string</td><td><p><strong>정책 타입 (메뉴명)-(정책명)-(기능)-(OS 종류)</strong><br></p><ul><li><p><strong>메뉴명</strong>  </p><ul><li>Vulnerability Check : PC 보안점검</li><li>Anti-Malware : 안티 바이러스</li><li>Ransomware Folder Protection : 랜섬웨어 방지</li><li>Web Protection : 웹 보호</li><li>Detect sensitive information : 개인(민감)정보 보호 </li><li>Data Loss Prevention : 정보 유출 방지</li><li>IT Operational Optimization : IT 운영최적화</li><li>Access Control : 접근제어</li><li>Security Management : 보안 관리</li><li>Agent Management : 에이전트 관리</li></ul></li></ul><p></p><ul><li><p><strong>정책명</strong> </p><ul><li>Full Scan Settings : 점검 정책</li><li>Real-time protection policy : 실시간 보호 정책 </li><li>Scheduled scan policy : 예약 검사 정책</li><li>Exception policy : 예외 정책</li><li>Real-time protection and exception policy : 실시간 보호 및 예외 정책</li><li>Real-time Scan : 실시간 검사정책</li><li>Scheduled Scan : 예약 검사정책</li><li>File Encryption : 확장자 기반 암호화 정책</li><li>Encryption Protection Control : 암호화 보호 정책</li><li>File Export Control : 파일반출 제어 정책</li><li>Device Control : 매체 제어 정책</li><li>Application Control : 애플리케이션 제어 정책</li><li>Screen Capture Control : 화면캡처 제어 정책</li><li>Print Control : 출력물 제어 정책</li><li>Web Control Policy : 웹 접속 관리 정책</li><li>File Export Backup Policy : 반출 파일 백업 정책</li><li>Policy settings : 정책 설정</li><li>Cloud Application : 클라우드 애플리케이션</li><li>In-House Application : 인하우스 애플리케이션</li><li>File Export Backup Policy : 반출 파일 백업 정책</li><li>Temporary Decryption Approval : 암호화 임시 해제 승인</li><li>Crypto Archive End Approval : 암호화 보관 종료 승인</li><li>Device Approval : 매체 승인</li><li>File Approval : 파일 반출 승인</li><li>Print Approval : 출력물 승인</li><li>Admin Access Security Management : 관리자 접속 보안 관리</li><li>Prevent Agent Deletion : 에이전트 삭제 방지설정</li><li>Agent Security Policy : 에이전트 무력화 방지</li><li>Agent Status and Deletion : 에이전트 현황 및 삭제</li><li>Account Security Management : 계정 보안 관리</li></ul></li><li><p><strong>기능</strong></p><ul><li>Function Activation : 기능 활성화</li><li>Security Settings : 보안 설정</li><li>Watermark Settings : 워터마크 설정</li><li>Integration Settings : 연동 설정</li><li>Exception Device Management : 예외 디바이스 관리</li><li>Exception IP Management : 예외 IP 관리</li><li>Prevent Agent Deletion : 에이전트 삭제 방지설정</li><li>Prevent Safe Mode Booting : 안전모드 부팅 방지설정</li><li>Prevent Multi-Booting : 멀티 부팅 방지설정</li><li>OS Time Zone Change Prevention : OS 시간대 변경 방지설정 </li></ul></li><li><p>OS 유형 </p><ul><li>Windows</li><li>MacOS</li><li>Common : 공통</li></ul></li></ul></td></tr><tr><td>policyTargetName</td><td>string</td><td><strong>정책 대상 이름</strong></td></tr><tr><td>eventType</td><td>string</td><td><ul><li><p><strong>이벤트 유형</strong></p><ul><li>Policy Group Setting : 정책 그룹 설정</li><li>Policy settings : 정책 설정</li><li>Feature Activation Setting : 기능 활성화 설정</li><li>Exception User Setting : 예외 사용자 설정</li><li>Scan option settings : 검사 옵션 설정</li><li>Inspection Exception Setting : 검사 예외 설정<br>Operating System Update : 운영체제 업데이트</li><li>Use Antivirus : 바이러스 백신 사용</li><li>Use Firewall : 방화벽 사용</li><li>Use Secure PC Password : 안전한 PC 비밀번호 사용</li><li>Periodic PC Password Change : 주기적인 PC 비밀번호 변경</li><li>Use Screen Saver : 화면 보호기 사용</li><li>Use Shared Folder : 공유 폴더 사용</li><li>Disable USB Auto-Run : USB 자동실행 해제</li><li>Software Update : 소프트웨어 업데이트</li><li>Use System Integrity Protection (SIP) : 시스템 무결성 보호(SIP) 사용</li><li>Block Unverified Apple Apps : Apple 미검증 앱 실행 차단</li><li>Set Inspection Schedule : 검사 예약 설정</li><li>Scan option settings : 검사 옵션 설정</li><li>Category Setting : 카테고리 설정</li><li>Set Website Exceptions : 웹사이트 예외 설정</li><li>Set Inspection Type : 검사 유형 설정</li><li>Set Inspection Rules - Personal Information Patterns : 검사 규칙 설정 - 개인 정보 패턴</li><li>Set Inspection Rules - Sensitive Information Keywords : 검사 규칙 설정 - 민감 정보 키워드</li><li>Set Exception Paths : 예외 경로 설정</li><li>Option Setting : 옵션 설정</li><li>Set Extensions : 확장자 설정</li><li>Individual Setting : 개별 설정</li><li>Website Exception Settings : 웹사이트 예외 설정</li><li>Extension Settings : 확장자 설정</li><li>Additional Settings : 추가 설정</li><li>SSO integration settings : SSO 연동 설정</li><li>SAML SSO Certificate : SAML SSO 인증서</li><li>Automatic linking settings for non-registered users : 미연동 사용자 자동 연동 설정</li><li>User integration settings : 사용자 연동 설정</li><li>Policy application settings : 정책 애플리케이션 설정</li><li>Device Security Settings : 디바이스 보안 설정</li><li>Allow access IP settings : 접근 허용 IP 설정</li><li>IP setting options : IP 설정 옵션</li><li>Exception Device Settings : 예외 디바이스 설정</li><li>Application Settings : 애플리케이션 설정</li><li>SDK Integration Settings : SDK 연동 설정</li><li>SDK Option Settings : SDK 옵션 설정</li><li>Network security settings : 네트워크 보안 설정</li><li>Authentication security settings : 인증 보안 설정</li><li>Edit exception device information : 예외 디바이스 정보 수정</li><li>Exception IP settings : 예외 IP 설정</li><li>Edit exception IP information : 예외 IP 정보 수정</li><li>Reason input setting for approval request : 승인 요청 시 사유 입력 설정</li><li>Approval expiration time setting : 승인 만료 시각 설정</li><li>Two-factor authentication setting : 2단계 인증 설정</li><li>Access allowed IP setting : 접속 허용 IP 설정</li><li>Setting options : 설정 옵션</li><li>deletion of event : 에이전트 삭제</li><li>Watermark Image : 워터마크 이미지</li><li>Watermark Text : 워터마크 텍스트</li><li>Password creation rules setting : 비밀번호 생성 규칙 설정</li><li>Password change rules setting : 비밀번호 변경 규칙 설정</li><li>Password error access restriction setting : 비밀번호 오류 접속 제한 설정</li><li>Password error access restriction status : 비밀번호 오류 접속 제한 현황<br></li></ul></li></ul></td></tr><tr><td>eventDetailData</td><td>array</td><td><a data-mention href="#undefined">#undefined</a><br><a data-mention href="policy-setting/event-type">event-type</a></td></tr><tr><td>eventPath</td><td>string</td><td><p><strong>정책 설정 경로</strong></p><p>Admin page : 관리자페이지<br>Email : 이메일</p></td></tr><tr><td>ip</td><td>string</td><td><strong>IP</strong></td></tr><tr><td>userAgent</td><td>string</td><td><strong>클라이언트의 브라우저</strong></td></tr><tr><td>dateOfEntryUTC</td><td>string</td><td><strong>정책 생성 시각</strong><br>UTC 기준, ISO 8601포맷</td></tr><tr><td>dateOfEntry</td><td>string</td><td><strong>정책 생성 시각</strong><br>요청 타임존 기준, ISO 8601포맷</td></tr></tbody></table>

#### 이벤트 유형 데이터 상세

<table><thead><tr><th width="181">항목</th><th width="110">타입</th><th>설명</th></tr></thead><tbody><tr><td>policyName</td><td>string</td><td>정책 이름</td></tr><tr><td>memo</td><td>string</td><td>정책 메모</td></tr><tr><td>startTimeUTC</td><td>string</td><td>정책 시작 시각</td></tr><tr><td>endTimeUTC</td><td>string</td><td>정책 종료 시각</td></tr></tbody></table>

### Example

{% tabs %}
{% tab title="200 Success" %}

```javascript
curl -X 'GET' \
  'https://openapi.exosp.com/audit/v1/admin/policy-setting?currentPage=0&tableSize=1000&timezone=Asia%2FSeoul' \
  -H 'accept: application/json' \
  -H 'x-exosp-access: YOUR_ACCESS_KEY' \
  -H 'x-exosp-secret: YOUR_ACCESS_SECRET' 

{
  "code": 0,
  "message": "success",
  "body": {
    "searchDate": "2025-10-26 ~ 2026-01-26",
    "data": [
      {
        "name": "Exosphere Support Team",
        "email": "support@exosp.com",
        "departmentFull": "Exosphere",
        "policyType": "Data Loss Prevention - Print Control - Function Activation",
        "policyTargetName": "예외 정책 추가2(ysmoon, test4)",
        "eventType": "Policy Group Setting",
        "eventDetailData": [
          {
            "policyName": "예외 정책 추가2",
            "memo": "",
            "policySettingType": "Scheduled Period",
            "startTimeUTC": "2025-12-18 09:08:40",
            "endTimeUTC": "2025-12-18 09:28:40",
            "timeZone": "Seoul"
          }
        ],
        "eventPath": "Admin page",
        "ip": "221.158.214.203",
        "userAgent": "Google Chrome - PC - mac",
        "dateOfEntryUTC": "2025-12-18T09:08:40+00:00",
        "dateOfEntry": "2025-12-18T18:08:40+09:00"
      },
      {
        "name": "Exosphere Support Team",
        "email": "support@exosp.com",
        "departmentFull": "Exosphere",
        "policyType": "Data Loss Prevention - Print Control - Function Activation",
        "policyTargetName": "정책 3(test2, test4)",
        "eventType": "Policy Group Setting",
        "eventDetailData": [
          {
            "add": {
              "user": [
                "test2"
              ]
            },
            "delete": {
              "user": ""
            }
          }
        ],
        "ip": "221.158.214.203",
        "userAgent": "Google Chrome - PC - mac",
        "dateOfEntryUTC": "2025-12-18T04:15:59+00:00",
        "dateOfEntry": "2025-12-18T13:15:59+09:00"
      },
      {
        "name": "Exosphere Support Team",
        "email": "support@exosp.com",
        "departmentFull": "Exosphere",
        "policyType": "Anti-Malware - Scheduled scan policy - Windows",
        "policyTargetName": "dev-ys(전체)",
        "eventType": "Set Inspection Schedule",
        "eventDetailData": [
          {
            "interval": "ONECE",
            "year": 2025,
            "month": 12,
            "day": 9,
            "dayOfWeek": null,
            "hh": 11,
            "mm": 9
          },
          {
            "interval": "ONECE",
            "year": 2025,
            "month": 12,
            "day": 9,
            "dayOfWeek": null,
            "hh": 11,
            "mm": 10
          }
        ],
        "ip": "221.158.214.203",
        "userAgent": "Google Chrome - PC - mac",
        "dateOfEntryUTC": "2025-12-09T02:00:08+00:00",
        "dateOfEntry": "2025-12-09T11:00:08+09:00"
      },
      {
        "name": "Exosphere Support Team",
        "email": "support@exosp.com",
        "departmentFull": "Exosphere",
        "policyType": "Anti-Malware - Scheduled scan policy - Windows",
        "policyTargetName": "dev-ys(전체)",
        "eventType": "Set Inspection Schedule",
        "eventDetailData": [
          {
            "interval": "ONECE",
            "year": 2025,
            "month": 12,
            "day": 9,
            "dayOfWeek": null,
            "hh": 11,
            "mm": 9
          }
        ],
        "ip": "221.158.214.203",
        "userAgent": "Google Chrome - PC - mac",
        "dateOfEntryUTC": "2025-12-09T01:59:16+00:00",
        "dateOfEntry": "2025-12-09T10:59:16+09:00"
      },
      {
        "name": "Exosphere Support Team",
        "email": "support@exosp.com",
        "departmentFull": "Exosphere",
        "policyType": "Anti-Malware - Scheduled scan policy - Windows",
        "policyTargetName": "dev-ys(전체)",
        "eventType": "Set Inspection Schedule",
        "eventDetailData": null,
        "ip": "221.158.214.203",
        "userAgent": "Google Chrome - PC - mac",
        "dateOfEntryUTC": "2025-12-09T01:59:09+00:00",
        "dateOfEntry": "2025-12-09T10:59:09+09:00"
      },
      {
        "name": "Exosphere Support Team",
        "email": "support@exosp.com",
        "departmentFull": "Exosphere",
        "policyType": "Web Protection - Real-time protection and exception policy - Windows",
        "policyTargetName": "dev-ys(전체)",
        "eventType": "Set Website Exceptions",
        "eventDetailData": [
          {
            "url": "sdfsdf"
          }
        ],
        "ip": "221.158.214.203",
        "userAgent": "Google Chrome - PC - windows",
        "dateOfEntryUTC": "2025-12-04T07:03:37+00:00",
        "dateOfEntry": "2025-12-04T16:03:37+09:00"
      },
      {
        "name": "Exosphere Support Team",
        "email": "support@exosp.com",
        "departmentFull": "Exosphere",
        "policyType": "Web Protection - Real-time protection and exception policy - Windows",
        "policyTargetName": "dev-ys(전체)",
        "eventType": "Set Website Exceptions",
        "eventDetailData": [
          {
            "url": "test"
          },
          {
            "url": "test2"
          },
          {
            "url": "naver.com"
          },
          {
            "url": "test3"
          },
          {
            "url": "test4"
          }
        ],
        "ip": "221.158.214.203",
        "userAgent": "Google Chrome - PC - mac",
        "dateOfEntryUTC": "2025-12-02T04:09:06+00:00",
        "dateOfEntry": "2025-12-02T13:09:06+09:00"
      }
    ],
    "total": 7,
    "currentPage": 0,
    "tableSize": 1000
  }
}
```

{% endtab %}
{% endtabs %}