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

# CultureAI 통합 설정

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

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

CultureAI는 피싱, 교육, 직원 신고, 데이터 보호 활동 데이터를 제공할 수 있습니다. 검토된 예시는 다음과 같습니다.

* `phishing.real.clicked` — 실제 피싱 이메일의 링크를 클릭함
* `data.transfer.blocked` — 데이터 전송이 차단됨
* `phishing.safe.reported` — 이후 안전한 것으로 판정된 이메일을 신고함

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

## Living Security에 필요한 정보

| 자격 증명 | 설명 |
| - | - |
| **API 키** | CultureAI 관리자 콘솔에서 생성한 키입니다. Living Security는 CultureAI API에 인증하기 위해 모든 요청에 이 키를 전송합니다. 필요한 유일한 자격 증명입니다. |

**범위(Scopes):** CultureAI API 키에는 범위가 지정되지 않으며, 유효한 키가 있으면 API에 접근할 수 있습니다. Living Security는 보고 데이터만 읽습니다. 키를 생성할 때 CultureAI 콘솔에서 범위 또는 권한을 선택할 수 있는 경우 보고 데이터에 대한 읽기 전용 접근 권한을 부여하십시오.

**필요한 역할:** CultureAI의 **관리자** 또는 **소유자** (API 접근 관리용)

### 사전 요구 사항

* API 접근을 관리할 수 있는 역할(일반적으로 **관리자** 또는 **소유자** 역할)로 CultureAI 관리자 콘솔에 로그인되어 있어야 합니다. API 또는 개발자 설정 영역이 보이지 않으면 CultureAI 계정 담당자에게 문의하여 귀 조직에 API 접근을 활성화하도록 요청하십시오.

***

## A단계 — CultureAI에서

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

<Steps>
  <Step title="API 키 생성">
    1. CultureAI 관리자 콘솔에 로그인합니다.
    2. 조직 또는 계정 설정을 열고 **API**(또는 **API keys** / **Developer**) 영역을 찾습니다.
    3. 새 API 키를 생성하고 설명이 되는 이름(예: `Living Security Platform`)을 지정합니다.

    <Note>
      Living Security는 CultureAI에서 수집하는 보고 데이터에 대한 읽기 전용 접근에 이 키를 사용합니다. 쓰기 권한은 필요하지 않습니다. CultureAI에서 범위 또는 권한을 선택하라는 메시지가 표시되면 보고 데이터에 대한 읽기 권한만 부여하십시오.
    </Note>

    <Warning>
      CultureAI는 API 키 값을 생성 시 **한 번만** 표시할 수 있습니다. 즉시 복사하여 비밀번호 보관소 또는 비밀 관리자와 같은 안전한 위치에 저장하십시오. 복사하지 않고 페이지를 벗어난 경우에는 새 키를 생성해야 합니다.
    </Warning>

    <Note>
      API 키를 생성할 위치를 찾을 수 없거나 어떤 권한을 부여해야 할지 확실하지 않은 경우 CultureAI 계정 담당자에게 문의하십시오. Living Security는 사용자를 대신하여 CultureAI 자격 증명을 생성할 수 없습니다.
    </Note>
  </Step>
</Steps>

***

## B단계 — Living Security Platform에서

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

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

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

***

## 문제 해결

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    API 키가 유효하지 않거나 해지되었습니다. 키가 올바른지, 그리고 CultureAI에서 재생성되지 않았는지 확인하십시오.
  </Accordion>

  <Accordion title="403 Forbidden">
    API 키에 보고 데이터에 대한 읽기 권한이 없습니다. CultureAI에서 해당 키에 읽기 권한이 부여되어 있는지 확인하거나, 올바른 권한으로 새 키를 생성하십시오.
  </Accordion>

  <Accordion title="빈 결과(200 OK이지만 데이터 없음)">
    API 키에 Living Security가 수집하는 보고 데이터에 대한 접근 권한이 없을 수 있습니다. CultureAI 계정 담당자에게 해당 키에 보고 데이터에 대한 읽기 권한이 있는지 확인하십시오.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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