> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Okta

> API 토큰으로 Okta를 Iru Compliance에 연결하여 디렉터리 사용자 및 그룹, 애플리케이션 할당, MFA 정책 및 System Log 감사 증거를 수집합니다.

### Okta 정보

**Okta** 커넥터는 Okta 조직에서 디렉터리 데이터, 그룹 멤버십, 애플리케이션 할당, 정책, MFA 상태 및 감사 관련 신호를 읽고 Iru Compliance에서 아티팩트로 표시합니다. 인증에는 **Okta Management API**를 통한 **Okta API 토큰**을 사용합니다. 통합은 **읽기 전용** 증거 수집을 위한 것입니다. Iru는 API 읽기 중에 토큰의 관리자 권한이 허용하는 범위를 넘어 Okta에서 사용자를 프로비저닝하거나 정책을 변경하지 않습니다.

### 작동 방식

Okta는 **SSWS** 방식으로 API 토큰을 받습니다.

```http theme={null}
Authorization: SSWS YOUR_API_TOKEN
```

토큰은 토큰을 생성한 관리자의 권한을 상속합니다. **사용되지 않는 토큰은 30일 후에 만료**되며, API 호출이 성공하면 해당 기간이 갱신됩니다.

Iru 커넥터는 테넌트의 서버 URL(프로덕션, EMEA, Gov, 프리뷰 또는 커스텀 도메인)을 단계별로 안내한 다음 마지막 단계에서 **API 토큰**을 받습니다. 앞선 마법사 단계는 제품이 필요로 하는 위치에 OAuth 관련 URL을 맞추며, 이 소스의 Management API 호출을 승인하는 것은 **SSWS 토큰 인증**입니다.

| 항목 | 값 |
| - | - |
| **범주** | 보안 |
| **인증** | Okta API 토큰(`Authorization: SSWS YOUR_TOKEN`) |
| **Okta 요금제** | 사용하는 Management API 액세스가 포함된 모든 요금제 |

문서: [Create an API token](https://developer.okta.com/docs/guides/create-an-api-token/main/), [API token management](https://help.okta.com/en-us/content/topics/security/api.htm), [Rate limits](https://developer.okta.com/docs/reference/rate-limits/).

### 사전 요구 사항

* **API 토큰을 생성**할 수 있는 Okta 관리자 역할(조직에서 자동화 계정에 허용하는 범위에 따라 **Super Admin**, **조직 관리자** 또는 **Read-only Admin**).
* 조직의 **하위 도메인** 또는 전체 **Okta 도메인**(예: 사용자가 `https://acme.okta.com`에서 로그인하는 경우 `acme`).

### Okta를 Iru에 연결

<Tabs>
  <Tab title="Okta">
    <Note>
      Compliance에서 소스를 연결하기 전에 이 탭을 완료하세요.
    </Note>

    <Steps>
      <Step title="Okta Admin Console에 로그인">
        조직의 관리자 URL(예: `https://YOUR_SUBDOMAIN.okta.com/admin`)을 열고 **API 토큰**을 생성할 수 있는 역할(조직에서 자동화 계정에 허용하는 범위에 따라 **Super Admin**, **조직 관리자** 또는 **Read-only Admin**)로 로그인합니다.
      </Step>

      <Step title="보안 열기">
        왼쪽 탐색에서 **보안**을 펼칩니다(또는 관리자 검색 창에서 **API**를 검색합니다).
      </Step>

      <Step title="API 토큰 관리 열기">
        **API** → **Tokens**를 선택하여 기존 토큰 목록과 **토큰 만들기**를 엽니다.
      </Step>

      <Step title="새 토큰 생성">
        **토큰 만들기**를 선택하고 알아볼 수 있는 이름(예: **Iru Compliance**)을 입력한 다음 생성을 확인하여 Okta가 시크릿을 한 번 표시하도록 합니다.
      </Step>

      <Step title="토큰 즉시 복사">
        대화 상자를 닫기 전에 토큰 값을 복사합니다. 페이지를 떠나면 다시 볼 수 없습니다. Iru에 붙여넣을 때까지 보관소에 저장하세요.

        **유휴 만료**에 대비하세요. **30일** 동안 토큰을 사용한 API 호출이 성공하지 않으면 Okta가 토큰을 무효화하며 새 토큰을 생성해야 합니다.
      </Step>

      <Step title="선택 사항: 네트워크 제한">
        환경에서 고정 송신 IP를 사용하는 경우 Okta 문서에 따라 선택적으로 토큰에 **network zone** 정책을 연결할 수 있습니다.
      </Step>
    </Steps>

    <Note>
      [**Iru Compliance**](#iru-compliance) 탭에서 계속 진행하세요.
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      먼저 [**Okta**](#okta) 탭을 완료하세요.
    </Note>

    <Steps>
      <Step title="소스 열기">
        Iru Compliance의 왼쪽 탐색 모음에서 **컴플라이언스**를 펼치고 **소스**를 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/tI0HDLDwHj8r9Ile/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=tI0HDLDwHj8r9Ile&q=85&s=87dcef15fc17d2fb9a6e53f454e41710" alt="왼쪽 탐색: Compliance가 펼쳐지고 Sources가 선택됨" width="410" height="1024" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Okta 켜기">
        **Okta**를 찾습니다(**범주** 또는 **이름 또는 설명으로 검색** 사용). 해당 카드에서 **토글**을 켭니다. 새 탭에서 커넥터 마법사가 열립니다.
      </Step>

      <Step title="테넌트에 맞는 서버 URL 선택">
        조직이 위치한 환경에 맞는 행을 선택합니다.

        | 환경 | 기본 URL 패턴 |
        | - | - |
        | 프로덕션(US) | `https://YOUR_SUBDOMAIN.okta.com` |
        | EMEA | `https://YOUR_SUBDOMAIN.okta-emea.com` |
        | 프리뷰 / 샌드박스 | `https://YOUR_SUBDOMAIN.oktapreview.com` |
        | US Gov | `https://YOUR_SUBDOMAIN.okta-gov.com` |
        | 커스텀 도메인 | `https://YOUR_OKTA_DOMAIN` |

        마법사가 올바른 Management API 기본 URL을 구성할 수 있도록 선택을 확인합니다.
      </Step>

      <Step title="하위 도메인 및 도메인 변수 입력">
        각 마법사 화면을 따라 진행합니다. OAuth 관련 URL이 테넌트와 일치하도록 메시지가 표시되는 곳에 **하위 도메인** 또는 도메인 값을 입력합니다.

        <Note>
          마법사 중간에 OAuth URL을 언급하는 단계는 커넥터 템플릿이 엔드포인트를 완전히 구성하기 때문에 존재합니다. Iru가 이 소스의 Management API 읽기에 사용하는 것은 마지막 단계의 **SSWS 토큰 인증**입니다.
        </Note>
      </Step>

      <Step title="API 토큰 붙여넣기">
        자격 증명 단계에서 **API 토큰**을 인증 필드에 붙여넣습니다.
      </Step>

      <Step title="연결 완료">
        **API 키 제출**을 선택합니다. 연결에 성공하면 마법사에 **연결 구성됨**이 표시됩니다.
      </Step>

      <Step title="소스가 활성인지 확인">
        **Iru가 외부 서비스에 대한 액세스를 요청하고 있습니다** 브라우저 탭을 닫은 다음 **컴플라이언스** → **소스**로 돌아가 **Okta** 카드가 **활성**인지 확인합니다.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### 문제 해결

<AccordionGroup>
  <Accordion title="소스를 켜도 아무것도 열리지 않음">
    Iru 사이트에 대한 **팝업 차단** 설정을 확인한 후 다시 시도하세요.
  </Accordion>

  <Accordion title="401 Unauthorized">
    토큰 문자열, 관리자 계정이 여전히 활성 상태인지, 토큰이 취소되지 않았는지 확인하세요.
  </Accordion>

  <Accordion title="토큰 만료">
    토큰이 30일 동안 유휴 상태였다면 **보안** → **API** → **Tokens**에서 토큰을 다시 생성하세요.
  </Accordion>

  <Accordion title="403 Forbidden">
    토큰에 연결된 관리자 프로필에 일부 엔드포인트에 대한 읽기 액세스 권한이 없을 수 있습니다. 필요한 증거에 대해 최소한 **Read-only Admin**(또는 이에 준하는) 권한이 있는지 확인하세요.
  </Accordion>

  <Accordion title="잘못된 호스트 / 도메인">
    연결을 해제했다가 다시 연결하면서 하위 도메인과 지역(US, EMEA, Gov, 프리뷰)을 다시 확인하세요.
  </Accordion>
</AccordionGroup>

### 고려 사항

<CardGroup cols={2}>
  <Card title="API 토큰을 자격 증명처럼 취급하세요" icon="circle-info">
    API 토큰을 자격 증명처럼 취급하세요. 증거 요구 사항을 충족하는 **최소** 관리자 역할을 가진 **서비스 계정**을 사용하는 것이 좋습니다.
  </Card>

  <Card title="Okta는 Management API 트래픽에 속도 제한을 적용합니다…" icon="shield">
    Okta는 Management API 트래픽에 **속도 제한**을 적용하므로 대규모 조직에서는 첫 번째 수집 시 동기화 시간이 길어질 수 있습니다.
  </Card>

  <Card title="Iru는 토큰이 액세스할 수 있는 API가 노출하는 데이터를 읽습니다…" icon="server">
    Iru는 토큰이 액세스할 수 있는 API가 노출하는 데이터를 읽으며, 부여하지 않은 Okta 권한을 재정의할 수 없습니다.
  </Card>
</CardGroup>

### 관련 문서

<CardGroup cols={2}>
  <Card title="Sources 관리" icon="plug" href="/ko/compliance/sources-management">
    모든 Compliance 소스를 찾아보고 관리합니다.
  </Card>

  <Card title="Compliance 시작하기" icon="rocket" href="/ko/compliance/getting-started-with-compliance">
    프레임워크, 작업 및 **아티팩트**.
  </Card>

  <Card title="Iru 개요" icon="layer-group" href="/ko/iru/platform-overview/iru-overview">
    Endpoint, Compliance 및 Identity가 함께 작동하는 방식.
  </Card>

  <Card title="Artifacts 관리" icon="folder-open" href="/ko/compliance/artifacts-management">
    소스 및 작업에서 수집한 증거를 업로드, 검토 및 정리합니다.
  </Card>
</CardGroup>