v3.11.0 - 2025-11-14

Release Overview

Version 3.11 marks the designation of the 3.x branch as a Long Term Maintenance (LTM) release. This designation establishes a clear maintenance strategy for the 3.x series: only critical bug fixes and security patches will be incorporated into future 3.x releases. All new features, enhancements, and non-critical improvements will be developed exclusively for the 4.x branch. This approach ensures stability and reliability for production deployments while allowing for continued innovation in the 4.x series. Organizations requiring new functionality should plan to migrate to the 4.x branch when ready.

v3.11.0 (2025-11-14)

Added

• #951 - Added data validation for name, role, device_type, location and platform.
• #1004 - Added the ability to sync Virtual Machine tags from vSphere to Nautobot

Fixed

• #973 - Fixes issue when creating new SecretsGroup's with Secrets associations not being created when more than one is specified.
• #973 - Provides additional checks to ensure secrets are specified before creating associations.
• #975 - In the Bootstrap User Guide, changes the type for the longitude and latitude fields under the Location section from str to float.
• #989 - Corrected identifiers for loading of Floor location associated to a Controller in DNA Center integration.
• #990 - Show SSOT job start time in user-defined timezone
• #996 - Fixed Infoblox integration diffsync model trying to assign a Prefix to Location M2M before the Prefix has been saved.
• #1000 - Fixes contrib NautobotModel _get_queryset method to properly add related fields to prefetch_related method.
• #1006 - Move diff to a separate tab so in case of a large diff only the diff tab timeouts but not entire Sync object detailed view.
• #1017 - Updated Device42 integration to use SoftwareVersion in core Nautobot over SoftwareLCM from Device Lifecycle Management App.

Housekeeping

• #985 - Corrected Nautobot destination terminology in InfoBlox integratin.
• #1007 - Cleaned up outdated code related to older versions of Nautobot and the Device Lifecycle Management App.
• Rebaked from the cookie nautobot-app-v2.7.0.
• Rebaked from the cookie nautobot-app-v2.7.1.

New Contributors

• @icovada made their first contribution in #990
• @oniram307 made their first contribution in #974
• @pszulczewski made their first contribution in #1002
• @bminnix made their first contribution in #956

Full Changelog: v3.10.0...v3.11.0

Release 4.0.0a1 - 2025-11-04

v4.0.0a1 (2025-11-04)

Breaking Changes

• #997 - SSOTvSphereConfig and SSOTInfobloxConfig no longer support Saved Views, Dynamic Groups, Metadata, Contacts and Data Compliance.

Added

• Added support for Nautobot 3.0.
• Added support for Python 3.13.

Contributors

• @smk4664

Full Changelog: v3.10.0...v4.0.0a1

Release 3.10.0 - 2025-10-21

What's Changed

• Mitigate CVE by enforcing permissions on the ServiceNow Config view.
• Minimum Nautobot version is now 2.4.20.
• Minimum Python version is now 3.10.

v3.10.0 (2025-10-21)

Security

• #991 - Enforce permissions on ServiceNow Config view to mitigate GHSA-535g-62r7-cx6v.

Added

• #877 - Added contrib base classes BaseNautobotAdapter and BaseNautobotModel.

Fixed

• #878 - Fixed inability of vSphere integration to sync IPv6 addresses
• #964 - Fixes sync of anycast IPs for CloudVision SSOT.
• #964 - Implements tag deduplication for CloudVision SSOT.
• #964 - Removes log noise when duplicate IP or IPAssignments are found by CloudVision SSOT.
• #964 - Fixes cert failures for CloudVision SSOT CVaaS implementations (verify cert = False). Such cases can happen when SSL inspection for nautobot workers is in place.
• #980 - Fix Bootstrap SoftwareVersion deletion error.
• #982 - Fixed Exception when attempting to delete Software referenced by a Device.

Housekeeping

• #984 - Removed redundant nautobot minimum version check in jobs module.
• #991 - Implemented UIViewSets and Component UI.
• Rebaked from the cookie nautobot-app-v2.6.0.

Contributors

• @Renrut5
• @gsnider2195
• @nopg
• @qduk
• @smk4664

New Contributors

• @pato23arg made their first contribution in #965

Full Changelog: v3.9.4...v3.10.0

Release 3.9.4 - 2025-09-18

v3.9.4 (2025-09-18)

Release Overview

This release is focused on some vulnerabilities being fixed and a bugfix for the Meraki integration.

Security

• #968 - GHSA-mw26-5g2v-hqw3
• #968 - Deepdiff needs to be pinned to >8.6.0, requiring ipfabric to be bumped

Fixed

• #962 - Meraki get-organization-devices API may omit notes key in response, changed slice to get() on the dictionary payload.

Full Changelog: v3.9.3...v3.9.4

Release 3.9.3 - 2025-09-09

v3.9.3 (2025-09-09)

Added

• #913 - Added the enable_global_search configuration option to control whether the Nautobot global search includes synclogs.
• #938 - Added support for Object Metadata in the Bootstrap integration.
• #948 - Added ExternalIntegration creation to Bootstrap integration.

Fixed

• #548 - Improved performance of the SSoT Sync history page by removing an unnecessary log prefetch and deferring large JSON fields.
• #596 - Use required default arg ("msg") instead of kwarg ("message") when using self.job.logger.
• #723 - Fixed _handle_single_parameter metadata key vs name inconsistency.
• #910 - Fixed Service Now caching sys_ids causing objects to not be created.
• #936 - Fixed creation of "Unknown" location when running LibreNMS integration in dry run mode.
• #940 - Fixed error in Citrix ADM integration when attempting to assign an IP Address to an Interface.
• #947 - Fixed Advanced Filters for Infoblox Config and Automation Gateway Management.
• #953 - Fixed an issue in the Cisco DNA Center integration where devices with unmapped platforms were silently skipped during synchronization, resulting in an incomplete inventory

Housekeeping

• #954 - Update ruff to target Python 3.9
• Rebaked from the cookie nautobot-app-v2.5.1.

New Contributors

• @cdtomkins made their first contribution in #929
• @kacem-expereo made their first contribution in #933
• @fpocai made their first contribution in #944
• @rodrigogbranco made their first contribution in #953
• @robertoduarte-codilime made their first contribution in #952

Full Changelog: v3.9.2...v3.9.3

Release 3.9.2 - 2025-08-08

Release Notes

This release is mostly bugfixes for the Bootstrap, contrib, and Meraki integrations.

v3.9.2 (2025-08-08)

Added

• #860 - Added nautobot_ssot.utils.orm.get_custom_relationship_association_parameters utility function.
• #860 - Added nautobot_ssot.utils.orm.get_custom_relationship_associations utility function.
• #860 - Added nautobot_ssot.utils.typing.get_inner_type utility function.

Changed

• #860 - Changed nautobot_ssot.contrib.adapter.NautobotAdapter to use new orm and typing utility functions.

Fixed

• #596 - Handles HTTP 404 exception case for expired A record and PTR reference, and logs as a warning instead of failing the job run.
• #881 - Fixed exception caused by missing secret value when creating a SecretsGroup with Bootstrap.
• #904 - Fixed exception caused by missing software version when creating ValidatedSoftware with Bootstrap.
• #916 - Fixed bootstrap signal DLM checks.
• #921 - Fixed missing Prefix bug in Meraki integration.
• #926 - Fixed issue with metadata_type when contrib models are used without the contrib adapter.

Documentation

• #925 - Added Analytics GTM template override only to the public ReadTheDocs build.

Full Changelog: v3.9.1...v3.9.2

Release 3.9.1 - 2025-07-09

Release Overview

Please note that the behavior in the SNOW integration now is to swallow and log an overview of how many duplicates encountered, and provide file output outlining what duplicates were encountered.

Changed

• #874 - Reverted changes in NautobotModel to be backwards compatible with other integrations.
• #874 - Reverted removal of invalidate_cache method in NautobotAdapter.

Fixed

• #844 - Fixed job failure if there are duplicate devices in LibreNMS. Will skip device instead.
• #867 - Gracefully swallow ServiceNow exceptions
• #867 - Adds ServiceNow duplicate file reports
• #867 - Fixes ServiceNow comparison filters to only compare against company names with Manufacturer set to True

New Contributors

• @msheiny made their first contribution in #871

Full Changelog: v3.9.0...v3.9.1

Release 3.9.0 - 2025-06-26

Release Overview

This release brings several significant additions and changes:

• A new VMware vSphere integration!
• CVE-2022-42969 has been successfully fixed!
• Sync and sync logs are now searchable in the global search!
• The example Jobs now support synchronizing Tags on appropriate objects between Nautobot instances.
• All integrations that utilize the contrib pattern will automatically support Object Metadata being added to their models.

v3.9.0 (2025-06-26)

Added

• #500 - Added VMWare vSphere Integration.
• #836 - Added hide_in_diff_view flag for Sync and SyncLogEntry to hide those models in version control diff view.
• #840 - Added support for synchronizing Tags between Nautobot instances for objects that support them in example Jobs.
• #847 - Added get_orm_attribute function and tests.
• #847 - Added load_typed_dict function and tests.
• #850 - Added Sync and SyncLogEntry to the searchable_models definition.
• #853 - Added orm_attribute_lookup utility function.

Changed

• #632 - Enhance contrib to support object metadata.
• #810 - Moved caching in NautobotAdapter to dedicated class.
• #847 - Moved nautobot_ssot/utils.py to nautobot_ssot/utils/__init__.py
• #853 - Changed references in NautobotAdapter to point to utility functions.
• #865 - added closing bracket to example on docs

Fixed

• #678 - - Removes Retry dependency, which in turn removes py depencency, thereby fixing CVE https://nvd.nist.gov/vuln/detail/CVE-2022-42969
• #678 - - Re-implements retry decorator
• #784 - Change _handle_to_many_relationship from static method to instance method
• #807 - Redo of fix for Meraki IP duplication bug.
• #830 - Fixed top_level list not being properly generated for software models.
• #831 - Refactored handling of various Nautobot versions and Device Lifecycle Management app handling Software, SoftwareImage, and ValidatedSoftware models being synced.
• #842 - Fixed IP version bug in Meraki integration on AP uplink ports.
• #845 - Fix DNA Center integration to ensure Meraki devices aren't included in the failed device list if the import_meraki setting is False.
• #845 - Fixed duplicate IPAddressToInterface diffs being created due to mask_length being included as identifier in DNA Center integration.
• #859 - Fixed a bug where the cache persisted between sync executions in the Infoblox integration.

Documentation

• #856 - Added a note to the developer upgrade documentation to explain the default value for text fields declared with blank=True, null=False.
• #870 - Updated installation steps for vSphere integration.

New Contributors

• @julmanglano made their first contribution in #785
• @mateusz-lachowski-codilime made their first contribution in #836
• @garymccann made their first contribution in #852
• @cheenpo made their first contribution in #864

Full Changelog: v3.8.1...v3.9.0

Release v3.8.1 - 2025-05-16

v3.8.1 Release Notes

This is a patch release to disable the sort_relationships() function that was recently added. We've gotten reports that it's causing problems so it's being disabled until we can fully ensure it's tested and no longer causing problems for users.

v3.8.1 (2025-05-16)

Changed

• #822 - Disabled auto sorting in SSoT.

Full Changelog: v3.8.0...v3.8.1

Release v3.8.0 - 2025-05-16

Release Overview

This release has a new IPFabric feature for syncing the Device Role using the Device Type. There were also a lot of bugfixes for a few integrations and performance improvements by adding an index to a few fields on the Sync and SyncLogEntry classes.

v3.8.0 (2025-05-16)

Added

• #812 - Added ipfabric_sync_ipf_dev_type_to_role flag to IP Fabric SSoT integration defaulting to True. Disabling this flag will prevent the sync of device types to device roles in IP Fabric and use the default device role mapping for new devices.
• #813 - Added IP Fabric Site Filter using Attribute Filters when a Nautobot Location Filter is used in the SSoT integration to optimize performance.
• #7154 - Added db_index to start_time in Sync
• #7154 - Added db_index to timestamp in SyncLogEntry

Fixed

• #467 - Fixed gRPC error during get_devices() call in CVP integration.
• #796 - Fixed incorrect URL used in CloudVision integration when attempting to connect to portal and get version.
• #802 - Fix TypeError contrib.sorting for issue #802.
• #807 - Fixed Meraki integration creating duplicate IPAddresses with same host address.
• #811 - Fixed the number of API calls to IP Fabric resulting in non-optimal performance causing SSoT synchronization timeouts.
• #814 - Removed ipfabric_allow_duplicate_addresses flag as it is not implemented in the IP Fabric integration.
• #815 - Fixed return of nautobot_ssot.integrations.ipfabric.diffsync.diffsync_models.Device.create method to return the newly created device so child objects are also synchronized and job succeeds without failures.
• #816 - Fixed sorting bug for types without __annotation__.
• #819 - Fix check before loading ValidatedSoftware Model.

Housekeeping

• Rebaked from the cookie nautobot-app-v2.5.0.

New Contributors

• @dsoftait made their first contribution in #798

Full Changelog: v3.7.0...v3.8.0