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

# 연동 설정

> 공급자 자격 증명을 준비하고, 지원되는 시스템을 연결하고, 데이터 스트림을 활성화한 후, 첫 번째 동기화가 성공했는지 확인합니다.

이 가이드는 **설정 → 통합 → 카탈로그**에 나열된 연동의 공통 설정 절차를 다룹니다. 공급자별 필드, 권한 및 인증 단계는 해당 공급자의 카탈로그 카드에 링크된 설정 가이드를 따릅니다.

## 사전 요구 사항

| 역할 | 책임 |
| - | - |
| [**프로그램 소유자**](/ko/reference/glossary#%ED%94%84%EB%A1%9C%EA%B7%B8%EB%9E%A8-%EC%86%8C%EC%9C%A0%EC%9E%90-program-owner) | 소스를 선택하고, Living Security에서 연결하고, 스트림을 활성화하고, 결과를 확인합니다 |
| [**시스템 관리자**](/ko/reference/glossary#%EC%8B%9C%EC%8A%A4%ED%85%9C-%EA%B4%80%EB%A6%AC%EC%9E%90-system-administrator) | 소스 시스템에서 자격 증명과 범위를 생성하거나 승인합니다 |

이 역할들은 동일한 사람이 맡을 수 있습니다. Living Security에 자격 증명을 입력하는 사람은 연동 관리를 허용하는 관리자 역할을 보유해야 합니다. 범위가 제한된 설정 전용 역할이 있다고 가정하여 소스 시스템 관리자를 Living Security에 초대하지 마십시오.

시작하기 전에 다음을 수행하십시오.

* 연결이 속할 Living Security 조직과 환경을 선택합니다.
* 공급자의 카탈로그 가이드를 열고 필요한 범위, 리디렉션 URL 및 허용 목록 요구 사항을 확인합니다.
* 자격 증명을 생성하는 사람과 입력하는 사람이 다른 경우, 조직에서 승인한 비밀 정보 공유 절차를 사용합니다.
* 비밀번호, 클라이언트 비밀, 개인 키 또는 액세스 키 값은 이메일이나 지원 티켓으로 절대 전송하지 마십시오.

## 1. 공급자 자격 증명 준비

**설정 → 통합 → 카탈로그**를 열고 공급자를 찾은 다음, 자격 증명을 생성하기 전에 해당 설정 가이드를 읽으십시오.

공급자 인증에는 OAuth 동의, API 토큰, 클라이언트 ID와 비밀, 서비스 계정 또는 공급자가 지원하는 다른 방식을 사용할 수 있습니다. 해당 공급자의 가이드에 명시된 자격 증명과 범위만 생성하십시오.

<Warning>
  다른 공급자의 권한을 복사하거나 “혹시 모르니” 광범위한 쓰기 권한을 부여하지
  마십시오. 권한이 부족한 경우 대개 수정 가능한 명확한 401 또는 403 오류가
  발생하지만, 과도한 권한은 피할 수 있는 위험을 초래합니다.
</Warning>

## 2. 공급자 연결

<Steps>
  <Step title="카탈로그 열기">
    **설정 → 통합 → 카탈로그**로 이동하여 공급자를 선택합니다.
  </Step>

  <Step title="연결 시작">
    **연결**을 선택합니다. OAuth 흐름을 완료하거나 연결 대화 상자에서 요청하는
    필드를 입력합니다. 각 값을 어디에서 가져오는지는 공급자 가이드에서
    설명합니다.
  </Step>

  <Step title="인증 완료">
    해당하는 경우 공급자의 동의 화면을 승인합니다. 인증에 성공하면 Living Security가 새 연결을 열거나 **연결됨**에 나열합니다.
  </Step>
</Steps>

공급자가 인증을 거부하면 진행하기 전에 중단하고 자격 증명, 테넌트, 리전, 리디렉션 URL 또는 소스 시스템 권한을 수정하십시오.

## 3. 데이터 스트림 활성화

**설정 → 통합 → 연결됨**에서 연결을 엽니다. Living Security는 해당 공급자에서 사용할 수 있는 동기화 템플릿을 검색하여 스트림으로 나열합니다.

1. 각 스트림의 이름과 용도를 검토합니다.
2. 프로그램에 필요한 스트림만 활성화합니다.
3. 관련 없는 스트림은 일시 중지 상태로 둡니다.
4. 가능한 경우 **지금 동기화**를 사용하여 첫 번째 실행을 요청합니다.

모든 공급자가 동일한 스트림이나 일정 제어를 제공하는 것은 아닙니다. 범용적인 빈도, 범위, 필드 매핑, 초안 또는 활성화 마법사가 있을 것으로 기대하지 말고, 연결에 표시되는 제어 항목을 따르십시오.

## 4. 첫 번째 실행 확인

연결 인증만으로는 데이터가 흐르고 있음이 증명되지 않습니다.

<Steps>
  <Step title="연결 상태 확인">
    연결이 정상이며 재인증을 요청하지 않는지 확인합니다.
  </Step>

  <Step title="스트림 상태 확인">
    필요한 스트림이 일시 중지되지 않고 활성화되어 있는지 확인합니다.
  </Step>

  <Step title="최근 실행 검사">
    스트림, 연결의 동기화 링크 또는 **설정** → **통합** → **동기화**를 엽니다. 성공적인 최종 결과가 나올 때까지 기다린 후, 가능한 경우 공급자 오류와 레코드 수를 검토합니다.
  </Step>

  <Step title="다운스트림 데이터 확인">
    관련 Living Security 화면을 엽니다. ID 데이터는 인력에 예상되는 사용자와 ID를 생성해야 하며, 보안 소스 데이터는 해당 공급자가 문서화한 기능에 표시되어야 합니다.
  </Step>
</Steps>

온보딩의 경우, 여정 맵의 **Verify Identity Data Flowing** 및 **Verify Integration Data Flowing** 작업은 수집된 데이터를 기준으로 완료됩니다. 저장된 연결을 이러한 확인 결과의 대체 수단으로 사용하지 마십시오.

## 동기화 상세 페이지

**설정** → **통합** → **동기화**에서 동기화를 열면 구성과 실행 이력을 한곳에서 볼 수 있습니다.

상세 페이지에는 다음 내용이 표시됩니다.

| 섹션 | 포함 내용 |
| - | - |
| **헤더** | 동기화 이름, 상태 배지, 연동 공급자 |
| **통계** | 모델, 마지막 동기화, 완료된 실행, 총 레코드 수 |
| **실행 이력** | 상태, 소요 시간, 레코드 수가 포함된 최근 실행 |
| **작업** | **새로 고침**, **일시 중지** / **이력서**, **지금 동기화** |

동기화가 활성 상태일 때 **지금 동기화**를 사용하여 즉시 실행을 시작합니다. 일시 중지된 동기화는 예약 실행이나 수동 실행이 시작되기 전에 재개해야 합니다.

연동에 활성 스트림이 나열되어 있으면 해당 연결 상세 페이지에서도 동기화를 열 수 있습니다.

## 연결 작업

연결 상세 페이지에는 해당 연동에서 지원하는 작업이 표시됩니다.

| 작업 | 효과 |
| - | - |
| **지금 동기화** | 선택한 스트림에 대해 즉시 실행을 요청합니다 |
| **스트림 일시 중지** | 연결은 유지한 채 해당 스트림의 새 실행을 중지합니다 |
| **연결 일시 중지** | 구성을 삭제하지 않고 지원되는 연결 활동을 중지합니다 |
| **이력서** | 일시 중지된 스트림 또는 연결을 다시 시작합니다 |
| **재인증** | 자격 증명이나 동의가 변경된 후 인증을 다시 수행합니다 |
| **제거** | 확인 후 연결 구성을 삭제합니다 |

연결을 제거하는 것은 해당 연결에서 이미 수집된 데이터를 삭제하는 것과 다릅니다. 데이터 보존 동작이 결정에 영향을 미치는 경우 공급자 가이드를 검토하거나 지원팀에 문의하십시오.

## 사용자 지정 푸시 소스

카탈로그 커넥터를 통해 폴링되는 방식이 아니라 시스템이 Living Security로 데이터를 전송하는 경우 **사용자 지정 푸시 소스**를 사용합니다.

1. **카탈로그** 하단에서 소스를 생성합니다.
2. 사용자 지정 푸시 영역에서 해당 상세 페이지를 엽니다.
3. 대상 스트림을 선택합니다.
4. 수동 일괄 처리에는 **CSV 업로드**를, 자동화된 전송기에는 **API로 푸시**를 사용합니다.
5. 전송 후 파일 또는 페이로드를 미리 보고 소스의 실행 이력을 검토합니다.

엔드포인트, 인증, 페이로드, 재시도 및 검증 규약 전체에 대해서는 [사용자 지정 푸시 소스 API](/ko/integrations/custom-push-source)를 참조하십시오. 이전 Unify 연동 가이드에서 이러한 세부 정보를 유추하지 마십시오.

소스 상세 업로더는 최대 100 MB의 소스 CSV 파일을 허용합니다. 업로드하기 전에 대시보드가 이 파일을 클라이언트 측에서 요청당 10 MB 및 10,000행 이하로 분할합니다. 이 소스 전용 업로더는 ID 및 활동 템플릿용 일반 **통합 → 업로드** 페이지와 별개입니다.

## 문제 해결

| 증상 | 확인 사항 |
| - | - |
| `401 Unauthorized` | 자격 증명 값, 만료, 해지, 공급자 테넌트 및 재인증 상태 |
| `403 Forbidden` | 필요한 공급자 역할, 범위, 관리자 동의 및 소스 시스템 액세스 정책 |
| 연결이 즉시 실패함 | 리디렉션 URL, 리전, 소스 URL, 네트워크 또는 IP 허용 목록 요구 사항 |
| 연결은 정상이지만 실행이 발생하지 않음 | 필요한 스트림이 활성화되어 있고 공급자가 해당 스트림을 제공함 |
| 성공한 실행이 레코드를 반환하지 않음 | 소스 계정이 예상 대상 집단을 볼 수 있고 공급자 측 필터가 올바름 |
| 데이터가 잘못된 사용자에게 표시됨 | 연결된 소스 전반에서 ID 속성과 별칭이 일관됨 |
| 데이터 업데이트가 중단됨 | 스트림 또는 연결이 일시 중지되었거나, 자격 증명이 만료되었거나, 최근 실행이 실패함 |

[Living Security 지원팀](mailto:support@livingsecurity.com)에 문의할 때는 조직, 공급자, 연결 이름, 스트림, 최근 실행 시간 및 표시된 오류를 포함하십시오. 비밀 정보는 포함하지 마십시오.

## 관련 문서

<CardGroup cols={2}>
  <Card title="통합 개요" icon="grid-2" href="/ko/integrations/overview">
    연결됨, 카탈로그, 동기화, 작업 및 업로드에 대한 참조 문서입니다.
  </Card>

  <Card title="데이터 매핑" icon="arrows-left-right" href="/ko/integrations/managing/data-mapping">
    지원되는 속성과 사용 가능한 경우의 매핑을 이해합니다.
  </Card>

  <Card title="연동 수명 주기" icon="route" href="/ko/integrations/managing/lifecycle">
    재인증 또는 제거를 통해 기존 연동을 운영합니다.
  </Card>

  <Card title="관리자 온보딩" icon="circle-check" href="/ko/getting-started/onboarding">
    ID 및 보안 데이터 확인 작업을 완료합니다.
  </Card>
</CardGroup>


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