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

# ServiceNow 통합: ServiceNow 구성

> Iru Endpoint 통합을 위해 Kandji ServiceNow 앱을 설치하고, OAuth 자격 증명과 서비스 계정을 생성하고, discovery source 설정을 확인합니다.

### Kandji ServiceNow 앱 설치

앱이 아직 설치되지 않은 경우 ServiceNow 인스턴스에 Kandji ServiceNow 앱을 설치하세요. 설치하면 테넌트에서 통합에 필요한 종속 항목이 추가됩니다.

<Steps>
  <Step title="ServiceNow Store 접속">
    [ServiceNow store](https://store.servicenow.com/sn_appstore_store.do#!/store/home)로 이동합니다.
  </Step>

  <Step title="Kandji ServiceNow 앱 찾기">
    스토어에서 **Kandji**를 검색하여 **Kandji ServiceNow app**을 찾습니다.
  </Step>

  <Step title="Kandji ServiceNow 앱 설치">
    **Get**을 선택하여 Kandji ServiceNow 앱을 설치합니다. 메시지가 표시되면 ServiceNow store에 로그인합니다. 사용하는 계정에는 Integration Hub 스토어 앱을 설치할 수 있는 권한이 있어야 합니다.
  </Step>
</Steps>

### OAuth 앱 생성

Iru Endpoint는 grant type이 \*\*Resource Owner Password Credentials (ROPC)\*\*인 ServiceNow OAuth API 클라이언트를 사용하여 인스턴스의 액세스 토큰과 새로 고침 토큰을 가져옵니다.

<Note>
  ServiceNow **Zurich** 이상 릴리스에서는 외부 클라이언트용 OAuth API 엔드포인트를 생성할 때 **Scope Restriction**을 **Broadly scoped**로 설정하세요. 이 필드가 더 좁은 범위로 설정되면 Iru Endpoint의 인바운드 API 호출이 *OAuth client does not have unrestricted access to unscoped APIs is not allowed*와 같은 오류로 실패할 수 있습니다. 자세한 내용은 ServiceNow [KB2731346](https://support.servicenow.com/kb?id=kb_article_view\&sysparm_article=KB2731346)을 참조하세요.
</Note>

<Steps>
  <Step title="ServiceNow 접속">
    ServiceNow 관리자 계정을 사용하여 ServiceNow 테넌트({yourtenant}.service-now\.com)에 로그인합니다.
  </Step>

  <Step title="System OAuth로 이동">
    **Filter navigator**에서 **System OAuth**를 검색합니다.
  </Step>

  <Step title="Application Registry 열기">
    **Application Registry**를 선택합니다.
  </Step>

  <Step title="OAuth 엔드포인트 생성">
    **Create an OAuth API endpoint for external clients**를 선택합니다.
  </Step>

  <Step title="OAuth 앱 구성">
    OAuth 앱의 이름을 지정합니다(예: `kandji_oauth_api`).
  </Step>

  <Step title="Redirect URL 설정">
    **Redirect URL** 필드에 [**https://kandji.io**](https://kandji.io)를 입력합니다.
  </Step>

  <Step title="구성 제출">
    **제출**을 선택합니다.
  </Step>

  <Step title="OAuth 앱 접속">
    방금 생성한 OAuth 앱으로 돌아갑니다.
  </Step>

  <Step title="Client ID 복사">
    **Client ID**를 강조 표시하고 복사합니다.
  </Step>

  <Step title="Client Secret 표시">
    자물쇠 아이콘을 선택하여 **Client Secret**을 표시합니다.
  </Step>

  <Step title="Client Secret 복사">
    **Client Secret**을 복사합니다. 직접 클라이언트 시크릿을 설정한 경우 **업데이트**를 선택하여 저장합니다.
  </Step>
</Steps>

### 서비스 계정 추가

서비스 계정 사용자 자격 증명은 Iru Endpoint에서 ServiceNow 통합을 구성하는 데 사용됩니다.

<Note>
  웹 서비스에 대한 접근 권한이 있고 **cmdb\_read**, **import\_transformer**, **rest\_api\_explorer** 역할이 있는 ServiceNow 사용자 계정이라면 어떤 계정이든 사용할 수 있습니다. 가능하면 이 통합 전용 서비스 계정을 생성하세요.
</Note>

<Steps>
  <Step title="ServiceNow 접속">
    ServiceNow 관리자 계정을 사용하여 ServiceNow 테넌트({yourtenant}.service-now\.com)에 로그인합니다.
  </Step>

  <Step title="사용자로 이동">
    **Filter navigator**에서 **사용자**를 검색합니다.
  </Step>

  <Step title="User Administration 열기">
    User Administration에서 **사용자**를 선택합니다.
  </Step>

  <Step title="새 사용자 생성">
    **New**를 선택하여 새 사용자를 추가합니다.
  </Step>

  <Step title="사용자 세부 정보 구성">
    사용자에 대한 설명이 포함된 이름을 입력합니다(예: `kandji_rest_api_user`). 사용자 이름을 안전한 위치에 복사해 두세요. Iru Endpoint에서 통합을 구성할 때 필요합니다.

    * 필요한 경우 조직에서 요구하는 추가 정보를 입력합니다.
  </Step>

  <Step title="웹 서비스 접근 설정">
    **Web service access only**를 선택합니다.
  </Step>

  <Step title="사용자 생성 제출">
    **제출**을 선택합니다.
  </Step>

  <Step title="사용자 비밀번호 설정">
    방금 생성한 사용자를 열고 **Set Password**를 선택합니다.
  </Step>

  <Step title="비밀번호 생성">
    **생성**을 선택하여 새 비밀번호를 생성합니다.
  </Step>

  <Step title="비밀번호 복사">
    새 비밀번호를 복사합니다.
  </Step>

  <Step title="비밀번호 저장">
    **Save Password**를 선택합니다. 비밀번호를 안전한 위치에 보관하세요. ServiceNow 통합을 구성할 때 Iru Endpoint에 입력합니다.
  </Step>

  <Step title="비밀번호 대화 상자 닫기">
    **닫기**를 선택하여 Users 페이지로 돌아갑니다.
  </Step>

  <Step title="사용자 역할 접속">
    사용자 페이지에서 **Roles**로 이동합니다.
  </Step>

  <Step title="역할 편집">
    **편집**을 선택합니다.
  </Step>

  <Step title="필수 역할 추가">
    서비스 계정 사용자에게 다음 역할을 추가합니다.

    * cmdb\_read
    * import\_transformer
    * rest\_api\_explorer
  </Step>

  <Step title="역할 할당 확인">
    총 6개의 역할이 표시되어야 합니다. 직접 추가한 역할 3개와 상속된 역할 3개입니다.
  </Step>

  <Step title="사용자 구성 저장">
    사용자 생성을 완료하려면 **저장**을 선택합니다.
  </Step>
</Steps>

### 문제 해결

#### Kandji가 Discovery Source인지 확인

<Steps>
  <Step title="Dictionary 접속">
    ServiceNow의 **Filter navigator**에 **Dictionary**를 입력합니다.
  </Step>

  <Step title="Dictionary 열기">
    System Definition에서 **Dictionary**를 선택합니다.
  </Step>

  <Step title="Discovery Source 검색">
    Dictionary Entries에서 **Column name**을 선택한 다음 **discovery\_source**를 입력합니다.
  </Step>

  <Step title="CMDB 테이블 선택">
    **cmdb\_ci** 테이블을 선택합니다.
  </Step>

  <Step title="Choices 탭 접속">
    아래로 스크롤하여 **Choices** 탭을 선택합니다.
  </Step>

  <Step title="Kandji 확인">
    **Kandji**가 목록에 있는지 확인합니다. 표시되지 않으면 레이블 **Kandji**를 검색합니다.
  </Step>
</Steps>

#### Kandji가 Discovery Source로 표시되지 않는 경우

Kandji ServiceNow 앱을 설치한 후 **Kandji**가 discovery source로 표시되지 않으면 **kandji\_fix\_script**를 수동으로 실행하세요.

<Steps>
  <Step title="Fix Scripts 접속">
    ServiceNow의 **Filter navigator**에 **Fix Script**를 입력합니다.
  </Step>

  <Step title="Fix Scripts 열기">
    System Definition에서 **Fix Scripts**를 선택합니다.
  </Step>

  <Step title="Fix Script 검색">
    Fix Scripts에서 **이름**을 선택한 다음 **kandji\_fix\_script**를 입력합니다.
  </Step>

  <Step title="Fix Script 선택">
    **kandji\_fix\_script** 레코드를 엽니다.
  </Step>

  <Step title="Fix Script 실행">
    **Run Fix Script**를 선택합니다.
  </Step>

  <Step title="백그라운드에서 실행">
    Run Fix Script 모달에서 **Proceed in Background**를 선택합니다.
  </Step>
</Steps>

이제 Kandji가 ServiceNow에서 discovery source 선택 항목으로 표시됩니다.

## 고려 사항

<CardGroup cols={2}>
  <Card title="서비스 계정" icon="user">
    접근 및 변경 사항을 더 쉽게 감사할 수 있도록 대화형 사용자를 재사용하는 대신 이 통합 전용 계정을 사용하는 것이 좋습니다.
  </Card>

  <Card title="OAuth" icon="key">
    **Zurich** 이상에서는 OAuth 앱을 생성할 때 **Scope Restriction**을 **Broadly scoped**로 설정하세요([OAuth 앱 생성](#creating-an-oauth-app) 참조). Redirect URL을 `https://kandji.io`로 설정하고 클라이언트 자격 증명을 안전하게 보관하세요.
  </Card>

  <Card title="역할" icon="shield">
    서비스 계정에는 **cmdb\_read**, **import\_transformer**, **rest\_api\_explorer** 역할이 필요합니다.
  </Card>

  <Card title="검색 소스" icon="magnifying-glass">
    설치 후 Dictionary에서 **cmdb\_ci**의 discovery source 선택 항목에 **Kandji**가 표시되는지 확인하세요.
  </Card>

  <Card title="문제 해결" icon="wrench">
    discovery source 또는 동기화가 올바르지 않은 경우 **kandji\_fix\_script** fix script를 실행하고 서비스 계정에 위의 세 가지 역할이 있는지 확인하세요.
  </Card>
</CardGroup>

### 관련 문서

<CardGroup cols={2}>
  <Card title="ServiceNow 통합: 개요" icon="book-open" href="/ko/endpoint/integrations/servicenow/servicenow-integration-overview">
    인벤토리가 Iru Endpoint에서 ServiceNow 테이블 및 변환으로 흐르는 방식과 SAM Pro 데이터가 활성화된 경우의 흐름을 설명합니다.
  </Card>

  <Card title="ServiceNow 통합: Iru Endpoint 구성" icon="plug" href="/ko/endpoint/integrations/servicenow/servicenow-integration-iru-endpoint-configuration">
    OAuth 앱과 서비스 계정으로 Iru Endpoint를 연결하고, ServiceNow가 준비된 후 통합을 관리합니다.
  </Card>
</CardGroup>