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

# ServiceNow

> ServiceNow ITSM을 CloudThinker에 연결하여 인시던트, 변경 요청, 문제, CMDB 관리를 수행합니다

ServiceNow ITSM 플랫폼을 연결하면 CloudThinker 에이전트가 인시던트, 변경 요청, 문제, CMDB 구성 항목을 관리할 수 있습니다. ServiceNow는 전용 서비스 계정의 **사용자명과 비밀번호**로 인증합니다.

***

## 지원 플랫폼

| 플랫폼                 | 지원                        |
| ------------------- | ------------------------- |
| **ServiceNow**      | Xanadu, Yokohama 및 이후 릴리즈 |
| **ServiceNow ITSM** | 모든 에디션                    |
| **ServiceNow ITOM** | 모든 에디션                    |

<Info>
  ServiceNow는 N 및 N-1 릴리즈를 지원합니다. CloudThinker는 모든 최신 릴리즈에서 안정적인 ServiceNow REST API를 사용합니다.
</Info>

***

## 사전 요구사항

* Xanadu 이상의 릴리즈를 실행하는 **ServiceNow 인스턴스**.
* 개발자 인스턴스의 경우: 관리자 자격 증명.
* 엔터프라이즈 인스턴스의 경우: `itil`, `cmdb_read`, `rest_api_explorer` 역할을 가진 전용 서비스 계정.

***

## 설정

<Tabs>
  <Tab title="개발자 인스턴스">
    <Steps>
      <Step title="인스턴스 URL 확인">
        개발자 인스턴스 URL은 다음 형식을 따릅니다:

        ```
        https://devXXXXX.service-now.com
        ```
      </Step>

      <Step title="CloudThinker에서 연결 추가">
        **Connections → ServiceNow**로 이동하여 다음을 입력합니다:

        * **Instance URL**: 개발자 인스턴스 URL
        * **Username**: 관리자 사용자명
        * **Password**: 관리자 비밀번호

        **Connect**를 클릭합니다. CloudThinker가 자격 증명을 확인하고 **Connected** 상태를 표시합니다.
      </Step>
    </Steps>
  </Tab>

  <Tab title="엔터프라이즈 인스턴스">
    <Steps>
      <Step title="전용 사용자 생성">
        ServiceNow에서 **User Administration → Users**로 이동하여 새 사용자를 생성합니다:

        * **User ID**: `cloudthinker`
        * **Password**: 강력하고 고유한 비밀번호
        * **Active**: 체크
      </Step>

      <Step title="역할 지정">
        사용자에게 다음 역할을 지정합니다:

        * `itil` — 인시던트, 변경, 문제 관리용
        * `cmdb_read` — CMDB 읽기 접근용
        * `rest_api_explorer` — API 접근용
      </Step>

      <Step title="인스턴스 URL 확인">
        ServiceNow 인스턴스 URL은 다음 형식을 따릅니다:

        ```
        https://your-instance.service-now.com
        ```
      </Step>

      <Step title="CloudThinker에서 연결 추가">
        **Connections → ServiceNow**로 이동하여 다음을 입력합니다:

        * **Instance URL**: ServiceNow 인스턴스 URL
        * **Username**: `cloudthinker`
        * **Password**: 설정한 비밀번호

        **Connect**를 클릭합니다. CloudThinker가 자격 증명을 확인하고 **Connected** 상태를 표시합니다.
      </Step>
    </Steps>
  </Tab>
</Tabs>

***

## 연결 세부 정보

| 필드                            | 설명                  | 예시                                      |
| ----------------------------- | ------------------- | --------------------------------------- |
| **SERVICENOW\_INSTANCE\_URL** | ServiceNow 인스턴스 URL | `https://your-instance.service-now.com` |
| **SERVICENOW\_USERNAME**      | ServiceNow 사용자명     | `cloudthinker`                          |
| **SERVICENOW\_PASSWORD**      | ServiceNow 비밀번호     | —                                       |

***

## 필요 권한

### 개발자 인스턴스

추가 구성 불필요 — 기본 관리자 사용자에게 전체 접근 권한이 있습니다.

### 엔터프라이즈 인스턴스

| 역할                  | 접근 권한                                     |
| ------------------- | ----------------------------------------- |
| `itil`              | 인시던트, 변경, 문제 및 기타 ITSM 작업 테이블에 대한 전체 CRUD |
| `cmdb_read`         | CMDB 구성 항목에 대한 읽기 전용 접근                   |
| `rest_api_explorer` | REST API 접근                               |

<Tip>
  최소 권한 원칙을 따르세요: 읽기 전용 사용 사례의 경우 전체 `itil` 역할 대신 필요한 테이블에 읽기 권한만 있는 커스텀 역할을 생성합니다.
</Tip>

***

## 에이전트 기능

연결 후 에이전트는 ServiceNow 데이터를 조회하고 작업할 수 있습니다.

| 기능              | 설명                      |
| --------------- | ----------------------- |
| **인시던트 관리**     | 인시던트 생성, 업데이트, 해결       |
| **변경 요청**       | 위험 평가와 함께 변경 요청 생성 및 검토 |
| **문제 관리**       | 문제 레코드 추적 및 분석          |
| **CMDB 조회**     | 구성 항목 및 의존성 조회          |
| **사용자 및 그룹 조회** | 사용자, 그룹 및 담당 작업 찾기      |
| **자연어 검색**      | 모든 ServiceNow 테이블에서 검색  |

### 연결 확인

```text theme={null}
@alex list all open P1 incidents in ServiceNow and show their priority and status
```

### 예시 프롬프트

```text theme={null}
@alex list all open P1 incidents and #report on any patterns across services
@alex review pending change requests and assess risk
@alex query the CMDB for all production servers and their dependencies
```

***

## 트러블슈팅

<Accordion title="연결 거부">
  ServiceNow 인스턴스 URL이 잘못되었거나 인스턴스가 유지보수 모드입니다. URL이 접근 가능한지 확인하고, IP 제한이 CloudThinker를 차단하지 않는지 확인합니다.
</Accordion>

<Accordion title="인증 실패">
  사용자명 또는 비밀번호가 잘못되었거나 사용자 계정이 잠겨 있습니다. 자격 증명을 확인하고 사용자에게 `rest_api_explorer` 또는 동등한 API 접근 역할이 있는지 확인합니다.
</Accordion>

<Accordion title="테이블에 대한 권한 거부">
  사용자가 접근 중인 테이블에 필요한 역할이 없습니다. ACL 규칙을 확인하고 CMDB 접근을 위해 `cmdb_read`가 지정되어 있는지 확인합니다.
</Accordion>

<Accordion title="속도 제한">
  ServiceNow가 과부하 시 API 요청을 제한할 수 있습니다. 429 오류가 발생하면 동시 작업을 줄이고, ServiceNow 관리자에게 속도 제한 설정을 검토하도록 요청합니다.
</Accordion>

***

## 보안

* **최소 권한** — 에이전트가 사용 사례에 필요한 권한만 부여하세요. 읽기 전용으로 시작한 후 필요에 따라 확장하세요.
* **기본 읽기 전용** — 에이전트가 이 연결을 통해 변경 작업을 수행하게 할 것이 아니라면 읽기 전용 자격증명을 사용하세요.
* **자격증명 교체** — 정기 일정에 따라 키와 토큰을 교체하세요. 연결을 업데이트하면 CloudThinker가 새 값을 자동으로 반영합니다.
* **오프보딩 시 취소** — 연결을 삭제하거나 팀원이 퇴사할 때 프로바이더에서 자격증명을 제거하세요.

- **전용 서비스 계정** — 공유 관리자 계정 대신 CloudThinker 전용 ServiceNow 사용자를 생성합니다.
- **IP 제한** — ServiceNow의 접근 제어 설정에서 API 접근을 CloudThinker IP로 제한하는 것을 고려합니다.

***

## 관련 항목

<CardGroup cols={2}>
  <Card title="PagerDuty 연결" icon="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/pagerduty.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=cdc34a966d5d46da70c3bc509a2a7492" href="/ko/guide/connections/pagerduty" width="24" height="24" data-path="images/icons/pagerduty.svg">
    인시던트 관리 및 온콜
  </Card>

  <Card title="Elasticsearch 연결" icon="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/icons/elasticsearch.svg?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=c7389cfcd0bc8d303aeeb68bd19199ca" href="/ko/guide/connections/elasticsearch" width="24" height="24" data-path="images/icons/elasticsearch.svg">
    로그와 ServiceNow 인시던트 연계
  </Card>
</CardGroup>