# 접근 제어 > 애플리케이션 접근 내역

<mark style="background-color:green;">GET</mark> `https://openapi.exosp.com/logs/v1/access-control/app`

접근 제어 > 애플리케이션 접근 내역을 조회하는 API 입니다.

### Query Parameters

<table><thead><tr><th width="167">항목</th><th width="112">타입</th><th>설명</th></tr></thead><tbody><tr><td>offset<mark style="color:red;">*</mark></td><td>int</td><td><strong>((현재 페이지 번호 -1)*tableSize)</strong><br>현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.</td></tr><tr><td>tableSize<mark style="color:red;">*</mark></td><td>int</td><td><strong>페이지 사이즈</strong></td></tr><tr><td>startTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><p><strong>응답 데이터 시작 시각</strong></p><p>UTC 기준, ISO 8601포맷<br><span data-gb-custom-inline data-tag="emoji" data-code="2705">✅</span> 최신 3개월 이내의 시각만 입력해주세요.</p></td></tr><tr><td>endTimeUTC<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 종료 시각</strong><br>UTC 기준, ISO 8601포맷</td></tr><tr><td>sortType<mark style="color:red;">*</mark></td><td>string</td><td><strong>응답 데이터 정렬 유형 (조치 시각 기준)</strong><br>ASC : 오름차순, DESC : 내림차순</td></tr><tr><td>timezone</td><td>string</td><td><p><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 참고</p><p>기본값 : UTC</p></td></tr><tr><td>search</td><td>string</td><td><p><strong>검색어</strong></p><p>검색 대상 : 사용자 이름, 그룹 이름, 컴퓨터 이름, 파일 이름</p><p>기본값 : 빈값</p></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>data</td><td>array</td><td><a data-mention href="#data">#data</a></td></tr></tbody></table>

#### data **상세**

<table><thead><tr><th width="200.4453125">항목</th><th width="89.0234375">타입</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>departmentName</td><td>string</td><td><strong>그룹 이름</strong></td></tr><tr><td>osType</td><td>string</td><td><strong>os 유형</strong><br>windows : 윈도우 , macos : 맥</td></tr><tr><td>computerName</td><td>string</td><td><strong>컴퓨터 이름</strong></td></tr><tr><td>userAgent</td><td>string</td><td><strong>브라우저</strong></td></tr><tr><td>ipAddress</td><td>string</td><td><strong>IP 주소</strong></td></tr><tr><td>appTitle</td><td>string</td><td><strong>애플리케이션 이름</strong></td></tr><tr><td>appType</td><td>string</td><td><strong>애플리케이션 유형</strong><br>Cloud : 클라우드 앱<br>Inhouse : 인하우스 앱</td></tr><tr><td>deviceID</td><td>string</td><td><strong>디바이스 ID</strong></td></tr><tr><td>agentInstall</td><td>string</td><td><strong>에이전트 설치 여부</strong><br>Installed : 설치,<br>Not Installed : 미설치</td></tr><tr><td>accessResult</td><td>string</td><td><strong>접근 결과</strong><br>Success : 성공, Fail : 실패</td></tr><tr><td>accessFail</td><td>string</td><td><strong>실패 사유</strong><br>Inaccessible operating system: 접근 불가 운영체제,<br>Inaccessible browser: 접근 불가 브라우저,<br>Agent not installed: 엑소스피어 미설치,<br>Agent installed with an unauthorized corporate ID: 허용되지 않은 기업 아이디로 엑소스피어 설치됨,<br>Operating system where Agent installation confirmation is restricted: 엑소스피어 설치 확인 제한 운영체제,<br>Unauthorized operating system (Mobile): 허용되지 않은 운영체제(Mobile),<br>Unauthorized browser (Mobile): 허용되지 않은 브라우저(Mobile),<br>Browser where Exosphere installation confirmation is restricted: 엑소스피어 설치 확인 제한 브라우저,<br>Password input exceeded (20 times): 비밀번호 입력 횟수 초과 (20회),<br>PIN input exceeded (20 times): PIN 입력 횟수 초과 (20회),<br>Application integration settings error (String count error): 애플리케이션 연동 설정 오류 (문자열 개수 오류),<br>Application integration settings error (Undecodable string): 애플리케이션 연동 설정 오류 (복호화 불가 문자열),<br>Application integration settings error (No string): 애플리케이션 연동 설정 오류 (문자열 없음),<br>Application integration settings error (String information error): 애플리케이션 연동 설정 오류 (문자열 정보 오류),<br>Application integration settings error (Other): 애플리케이션 연동 설정 오류 (기타),<br>Access control service not used: 접근제어 서비스 이용 안함,<br>Service expired: 서비스 만료,<br>Application integration not set: 애플리케이션 연동 설정 안함,<br>Certificate registration error: 인증서 등록 오류,<br>License exceeded: 라이선스 초과,<br>User information retrieval failed: 사용자 정보 조회 실패,<br>Unintegrated user: 미연동 사용자,<br>Inaccessible IP: 접근 불가 IP,</td></tr><tr><td>accessSuccess</td><td>string</td><td><strong>성공 사유</strong><br>PC Automatic login succeeded: PC 자동 로그인 성공,<br>PC Manual login succeeded: PC 수동 로그인 성공,<br>PC Login with another account: PC 다른 계정 로그인 성공, <br>Authentication Device login succeeded: 인증 디바이스 로그인 성공,<br>Exclude Device login succeeded: 디바이스 허용 수동 로그인 -> 예외 디바이스 로그인 성공,<br>Exclude IP login succeeded: 예외 IP 로그인 성공</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>

### Example

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

<pre class="language-javascript"><code class="lang-javascript">curl -X 'GET' \
  'https://openapi.exosp.com/logs/v1/access-control/app?startTimeUTC=2025-07-13T15%3A00%3A00%2B00%3A00&#x26;endTimeUTC=2025-07-21T15%3A00%3A00%2B00%3A00&#x26;tableSize=10&#x26;offset=0&#x26;sortType=DESC&#x26;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": {
    "total": 317,
    "data": [
      {
                "name": "정민지",
                "email": "minji@exosp.com",
                "departmentName": "웹 서버",
                "osType": "Windows",
                "computerName": "minji",
                "userAgent": "Google Chrome",
                "ipAddress": "192.168.0.1",
                "appTitle": "Slack",
                "appType": "Cloud",
                "deviceID": "e4f1029e182c1ad95cbc222df41c6527fa30415760280d9d375f762962591b93",
                "agentInstall": "Installed",
                "accessResult": "Success",
                "accessFail": "-",
                "accessSuccess": "PC Automatic login succeeded",
                "dateOfEntryUTC": "<a data-footnote-ref href="#user-content-fn-1">2025</a>-07-21T05:22:23+00:00",
                "dateOfEntry": "2025-07-21T14:22:23+09:00"
            }
    ]
  }
}
</code></pre>

{% endtab %}
{% endtabs %}

[^1]: