접근 제어 > 클라우드 애플리케이션 접근 내역
GET https://openapi.exosp.com/logs/v1/access-control/cloud-app
접근 제어 > 클라우드 애플리케이션 접근 내역을 조회하는 API 입니다.
Query Parameters
offset*
int
((현재 페이지 번호 -1)*tableSize) 현재 페이지의 첫 번째 데이터가 위치한 인덱스를 나타냅니다.
tableSize*
int
페이지 사이즈
startTimeUTC*
string
응답 데이터 시작 시각
UTC 기준, ISO 8601포맷 ✅ 최신 3개월 이내의 시각만 입력해주세요.
endTimeUTC*
string
응답 데이터 종료 시각 UTC 기준, ISO 8601포맷
sortType*
string
응답 데이터 정렬 유형 (조치 시각 기준) ASC : 오름차순, DESC : 내림차순
timezone
string
응답 데이터 타임존https://en.wikipedia.org/wiki/List_of_tz_database_time_zones 에서 TZ identifier 참고
기본값 : UTC
search
string
검색어
검색 대상 : 사용자 이름, 그룹 이름, 컴퓨터 이름, 파일 이름
기본값 : 빈값
Response Schema
body 상세
total
int
전체 레코드 수
data 상세
name
string
사용자 이름
string
사용자 이메일
departmentName
string
그룹 이름
osType
string
os 유형 windows : 윈도우 , macos : 맥
computerName
string
컴퓨터 이름
userAgent
string
브라우저
ipAddress
string
IP 주소
appTitle
string
애플리케이션 이름
deviceID
string
디바이스 ID
agentInstall
string
에이전트 설치 여부 Installed : 설치, Not Installed : 미설치
accessResult
string
접근 결과 Success : 성공, Fail : 실패
accessFail
string
실패 사유 Inaccessible operating system: 접근 불가 운영체제, Inaccessible browser: 접근 불가 브라우저, Agent not installed: 엑소스피어 미설치, Agent installed with an unauthorized corporate ID: 허용되지 않은 기업 아이디로 엑소스피어 설치됨, Operating system where Agent installation confirmation is restricted: 엑소스피어 설치 확인 제한 운영체제, Unauthorized operating system (Mobile): 허용되지 않은 운영체제(Mobile), Unauthorized browser (Mobile): 허용되지 않은 브라우저(Mobile), Browser where Exosphere installation confirmation is restricted: 엑소스피어 설치 확인 제한 브라우저, Password input exceeded (20 times): 비밀번호 입력 횟수 초과 (20회), PIN input exceeded (20 times): PIN 입력 횟수 초과 (20회), Application integration settings error (String count error): 애플리케이션 연동 설정 오류 (문자열 개수 오류), Application integration settings error (Undecodable string): 애플리케이션 연동 설정 오류 (복호화 불가 문자열), Application integration settings error (No string): 애플리케이션 연동 설정 오류 (문자열 없음), Application integration settings error (String information error): 애플리케이션 연동 설정 오류 (문자열 정보 오류), Application integration settings error (Other): 애플리케이션 연동 설정 오류 (기타), Access control service not used: 접근제어 서비스 이용 안함, Service expired: 서비스 만료, Application integration not set: 애플리케이션 연동 설정 안함, Certificate registration error: 인증서 등록 오류, License exceeded: 라이선스 초과, User information retrieval failed: 사용자 정보 조회 실패, Unintegrated user: 미연동 사용자, Inaccessible IP: 접근 불가 IP,
dateOfEntryUTC
string
접근 시각 UTC 기준, ISO 8601포맷
dateOfEntry
string
접근 시각 요청 타임존 기준, ISO 8601포맷
Example
curl -X 'GET' \
'https://openapi.exosp.com/logs/v1/access-control/cloud-app?startTimeUTC=2025-07-13T15%3A00%3A00%2B00%3A00&endTimeUTC=2025-07-21T15%3A00%3A00%2B00%3A00&tableSize=10&offset=0&sortType=DESC&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": "[email protected]",
"departmentName": "웹 서버",
"osType": "Windows",
"computerName": "minji",
"userAgent": "Google Chrome",
"ipAddress": "192.168.0.1",
"appTitle": "Slack",
"deviceID": "e4f1029e182c1ad95cbc222df41c6527fa30415760280d9d375f762962591b93",
"agentInstall": "Installed",
"accessResult": "Success",
"accessFail": "-",
"dateOfEntryUTC": "2025-07-21T05:22:23+00:00",
"dateOfEntry": "2025-07-21T14:22:23+09:00"
}
]
}
}Last updated