> 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/status/cf-user.md).

# 개인(민감)정보 사용자별 현황

<mark style="background-color:green;">GET</mark> `https://openapi.exosp.com/status/v1/cf/user`

개인(민감)정보 사용자별 현황을 조회하는 API 입니다.

### Query Parameters

<table><thead><tr><th width="167">항목</th><th width="112">타입</th><th>설명</th></tr></thead><tbody><tr><td>email<mark style="color:red;">*</mark></td><td>string</td><td><strong>사용자 메일</strong></td></tr><tr><td>name<mark style="color:red;">*</mark></td><td>string</td><td><strong>사용자 이름</strong> </td></tr><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>sortField</td><td>string</td><td><strong>개인(민감)정보의 보유량이 많은 파일의 정렬을 원하는 컬럼명</strong><br>DetectionTotalCount : 개인(민감)정보 개수, DetectionTime : 탐지 시각</td></tr><tr><td>sortType</td><td>string</td><td><strong>응답 데이터 정렬 유형 (제어 시각 기준)</strong><br>ASC : 오름차순, DESC : 내림차순</td></tr><tr><td>search</td><td>string</td><td><p><strong>검색어</strong></p><p>검색 대상 : 컴퓨터이름, 파일이름 </p><p>기본값 : 빈값</p></td></tr><tr><td>cfRsSortField</td><td>string</td><td><strong>개인(민감)정보 파일의 보유량이 많은 PC의 정렬을 원하는 컬럼명</strong><br>FileCount : 탐지된 파일 수, CFCount : 개인(민감)정보 개수, MaxDetectionTime : 최근 탐지 시각</td></tr><tr><td>cfRsSortType</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></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>fileCount</td><td>int</td><td>개인(민감)정보 파일 수</td></tr><tr><td>cfCount</td><td>int</td><td>개인(민감)정보 수</td></tr><tr><td>log_cf_status_info</td><td>array</td><td><a data-mention href="#undefined">#undefined</a></td></tr><tr><td>log_cf_rs_info</td><td>int</td><td><a data-mention href="#pc">#pc</a></td></tr></tbody></table>

#### 개인(민감)정보 보유 현황

<table><thead><tr><th width="181">항목</th><th width="110">타입</th><th>설명</th></tr></thead><tbody><tr><td>user</td><td>string</td><td><strong>사용자(PC)</strong></td></tr><tr><td>detectType</td><td>string</td><td><p><strong>구분</strong><br>Real-Time Scan : 실시간 탐지</p><p>Administrator Scheduled Scan : 관리자 예약검사</p><p>User Full Scan : 사용자 전체검사</p><p>User Custom Scan : 사용자 지정검사</p></td></tr><tr><td>inspectionType</td><td>string</td><td><p><strong>검사 유형</strong><br>Quick Scan : 빠른 검사</p><p>Full Scan : 일반 검사</p></td></tr><tr><td>fileName</td><td>string</td><td><strong>파일 이름</strong></td></tr><tr><td>detectCount</td><td>string</td><td><strong>개인(민감)정보 수</strong></td></tr><tr><td>name</td><td>string</td><td><strong>사용자 이름</strong></td></tr><tr><td>departmentFull</td><td>string</td><td><strong>그룹 전체 경로</strong></td></tr><tr><td>computerName</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>osUserName</td><td>string</td><td><strong>OS 계정</strong></td></tr><tr><td>detectResult</td><td>string</td><td><a data-mention href="#undefined-1">#undefined-1</a></td></tr><tr><td>filePath</td><td>string</td><td><strong>파일 경로</strong></td></tr><tr><td>fileSize</td><td>string</td><td><strong>파일 크기</strong></td></tr><tr><td>protectionType</td><td>string</td><td><p><strong>보호 유형</strong><br>No Protection : 보호 처리 없음</p><p>Encryption : 암호화</p></td></tr><tr><td>encryptionResult</td><td>string</td><td><p><strong>암호화 결과</strong><br>No Protection : 보호 처리 없음</p><p>Encryption : 암호화</p></td></tr><tr><td>detectionTime</td><td>string</td><td><strong>탐지 시각(사용자 기준)</strong><br>요청 타임존 기준,  ISO 8601포맷</td></tr><tr><td>detectionTimeUTC</td><td>string</td><td><strong>탐지 시각(PC 기준)</strong><br>UTC 기준, ISO 8601포맷</td></tr></tbody></table>

#### 개인 민감 정보 상세

<table><thead><tr><th width="164">항목</th><th width="115">타입</th><th>설명</th></tr></thead><tbody><tr><td>type</td><td>string</td><td><p><strong>개인(민감)정보 구분</strong><br>Type : 개인(민감)정보 유형</p><p> Keyword : 개인(민감)정보 키워드</p></td></tr><tr><td>name</td><td>string</td><td><strong>개인(민감)정보 유형 / 키워드</strong></td></tr><tr><td>count</td><td>int</td><td><strong>탐지건수</strong></td></tr></tbody></table>

#### PC별 개인(민감)정보 보유 현황

<table><thead><tr><th width="198.4375">항목</th><th width="110">타입</th><th>설명</th></tr></thead><tbody><tr><td>name</td><td>string</td><td><strong>사용자 이름</strong></td></tr><tr><td>departmentFull</td><td>string</td><td><strong>그룹 전체 경로</strong></td></tr><tr><td>fileCount</td><td>int</td><td><strong>개인(민감)정보 파일 수</strong></td></tr><tr><td>cfCount</td><td>int</td><td><strong>개인(민감)정보 수</strong></td></tr><tr><td>computerName</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>osUserName</td><td>string</td><td><strong>OS 계정</strong></td></tr><tr><td>maxDetectionTime</td><td>string</td><td><strong>탐지 시각(사용자 기준)</strong><br>요청 타임존 기준,  ISO 8601포맷</td></tr><tr><td>maxDetectionTimeUTC</td><td>string</td><td><strong>탐지 시각(PC 기준)</strong><br>UTC 기준, ISO 8601포맷</td></tr></tbody></table>

### Example

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

```javascript
curl -X 'GET' \
  'https://openapi.exosp.com/status/v1/cf/user?email=test%40exosp.com&name=test&currentPage=0&tableSize=1000&sortField=DetectionTotalCount&sortType=DESC&cfRsSortField=FileCount&cfRsSortType=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": {
    "fileCount": 1,
    "cfCount": 5,
    "log_cf_status_info_count": 1,
    "log_cf_status_info": [
      {
        "user": "test(test의 Mac mini (2))",
        "detectType": "Administrator Scheduled Scan",
        "inspectionType": "Quick Scan",
        "fileName": "SAVAPI-Documentation-v4.15.pdf",
        "detectCount": 5,
        "name": "test",
        "departmentFull": "test",
        "computerName": "Deok의 Mac mini (2)",
        "osType": "macos",
        "osUserName": "test Mac Mini(test)",
        "detectResult": [
          {
            "type": "Type",
            "name": "Email",
            "count": 5
          }
        ],
        "filePath": "/Users/test/Downloads/SAVAPI-Documentation-v4.15.pdf",
        "fileSize": 1429562,
        "protectionType": "No Protection",
        "encryptionResult": "No Protection",
        "detectionTime": "2024-05-21T18:02:41+09:00",
        "detectionTimeUTC": "2024-05-21T09:02:41+00:00"
      }
    ],
    "log_cf_rs_info_count": 1,
    "log_cf_rs_info": [
      {
        "name": "test(test의 Mac mini (2))",
        "departmentFull": "test",
        "fileCount": 1,
        "cfCount": 5,
        "computerName": "test의 Mac mini (2)",
        "osType": "macos",
        "osUserName": "test Mac Mini(test)",
        "maxDetectionTime": "2024-05-21T19:04:40+09:00",
        "maxDetectionTimeUTC": "2024-05-21T10:04:40+00:00"
      }
    ]
  }
}
```

{% endtab %}
{% endtabs %}