Skip to content

docs: add ServiceNow extension page#251

Merged
maximelb merged 4 commits into
masterfrom
docs/ext-servicenow
Jun 30, 2026
Merged

docs: add ServiceNow extension page#251
maximelb merged 4 commits into
masterfrom
docs/ext-servicenow

Conversation

@maximelb

@maximelb maximelb commented Jun 5, 2026

Copy link
Copy Markdown
Contributor

Documents the ext-servicenow extension under Integrations → Extensions → Third-Party, following the existing third-party extension pattern (HaloPSA / ThreatLocker).

What's covered

  • Generic Table API bridgecreate_record, get_record, update_record, delete_record, query_table, count_records against any table.
  • Typed incident conveniencescreate_incident, update_incident, get_incident, search_incidents (default incident, retargetable to sn_si_incident or any task-derived table).
  • Journal, attachments, CMDBadd_note, add_attachment, list_attachments, get_attachment, lookup_ci.
  • Optional Case-mirroring recipemirror_case (LC → ServiceNow) and pull_incident_changes (ServiceNow → LC), anchored on correlation_id, with the echo-loop guard via integration_user.
  • Three auth modes (basic, oauth_password, oauth_client_credentials) and hive:// secret references for password / client_secret.

Field tables are generated from the extension's schema.go config + request schemas.

Wiring

  • Added to the third-party index and the mkdocs nav (alphabetical, between SecureAnnex and Strelka).
  • Added the ext-servicenow readme.io redirect for the legacy slug.

Draft — markdownlint-cli2 passes clean. Opened as draft for review before publish.

🤖 Generated with Claude Code

Documents the ext-servicenow extension (Integrations → Extensions →
Third-Party): an API bridge that lets LimaCharlie automation drive a
ServiceNow instance.

- Generic Table API bridge actions (create/get/update/delete_record,
  query_table, count_records) against any table.
- Typed incident conveniences (create/update/get/search_incidents,
  default `incident`, retargetable to sn_si_incident or any task table).
- Journal, attachment and CMDB actions (add_note, add/list/get_attachment,
  lookup_ci).
- The optional bidirectional Case-mirroring recipe (mirror_case LC→SN,
  pull_incident_changes SN→LC) anchored on correlation_id, with the
  echo-loop guard via integration_user.
- Three auth modes (basic, oauth_password, oauth_client_credentials) and
  hive:// secret references for password/client_secret.

Wires the page into the third-party index, the mkdocs nav, and adds the
ext-servicenow readme.io redirect for the legacy slug.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
lcbill
lcbill previously approved these changes Jun 16, 2026
The legacy 'Solved (Permanently)' close_code no longer exists on current
ServiceNow releases; the API silently drops it and then trips the
mandatory-resolution-code data policy (403), so a default mirror_case
resolve/close would fail. The extension default is now 'Solution
provided'. Document the new value and the requirement that it be a valid
close_code choice on the instance.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PPUULMpna9zzM5AfdanDTX
@maximelb maximelb marked this pull request as ready for review June 30, 2026 00:18
lcbill
lcbill previously approved these changes Jun 30, 2026
# Conflicts:
#	docs/5-integrations/extensions/third-party/index.md
#	docs/5-integrations/extensions/third-party/servicenow.md
#	mkdocs.yml
lcbill
lcbill previously approved these changes Jun 30, 2026
A literal </content></invoke> pair from the merge resolution landed at the
end of the file, tripping markdownlint MD032.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PPUULMpna9zzM5AfdanDTX
@maximelb maximelb merged commit 1ac6151 into master Jun 30, 2026
2 checks passed
@maximelb maximelb deleted the docs/ext-servicenow branch June 30, 2026 13:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants