> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 가장 취약한 사용자

> /v1 시뮬레이션 결과 및 엔터티를 사용하여 이전 공급업체의 12개월 가장 취약한 사용자 롤업을 재현합니다.

이 보고서는 사용자별 12개월 취약성 롤업입니다. 최근 1년 동안 시뮬레이션을 한 번 이상 받은 사람마다 한 행씩 생성되며, 클릭/자격 증명/신고 횟수 및 비율, 현재 연속 클릭 횟수, 그리고 최근 5개 결과를 이어 붙인 목록이 포함됩니다.

기간은 365일이 아닌 \*\*12개월(달력 기준)\*\*이며, 12개월 전 같은 날짜의 UTC 자정부터 시작합니다.

<Note>
  자동화된 스캐너/봇 상호작용은 클릭 및 자격 증명 횟수에서 제외됩니다. 이는 기존 내보내기와 의도적으로 다르게 처리하는 부분입니다. 자세한 내용은
  [기존 내보내기와의 차이점](#%EA%B8%B0%EC%A1%B4-%EB%82%B4%EB%B3%B4%EB%82%B4%EA%B8%B0%EC%99%80%EC%9D%98-%EC%B0%A8%EC%9D%B4%EC%A0%90)을 참조하십시오.
</Note>

설정, 자격 증명, 페이지 매김 및 요금 제한 재시도는
[Power BI / Excel 연결 가이드](/ko/developers/v1/powerbi)와 동일합니다. 먼저 공유
`Fn_FetchAll` 쿼리를 추가하십시오. 이 보고서는 해당 쿼리를 이름으로 호출합니다.

## 필요한 키 범위

| 범위 | 용도 |
| - | - |
| `simulation:read` | `GET /v1/simulation_results` |
| `entity:read` | `GET /v1/entities` (이메일 및 표시 이름 조인) |

이 보고서는 보고 미리보기 계열이 아닌 **운영용** 사용자별 결과 목록을 사용합니다. `reporting:read`만 부여된 키는
`GET /v1/simulation_results`을(를) 호출할 수 없습니다(API가 `403`을(를) 반환합니다). 자세한 내용은
[적절한 세분성 선택](/ko/developers/v1/powerbi#%EC%A0%81%ED%95%A9%ED%95%9C-%EA%B7%B8%EB%A0%88%EC%9D%B8-%EC%84%A0%ED%83%9D)을 참조하십시오.

## 소스 엔드포인트

| 엔드포인트 | 역할 |
| - | - |
| `GET /v1/simulation_results` | 수신자별 결과입니다. 팩트 세분성에 해당합니다. |
| `GET /v1/entities` | `entity`을(를) 이메일/표시 이름으로 변환합니다. 결과 행에는 수신자 이메일이나 표시 이름이 없으며(`entity`만 있음) 이를 통해 확인합니다. |

결과 목록에서 허용되는 필터는 `limit`, `page_token`,
`simulation`, `entity`입니다. 이 목록에는 `delivered_after` / `start_date`이(가) 없으므로,
최근 12개월 조건은 전체 순회가 끝난 후 Power Query에서 적용됩니다.

각 결과에서 사용되는 필드: `id`, `simulation`, `entity`, `status`,
`targeted_at`, `delivered_at`, `bounced_at`, `opened_at`, `clicked_at`,
`attachment_opened_at`, `credential_submitted_at`, `reported_at`,
`reported_before_interaction`, `bot_activity_detected`, `email_subject`,
`sender_email`, `difficulty_level`, `created_at`, `updated_at`.

### 세분성

최근 12개월(달력 기준) 동안 `delivered_at`이(가) 있는 결과가 하나 이상 있는 엔터티마다 한 행이 생성됩니다. 대상으로 지정되었으나 전달되지 않은 사용자는 나타나지 않습니다. 동일한 사용자에 대한 여러 시뮬레이션은 여기서 하나로 합쳐집니다.

요청 예산: 조직의 모든 시뮬레이션 결과에 대한 페이지 매김 순회 1회와 엔터티 순회 1회입니다. 항상 `limit = "500"`을(를) 설정하십시오.

## 결과 우선순위(`last_5_assessments`)

전달된 결과 중 가장 최근 5건(`delivered_at`
내림차순)은 각각 `YYYY-MM-DD: <outcome>`(으)로 요약됩니다. 일치하는 첫 번째
타임스탬프가 적용되며, 우선순위가 높은 것부터 확인합니다.

| 우선순위 | 타임스탬프 | 결과 레이블 |
| - | - | - |
| 1 | `credential_submitted_at` | `credential submitted` |
| 2 | `clicked_at` | `clicked` |
| 3 | `attachment_opened_at` | `attachment opened` |
| 4 | `reported_at` | `reported` |
| 5 | `opened_at` | `opened` |
| 6 | `delivered_at` | `no action` |
| 7 | `bounced_at` | `bounced` |

전달만 된 경우는 `no action`입니다(메시지는 도착했지만 사용자가 아무 작업도 하지 않음). 클릭한 후 나중에 신고한 사용자는 `clicked`입니다. 이 목록에서는 신고가 위험한 상호작용보다 우선하지 않습니다. 봇으로 플래그된 행도 존재하는 타임스탬프에 따라 결과 레이블이 지정되지만, 클릭/자격 증명 횟수는 증가시키지 않습니다.

**현재 연속 클릭 횟수:** 동일하게 전달된 결과를 최신순으로 순회하면서 `clicked_at`이(가) null이 아니고 **동시에**
`bot_activity_detected`이(가) `true`이(가) 아닌 연속 행의 수를 셉니다. 처음으로 조건에 맞지 않는 행에서 중단합니다.

## 열 매핑

기존 열 이름은 이전 공급업체의 내보내기에서 가져온 것입니다. `/v1` 필드는
공개 API 이름이며, 쿼리에서 횟수와 비율을 계산합니다.

| 기존 열 | `/v1` 필드 또는 계산 방식 | 보고서 열 |
| - | - | - |
| Email | `Entity.email`(`Result.entity` 기준으로 조인) | `email` |
| Full name | `Entity.display_name` | `full_name` |
| Total simulations received | `delivered_at`이(가) null이 아닌 결과의 수(봇으로 플래그된 행 포함) | `total_received` |
| Clicks # | `clicked_at`이(가) null이 아니고 **동시에** `bot_activity_detected` ≠ `true`인 결과의 수 | `clicks` |
| Clicks % | `clicks / total_received` | `click_pct` |
| Credential submissions # | `credential_submitted_at`이(가) null이 아니고 **동시에** `bot_activity_detected` ≠ `true`인 결과의 수 | `credential_submissions` |
| Credential submissions % | `credential_submissions / total_received` | `credential_submission_pct` |
| Reported # | `reported_at`이(가) null이 아닌 결과의 수(봇 포함, 클릭/자격 증명이 아님) | `reported` |
| Reported % | `reported / total_received` | `reported_pct` |
| Current click streak | 사용자가 클릭한, 연속된 최신 전달 결과의 수(봇이 있으면 중단됨) | `current_click_streak` |
| Last 5 assessments | 가장 최근에 전달된 결과 5건을 `"; "`(으)로 구분(자세한 내용은 [우선순위](#결과-우선순위-last_5_assessments) 참조) | `last_5_assessments` |
| Directory extras (department, …) | `/v1`에 없음 | null로 처리하지 않고 생략됨 |

스타 스키마 모델에 유지되는 조인 키: `entity_id`.

## 기존 내보내기와의 차이점

* **봇 활동은 클릭 및 자격 증명 횟수에서 제외됩니다.** 이전 공급업체의 내보내기에서는 자동화된 스캐너/봇 상호작용을 클릭 및 자격 증명 제출로 집계했습니다. 이 쿼리는 그렇게 하지 않습니다. `bot_activity_detected = true`인 결과도 여전히 전달된 시뮬레이션이므로 `total_received` 및 신고 집계에는 포함되지만, 클릭이 아니고 제출도 아닌 것으로 처리됩니다. 즉 `clicks` / `credential_submissions`에서 제외되며 현재 연속 클릭 횟수를 중단시킵니다. 기존 내보내기와 맞추기 위해 봇을 집계하는 방식으로 "수정"하지 마십시오.
* **`last_5_assessments`에서는 신고가 클릭보다 우선하지 않습니다.** 클릭한 후 나중에 신고한 사용자에게는 `clicked` 레이블이 지정됩니다.
* **디렉터리 추가 정보는 null로 처리되지 않고 생략됩니다.** 부서 및 유사한 필드는 `/v1`에 없습니다.
* **서버 측 시간 필터가 없습니다.** `GET /v1/simulation_results`에는
  `delivered_after`이(가) 없습니다. 쿼리는 모든 결과를 순회한 후 최근 12개월(달력 기준) 내의 `delivered_at`만 유지합니다. 과거 데이터가 많은 조직은 필터가 적용된 목록을 사용하는 경우보다 키별 요금 제한 예산을 더 많이 소모할 수 있습니다.

## 다음 단계

<CardGroup cols={2}>
  <Card title="Power BI 및 Excel 설정" href="/ko/developers/v1/powerbi">
    자격 증명, 페이지 매김, 그리고 Power BI 또는 Excel에서 이러한 쿼리를 로드하는 방법입니다.
  </Card>

  <Card title="이메일 피싱 로그" href="/ko/developers/v1/reports/email-phishing-log">
    최근 12개월간의 이벤트 수준 피싱 상호작용입니다.
  </Card>

  <Card title="사용자별 규정 준수" href="/ko/developers/v1/reports/per-person-compliance">
    사용자 × 할당 세분성의 교육 등록 현황입니다.
  </Card>

  <Card title="API 키" href="/ko/developers/developer-hub/api-keys">
    이 보고서를 새로 고치는 키에 `simulation:read` 및 `entity:read`을(를) 부여하십시오.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.