Điều kiện tiên quyết
- Một instance ServiceNow và URL của instance, dạng
https://<instance>.service-now.com. - Quyền tạo người dùng và gán role trong instance đó, hoặc một admin có thể làm việc này thay bạn.
- Một service account đăng nhập được bằng mật khẩu ServiceNow cục bộ. Nếu instance chuyển người dùng qua SSO hoặc yêu cầu MFA, tài khoản vẫn phải xác thực được bằng mật khẩu riêng cho các lệnh gọi API.
- Role Admin trong workspace CloudThinker, cần để thêm kết nối. Xem Roles.
Thiết lập
1
Tạo service account
Trong ServiceNow, mở User Administration → Users và nhấn New:
- User ID:
cloudthinker - Password: mật khẩu mạnh, không dùng lại ở nơi khác
- Active: đã chọn
2
Gán role
Trên bản ghi người dùng, thêm các role trong Quyền yêu cầu. Bắt đầu với
itil và cmdb_read.3
Thêm kết nối trong CloudThinker
Trong thanh bên, nhấn More → Workspace settings → Connections, giữ nguyên tab Builtin Connections và chọn ServiceNow. Form hiển thị tên trường đúng như bên dưới. Điền:
- SERVICENOW_INSTANCE_URL: URL instance của bạn, ví dụ
https://acme.service-now.com - SERVICENOW_USERNAME:
cloudthinker - SERVICENOW_PASSWORD: mật khẩu bạn đã đặt
Chi tiết kết nối
Để truy cập instance khác, chẳng hạn instance sub-production, hãy thêm instance đó thành một kết nối riêng.
Quyền yêu cầu
ServiceNow quyết định tài khoản thấy được gì thông qua role và quy tắc truy cập bảng (ACL). Agent chỉ đọc và thay đổi được những gì tài khoản được phép.Khả năng của agent
Thao tác đọc chạy mà không hỏi.
Mọi thay đổi do agent thực hiện đều đi qua Approvals của workspace trước. Ở chế độ mặc định Auto · Rules + AI · Ask me, AI judgment có thể cho một thay đổi an toàn chạy mà không cần hỏi. Allow Rule cũng vậy, sau khi CloudThinker bật Rule enforcement cho workspace của bạn. Chọn Manual nếu bạn muốn tự phê duyệt mọi thay đổi.
Để approve một change request, tài khoản còn phải là approver của change đó trong ServiceNow. Chỉ role
itil thì chưa đủ.
Dùng với Resolve
ServiceNow tích hợp với Resolve. Trong Resolve → Triggers & Outcomes → ServiceNow, kết quả Create follow-up tickets tạo một bản ghi ServiceNow cho phần việc còn lại khi sự cố kết thúc. Đặt Assignment group cho kết quả này, ví dụCloud Operations. ServiceNow cũng có thể gửi incident đến Resolve dưới dạng tín hiệu webhook.
Xác minh kết nối
itil hoặc quyền đọc bảng.
Ví dụ prompt
Khắc phục sự cố
Connect fails or requests return 401
Connect fails or requests return 401
Username hoặc password sai, người dùng không ở trạng thái active, hoặc tài khoản bị khóa. Đăng nhập ServiceNow bằng tài khoản admin, kiểm tra bản ghi người dùng, đặt lại mật khẩu nếu cần, rồi chỉnh sửa kết nối.Nếu mật khẩu đúng, hãy kiểm tra SSO hoặc MFA có chặn đăng nhập bằng mật khẩu cho tài khoản này không. Tài khoản cần một mật khẩu cục bộ dùng được cho lệnh gọi API.
Some tables return a permission error
Some tables return a permission error
Tài khoản thiếu role hoặc ACL cho bảng đó. Đọc CMDB cần
cmdb_read. Đọc incident, change và problem cần itil hoặc một role tùy chỉnh tương đương. Thêm role trong ServiceNow rồi hỏi lại; không cần kết nối lại.Requests time out or return 503
Requests time out or return 503
Instance đang bảo trì hoặc đang ngủ. Personal developer instance sẽ hibernate khi không hoạt động: hãy đánh thức instance từ ServiceNow developer portal rồi thử lại. Đồng thời kiểm tra instance không chặn CloudThinker bằng IP access rule. Để cho CloudThinker đi qua, thêm egress IP của CloudThinker vào rule đó. Tài liệu này không công bố danh sách egress IP của CloudThinker: hãy hỏi đầu mối liên hệ CloudThinker của bạn, hoặc liên hệ với chúng tôi.
A record can't be found by its number
A record can't be found by its number
Agent tra cứu bản ghi theo URL instance sai cũng hiện thành “not found”, nên hãy kiểm tra URL khớp với địa chỉ trên trình duyệt.
sys_id, không theo số như INC0012345. Nếu tra cứu thất bại, hãy yêu cầu tìm theo số:Requests return 429
Requests return 429
Instance đang giới hạn tốc độ lệnh gọi API. Đợi một phút, đặt câu hỏi hẹp hơn rồi thử lại. Admin ServiceNow có thể xem lại các rate limit rule của instance.
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.
- Service account riêng: dùng tài khoản chỉ dành cho CloudThinker, bật Web service access only, để bạn có thể xoay vòng hoặc vô hiệu hóa tài khoản mà không ảnh hưởng đến người dùng thật.
- Dùng role thay vì admin: không bao giờ kết nối instance production bằng role
admin.itilcộng vớicmdb_readđủ cho công việc với incident, change, problem và CMDB. Approve một change còn cần tài khoản được đặt làm approver, và thao tác đọc Any table cần quyền đọc trên từng bảng.
Liên quan
Triggers & Outcomes của Resolve
Bật bản ghi follow-up và tín hiệu từ ServiceNow cho sự cố.
Approvals
Kiểm soát cập nhật ServiceNow nào phải chờ người phê duyệt.