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

> Kết nối ServiceNow ITSM với CloudThinker để quản lý sự cố, change request, vấn đề và CMDB

Kết nối nền tảng ServiceNow ITSM của bạn để cho phép các agent CloudThinker quản lý sự cố, change request, vấn đề và các mục cấu hình CMDB. ServiceNow xác thực bằng **tên đăng nhập và mật khẩu** của một tài khoản dịch vụ chuyên dụng.

***

## Nền tảng được hỗ trợ

| Nền tảng            | Hỗ trợ                                        |
| ------------------- | --------------------------------------------- |
| **ServiceNow**      | Xanadu, Yokohama và các bản phát hành mới hơn |
| **ServiceNow ITSM** | Tất cả phiên bản                              |
| **ServiceNow ITOM** | Tất cả phiên bản                              |

<Info>
  ServiceNow hỗ trợ bản phát hành N và N-1. CloudThinker sử dụng REST API của ServiceNow, ổn định trên tất cả các bản phát hành gần đây.
</Info>

***

## Điều kiện tiên quyết

* Một **instance ServiceNow** đang chạy Xanadu hoặc bản phát hành mới hơn.
* Với instance dành cho nhà phát triển: thông tin xác thực admin.
* Với instance doanh nghiệp: tài khoản dịch vụ chuyên dụng với các vai trò `itil`, `cmdb_read` và `rest_api_explorer`.

***

## Thiết lập

<Tabs>
  <Tab title="Instance dành cho nhà phát triển">
    <Steps>
      <Step title="Tìm URL instance của bạn">
        URL instance dành cho nhà phát triển của bạn theo định dạng:

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

      <Step title="Thêm kết nối trong CloudThinker">
        Điều hướng đến **Connections → ServiceNow** và nhập:

        * **Instance URL**: URL instance dành cho nhà phát triển của bạn
        * **Username**: tên đăng nhập admin
        * **Password**: mật khẩu admin

        Nhấp **Connect**. CloudThinker xác minh thông tin xác thực và hiển thị trạng thái **Connected**.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Instance doanh nghiệp">
    <Steps>
      <Step title="Tạo người dùng chuyên dụng">
        Trong ServiceNow, điều hướng đến **User Administration → Users** và tạo người dùng mới:

        * **User ID**: `cloudthinker`
        * **Password**: mật khẩu mạnh, duy nhất
        * **Active**: đã chọn
      </Step>

      <Step title="Gán vai trò">
        Gán các vai trò sau cho người dùng:

        * `itil` — để quản lý sự cố, thay đổi và vấn đề
        * `cmdb_read` — để truy cập đọc CMDB
        * `rest_api_explorer` — để truy cập API
      </Step>

      <Step title="Tìm URL instance của bạn">
        URL instance ServiceNow của bạn theo định dạng:

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

      <Step title="Thêm kết nối trong CloudThinker">
        Điều hướng đến **Connections → ServiceNow** và nhập:

        * **Instance URL**: URL instance ServiceNow của bạn
        * **Username**: `cloudthinker`
        * **Password**: mật khẩu bạn đã đặt

        Nhấp **Connect**. CloudThinker xác minh thông tin xác thực và hiển thị trạng thái **Connected**.
      </Step>
    </Steps>
  </Tab>
</Tabs>

***

## Chi tiết kết nối

| Trường                        | Mô tả                           | Ví dụ                                   |
| ----------------------------- | ------------------------------- | --------------------------------------- |
| **SERVICENOW\_INSTANCE\_URL** | URL instance ServiceNow của bạn | `https://your-instance.service-now.com` |
| **SERVICENOW\_USERNAME**      | Tên đăng nhập ServiceNow        | `cloudthinker`                          |
| **SERVICENOW\_PASSWORD**      | Mật khẩu ServiceNow             | —                                       |

***

## Quyền hạn cần thiết

### Instance dành cho nhà phát triển

Không cần cấu hình thêm — người dùng admin mặc định có toàn quyền truy cập.

### Instance doanh nghiệp

| Vai trò             | Quyền truy cập                                                            |
| ------------------- | ------------------------------------------------------------------------- |
| `itil`              | Toàn quyền CRUD trên sự cố, thay đổi, vấn đề và các bảng tác vụ ITSM khác |
| `cmdb_read`         | Quyền truy cập chỉ đọc vào các mục cấu hình CMDB                          |
| `rest_api_explorer` | Quyền truy cập REST API                                                   |

<Tip>
  Tuân thủ nguyên tắc đặc quyền tối thiểu: với các trường hợp chỉ đọc, hãy tạo vai trò tùy chỉnh chỉ có quyền đọc trên các bảng cần thiết thay vì sử dụng vai trò `itil` đầy đủ.
</Tip>

***

## Khả năng của agent

Sau khi kết nối, các agent có thể truy vấn và hành động trên dữ liệu ServiceNow.

| Khả năng                       | Mô tả                                             |
| ------------------------------ | ------------------------------------------------- |
| **Quản lý sự cố**              | Tạo, cập nhật và giải quyết sự cố                 |
| **Change request**             | Tạo và xem xét change request kèm đánh giá rủi ro |
| **Quản lý vấn đề**             | Theo dõi và phân tích bản ghi vấn đề              |
| **Truy vấn CMDB**              | Truy vấn các mục cấu hình và phụ thuộc            |
| **Tra cứu người dùng & nhóm**  | Tìm người dùng, nhóm và các nhiệm vụ của họ       |
| **Tìm kiếm ngôn ngữ tự nhiên** | Tìm kiếm trên bất kỳ bảng ServiceNow nào          |

### Xác minh kết nối

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

### Các lệnh mẫu

```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
```

***

## Xử lý sự cố

<Accordion title="Kết nối bị từ chối">
  URL instance ServiceNow không chính xác hoặc instance đang trong chế độ bảo trì. Xác minh URL có thể truy cập và không có hạn chế IP nào chặn CloudThinker.
</Accordion>

<Accordion title="Xác thực thất bại">
  Tên đăng nhập hoặc mật khẩu không chính xác, hoặc tài khoản người dùng bị khóa. Xác minh thông tin xác thực và đảm bảo người dùng có vai trò `rest_api_explorer` hoặc tương đương.
</Accordion>

<Accordion title="Quyền truy cập bị từ chối trên bảng">
  Người dùng thiếu các vai trò cần thiết cho bảng đang được truy cập. Kiểm tra quy tắc ACL và đảm bảo `cmdb_read` được gán để truy cập CMDB.
</Accordion>

<Accordion title="Giới hạn tốc độ">
  ServiceNow có thể giới hạn các yêu cầu API dưới tải nặng. Giảm các thao tác đồng thời nếu bạn thấy lỗi 429, và liên hệ với quản trị viên ServiceNow để xem xét cài đặt giới hạn tốc độ.
</Accordion>

***

## Bảo mật

* **Quyền tối thiểu** — chỉ cấp các quyền mà agent cần cho trường hợp sử dụng của bạn; bắt đầu với quyền chỉ đọc và mở rộng sau.
* **Chỉ đọc theo mặc định** — sử dụng thông tin xác thực chỉ đọc trừ khi bạn muốn agent thực hiện thay đổi qua kết nối này.
* **Xoay vòng thông tin xác thực** — xoay vòng khóa và token theo lịch trình thông thường của bạn; CloudThinker sẽ lấy giá trị mới khi bạn cập nhật kết nối.
* **Thu hồi khi bàn giao** — xóa thông tin xác thực tại nhà cung cấp khi bạn xóa một kết nối hoặc khi đồng nghiệp rời nhóm.

- **Tài khoản dịch vụ chuyên dụng** — tạo người dùng ServiceNow chuyên dụng cho CloudThinker thay vì sử dụng tài khoản admin dùng chung.
- **Hạn chế IP** — xem xét giới hạn quyền truy cập API chỉ đến các IP CloudThinker trong cài đặt kiểm soát truy cập của ServiceNow.

***

## Liên quan

<CardGroup cols={2}>
  <Card title="Kết nối 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="/vi/guide/connections/pagerduty" width="24" height="24" data-path="images/icons/pagerduty.svg">
    Quản lý sự cố và on-call
  </Card>

  <Card title="Kết nối 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="/vi/guide/connections/elasticsearch" width="24" height="24" data-path="images/icons/elasticsearch.svg">
    Tương quan log với sự cố ServiceNow
  </Card>
</CardGroup>