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

# KnowBe4 연동 설정

> KnowBe4를 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 EgressIpSafelist = ({system}) => <Note>
    <strong>Living Security 동기화 송신 IP 주소 4개를 모두</strong> {system}의 허용 목록에 추가하십시오. {system}에서 CIDR 표기법을 요구하는 경우 각 주소를 <code>/32</code>를 붙인 단일 호스트로 입력하십시오.
    <br />
    <code>52.34.139.153/32</code>, <code>54.69.127.183/32</code>, <code>44.247.133.183/32</code>,{' '}
    <code>52.26.211.56/32</code>
    <br />
    <br />
    트래픽은 4개의 주소 중 어느 것에서든 발생할 수 있으므로 일부만 허용 목록에 추가하면 간헐적으로 동기화 오류가 발생합니다. 이 4개의 주소는 모든 Living Security 리전에서 동일합니다. 전체 목록, 변경 정책 및 문제 해결 방법은{' '}
    <a href="/ko/integrations/managing/egress-ip-addresses">
      연동 송신 IP 주소 구성
    </a>{' '}
    문서를 참조하십시오.
  </Note>;

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="KnowBe4" />

## 이 연동이 제공하는 데이터

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

* `training.completed` — 보안 교육을 완료함
* `training.past.due` — 기한이 지난 교육이 있음
* `phishing.simulation.clicked` — 시뮬레이션을 클릭하고 신고하지 않음

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

## Living Security에 필요한 정보

| 자격 증명 | 설명 |
| - | - |
| **API 키** | **Account Settings → API**에서 생성한 Reporting API 베어러 토큰입니다. 모든 요청의 `Authorization: Bearer` 헤더에 포함되어 전송됩니다. |
| **Reporting API server region** | KnowBe4 계정이 프로비저닝된 리전이며, 목록에서 선택합니다(US, EU, Canada, UK, Germany). |

**범위(Scope):** 구성할 항목이 없습니다. KnowBe4 Reporting API 토큰은 설계상 읽기 전용이며 범위가 지정되지 않습니다. 이 토큰은 사용자, 교육 등록 정보 및 피싱 보안 테스트 결과에 대한 읽기 권한을 부여하며, 이는 동기화가 읽는 데이터와 정확히 일치합니다.

**필요한 역할:** KnowBe4의 **Account Admin**(계정 관리자만 **Account Settings → API**에 액세스할 수 있습니다)

### 사전 요구 사항

* **Account Admin** 역할로 KnowBe4 콘솔에 로그인해야 합니다. 계정 관리자만 **Account Settings → API**에 액세스하여 Reporting API를 활성화하고 토큰을 생성할 수 있습니다.

***

## 파트 A — KnowBe4에서

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

<Steps>
  <Step title="Reporting API 활성화 및 토큰 생성">
    1. KnowBe4 콘솔에 로그인합니다.
    2. 오른쪽 상단의 계정 이름을 클릭하고 **Account Settings**를 선택합니다.
    3. 왼쪽 탐색 메뉴에서 **API**를 선택합니다.
    4. **Reporting API**가 활성화되어 있지 않으면 활성화한 다음 새 API 토큰을 생성합니다.

    콘솔에서 용도를 입력하라는 메시지가 표시되면 토큰에 용도를 알 수 있는 설명(예: `Living Security Platform`)을 지정합니다.

    <Warning>
      KnowBe4는 API 토큰 값을 생성될 때 **한 번만** 표시합니다. 즉시 복사하여 비밀번호 보관소나 시크릿 관리자와 같은 안전한 위치에 저장하십시오. 복사하지 않고 페이지를 벗어난 경우 새 토큰을 생성해야 합니다.
    </Warning>

    <Note>
      Reporting API는 읽기 전용입니다. 이 API는 사용자, 교육 등록 정보 및 피싱 보안 테스트 결과를 제공하며, 이는 Living Security가 점수 산정 및 보고를 위해 수집하는 데이터입니다. 쓰기 권한은 필요하지 않습니다.
    </Note>
  </Step>

  <Step title="Allowed IP Addresses 목록에 Living Security 송신 IP 추가">
    KnowBe4에서는 Reporting API 액세스를 특정 소스 IP 주소 집합으로 제한할 수 있습니다. 이 설정은 토큰과 같은 위치에 있습니다.

    1. KnowBe4 콘솔에서 **Account Settings → API → Allowed IP Addresses**로 이동합니다.
    2. 각 [Living Security 송신 IP 주소](/ko/integrations/managing/egress-ip-addresses)를 허용 목록에 추가합니다. 동일한 네 개의 주소가 모든 리전에 적용됩니다.

    <EgressIpSafelist system="KnowBe4" />

    <Warning>
      **Allowed IP Addresses 목록이 구성되어 있으면 네트워크 계층에서 적용됩니다.** 연결 대화 상자에서는 인증 시점에 성공하지만, Living Security 송신 IP가 허용 목록에 추가될 때까지 데이터 동기화는 실패합니다(네트워크 계층에서 차단되며, 일반적으로 `403`로 나타납니다). 이 목록에 주소를 하나라도 추가한 경우 Living Security 범위도 반드시 추가해야 합니다. 그렇지 않으면 토큰이 유효하더라도 요청이 거부됩니다.
    </Warning>

    <Note>
      Living Security의 송신 IP 주소는 인프라가 업데이트될 때 변경될 수 있으나, 이러한 변경은 드물게 발생합니다. 이전에 정상적으로 작동하던 데이터 동기화가 실패하기 시작하면 [연동 송신 IP 주소 구성](/ko/integrations/managing/egress-ip-addresses)을 확인하고 Allowed IP Addresses 목록이 일치하는지 확인하십시오.
    </Note>
  </Step>

  <Step title="KnowBe4 서버 리전 확인">
    KnowBe4는 리전별 호스트에서 Reporting API를 제공합니다. 호스트 이름을 직접 입력하는 대신 연결 대화 상자에서 리전을 선택합니다.

    | 리전 | Reporting API 호스트 |
    | - | - |
    | 미국 | `us.api.knowbe4.com` |
    | 유럽 | `eu.api.knowbe4.com` |
    | 캐나다 | `ca.api.knowbe4.com` |
    | 영국 | `uk.api.knowbe4.com` |
    | 독일 | `de.api.knowbe4.com` |

    계정이 사용하는 리전을 확실히 모르는 경우 KnowBe4 콘솔 URL의 도메인을 확인하거나 KnowBe4 관리자에게 문의하십시오.

    <Note>
      이 다섯 개 리전이 Living Security가 연결할 수 있는 리전입니다. KnowBe4 계정이 다른 서버(예: 미국 정부 인스턴스)에 있는 경우 연결을 시작하기 전에 Living Security 지원팀에 문의하십시오.
    </Note>
  </Step>
</Steps>

***

## 파트 B — Living Security Platform에서

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

<Steps>
  <ConnectInPlatform tile="KnowBe4">
    | 필드 | 값 |
    | - | - |
    | **API 키** | 파트 A 1단계의 Reporting API 토큰 |
    | **Reporting API server region** | 파트 A 3단계에서 확인한 리전(예: United States) |
  </ConnectInPlatform>
</Steps>

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

***

## 문제 해결

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    API 토큰이 유효하지 않거나 만료되었습니다. 토큰이 올바른지, 그리고 **Account Settings → API**에서 재생성되지 않았는지 확인하십시오.
  </Accordion>

  <Accordion title="403 Forbidden">
    토큰에 Reporting API 액세스 권한이 없거나, 요청 IP가 Allowed IP Addresses 목록에 없습니다. Reporting API가 활성화되어 있는지, 그리고 네 개의 [Living Security 송신 IP 주소](/ko/integrations/managing/egress-ip-addresses)가 모두 허용 목록에 있는지 확인하십시오.
  </Accordion>

  <Accordion title="빈 결과(200 OK이지만 데이터 없음)">
    Reporting API에 아직 반환할 데이터가 없거나, 토큰의 계정이 Living Security가 수집하는 사용자와 캠페인을 볼 수 있는 권한이 없을 수 있습니다. 토큰이 Account Admin에 의해 생성되었는지 확인하십시오.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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