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

# NINJIO 통합 설정

> NINJIO를 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="NINJIO" />

## 이 통합이 제공하는 정보

NINJIO는 인력, 교육, 피싱 시뮬레이션 결과를 제공할 수 있습니다. 검토된 예시는 다음과 같습니다.

* `training.assigned` — 할당된 보안 교육이 있음
* `training.completed` — 보안 교육을 이수함
* `training.passed` — 보안 교육 평가를 통과함
* `phishing.simulation.clicked` — 신고하지 않고 시뮬레이션을 클릭함
* `phishing.simulation.reported` — 피싱 시뮬레이션을 신고함

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

## Living Security에 필요한 정보

| 자격 증명 | 설명 |
| - | - |
| **API 키** | 직원, 교육, 피싱 액세스 포인트에 대한 읽기 권한이 있는 NINJIO API 키입니다. Living Security는 모든 요청에 이 키를 함께 전송합니다. |

**범위:** NINJIO는 API 키의 범위를 *액세스 포인트*별로 지정하며, 읽기 권한과 쓰기 권한이 별도로 구분됩니다. Living Security에는 직원, 교육, 피싱 세 가지 액세스 포인트에 대한 **읽기** 권한이 필요합니다. 쓰기 권한은 필요하지 않으므로 부여하지 않아야 합니다.

**필요한 역할:** NINJIO 계정의 **관리자**입니다. 키를 생성하는 통합 영역에는 관리자만 접근할 수 있습니다.

<Warning>
  **NINJIO는 새 키를 생성하는 시점에 한 번만 표시합니다.** 다른 페이지로 이동하기 전에 키를 바로 Living Security Platform 또는 비밀번호 보관소에 복사하십시오. 복사하지 않은 키는 다시 확인할 수 없으며, 새 키를 생성해야 합니다.
</Warning>

### Living Security가 가져오는 정보

| 데이터 | 세부 정보 |
| - | - |
| **학습자** | NINJIO 직원 디렉터리의 이름, 이메일, 부서, 직책, 관리자, 국가, 지점, 활성 상태입니다. |
| **교육** | 각 교육이 할당된 대상과 이수한 대상, 그리고 이수 날짜, 시험 점수, 참여 점수입니다. |
| **피싱** | 시뮬레이션 피싱 이메일에 반응한 대상과 신고한 대상, 그리고 해당 시각입니다. |

<Note>
  **학습자의 전화번호는 저장되지 않습니다.** NINJIO는 직원 레코드에 전화번호를 포함하여 반환합니다. Living Security의 어떤 기능도 전화번호를 사용하지 않으므로, Living Security는 데이터를 저장하기 전에 이를 삭제합니다.
</Note>

### 사전 요구 사항

* API 액세스가 가능한 NINJIO 계정
* [admin.goninjio.com](https://admin.goninjio.com/)에 대한 관리자 액세스 권한
* 연결된 다른 시스템에서 사용하는 이메일 주소와 일치하는 NINJIO 학습자 이메일 주소. Living Security는 이메일을 기준으로 NINJIO 학습자를 개인과 매칭합니다.

***

## A부 — NINJIO에서 수행

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

<Steps>
  <Step title="통합 영역 열기">
    1. 관리자로 [admin.goninjio.com](https://admin.goninjio.com/)에 로그인합니다.
    2. 화면 오른쪽 상단에서 **Integration**을 선택합니다.
  </Step>

  <Step title="API 키 생성">
    1. **New API Key**를 선택합니다.
    2. 나중에 알아볼 수 있도록 키의 이름을 지정합니다. 예: `Living Security`
    3. **employee**, **training**, **phishing** 액세스 포인트에 **읽기** 권한을 부여합니다.
    4. 쓰기 권한은 선택하지 않은 상태로 둡니다. Living Security는 NINJIO에서 데이터를 읽기만 합니다.
    5. **Generate Key**를 선택합니다.

    <Warning>
      지금 키를 복사하십시오. NINJIO는 키를 한 번만 표시하며 다시 표시할 수 없습니다.
    </Warning>
  </Step>
</Steps>

***

## B부 — Living Security Platform에서 수행

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

<Steps>
  <ConnectInPlatform tile="NINJIO">
    | 필드 | 값 |
    | - | - |
    | **API 키** | A부에서 생성한 키 |
  </ConnectInPlatform>
</Steps>

이제 NINJIO에 연결되었습니다.

***

## 데이터 가져오기 주기

| 데이터 | 일정 |
| - | - |
| 학습자 | 매일 |
| 교육 결과 | 6시간마다 |
| 피싱 결과 | 6시간마다 |

처음 연결하면 Living Security는 지난 12개월 동안의 교육 이수 내역을 가져온 후 이후에는 증분 방식으로 최신 상태를 유지합니다. 피싱 시뮬레이션은 한 번 읽어 온 뒤 종료 후 2주 동안 다시 확인하므로, 늦게 발생한 클릭과 신고도 수집됩니다.

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

***

## 문제 해결

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    API 키가 잘못되었거나 불완전합니다. 가장 흔한 원인은 키가 일부만 복사된 경우입니다. NINJIO는 키를 한 번만 표시하므로 붙여넣기가 잘리기 쉽고, 나중에는 이를 확인할 수 없습니다. NINJIO에서 새 키를 생성한 후 해당 키로 다시 연결하십시오.
  </Accordion>

  <Accordion title="403 Forbidden">
    이는 자격 증명 문제가 **아닙니다**. 키 인증은 성공했지만, 필요한 액세스 포인트 중 하나에 읽기 권한이 부여되지 않았습니다.

    같은 키를 다시 붙여넣어도 해결되지 않습니다. NINJIO에서 employee, training, phishing 세 가지 액세스 포인트 모두에 **읽기** 권한이 있는 키를 생성하고 해당 키로 다시 연결하십시오.
  </Accordion>

  <Accordion title="연결은 성공했지만 교육 데이터가 없음">
    NINJIO에서 **활성** 상태이면서 시뮬레이션이 연결된 교육 캠페인이 하나 이상 있는지 확인하십시오. 시뮬레이션이 없는 캠페인은 비활성 상태로 유지되며 아무것도 전달하지 않으므로 가져올 결과가 없습니다.

    캠페인이 활성 상태라면 해당 캠페인의 학습자에게 NINJIO 레코드에 이메일 주소가 있는지 확인하십시오. 이메일 주소가 없는 학습자는 개인과 매칭할 수 없으므로 건너뜁니다.
  </Accordion>

  <Accordion title="교육이 할당됨으로 표시되지만 이수되지 않음">
    학습자가 아직 완료하지 않은 교육은 이렇게 표시되는 것이 정상입니다. Living Security는 NINJIO 시뮬레이션이 시작될 때 할당을 기록하고, NINJIO가 이수 날짜를 보고하면 이수를 별도로 기록합니다.
  </Accordion>

  <Accordion title="일부 학습자가 누락됨">
    Living Security는 **이메일 주소**를 기준으로 NINJIO 학습자를 개인과 매칭합니다. NINJIO의 이메일이 디렉터리에 저장된 주소와 다른 학습자(개인 이메일 주소, 이전 도메인, 오타 등)는 매칭되지 않습니다.

    NINJIO에서 주소를 수정하면 다음 예약된 데이터 가져오기 때 매칭됩니다.
  </Accordion>

  <Accordion title="이전 시뮬레이션의 피싱 결과가 누락됨">
    Living Security는 피싱 시뮬레이션이 종료된 후 2주 동안 다시 확인한 다음 중단합니다. 이 기간 이후에 NINJIO에 기록된 결과는 수집되지 않습니다. 이전 시뮬레이션을 다시 읽어야 하는 경우 지원팀에 문의하십시오.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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