MOSS ServiceNow Integration
Full ServiceNow connector for AI agent governance with MOSS.
- SIEM/Security Operations: Send signed events for security monitoring
- ITSM: Create incidents on policy violations
- Workflows: Sign ServiceNow AI agent actions
Installation
pip install moss-servicenow
Quick Start
SIEM - Security Events
Send MOSS signed events to ServiceNow Security Operations:
from moss_servicenow import ServiceNowSIEM, EventType, EventSeverity
siem = ServiceNowSIEM(
instance="your-instance.service-now.com",
username="api_user",
password=os.environ["SERVICENOW_PASSWORD"]
)
# Send policy violation event
siem.send_event(
event_type=EventType.POLICY_BLOCK,
severity=EventSeverity.HIGH,
agent_id="finance-agent",
action="wire_transfer",
description="Blocked: Transfer exceeds $10,000 limit",
envelope=signed_result.envelope.to_dict()
)
Or send directly from a MOSS SignResult:
from moss import sign
from moss_servicenow import ServiceNowSIEM
result = sign(output=data, agent_id="my-agent", action="transfer")
if result.blocked:
siem.send_from_sign_result(result)
ITSM - Incident Management
Create incidents when policy violations occur:
from moss_servicenow import ServiceNowITSM, IncidentPriority
itsm = ServiceNowITSM(
instance="your-instance.service-now.com",
username="api_user",
password=os.environ["SERVICENOW_PASSWORD"],
default_assignment_group="AI Governance Team"
)
# Create incident from policy violation
incident = itsm.create_incident(
short_description="AI Agent Policy Violation - Unauthorized Access",
description="Agent attempted to access PII without proper authorization",
priority=IncidentPriority.HIGH,
envelope=signed_result.envelope.to_dict(),
agent_id="data-agent",
action="read_pii"
)
print(f"Created incident: {incident['number']}")
Or create directly from a MOSS SignResult:
if result.blocked:
incident = itsm.create_from_sign_result(result)
Workflow Signing
Sign ServiceNow AI agent actions before execution:
from moss_servicenow import sign_workflow_action
# Sign before executing
result = sign_workflow_action(
action="create_incident",
payload={"short_description": "System alert", "priority": "2"},
agent_id="snow-automation",
workflow_name="incident_management"
)
if result.blocked:
print(f"Blocked: {result.enterprise.policy.reason}")
else:
# Proceed with ServiceNow API call
client.create("incident", payload)
Callback Handler for Now Assist
Wrap functions to automatically sign actions:
from moss_servicenow import ServiceNowCallbackHandler
handler = ServiceNowCallbackHandler(
agent_id="now-assist-agent",
context={"tenant": "acme"}
)
@handler.wrap("create_incident")
def create_incident(data):
return client.create("incident", data)
# Action is automatically signed before execution
# Raises PermissionError if blocked by policy
result = create_incident({"short_description": "Alert"})
Configuration
Environment Variables
# ServiceNow credentials
SERVICENOW_INSTANCE=your-instance.service-now.com
SERVICENOW_USERNAME=api_user
SERVICENOW_PASSWORD=api_password
# MOSS API key (for enterprise features)
MOSS_API_KEY=moss_live_...
Tables
- SIEM:
sn_si_incident(Security Incidents) by default - ITSM:
incidenttable
API Reference
ServiceNowSIEM
| Method | Description |
|---|---|
send_event() |
Send security event |
send_from_sign_result() |
Send event from MOSS SignResult |
send_batch() |
Send multiple events |
ServiceNowITSM
| Method | Description |
|---|---|
create_incident() |
Create incident |
create_from_sign_result() |
Create incident from MOSS SignResult |
update_incident() |
Update incident fields |
resolve_incident() |
Resolve and close incident |
get_incident() |
Get incident by sys_id |
Workflow Signing
| Function | Description |
|---|---|
sign_workflow_action() |
Sign workflow action |
sign_table_operation() |
Sign table API operation |
ServiceNowCallbackHandler |
Decorator-based signing |
License
MIT
Metadata
Release files for moss-servicenow 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| moss_servicenow-0.1.0.tar.gz | 14.9 kB | Without provenance | Details for moss_servicenow-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| moss_servicenow-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for moss_servicenow-0.1.0-py3-none-any.whl |
Total release size: 29.1 kB
Release files / moss_servicenow-0.1.0.tar.gz
| Download URL | moss_servicenow-0.1.0.tar.gz |
|---|---|
| Size | 14.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b09ae99595926351068f1b73d4ebc74afa98bf1363314a9ce4f8cde41ac1a95d
|
|
BLAKE2b-256 checksum How to use checksums |
48adca6487970ec719c6313d5e76fa7d9b3d163096121ab0b0dde5375a80c3b4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.6
|
Release files / moss_servicenow-0.1.0-py3-none-any.whl
| Download URL | moss_servicenow-0.1.0-py3-none-any.whl |
|---|---|
| Size | 14.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2b16758b29fa5d436d7054a1ef9298d439958d7272d154c152b162bb9af1ca5b
|
|
BLAKE2b-256 checksum How to use checksums |
de583dca85b187f861378f251a5eb4523a8cd85efe81e71e620b7a57b68775ba
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.6
|
Security for moss-servicenow 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.