Skip to main content

Nautobot SSoT ServiceNow

Project description

Nautobot Single Source of Truth -- ServiceNow Data Target

A plugin for Nautobot, building atop the nautobot-ssot plugin.

This plugin provides the ability to synchronize basic data from Nautobot into ServiceNow. Currently the following data is mapped and synchronized:

  • Nautobot Manufacturer table to ServiceNow Company table
  • Nautobot DeviceType table to ServiceNow Hardware Product Model table
  • Nautobot Region and Site tables to ServiceNow Location table
  • Nautobot Device table to ServiceNow IP Switch table
  • Nautobot Interface table to ServiceNow Interface table

For more information about general usage of the Nautobot SSoT plugin, refer to its documentation.

Installation and Configuration

The plugin is available as a Python package in PyPI and can be installed with pip into an existing Nautobot installation:

pip install nautobot-ssot-servicenow

The plugin is compatible with Nautobot 1.2.0 and higher

Once installed, the plugin needs to be enabled in your nautobot_config.py and configured appropriately:

# nautobot_config.py
PLUGINS = [
    "nautobot_ssot",
    "nautobot_ssot_servicenow",
]

PLUGINS_CONFIG = {
    "nautobot_ssot": {
        "hide_example_jobs": True,
    },
    "nautobot_ssot_servicenow": {
        "instance": os.getenv("SERVICENOW_INSTANCE"),
        "username": os.getenv("SERVICENOW_USERNAME"),
        "password": os.getenv("SERVICENOW_PASSWORD"),
    },
}

The plugin behavior can be controlled with the following list of settings:

  • instance: The ServiceNow instance to point to (as in <instance>.servicenow.com)
  • username: Username to access this instance
  • password: Password to access this instance

There is also the option of omitting these settings from PLUGINS_CONFIG and instead defining them through the UI at /plugins/ssot-servicenow/config/ (reachable by navigating to Plugins > Installed Plugins then clicking the "gear" icon next to the Nautobot SSoT ServiceNow entry) using Nautobot's standard UI and secrets functionality.

If you configure the plugin's settings in PLUGINS_CONFIG, those values will take precedence over any configuration in the UI.

Depending on the amount of data involved, and the performance of your ServiceNow instance, you may need to increase the Nautobot job execution time limits (CELERY_TASK_SOFT_TIME_LIMIT and CELERY_TASK_TIME_LIMIT) so that the job can execute to completion without timing out.

Questions

For any questions or comments, please check the FAQ first and feel free to swing by the Network to Code slack channel (channel #networktocode). Sign up here

Usage

Once the plugin is installed and configured, from the Nautobot SSoT dashboard view (/plugins/ssot/), ServiceNow will be shown as a Data Target. You can click the Sync button to access a form view from which you can run the Nautobot-to-ServiceNow synchronization Job. Running the job will redirect you to a Nautobot Job Result view, from which you can access the SSoT Sync Details view to see detailed information about the outcome of the sync Job.

Detail View


Results View

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nautobot-ssot-servicenow-0.9.2.tar.gz (46.3 kB view details)

Uploaded Source

Built Distribution

nautobot_ssot_servicenow-0.9.2-py3-none-any.whl (60.9 kB view details)

Uploaded Python 3

File details

Details for the file nautobot-ssot-servicenow-0.9.2.tar.gz.

File metadata

File hashes

Hashes for nautobot-ssot-servicenow-0.9.2.tar.gz
Algorithm Hash digest
SHA256 4dfc3a51354df6208c04d720eead902f0d0d793ef5901339c0f730e7a3fd0c95
MD5 e0332143094159ed9c1563c0fd9f06a9
BLAKE2b-256 a5969fac8940d8d8583f6c2cc17f0f69deb4c9565211bcf473fb1e1168d6fc33

See more details on using hashes here.

File details

Details for the file nautobot_ssot_servicenow-0.9.2-py3-none-any.whl.

File metadata

File hashes

Hashes for nautobot_ssot_servicenow-0.9.2-py3-none-any.whl
Algorithm Hash digest
SHA256 1cb94e180980ea2abf738c020a095c9285ff9789322cce4d1b5603c82f202fb6
MD5 d16ba77f4b850f134c2225ee63d6680e
BLAKE2b-256 9d2ff5c5785f4a49e7fbc62cbd2e6d45499aa411e4057e06e3542a9b24e8dda6

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page