> For the complete documentation index, see [llms.txt](https://openapi-docs.exosp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://openapi-docs.exosp.com/guide/logs/audit/admin-app.md).

# 제로트러스트 애플리케이션 연동 설정 이벤트

<mark style="background-color:green;">GET</mark> `https://openapi.exosp.com/audit/v1/zts/admin/app`

제로트러스트 애플리케이션 연동 설정 이벤트를 조회하는 API 입니다.

### Query Parameters

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

### 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>searchDate</td><td>string</td><td><strong>조회날짜</strong></td></tr><tr><td>total</td><td>int</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="110">타입</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>eventType</td><td>string</td><td><p><strong>이벤트 유형</strong></p><ul><li>Application settings : 애플리케이션 설정</li><li>Application integration settings : 애플리케이션 연동 설정</li><li>SAML SSO certificate : SAML SSO 인증서</li><li>SDK option settings : SDK 옵션 설정</li><li>Automatic linking for unlinked users settings : 미연동 사용자 자동 연동 설정</li><li>Additional SSO option settings : SSO 추가 옵션 설정</li></ul></td></tr><tr><td>eventDetailData</td><td>array</td><td><ul><li>Add application : 애플리케이션 추가</li><li>Delete application : 애플리케이션 삭제</li><li>Edit application : 애플리케이션 수정</li><li>Link : 연결</li><li>Unlink : 연결 해제</li><li>Add certificate : 인증서 추가</li><li>Delete certificate : 인증서 삭제</li><li>Download certificate/metadata : 인증서/메타데이터 다운로드</li><li>Loading popup text : 로딩 팝업 텍스트</li><li>SDK device authentication settings : SDK 장치 인증 설정</li><li>Enable : 활성화</li><li>Disable : 비활성화</li><li>Modify ACS URL : ACS URL 수정</li><li>Modify Issuer URL : Issuer URL 수정</li></ul><p></p><ul><li>Category : 카테고리</li><li>Domain : 도메인</li><li>Description : 메모</li><li>Session duration : 인증 유지 시간</li><li>Log during session retention : 인증 유지 중 로그 기록</li></ul></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/zts/admin/app?offset=0&tableSize=1&timezone=Asia%2FSeoul&sortType=DESC' \
  -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-11-26 ~ 2026-02-25",
    "total": 2,
    "data": [
      {
        "name": "Exosphere Support Team",
        "email": "support@exosp.com",
        "departmentFull": "Exosphere",
        "appTitle": "Google Workspace",
        "eventType": "Application integration settings",
        "eventDetailData": "Link",
        "ip": "",
        "userAgent": "Google Chrome",
        "dateOfEntry": "2026-02-23T17:44:35+09:00",
        "dateOfEntryUTC": "2026-02-23T08:44:35+00:00"
      },
      {
        "name": "Exosphere Support Team",
        "email": "support@exosp.com",
        "departmentFull": "Exosphere",
        "appTitle": "Google Workspace",
        "eventType": "Application settings",
        "eventDetailData": "Add application",
        "ip": "",
        "userAgent": "Google Chrome",
        "dateOfEntry": "2026-02-23T17:44:32+09:00",
        "dateOfEntryUTC": "2026-02-23T08:44:32+00:00"
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}
