> ## 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.

# Adaptive Security 통합 설정

> Adaptive Security를 Living Security Platform에 연결하여 인력의 피싱, 스미싱, 비싱 시뮬레이션 결과와 보안 인식 교육 결과를 가져옵니다.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>관련 자료</h2>
    <ul>
      <li>
        <a href="/ko/signals/data-sources">연동 데이터가 Human Risk Management 신호로 변환되는 방식 알아보기</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Living Security 연동 살펴보기</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Living Security Platform 열기</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Living Security 데모 요청하기</a>
      </li>
    </ul>
  </>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Living Security Platform에 자격 증명 입력">
    <p>
      Living Security 액세스 권한을 보유한 담당자(프로그램 소유자 또는 초대된 경우 시스템
      관리자(위임된 설정))가 완료합니다.
    </p>
    <ol>
      <li>
        <strong>설정 → 통합 → 카탈로그</strong>로 이동하여{' '}
        <strong>{tile}</strong> 타일을 찾은 다음 <strong>연결</strong>을 클릭합니다.
      </li>
      <li>
        아래 필드를 입력한 다음 <strong>연결</strong>을 클릭합니다.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>이 가이드는 {system} 관리자를 위한 문서입니다.</strong> {system} 내에서 API
      자격 증명을 생성하는 방법을 다루며, 이 작업에는 Living Security Platform이 아닌 {system}에 대한
      관리자 권한이 필요합니다.
    </p>
    <p>
      Living Security <strong>프로그램 소유자</strong>이면서 {system}을(를) 관리하지 않는 경우,
      이 페이지를 {system}을(를) 관리하는 담당자에게 전달하십시오. 담당자가 A부를 완료한 후 자격 증명을 귀하에게 전달하거나
      (플랫폼에 초대한 경우에는 담당자가 직접 입력할 수도 있습니다).
      {recommendDelegated && <>
          {' '}설정 과정에서 민감한 키 정보가 생성되므로, 시크릿이 귀하에게 전달되지 않도록{' '}
          <strong>위임 설정</strong> 방식을 권장합니다.
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="Adaptive Security" />

## 이 통합이 제공하는 데이터

Adaptive Security는 인력, 교육, 다중 채널 시뮬레이션 결과를 제공할 수 있습니다. 검토된 예시는 다음과 같습니다.

* `phishing.simulation.clicked` — 신고하지 않고 시뮬레이션 이메일을 클릭함
* `phishing.simulation.credential.submitted` — 시뮬레이션 로그인 페이지에 자격 증명을 입력함
* `phishing.simulation.attachment.opened` — 시뮬레이션 이메일의 첨부 파일을 열었음
* `phishing.simulation.reported` — 시뮬레이션 이메일을 신고함
* `smishing.simulation.replied` — 시뮬레이션 문자 메시지에 회신함
* `vishing.simulation.succeeded` — 시뮬레이션 음성 통화 발신자의 요구에 응함
* `training.assigned` — 보안 교육이 할당됨
* `training.completed` — 보안 교육을 완료함
* `training.past.due` — 교육 기한을 놓침

이 예시는 Living Security에서 사용할 수 있는 정규화된 활동 유형을 보여 줍니다. [통합 데이터가 신호가 되는 방식](/ko/signals/data-sources)을 참조하십시오.

<Note>
  **Adaptive는 세 가지 채널로 시뮬레이션을 수행하며, Living Security는 각 채널을 별도로 점수화합니다.**
  이메일 결과는 피싱으로, 문자 메시지 결과는 스미싱으로, 음성 통화 결과는 비싱으로 점수화됩니다. 시뮬레이션 이메일을 클릭한 사람과 시뮬레이션 문자에 회신한 사람은 각각 내린 판단이 다르므로 동일한 행동으로 측정되지 않습니다.
</Note>

## Living Security에 필요한 정보

| 자격 증명 | 설명 |
| - | - |
| **API 토큰** | Adaptive Security API 토큰입니다. Living Security는 모든 요청에 이 토큰을 베어러 토큰으로 전송합니다. |

**필요한 역할:** **Settings → API**에 액세스할 수 있는 Adaptive Security 계정의 관리자입니다. Adaptive는 역할 기반 권한으로 API 액세스를 제어하므로, 토큰은 사용자, 피싱, 교육을 읽을 수 있는 역할에 속해야 합니다.

**액세스:** 읽기 전용입니다. Living Security는 Adaptive Security에서 데이터를 읽기만 하며, 계정에서 어떤 항목도 생성, 변경 또는 삭제하지 않습니다.

### Living Security가 가져오는 데이터

| 데이터 | 세부 정보 |
| - | - |
| **사람들** | Adaptive 사용자 디렉터리: 이름, 이메일, 부서, 직함, 관리자 이름 및 이메일, 위치, 사업부, 고용 상태, 입사일. |
| **이메일 시뮬레이션** | 시뮬레이션별, 사람별: 메시지가 전달된 시점, 열린 시점, 클릭된 시점, 회신된 시점, 첨부 파일이 열린 시점, QR 코드가 스캔된 시점, 자격 증명이 입력된 시점 또는 신고된 시점. |
| **문자 시뮬레이션** | 시뮬레이션별, 사람별: 전달, 열람, 클릭, 회신, 자격 증명 입력 또는 신고 여부. |
| **음성 시뮬레이션** | 시뮬레이션별, 사람별: 전달된 미끼, 발신된 번호, 해당 사람이 발신자의 요구에 응했는지 여부, 신고했는지 여부. |
| **교육** | 캠페인별, 사람별: 등록 시점, 기한, 시작 시점, 완료 시점, 캠페인 정책 확인 여부. |

<Note>
  **전화번호는 저장되지 않습니다.** Adaptive는 사용자 레코드에 사무실 및 휴대폰 번호를 반환합니다. Living Security의 어떤 기능도 이 번호를 사용하지 않으므로, Living Security는 저장하기 전에 두 번호를 모두 폐기합니다.
</Note>

<Note>
  **Adaptive 자체 위험 점수는 기록되지만 점수 산정에는 사용되지 않습니다.** Adaptive는 사람별로 `current_risk_score`를 계산합니다. Living Security는 두 시스템을 나란히 비교할 수 있도록 이 값을 보관하지만, 인간 위험 지수는 항상 관찰된 행동을 기반으로 Living Security가 공개한 자체 모델을 사용하여 계산되며 다른 공급업체의 종합 점수는 사용하지 않습니다.
</Note>

### 사전 요구 사항

* API가 활성화된 Adaptive Security 계정
* [admin.adaptivesecurity.com](https://admin.adaptivesecurity.com)에 대한 관리자 액세스
* 연결된 다른 시스템에서 사용하는 주소와 일치하는 Adaptive의 사용자 이메일 주소. Living Security는 이메일을 사용하여 Adaptive 사용자를 사람과 매칭합니다.

***

## 파트 A — Adaptive Security에서

*Adaptive Security 관리자가 다음 단계를 완료합니다.*

<Steps>
  <Step title="API 설정 열기">
    1. 관리자로 [admin.adaptivesecurity.com](https://admin.adaptivesecurity.com)에 로그인합니다.
    2. **Settings → API**로 이동합니다.
  </Step>

  <Step title="API 토큰 생성">
    1. 새 API 토큰을 생성합니다.
    2. 나중에 알아볼 수 있는 이름을 지정합니다. 예: `Living Security`.
    3. 토큰의 역할이 사용자, 피싱 캠페인, 교육 캠페인을 읽을 수 있는지 확인합니다.
    4. 토큰을 복사합니다.

    <Warning>
      페이지를 떠나기 전에 토큰을 복사하십시오. Adaptive 계정에서 토큰에 만료 기한을 설정한 경우 해당 날짜를 기록해 두십시오. 토큰이 만료되면 Living Security가 데이터를 가져올 수 없으며, 새 토큰으로 연결을 업데이트해야 합니다.
    </Warning>
  </Step>
</Steps>

***

## 파트 B — Living Security Platform에서

*프로그램 소유자가 이 단계를 완료하거나, 위임된 설정을 사용하는 경우 시스템 관리자가 완료합니다.*

<Steps>
  <ConnectInPlatform tile="Adaptive Security">
    | 필드 | 값 |
    | - | - |
    | **API 토큰** | 파트 A에서 생성한 토큰 |
  </ConnectInPlatform>
</Steps>

이제 Adaptive Security에 연결되었습니다.

***

## 데이터 가져오기 주기

| 데이터 | 일정 |
| - | - |
| 사람들 | 6시간마다 |
| 시뮬레이션 결과(이메일, 문자, 음성) | 6시간마다 |
| 교육 결과 | 6시간마다 |

Adaptive의 보고 API는 "마지막 이후 변경 사항" 필터를 제공하지 않으므로, Living Security는 각 시뮬레이션 및 교육 캠페인이 결과를 생성하는 동안 읽고, 캠페인이 종료된 지 2주가 지나면 읽기를 중단합니다. 따라서 늦게 발생한 클릭과 신고도 수집되며, 종료된 캠페인을 계속 다시 읽지 않습니다.

<Note>
  규모가 큰 Adaptive 계정을 처음 연결하면 모든 데이터를 읽는 데 예약된 실행이 여러 번 필요할 수 있습니다. 각 실행은 가능한 만큼 읽고 다음 실행이 중단된 지점부터 이어서 진행하므로, 집계 수치는 한꺼번에 나타나지 않고 처음 하루나 이틀에 걸쳐 증가합니다.
</Note>

***

## 문제 해결

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    API 토큰이 잘못되었거나 만료되었거나 해지되었습니다. Adaptive는 이 오류에 대해 빈 응답 본문을 반환하므로 확인할 수 있는 추가 정보가 없습니다. **Settings → API**에서 새 토큰을 생성하고 해당 토큰으로 다시 연결하십시오. 토큰을 일부만 복사한 경우에도 동일한 오류가 발생하며, 이것이 가장 흔한 원인입니다.
  </Accordion>

  <Accordion title="403 Forbidden">
    토큰은 인증되었지만 해당 역할로는 요청된 데이터를 읽을 수 없습니다. 같은 토큰을 다시 붙여넣어도 해결되지 않습니다. Adaptive에서 토큰의 역할에 사용자, 피싱, 교육에 대한 읽기 권한이 있는지 확인하거나, 해당 권한이 있는 역할로 토큰을 발급하십시오.
  </Accordion>

  <Accordion title="429 Too Many Requests">
    Adaptive가 연결에 속도 제한을 적용했습니다. Living Security는 해당 실행을 중단하고 다음 예약 실행에서 같은 지점부터 재개하므로 데이터는 손실되지 않으며, 집계 수치가 증가하는 데 시간이 더 걸릴 뿐입니다. 며칠 동안 계속되는 경우 Adaptive Security 지원팀에 문의하여 계정에 적용되는 속도 제한을 확인하십시오.
  </Accordion>

  <Accordion title="사람은 표시되지만 시뮬레이션 결과가 없음">
    예상하는 캠페인이 실제로 실행되었는지 확인하십시오. Adaptive는 발송된 시뮬레이션에 대해서만 등록 정보를 보고하므로, **초안** 또는 **예정됨** 상태의 캠페인은 발송되기 전까지 아무 데이터도 제공하지 않습니다. Living Security는 실제 결과가 있는 캠페인에 요청 할당량을 사용하도록 이러한 캠페인을 의도적으로 읽지 않습니다.
  </Accordion>

  <Accordion title="음성 또는 문자 시뮬레이션이 누락됨">
    Living Security는 각 결과에 연결된 시나리오를 기준으로 채널을 결정합니다. 시뮬레이션이 실행된 후 Adaptive에서 시나리오가 삭제된 경우 채널을 더 이상 읽을 수 없으므로 해당 결과는 이메일 채널로 기록됩니다. 사용이 종료된 시나리오를 삭제하지 않고 Adaptive에 보관하면 이 문제를 방지할 수 있습니다.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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