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

# Netskope 연동 설정

> 웹, 클라우드, 인증, 데이터 보호 및 위협 활동을 수집하기 위해 Netskope를 Living Security에 연결합니다.

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

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

Netskope는 정규화된 웹, 클라우드, 인증, 데이터 보호 및 위협 활동을 제공할 수 있습니다. 검토된 예시는 다음과 같습니다.

* `web.ai.visited` — AI 웹사이트 방문
* `data.bulk.uploaded` — 대량 데이터 업로드
* `geo.impossible` — 로그인 간 불가능한 이동(impossible travel)

현재 연결은 REST API v2를 사용하며, 기존 고객에게는 레거시 REST 방식이 표시될 수 있습니다. [연동 데이터가 신호가 되는 방식](/ko/signals/data-sources)을 참조하십시오.

## Living Security에 필요한 정보

| 자격 증명 | 설명 |
| - | - |
| **API 토큰** | Netskope 관리자 콘솔에서 생성한 REST API v2 토큰 |
| **테넌트 서브도메인** | Netskope 테넌트의 서브도메인(예: `acme.goskope.com`의 `acme`) |

**필요한 엔드포인트 액세스:**

| 엔드포인트 | 용도 |
| - | - |
| `/api/v2/events/data/alert` | 위협 경고, 정책 위반, DLP 이벤트, 악성코드 탐지 |
| `/api/v2/events/data/page` | 웹 활동 — 브라우징, 허용 및 차단된 사이트, 클라우드 앱 액세스 |

**필요한 역할:** **Tenant Admin** 또는 **Settings → Tools**에 액세스할 수 있는 동등한 역할

<Note>
  이 연동에는 v1 토큰이 아닌 **v2 API 토큰**이 필요합니다. v1 토큰은 쿼리 매개변수 인증을 사용하므로 v2 API 엔드포인트에서 작동하지 않습니다.
</Note>

### 사전 요구 사항

* REST API 토큰을 관리하려면 Netskope에서 **Tenant Admin** 권한이 있어야 합니다.

***

## A부 — Netskope에서

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

<Steps>
  <Step title="REST API v2 토큰 관리로 이동">
    1. `https://<tenant>.goskope.com`에서 Netskope 관리자 콘솔에 로그인합니다.
    2. 왼쪽 탐색 메뉴에서 **Settings**를 클릭합니다.
    3. **Tools** 아래에서 **REST API v2**를 선택합니다.
  </Step>

  <Step title="새 토큰 생성">
    1. **New Token**을 클릭합니다.
    2. 식별하기 쉬운 이름을 입력합니다(예: `Living Security Platform`).
    3. 엔드포인트 액세스에서 다음에 대한 액세스를 활성화합니다.

    | 엔드포인트 | 필요한 액세스 |
    | - | - |
    | `/api/v2/events/data/alert` | 읽기 |
    | `/api/v2/events/data/page` | 읽기 |

    <Warning>
      **두** 엔드포인트를 모두 허용하십시오. 두 엔드포인트는 `alerts` 및
      `events`이라는 별개의 두 스트림에 데이터를 공급하며, 둘 중 하나로만 범위가 지정된 토큰도 연결에는 성공합니다.
      그러나 누락된 엔드포인트에 연결된 스트림은 오류 없이 아무 데이터도 반환하지 않으므로 원인을 알 수 없습니다.
    </Warning>

    <Note>
      이 두 엔드포인트만 Living Security에 필요합니다. 그 외의 권한을 부여하지 않는 것이 최소 권한 원칙에 부합합니다.
    </Note>

    4. **Save**(또는 **Generate Token**)를 클릭합니다.
  </Step>

  <Step title="토큰 복사 및 저장">
    **토큰을 즉시 복사**하여 안전하게 보관하십시오.

    <Warning>
      Netskope는 토큰 값을 생성 시 **한 번만** 표시합니다. 복사하지 않고 페이지를 벗어난 경우 토큰을 삭제하고 새로 만들어야 합니다.
    </Warning>
  </Step>

  <Step title="IP 허용 목록 구성(해당하는 경우)">
    Netskope 테넌트에서 IP 허용 목록이 활성화되어 있다면 Living Security의 송신(egress) IP 대역을 추가해야 합니다.

    1. Netskope 관리자 콘솔에서 **Settings → Administration → IP Allowlist**로 이동합니다.
    2. IP 허용 목록이 활성화되어 있다면 각 [Living Security 송신 IP 주소](/ko/integrations/managing/egress-ip-addresses)를 **Custom IP** 목록에 추가합니다.

    <EgressIpSafelist system="Netskope" />

    <Warning>
      IP 허용 목록이 활성화된 경우 연결 대화 상자에서는 성공하더라도, 올바른 IP가 추가될 때까지 데이터 동기화는 `401 Unauthorized` 오류와 함께 실패합니다.
    </Warning>
  </Step>

  <Step title="테넌트 서브도메인 확인">
    테넌트 서브도메인은 Netskope 관리자 콘솔 URL의 접두사입니다.

    콘솔 URL이 `https://acme.goskope.com`인 경우 서브도메인은 `acme`입니다.

    서브도메인만 입력하십시오. `https://`, `.goskope.com`, 후행 슬래시는 포함하지 않습니다.

    <Note>
      연결 대화 상자는 여러 입력 형식(서브도메인만, 전체 호스트 이름 또는 전체 URL)을 허용하며 자동으로 정규화합니다. 그래도 서브도메인만 입력하는 것을 권장합니다.
    </Note>
  </Step>
</Steps>

***

## B부 — Living Security Platform에서

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

<Steps>
  <ConnectInPlatform tile="Netskope (v2 API)">
    | 필드 | 값 |
    | - | - |
    | **API 키** | A부 3단계에서 받은 토큰 |
    | **테넌트 서브도메인** | A부 5단계에서 확인한 서브도메인(예: `acme`) |

    <img src="https://mintcdn.com/livingsecurity/oVkrOMkYmNevekTI/integrations/images/netskope-v2-api/connect-dialog.png?fit=max&auto=format&n=oVkrOMkYmNevekTI&q=85&s=89b64e78a14c51a0977c3a2a28418988" alt="Netskope v2 API용 Living Security 연결 대화 상자" style={{maxWidth: "450px"}} width="576" height="356" data-path="integrations/images/netskope-v2-api/connect-dialog.png" />
  </ConnectInPlatform>
</Steps>

이제 Netskope(v2 API)에 연결되었습니다.

***

## 문제 해결

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    일반적인 원인은 다음과 같습니다.

    1. **토큰이 취소되었거나 만료됨** — 새 토큰을 생성합니다.
    2. **v1 토큰 사용** — v1 토큰은 쿼리 매개변수로 인증하므로 v2 엔드포인트에서 작동하지 않습니다. **Settings → Tools → REST API v2**에서 새 v2 토큰을 생성합니다.
    3. **IP 허용 목록이 요청을 차단함** — 테넌트에서 IP 허용 목록이 활성화되어 있다면 [Living Security 송신 IP 주소](/ko/integrations/managing/egress-ip-addresses) 네 개가 모두 허용 목록에 있는지 확인합니다.
  </Accordion>

  <Accordion title="403 Forbidden">
    토큰이 `/api/v2/events/data/alert` 또는 `/api/v2/events/data/page`에 대한 액세스 권한 없이 생성되었습니다. 토큰의 엔드포인트 권한은 생성 후 변경할 수 없으므로, 두 엔드포인트 모두에 읽기 권한이 있는 새 토큰을 생성한 후 다시 연결하십시오.
  </Accordion>

  <Accordion title="경고는 수신되지만 웹 활동이 누락됨(또는 그 반대)">
    토큰에 필요한 두 엔드포인트 중 하나가 누락되어 있습니다.
    `/api/v2/events/data/alert` 또는 `/api/v2/events/data/page` 중 하나로만 범위가 지정된 토큰도 연결은 되지만,
    누락된 엔드포인트에 연결된 스트림은 아무 알림 없이 계속 비어 있게 됩니다.

    엔드포인트 권한은 토큰 생성 후 변경할 수 없습니다. 두 엔드포인트 모두에 읽기 권한이 있는
    새 토큰을 생성한 후 다시 연결하십시오.
  </Accordion>

  <Accordion title="동기화가 작동했으나 이제 401 오류로 실패함">
    IP 허용 목록이 활성화된 경우 Living Security의 송신 IP 주소가 변경되었을 수 있습니다. [연동 송신 IP 주소 구성](/ko/integrations/managing/egress-ip-addresses)을 확인하고 **Custom IP** 목록을 그에 맞게 업데이트하십시오.
  </Accordion>

  <Accordion title="v2 대신 v1 토큰을 사용함">
    v1 토큰과 v2 토큰은 서로 다른 인증 방식을 사용합니다.

    * **v1**: 쿼리 매개변수(`token=...`)
    * **v2**: 헤더(`Netskope-Api-Token: ...`)

    Living Security는 v2 인증을 사용합니다. **Settings → Tools → REST API v2**(레거시 v1 토큰 페이지가 아님)에서 새 토큰을 생성하십시오.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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