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

# OneLogin 연동 설정

> 사용자 수명 주기, 인증, MFA 및 관리 활동을 위해 OneLogin을 Living Security에 연결합니다.

export const EgressIpAllowlistBothSets = ({system}) => <Warning>
    <strong>{system}에는 하나가 아닌 두 세트의 주소가 필요합니다.</strong> Living Security는 자체 인프라에서 이 연동의 액세스 토큰을 발급하고 지속적으로 갱신하므로, 설정 트래픽과 동기화 트래픽은 서로 다른 네트워크에서 발생합니다. {system}에서 두 세트를 모두 허용 목록에 추가하고 계속 유지하십시오. 이는 설정 시에만 필요한 요구 사항이 아닙니다.
    <br />
    <br />
    <strong>연동 동기화 트래픽</strong> — 모든 리전에서 동일합니다.
    <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 />
    <strong>플랫폼 트래픽</strong> — 조직이 호스팅되는 리전의 행만 사용하십시오.
    <br />
    미국: <code>98.91.60.249/32</code>, <code>13.216.91.102/32</code>
    <br />
    유럽 연합: <code>34.246.236.210/32</code>, <code>52.31.102.238/32</code>
    <br />
    <br />
    동기화 세트만 허용 목록에 추가하면 설정이 완료되지 않습니다. 플랫폼 세트만 허용 목록에 추가하면 설정은 성공하지만 모든 동기화가 실패합니다. 두 가지 실패 유형과 변경 정책은{' '}
    <a href="/ko/integrations/managing/egress-ip-addresses">
      연동 송신 IP 주소 구성
    </a>{' '}
    문서를 참조하십시오.
  </Warning>;

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="OneLogin" recommendDelegated={true} />

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

OneLogin은 정규화된 사용자 수명 주기, 인증, MFA 및 관리 활동 데이터를 제공할 수 있습니다. 검토된 예시는 다음과 같습니다.

* `mfa.success` — MFA 인증 요청을 완료합니다
* `mfa.failed` — MFA 인증 요청에 실패합니다
* `account.locked` — 계정이 잠깁니다

[연동 데이터가 신호가 되는 과정](/ko/signals/data-sources)을 참조하십시오.

## Living Security에 필요한 정보

| 자격 증명 | 설명 |
| - | - |
| **클라이언트 ID** | 사용자 및 이벤트를 읽을 수 있는 권한이 있는 OneLogin API 자격 증명 쌍의 클라이언트 ID입니다. |
| **클라이언트 시크릿** | 해당 자격 증명 쌍의 클라이언트 시크릿입니다. |
| **테넌트 서브도메인** | OneLogin 테넌트 URL에서 `.onelogin.com` 앞에 있는 값입니다. |

## 설정

<Steps>
  <Step title="OneLogin에서 API 자격 증명 생성">
    계정 소유자 또는 관리자로서 **Developers → API Credentials**를 열고 전용 자격 증명을 생성한 다음, 사용자 및 이벤트를 읽을 수 있는 범위를 선택합니다. 클라이언트 ID와 시크릿은 안전하게 보관하십시오.
  </Step>

  <ConnectInPlatform tile="OneLogin">
    테넌트 서브도메인, 클라이언트 ID, 클라이언트 시크릿을 입력한 후 연결합니다.
  </ConnectInPlatform>
</Steps>

Living Security는 자격 증명 쌍을 액세스 토큰으로 교환하고 만료되기 전에 갱신하므로, 사용자가 토큰을 생성하거나 교체할 필요가 없습니다. 자격 증명 쌍 자체는 평소 일정에 따라 교체하고, 교체 후에는 타일을 다시 연결하십시오.

## 확인 및 문제 해결

연결에서 최소 한 명의 사용자를 읽을 수 있는지 확인하십시오. 테넌트에 최근 활동이 없는 경우 감사 이벤트가 비어 있을 수 있습니다.

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    클라이언트 ID 또는 클라이언트 시크릿이 잘못되었거나, OneLogin에서 해당 자격 증명 쌍이 삭제되었습니다. **Developers → API Credentials**에서 해당 쌍이 아직 존재하는지 확인한 후, 현재 값으로 다시 연결하십시오.
  </Accordion>

  <Accordion title="403 Forbidden">
    OneLogin 리소스 API, 사용자 및 이벤트를 읽을 수 있는 권한으로 API 자격 증명을 다시 생성하십시오.
  </Accordion>

  <Accordion title="테넌트에 연결할 수 없음">
    전체 URL이나 관리용 표시 이름이 아닌 테넌트 서브도메인만 입력하십시오.

    서브도메인이 올바른데도 테넌트에 연결할 수 없는 경우, 사용 중인 계정에서 OneLogin이 소스 IP 주소를 기준으로 API 접근을 제한하는지 확인하십시오. Living Security가 액세스 토큰을 직접 발급하고 지속적으로 갱신하기 때문에, 토큰 요청과 예약된 동기화가 서로 다른 네트워크에서 발생합니다. 따라서 이 연동에서는 **두 가지** 주소 집합을 모두 허용 목록에 추가해야 합니다.

    <EgressIpAllowlistBothSets system="OneLogin" />
  </Accordion>
</AccordionGroup>

공급업체 측 세부 정보는 [OneLogin의 API 자격 증명 가이드](https://developers.onelogin.com/api-docs/2/getting-started/working-with-api-credentials)를 참조하십시오.

<PublicIntegrationNextSteps />


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