From 8421d0864cbba1bc1148a3334d1992ba186c5c7f Mon Sep 17 00:00:00 2001 From: Jason Yates Date: Thu, 7 Apr 2022 08:21:13 +0100 Subject: [PATCH 01/28] Limit amount of nonracked devices displayed Fixes #8920 Limits the amount of non-racked devices on Site and Location view to 10 and provides a link to the device list this is pre-filtered to the relevant site or location. --- netbox/dcim/views.py | 18 ++++- .../templates/dcim/inc/nonracked_devices.html | 68 +++++++++++-------- 2 files changed, 57 insertions(+), 29 deletions(-) diff --git a/netbox/dcim/views.py b/netbox/dcim/views.py index c0b46f16e..9b24ea9d1 100644 --- a/netbox/dcim/views.py +++ b/netbox/dcim/views.py @@ -346,7 +346,13 @@ class SiteView(generic.ObjectView): site=instance, position__isnull=True, parent_bay__isnull=True - ).prefetch_related('device_type__manufacturer') + ).prefetch_related('device_type__manufacturer').order_by('-pk')[:10] + + total_nonracked_devices_count = Device.objects.filter( + site=instance, + position__isnull=True, + parent_bay__isnull=True + ).count() asns = ASN.objects.restrict(request.user, 'view').filter(sites=instance) asn_count = asns.count() @@ -358,6 +364,7 @@ class SiteView(generic.ObjectView): 'locations': locations, 'asns': asns, 'nonracked_devices': nonracked_devices, + 'total_nonracked_devices_count': total_nonracked_devices_count, } @@ -439,13 +446,20 @@ class LocationView(generic.ObjectView): location=instance, position__isnull=True, parent_bay__isnull=True - ).prefetch_related('device_type__manufacturer') + ).prefetch_related('device_type__manufacturer').order_by('-pk')[:10] + + total_nonracked_devices_count = Device.objects.filter( + location=instance, + position__isnull=True, + parent_bay__isnull=True + ).count() return { 'rack_count': rack_count, 'device_count': device_count, 'child_locations_table': child_locations_table, 'nonracked_devices': nonracked_devices, + 'total_nonracked_devices_count': total_nonracked_devices_count, } diff --git a/netbox/templates/dcim/inc/nonracked_devices.html b/netbox/templates/dcim/inc/nonracked_devices.html index 7f4da2f24..68112e2a7 100644 --- a/netbox/templates/dcim/inc/nonracked_devices.html +++ b/netbox/templates/dcim/inc/nonracked_devices.html @@ -1,40 +1,54 @@ {% load helpers %}
-
- Non-Racked Devices -
-
-{% if nonracked_devices %} - - - - - - - - {% for device in nonracked_devices %} - - - - - {% if device.parent_bay %} - - - {% else %} - +
+ Non-Racked Devices +
+
+ {% if nonracked_devices %} +
NameRoleTypeParent Device
- {{ device }} - {{ device.device_role }}{{ device.device_type }}{{ device.parent_bay.device|linkify }}{{ device.parent_bay }}—
+ + + + + + + {% for device in nonracked_devices %} + + + + + {% if device.parent_bay %} + + + {% else %} + + {% endif %} + + {% endfor %} +
NameRoleTypeParent Device
+ {{ device }} + {{ device.device_role }}{{ device.device_type }}{{ device.parent_bay.device|linkify }}{{ device.parent_bay }}—
+ + {% if nonracked_devices.count == 10 %} + {% if object|meta:'verbose_name' == 'site' %} +
+ Displaying 10 of {{ total_nonracked_devices_count }} devices (View full list) +
+ {% elif object|meta:'verbose_name' == 'location' %} +
+ Displaying 10 of {{ total_nonracked_devices_count }} devices (View full list) +
{% endif %} - - {% endfor %} - + {% endif %} + {% else %}
None
{% endif %}
+ {% if perms.dcim.add_device %} {% if object|meta:'verbose_name' == 'rack' %}
From 852645d6cf37ea7fbead16fb67f4713a4606c175 Mon Sep 17 00:00:00 2001 From: Jason Yates Date: Thu, 7 Apr 2022 08:32:50 +0100 Subject: [PATCH 02/28] Update nonracked_devices.html Fixing issue where Displaying 10 of 10 would appear when it's not required. --- netbox/templates/dcim/inc/nonracked_devices.html | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/netbox/templates/dcim/inc/nonracked_devices.html b/netbox/templates/dcim/inc/nonracked_devices.html index 68112e2a7..d4cd58839 100644 --- a/netbox/templates/dcim/inc/nonracked_devices.html +++ b/netbox/templates/dcim/inc/nonracked_devices.html @@ -30,14 +30,14 @@ {% endfor %} - {% if nonracked_devices.count == 10 %} + {% if total_nonracked_devices_count > nonracked_devices.count %} {% if object|meta:'verbose_name' == 'site' %}
- Displaying 10 of {{ total_nonracked_devices_count }} devices (View full list) + Displaying {{ nonracked_devices.count }} of {{ total_nonracked_devices_count }} devices (View full list)
{% elif object|meta:'verbose_name' == 'location' %}
- Displaying 10 of {{ total_nonracked_devices_count }} devices (View full list) + Displaying {{ nonracked_devices.count }} of {{ total_nonracked_devices_count }} devices (View full list)
{% endif %} {% endif %} From 3ef7f903d9b4cee81c1bac66099d5860628d0b17 Mon Sep 17 00:00:00 2001 From: Jason Yates Date: Sun, 10 Apr 2022 09:06:14 +0100 Subject: [PATCH 03/28] Updating to use a single queryset Updating to use a single queryset for both template variables --- netbox/dcim/views.py | 26 ++++++++------------------ 1 file changed, 8 insertions(+), 18 deletions(-) diff --git a/netbox/dcim/views.py b/netbox/dcim/views.py index 9b24ea9d1..bc2cbdcb8 100644 --- a/netbox/dcim/views.py +++ b/netbox/dcim/views.py @@ -342,17 +342,12 @@ class SiteView(generic.ObjectView): 'device_count', cumulative=True ).restrict(request.user, 'view').filter(site=instance) + nonracked_devices = Device.objects.filter( site=instance, position__isnull=True, parent_bay__isnull=True - ).prefetch_related('device_type__manufacturer').order_by('-pk')[:10] - - total_nonracked_devices_count = Device.objects.filter( - site=instance, - position__isnull=True, - parent_bay__isnull=True - ).count() + ).prefetch_related('device_type__manufacturer') asns = ASN.objects.restrict(request.user, 'view').filter(sites=instance) asn_count = asns.count() @@ -363,8 +358,8 @@ class SiteView(generic.ObjectView): 'stats': stats, 'locations': locations, 'asns': asns, - 'nonracked_devices': nonracked_devices, - 'total_nonracked_devices_count': total_nonracked_devices_count, + 'nonracked_devices': nonracked_devices.order_by('-pk')[:10], + 'total_nonracked_devices_count': nonracked_devices.count(), } @@ -442,24 +437,19 @@ class LocationView(generic.ObjectView): ).filter(pk__in=location_ids).exclude(pk=instance.pk) child_locations_table = tables.LocationTable(child_locations) child_locations_table.configure(request) + nonracked_devices = Device.objects.filter( location=instance, position__isnull=True, parent_bay__isnull=True - ).prefetch_related('device_type__manufacturer').order_by('-pk')[:10] - - total_nonracked_devices_count = Device.objects.filter( - location=instance, - position__isnull=True, - parent_bay__isnull=True - ).count() + ).prefetch_related('device_type__manufacturer') return { 'rack_count': rack_count, 'device_count': device_count, 'child_locations_table': child_locations_table, - 'nonracked_devices': nonracked_devices, - 'total_nonracked_devices_count': total_nonracked_devices_count, + 'nonracked_devices': nonracked_devices.order_by('-pk')[:10], + 'total_nonracked_devices_count': nonracked_devices.count(), } From 3255aae0896d2586f173d77c080840d6f6b64cff Mon Sep 17 00:00:00 2001 From: Joe Izzard Date: Mon, 11 Apr 2022 12:20:44 +0100 Subject: [PATCH 04/28] Closes #8415: Adds Neutrik power connectors --- netbox/dcim/choices.py | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/netbox/dcim/choices.py b/netbox/dcim/choices.py index c5f70c1b6..1bfbcbc94 100644 --- a/netbox/dcim/choices.py +++ b/netbox/dcim/choices.py @@ -345,6 +345,10 @@ class PowerPortTypeChoices(ChoiceSet): TYPE_DC = 'dc-terminal' # Proprietary TYPE_SAF_D_GRID = 'saf-d-grid' + TYPE_NEUTRIK_POWERCON = 'neutrik-powercon' + TYPE_NEUTRIK_POWERCON_32A = 'neutrik-powercon-32' + TYPE_NEUTRIK_TRUE1 = 'neutrik-true1' + TYPE_NEUTRIK_TRUE1_TOP = 'neutrik-true1-top' # Other TYPE_HARDWIRED = 'hardwired' @@ -456,6 +460,10 @@ class PowerPortTypeChoices(ChoiceSet): )), ('Proprietary', ( (TYPE_SAF_D_GRID, 'Saf-D-Grid'), + (TYPE_NEUTRIK_POWERCON, 'Neutrik powerCon'), + (TYPE_NEUTRIK_POWERCON_32A, 'Neutrik powerCon (32A)'), + (TYPE_NEUTRIK_TRUE1, 'Neutrik powerCon TRUE1'), + (TYPE_NEUTRIK_TRUE1_TOP, 'Neutrik powerCon TRUE1 TOP'), )), ('Other', ( (TYPE_HARDWIRED, 'Hardwired'), @@ -561,6 +569,10 @@ class PowerOutletTypeChoices(ChoiceSet): # Proprietary TYPE_HDOT_CX = 'hdot-cx' TYPE_SAF_D_GRID = 'saf-d-grid' + TYPE_NEUTRIK_POWERCON = 'neutrik-powercon' + TYPE_NEUTRIK_POWERCON_32A = 'neutrik-powercon-32' + TYPE_NEUTRIK_TRUE1 = 'neutrik-true1' + TYPE_NEUTRIK_TRUE1_TOP = 'neutrik-true1-top' # Other TYPE_HARDWIRED = 'hardwired' @@ -665,6 +677,10 @@ class PowerOutletTypeChoices(ChoiceSet): ('Proprietary', ( (TYPE_HDOT_CX, 'HDOT Cx'), (TYPE_SAF_D_GRID, 'Saf-D-Grid'), + (TYPE_NEUTRIK_POWERCON, 'Neutrik powerCon'), + (TYPE_NEUTRIK_POWERCON_32A, 'Neutrik powerCon (32A)'), + (TYPE_NEUTRIK_TRUE1, 'Neutrik powerCon TRUE1'), + (TYPE_NEUTRIK_TRUE1_TOP, 'Neutrik powerCon TRUE1 TOP'), )), ('Other', ( (TYPE_HARDWIRED, 'Hardwired'), From 00ad3f7632794658b357c958b0a9b295cb2d9d5d Mon Sep 17 00:00:00 2001 From: jeremystretch Date: Mon, 11 Apr 2022 08:28:10 -0400 Subject: [PATCH 05/28] Fixes #9100: Include position field in module type YAML export --- docs/release-notes/version-3.2.md | 1 + netbox/dcim/models/devices.py | 1 + 2 files changed, 2 insertions(+) diff --git a/docs/release-notes/version-3.2.md b/docs/release-notes/version-3.2.md index 101797793..8dc2302e5 100644 --- a/docs/release-notes/version-3.2.md +++ b/docs/release-notes/version-3.2.md @@ -15,6 +15,7 @@ * [#9061](https://github.com/netbox-community/netbox/issues/9061) - Change inheritance order for DeviceComponentFilterSets * [#9065](https://github.com/netbox-community/netbox/issues/9065) - Min/max VID should not be required when filtering VLAN groups * [#9079](https://github.com/netbox-community/netbox/issues/9079) - Fail validation when an inventory item is assigned as its own parent +* [#9100](https://github.com/netbox-community/netbox/issues/9100) - Include position field in module type YAML export --- diff --git a/netbox/dcim/models/devices.py b/netbox/dcim/models/devices.py index d95063601..6ed7b349f 100644 --- a/netbox/dcim/models/devices.py +++ b/netbox/dcim/models/devices.py @@ -257,6 +257,7 @@ class DeviceType(NetBoxModel): { 'name': c.name, 'label': c.label, + 'position': c.position, 'description': c.description, } for c in self.modulebaytemplates.all() From 995048b6c31947d754ec09844829126cf4f5e4b0 Mon Sep 17 00:00:00 2001 From: jeremystretch Date: Mon, 11 Apr 2022 08:51:11 -0400 Subject: [PATCH 06/28] Fixes #9096: Remove duplicate filter tag when filtering by "none" --- docs/release-notes/version-3.2.md | 1 + netbox/utilities/forms/utils.py | 10 +++++----- 2 files changed, 6 insertions(+), 5 deletions(-) diff --git a/docs/release-notes/version-3.2.md b/docs/release-notes/version-3.2.md index 8dc2302e5..4269cb5f0 100644 --- a/docs/release-notes/version-3.2.md +++ b/docs/release-notes/version-3.2.md @@ -15,6 +15,7 @@ * [#9061](https://github.com/netbox-community/netbox/issues/9061) - Change inheritance order for DeviceComponentFilterSets * [#9065](https://github.com/netbox-community/netbox/issues/9065) - Min/max VID should not be required when filtering VLAN groups * [#9079](https://github.com/netbox-community/netbox/issues/9079) - Fail validation when an inventory item is assigned as its own parent +* [#9096](https://github.com/netbox-community/netbox/issues/9096) - Remove duplicate filter tag when filtering by "none" * [#9100](https://github.com/netbox-community/netbox/issues/9100) - Include position field in module type YAML export --- diff --git a/netbox/utilities/forms/utils.py b/netbox/utilities/forms/utils.py index 6d45d524d..db10cf1e0 100644 --- a/netbox/utilities/forms/utils.py +++ b/netbox/utilities/forms/utils.py @@ -144,11 +144,11 @@ def get_selected_values(form, field_name): label for value, label in choices if str(value) in filter_data or None in filter_data ] - if hasattr(field, 'null_option'): - # If the field has a `null_option` attribute set and it is selected, - # add it to the field's grouped choices. - if field.null_option is not None and None in filter_data: - values.append(field.null_option) + # If the field has a `null_option` attribute set and it is selected, + # add it to the field's grouped choices. + if getattr(field, 'null_option') and None in filter_data: + values.remove(None) + values.insert(0, field.null_option) return values From 889ef47d07f063e59e7c81af7ac3fbb73d1c2ded Mon Sep 17 00:00:00 2001 From: jeremystretch Date: Tue, 12 Apr 2022 08:13:08 -0400 Subject: [PATCH 07/28] #9096: Correct getattr() call --- netbox/utilities/forms/utils.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/netbox/utilities/forms/utils.py b/netbox/utilities/forms/utils.py index db10cf1e0..9a4b011e0 100644 --- a/netbox/utilities/forms/utils.py +++ b/netbox/utilities/forms/utils.py @@ -146,7 +146,7 @@ def get_selected_values(form, field_name): # If the field has a `null_option` attribute set and it is selected, # add it to the field's grouped choices. - if getattr(field, 'null_option') and None in filter_data: + if getattr(field, 'null_option', None) and None in filter_data: values.remove(None) values.insert(0, field.null_option) From 0550f268ef7c20d499e68091d0ddc50ed073af01 Mon Sep 17 00:00:00 2001 From: jeremystretch Date: Tue, 12 Apr 2022 08:22:17 -0400 Subject: [PATCH 08/28] Tweak changelog for #9061 --- docs/release-notes/version-3.2.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/release-notes/version-3.2.md b/docs/release-notes/version-3.2.md index 4269cb5f0..8fcfd6136 100644 --- a/docs/release-notes/version-3.2.md +++ b/docs/release-notes/version-3.2.md @@ -12,7 +12,7 @@ * [#8931](https://github.com/netbox-community/netbox/issues/8931) - Copy assigned tenant when cloning a location * [#9055](https://github.com/netbox-community/netbox/issues/9055) - Restore ability to move inventory item to other device * [#9057](https://github.com/netbox-community/netbox/issues/9057) - Fix missing instance counts for module types -* [#9061](https://github.com/netbox-community/netbox/issues/9061) - Change inheritance order for DeviceComponentFilterSets +* [#9061](https://github.com/netbox-community/netbox/issues/9061) - Fix general search for device components * [#9065](https://github.com/netbox-community/netbox/issues/9065) - Min/max VID should not be required when filtering VLAN groups * [#9079](https://github.com/netbox-community/netbox/issues/9079) - Fail validation when an inventory item is assigned as its own parent * [#9096](https://github.com/netbox-community/netbox/issues/9096) - Remove duplicate filter tag when filtering by "none" From 21304071755a95cc3075dd7bbf022edab8828f91 Mon Sep 17 00:00:00 2001 From: jeremystretch Date: Tue, 12 Apr 2022 09:00:19 -0400 Subject: [PATCH 09/28] Closes #9099: Enable display of installed module serial & asset tag in module bays list --- docs/release-notes/version-3.2.md | 1 + netbox/dcim/tables/devices.py | 16 ++++++++++++++-- netbox/templates/dcim/modulebay.html | 12 ++++++++++++ 3 files changed, 27 insertions(+), 2 deletions(-) diff --git a/docs/release-notes/version-3.2.md b/docs/release-notes/version-3.2.md index 8fcfd6136..faa87c6d2 100644 --- a/docs/release-notes/version-3.2.md +++ b/docs/release-notes/version-3.2.md @@ -6,6 +6,7 @@ * [#5479](https://github.com/netbox-community/netbox/issues/5479) - Allow custom job timeouts for scripts & reports * [#8973](https://github.com/netbox-community/netbox/issues/8973) - Display VLAN group count under site view +* [#9099](https://github.com/netbox-community/netbox/issues/9099) - Enable display of installed module serial & asset tag in module bays list ### Bug Fixes diff --git a/netbox/dcim/tables/devices.py b/netbox/dcim/tables/devices.py index f3e1d39e0..25ad1415d 100644 --- a/netbox/dcim/tables/devices.py +++ b/netbox/dcim/tables/devices.py @@ -739,13 +739,22 @@ class ModuleBayTable(DeviceComponentTable): linkify=True, verbose_name='Installed module' ) + module_serial = tables.Column( + accessor=tables.A('installed_module__serial') + ) + module_asset_tag = tables.Column( + accessor=tables.A('installed_module__asset_tag') + ) tags = columns.TagColumn( url_name='dcim:modulebay_list' ) class Meta(DeviceComponentTable.Meta): model = ModuleBay - fields = ('pk', 'id', 'name', 'device', 'label', 'position', 'installed_module', 'description', 'tags') + fields = ( + 'pk', 'id', 'name', 'device', 'label', 'position', 'installed_module', 'module_serial', 'module_asset_tag', + 'description', 'tags', + ) default_columns = ('pk', 'name', 'device', 'label', 'installed_module', 'description') @@ -756,7 +765,10 @@ class DeviceModuleBayTable(ModuleBayTable): class Meta(DeviceComponentTable.Meta): model = ModuleBay - fields = ('pk', 'id', 'name', 'label', 'position', 'installed_module', 'description', 'tags', 'actions') + fields = ( + 'pk', 'id', 'name', 'label', 'position', 'installed_module', 'module_serial', 'module_asset_tag', + 'description', 'tags', 'actions', + ) default_columns = ('pk', 'name', 'label', 'installed_module', 'description') diff --git a/netbox/templates/dcim/modulebay.html b/netbox/templates/dcim/modulebay.html index a12e020e9..3ef539156 100644 --- a/netbox/templates/dcim/modulebay.html +++ b/netbox/templates/dcim/modulebay.html @@ -52,6 +52,10 @@ {% if object.installed_module %} {% with module=object.installed_module %} + + + + @@ -60,6 +64,14 @@ + + + + + + + +
Module{{ module|linkify }}
Manufacturer {{ module.module_type.manufacturer|linkify }}Module Type {{ module.module_type|linkify }}
Serial Number{{ module.serial|placeholder }}
Asset Tag{{ module.asset_tag|placeholder }}
{% endwith %} {% else %} From cac2685e991ab8432b485d50ca35b2a22734b983 Mon Sep 17 00:00:00 2001 From: jeremystretch Date: Tue, 12 Apr 2022 09:56:33 -0400 Subject: [PATCH 10/28] Closes #9081: Add fhrpgroup_id filter for IP addresses --- docs/release-notes/version-3.2.md | 1 + netbox/ipam/filtersets.py | 5 +++++ netbox/ipam/tests/test_filtersets.py | 23 +++++++++++++++++++---- 3 files changed, 25 insertions(+), 4 deletions(-) diff --git a/docs/release-notes/version-3.2.md b/docs/release-notes/version-3.2.md index faa87c6d2..171783e36 100644 --- a/docs/release-notes/version-3.2.md +++ b/docs/release-notes/version-3.2.md @@ -6,6 +6,7 @@ * [#5479](https://github.com/netbox-community/netbox/issues/5479) - Allow custom job timeouts for scripts & reports * [#8973](https://github.com/netbox-community/netbox/issues/8973) - Display VLAN group count under site view +* [#9081](https://github.com/netbox-community/netbox/issues/9081) - Add `fhrpgroup_id` filter for IP addresses * [#9099](https://github.com/netbox-community/netbox/issues/9099) - Enable display of installed module serial & asset tag in module bays list ### Bug Fixes diff --git a/netbox/ipam/filtersets.py b/netbox/ipam/filtersets.py index 88b586bf2..977e70020 100644 --- a/netbox/ipam/filtersets.py +++ b/netbox/ipam/filtersets.py @@ -535,6 +535,11 @@ class IPAddressFilterSet(NetBoxModelFilterSet, TenancyFilterSet): queryset=VMInterface.objects.all(), label='VM interface (ID)', ) + fhrpgroup_id = django_filters.ModelMultipleChoiceFilter( + field_name='fhrpgroup', + queryset=FHRPGroup.objects.all(), + label='FHRP group (ID)', + ) assigned_to_interface = django_filters.BooleanFilter( method='_assigned_to_interface', label='Is assigned to an interface', diff --git a/netbox/ipam/tests/test_filtersets.py b/netbox/ipam/tests/test_filtersets.py index eaf84ee16..9bae84e3a 100644 --- a/netbox/ipam/tests/test_filtersets.py +++ b/netbox/ipam/tests/test_filtersets.py @@ -771,6 +771,12 @@ class IPAddressTestCase(TestCase, ChangeLoggedFilterSetTests): ) VMInterface.objects.bulk_create(vminterfaces) + fhrp_groups = ( + FHRPGroup(protocol=FHRPGroupProtocolChoices.PROTOCOL_VRRP2, group_id=101), + FHRPGroup(protocol=FHRPGroupProtocolChoices.PROTOCOL_VRRP2, group_id=102), + ) + FHRPGroup.objects.bulk_create(fhrp_groups) + tenant_groups = ( TenantGroup(name='Tenant group 1', slug='tenant-group-1'), TenantGroup(name='Tenant group 2', slug='tenant-group-2'), @@ -791,18 +797,22 @@ class IPAddressTestCase(TestCase, ChangeLoggedFilterSetTests): IPAddress(address='10.0.0.2/24', tenant=tenants[0], vrf=vrfs[0], assigned_object=interfaces[0], status=IPAddressStatusChoices.STATUS_ACTIVE, dns_name='ipaddress-b'), IPAddress(address='10.0.0.3/24', tenant=tenants[1], vrf=vrfs[1], assigned_object=interfaces[1], status=IPAddressStatusChoices.STATUS_RESERVED, role=IPAddressRoleChoices.ROLE_VIP, dns_name='ipaddress-c'), IPAddress(address='10.0.0.4/24', tenant=tenants[2], vrf=vrfs[2], assigned_object=interfaces[2], status=IPAddressStatusChoices.STATUS_DEPRECATED, role=IPAddressRoleChoices.ROLE_SECONDARY, dns_name='ipaddress-d'), + IPAddress(address='10.0.0.5/24', tenant=None, vrf=None, assigned_object=fhrp_groups[0], status=IPAddressStatusChoices.STATUS_ACTIVE), IPAddress(address='10.0.0.1/25', tenant=None, vrf=None, assigned_object=None, status=IPAddressStatusChoices.STATUS_ACTIVE), IPAddress(address='2001:db8::1/64', tenant=None, vrf=None, assigned_object=None, status=IPAddressStatusChoices.STATUS_ACTIVE, dns_name='ipaddress-a', description='foobar2'), IPAddress(address='2001:db8::2/64', tenant=tenants[0], vrf=vrfs[0], assigned_object=vminterfaces[0], status=IPAddressStatusChoices.STATUS_ACTIVE, dns_name='ipaddress-b'), IPAddress(address='2001:db8::3/64', tenant=tenants[1], vrf=vrfs[1], assigned_object=vminterfaces[1], status=IPAddressStatusChoices.STATUS_RESERVED, role=IPAddressRoleChoices.ROLE_VIP, dns_name='ipaddress-c'), IPAddress(address='2001:db8::4/64', tenant=tenants[2], vrf=vrfs[2], assigned_object=vminterfaces[2], status=IPAddressStatusChoices.STATUS_DEPRECATED, role=IPAddressRoleChoices.ROLE_SECONDARY, dns_name='ipaddress-d'), + IPAddress(address='2001:db8::5/64', tenant=None, vrf=None, assigned_object=fhrp_groups[1], status=IPAddressStatusChoices.STATUS_ACTIVE), IPAddress(address='2001:db8::1/65', tenant=None, vrf=None, assigned_object=None, status=IPAddressStatusChoices.STATUS_ACTIVE), ) IPAddress.objects.bulk_create(ipaddresses) def test_family(self): + params = {'family': '4'} + self.assertEqual(self.filterset(params, self.queryset).qs.count(), 6) params = {'family': '6'} - self.assertEqual(self.filterset(params, self.queryset).qs.count(), 5) + self.assertEqual(self.filterset(params, self.queryset).qs.count(), 6) def test_dns_name(self): params = {'dns_name': ['ipaddress-a', 'ipaddress-b']} @@ -814,9 +824,9 @@ class IPAddressTestCase(TestCase, ChangeLoggedFilterSetTests): def test_parent(self): params = {'parent': '10.0.0.0/24'} - self.assertEqual(self.filterset(params, self.queryset).qs.count(), 5) + self.assertEqual(self.filterset(params, self.queryset).qs.count(), 6) params = {'parent': '2001:db8::/64'} - self.assertEqual(self.filterset(params, self.queryset).qs.count(), 5) + self.assertEqual(self.filterset(params, self.queryset).qs.count(), 6) def test_filter_address(self): # Check IPv4 and IPv6, with and without a mask @@ -835,7 +845,7 @@ class IPAddressTestCase(TestCase, ChangeLoggedFilterSetTests): def test_mask_length(self): params = {'mask_length': '24'} - self.assertEqual(self.filterset(params, self.queryset).qs.count(), 4) + self.assertEqual(self.filterset(params, self.queryset).qs.count(), 5) def test_vrf(self): vrfs = VRF.objects.all()[:2] @@ -872,6 +882,11 @@ class IPAddressTestCase(TestCase, ChangeLoggedFilterSetTests): params = {'vminterface': ['Interface 1', 'Interface 2']} self.assertEqual(self.filterset(params, self.queryset).qs.count(), 2) + def test_fhrpgroup(self): + fhrp_groups = FHRPGroup.objects.all()[:2] + params = {'fhrpgroup_id': [fhrp_groups[0].pk, fhrp_groups[1].pk]} + self.assertEqual(self.filterset(params, self.queryset).qs.count(), 2) + def test_assigned_to_interface(self): params = {'assigned_to_interface': 'true'} self.assertEqual(self.filterset(params, self.queryset).qs.count(), 6) From 6b1e690df0f0ec1b6bce9a04e93c7fc45301c654 Mon Sep 17 00:00:00 2001 From: jeremystretch Date: Tue, 12 Apr 2022 10:07:31 -0400 Subject: [PATCH 11/28] Fixes #9116: assigned_to_interface filter for IP addresses should not match FHRP group assignments --- docs/release-notes/version-3.2.md | 1 + netbox/ipam/filtersets.py | 12 +++++++++++- netbox/ipam/tests/test_filtersets.py | 2 +- 3 files changed, 13 insertions(+), 2 deletions(-) diff --git a/docs/release-notes/version-3.2.md b/docs/release-notes/version-3.2.md index 171783e36..a7cccf946 100644 --- a/docs/release-notes/version-3.2.md +++ b/docs/release-notes/version-3.2.md @@ -19,6 +19,7 @@ * [#9079](https://github.com/netbox-community/netbox/issues/9079) - Fail validation when an inventory item is assigned as its own parent * [#9096](https://github.com/netbox-community/netbox/issues/9096) - Remove duplicate filter tag when filtering by "none" * [#9100](https://github.com/netbox-community/netbox/issues/9100) - Include position field in module type YAML export +* [#9116](https://github.com/netbox-community/netbox/issues/9116) - `assigned_to_interface` filter for IP addresses should not match FHRP group assignments --- diff --git a/netbox/ipam/filtersets.py b/netbox/ipam/filtersets.py index 977e70020..53c589bb3 100644 --- a/netbox/ipam/filtersets.py +++ b/netbox/ipam/filtersets.py @@ -618,7 +618,17 @@ class IPAddressFilterSet(NetBoxModelFilterSet, TenancyFilterSet): ) def _assigned_to_interface(self, queryset, name, value): - return queryset.exclude(assigned_object_id__isnull=value) + content_types = ContentType.objects.get_for_models(Interface, VMInterface).values() + if value: + return queryset.filter( + assigned_object_type__in=content_types, + assigned_object_id__isnull=False + ) + else: + return queryset.exclude( + assigned_object_type__in=content_types, + assigned_object_id__isnull=False + ) class FHRPGroupFilterSet(NetBoxModelFilterSet): diff --git a/netbox/ipam/tests/test_filtersets.py b/netbox/ipam/tests/test_filtersets.py index 9bae84e3a..4bb72dce2 100644 --- a/netbox/ipam/tests/test_filtersets.py +++ b/netbox/ipam/tests/test_filtersets.py @@ -891,7 +891,7 @@ class IPAddressTestCase(TestCase, ChangeLoggedFilterSetTests): params = {'assigned_to_interface': 'true'} self.assertEqual(self.filterset(params, self.queryset).qs.count(), 6) params = {'assigned_to_interface': 'false'} - self.assertEqual(self.filterset(params, self.queryset).qs.count(), 4) + self.assertEqual(self.filterset(params, self.queryset).qs.count(), 6) def test_status(self): params = {'status': [PrefixStatusChoices.STATUS_DEPRECATED, PrefixStatusChoices.STATUS_RESERVED]} From 557248c53f30680bdbf651b21f5929c50b9a09e1 Mon Sep 17 00:00:00 2001 From: kkthxbye <> Date: Thu, 24 Mar 2022 13:42:07 +0100 Subject: [PATCH 12/28] Save old JobResults --- netbox/extras/api/views.py | 4 ++-- netbox/extras/management/commands/runscript.py | 7 ------- netbox/extras/reports.py | 9 --------- netbox/extras/scripts.py | 11 +---------- netbox/extras/views.py | 4 ++-- netbox/netbox/views/__init__.py | 11 +---------- 6 files changed, 6 insertions(+), 40 deletions(-) diff --git a/netbox/extras/api/views.py b/netbox/extras/api/views.py index 579e39d86..688f3c7ab 100644 --- a/netbox/extras/api/views.py +++ b/netbox/extras/api/views.py @@ -179,7 +179,7 @@ class ReportViewSet(ViewSet): for r in JobResult.objects.filter( obj_type=report_content_type, status__in=JobResultStatusChoices.TERMINAL_STATE_CHOICES - ).defer('data') + ).order_by('name', '-created').distinct('name').defer('data') } # Iterate through all available Reports. @@ -271,7 +271,7 @@ class ScriptViewSet(ViewSet): for r in JobResult.objects.filter( obj_type=script_content_type, status__in=JobResultStatusChoices.TERMINAL_STATE_CHOICES - ).defer('data').order_by('created') + ).order_by('name', '-created').distinct('name').defer('data') } flat_list = [] diff --git a/netbox/extras/management/commands/runscript.py b/netbox/extras/management/commands/runscript.py index 0d1dc5cea..12188619f 100644 --- a/netbox/extras/management/commands/runscript.py +++ b/netbox/extras/management/commands/runscript.py @@ -113,13 +113,6 @@ class Command(BaseCommand): script_content_type = ContentType.objects.get(app_label='extras', model='script') - # Delete any previous terminal state results - JobResult.objects.filter( - obj_type=script_content_type, - name=script.full_name, - status__in=JobResultStatusChoices.TERMINAL_STATE_CHOICES - ).delete() - # Create the job result job_result = JobResult.objects.create( name=script.full_name, diff --git a/netbox/extras/reports.py b/netbox/extras/reports.py index 0bdc4847e..0a8a8d89b 100644 --- a/netbox/extras/reports.py +++ b/netbox/extras/reports.py @@ -84,15 +84,6 @@ def run_report(job_result, *args, **kwargs): job_result.save() logging.error(f"Error during execution of report {job_result.name}") - # Delete any previous terminal state results - JobResult.objects.filter( - obj_type=job_result.obj_type, - name=job_result.name, - status__in=JobResultStatusChoices.TERMINAL_STATE_CHOICES - ).exclude( - pk=job_result.pk - ).delete() - class Report(object): """ diff --git a/netbox/extras/scripts.py b/netbox/extras/scripts.py index 5351bca8a..4eacddbeb 100644 --- a/netbox/extras/scripts.py +++ b/netbox/extras/scripts.py @@ -481,15 +481,6 @@ def run_script(data, request, commit=True, *args, **kwargs): else: _run_script() - # Delete any previous terminal state results - JobResult.objects.filter( - obj_type=job_result.obj_type, - name=job_result.name, - status__in=JobResultStatusChoices.TERMINAL_STATE_CHOICES - ).exclude( - pk=job_result.pk - ).delete() - def get_scripts(use_names=False): """ @@ -497,7 +488,7 @@ def get_scripts(use_names=False): defined name in place of the actual module name. """ scripts = OrderedDict() - # Iterate through all modules within the reports path. These are the user-created files in which reports are + # Iterate through all modules within the scripts path. These are the user-created files in which reports are # defined. for importer, module_name, _ in pkgutil.iter_modules([settings.SCRIPTS_ROOT]): # Remove cached module to ensure consistency with filesystem diff --git a/netbox/extras/views.py b/netbox/extras/views.py index 785c5eb5a..9825d10de 100644 --- a/netbox/extras/views.py +++ b/netbox/extras/views.py @@ -524,7 +524,7 @@ class ReportListView(ContentTypePermissionRequiredMixin, View): for r in JobResult.objects.filter( obj_type=report_content_type, status__in=JobResultStatusChoices.TERMINAL_STATE_CHOICES - ).defer('data') + ).order_by('name', '-created').distinct('name').defer('data') } ret = [] @@ -656,7 +656,7 @@ class ScriptListView(ContentTypePermissionRequiredMixin, View): for r in JobResult.objects.filter( obj_type=script_content_type, status__in=JobResultStatusChoices.TERMINAL_STATE_CHOICES - ).defer('data') + ).order_by('name', '-created').distinct('name').defer('data') } for _scripts in scripts.values(): diff --git a/netbox/netbox/views/__init__.py b/netbox/netbox/views/__init__.py index 5d388be35..fad347c36 100644 --- a/netbox/netbox/views/__init__.py +++ b/netbox/netbox/views/__init__.py @@ -19,8 +19,7 @@ from circuits.models import Circuit, Provider from dcim.models import ( Cable, ConsolePort, Device, DeviceType, Interface, PowerPanel, PowerFeed, PowerPort, Rack, Site, ) -from extras.choices import JobResultStatusChoices -from extras.models import ObjectChange, JobResult +from extras.models import ObjectChange from extras.tables import ObjectChangeTable from ipam.models import Aggregate, IPAddress, IPRange, Prefix, VLAN, VRF from netbox.constants import SEARCH_MAX_RESULTS, SEARCH_TYPES @@ -48,13 +47,6 @@ class HomeView(View): pk__lt=F('_path__destination_id') ) - # Report Results - report_content_type = ContentType.objects.get(app_label='extras', model='report') - report_results = JobResult.objects.filter( - obj_type=report_content_type, - status__in=JobResultStatusChoices.TERMINAL_STATE_CHOICES - ).defer('data')[:10] - def build_stats(): org = ( ("dcim.view_site", "Sites", Site.objects.restrict(request.user, 'view').count), @@ -150,7 +142,6 @@ class HomeView(View): return render(request, self.template_name, { 'search_form': SearchForm(), 'stats': build_stats(), - 'report_results': report_results, 'changelog_table': changelog_table, 'new_release': new_release, }) From 56a8a860432e3cb8d8549761025a47387dd8c036 Mon Sep 17 00:00:00 2001 From: kkthxbye <> Date: Fri, 25 Mar 2022 09:00:02 +0100 Subject: [PATCH 13/28] Add dynamic config JOBRESULT_RETENTION and cleanup functionality to the housekeeping script --- docs/administration/housekeeping.md | 1 + docs/configuration/dynamic-settings.md | 12 ++++++++ netbox/extras/admin.py | 2 +- .../management/commands/housekeeping.py | 28 +++++++++++++++++++ netbox/netbox/config/parameters.py | 7 +++++ 5 files changed, 49 insertions(+), 1 deletion(-) diff --git a/docs/administration/housekeeping.md b/docs/administration/housekeeping.md index bbb03dc27..1989e41c0 100644 --- a/docs/administration/housekeeping.md +++ b/docs/administration/housekeeping.md @@ -4,6 +4,7 @@ NetBox includes a `housekeeping` management command that should be run nightly. * Clearing expired authentication sessions from the database * Deleting changelog records older than the configured [retention time](../configuration/dynamic-settings.md#changelog_retention) +* Deleting job result records older than the configured [retention time](../configuration/dynamic-settings.md#jobresult_retention) This command can be invoked directly, or by using the shell script provided at `/opt/netbox/contrib/netbox-housekeeping.sh`. This script can be linked from your cron scheduler's daily jobs directory (e.g. `/etc/cron.daily`) or referenced directly within the cron configuration file. diff --git a/docs/configuration/dynamic-settings.md b/docs/configuration/dynamic-settings.md index 5649eb9be..4a12726ba 100644 --- a/docs/configuration/dynamic-settings.md +++ b/docs/configuration/dynamic-settings.md @@ -43,6 +43,18 @@ changes in the database indefinitely. --- +## JOBRESULT_RETENTION + +Default: 0 + +The number of days to retain job results (scripts and reports). Set this to `0` to retain +job results in the database indefinitely. + +!!! warning + If enabling indefinite job results retention, it is recommended to periodically delete old entries. Otherwise, the database may eventually exceed capacity. + +--- + ## CUSTOM_VALIDATORS This is a mapping of models to [custom validators](../customization/custom-validation.md) that have been defined locally to enforce custom validation logic. An example is provided below: diff --git a/netbox/extras/admin.py b/netbox/extras/admin.py index 64c224cb1..28902c323 100644 --- a/netbox/extras/admin.py +++ b/netbox/extras/admin.py @@ -40,7 +40,7 @@ class ConfigRevisionAdmin(admin.ModelAdmin): 'fields': ('DEFAULT_USER_PREFERENCES',), }), ('Miscellaneous', { - 'fields': ('MAINTENANCE_MODE', 'GRAPHQL_ENABLED', 'CHANGELOG_RETENTION', 'MAPS_URL'), + 'fields': ('MAINTENANCE_MODE', 'GRAPHQL_ENABLED', 'CHANGELOG_RETENTION', 'JOBRESULT_RETENTION', 'MAPS_URL'), }), ('Config Revision', { 'fields': ('comment',), diff --git a/netbox/extras/management/commands/housekeeping.py b/netbox/extras/management/commands/housekeeping.py index 0607a16c2..51d50d7e1 100644 --- a/netbox/extras/management/commands/housekeeping.py +++ b/netbox/extras/management/commands/housekeeping.py @@ -9,6 +9,7 @@ from django.db import DEFAULT_DB_ALIAS from django.utils import timezone from packaging import version +from extras.models import JobResult from extras.models import ObjectChange from netbox.config import Config @@ -63,6 +64,33 @@ class Command(BaseCommand): f"\tSkipping: No retention period specified (CHANGELOG_RETENTION = {config.CHANGELOG_RETENTION})" ) + # Delete expired JobResults + if options['verbosity']: + self.stdout.write("[*] Checking for expired jobresult records") + if config.JOBRESULT_RETENTION: + cutoff = timezone.now() - timedelta(days=config.JOBRESULT_RETENTION) + if options['verbosity'] >= 2: + self.stdout.write(f"\tRetention period: {config.JOBRESULT_RETENTION} days") + self.stdout.write(f"\tCut-off time: {cutoff}") + expired_records = JobResult.objects.filter(created__lt=cutoff).count() + if expired_records: + if options['verbosity']: + self.stdout.write( + f"\tDeleting {expired_records} expired records... ", + self.style.WARNING, + ending="" + ) + self.stdout.flush() + JobResult.objects.filter(created__lt=cutoff)._raw_delete(using=DEFAULT_DB_ALIAS) + if options['verbosity']: + self.stdout.write("Done.", self.style.SUCCESS) + elif options['verbosity']: + self.stdout.write("\tNo expired records found.", self.style.SUCCESS) + elif options['verbosity']: + self.stdout.write( + f"\tSkipping: No retention period specified (JOBRESULT_RETENTION = {config.JOBRESULT_RETENTION})" + ) + # Check for new releases (if enabled) if options['verbosity']: self.stdout.write("[*] Checking for latest release") diff --git a/netbox/netbox/config/parameters.py b/netbox/netbox/config/parameters.py index 89de94674..9bbf45ceb 100644 --- a/netbox/netbox/config/parameters.py +++ b/netbox/netbox/config/parameters.py @@ -187,6 +187,13 @@ PARAMS = ( description="Days to retain changelog history (set to zero for unlimited)", field=forms.IntegerField ), + ConfigParam( + name='JOBRESULT_RETENTION', + label='Job result retention', + default=0, + description="Days to retain job result history (set to zero for unlimited)", + field=forms.IntegerField + ), ConfigParam( name='MAPS_URL', label='Maps URL', From 9515cf1efd3d34f9cb05f570512916aa44b95d1a Mon Sep 17 00:00:00 2001 From: kkthxbye-code Date: Fri, 8 Apr 2022 22:10:17 +0200 Subject: [PATCH 14/28] Change default JOBRESULT_RETENTION from 0 to 90 --- docs/configuration/dynamic-settings.md | 2 +- netbox/netbox/config/parameters.py | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/configuration/dynamic-settings.md b/docs/configuration/dynamic-settings.md index 4a12726ba..2fa046fcf 100644 --- a/docs/configuration/dynamic-settings.md +++ b/docs/configuration/dynamic-settings.md @@ -45,7 +45,7 @@ changes in the database indefinitely. ## JOBRESULT_RETENTION -Default: 0 +Default: 90 The number of days to retain job results (scripts and reports). Set this to `0` to retain job results in the database indefinitely. diff --git a/netbox/netbox/config/parameters.py b/netbox/netbox/config/parameters.py index 9bbf45ceb..68c96b38a 100644 --- a/netbox/netbox/config/parameters.py +++ b/netbox/netbox/config/parameters.py @@ -190,7 +190,7 @@ PARAMS = ( ConfigParam( name='JOBRESULT_RETENTION', label='Job result retention', - default=0, + default=90, description="Days to retain job result history (set to zero for unlimited)", field=forms.IntegerField ), From 72a46183eb3f2e5cda998b1d5c1ba5b1e6fbffa6 Mon Sep 17 00:00:00 2001 From: jeremystretch Date: Tue, 12 Apr 2022 12:05:09 -0400 Subject: [PATCH 15/28] Changelog for #8920, #8956 --- docs/release-notes/version-3.2.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/release-notes/version-3.2.md b/docs/release-notes/version-3.2.md index a7cccf946..d3af481d7 100644 --- a/docs/release-notes/version-3.2.md +++ b/docs/release-notes/version-3.2.md @@ -5,6 +5,8 @@ ### Enhancements * [#5479](https://github.com/netbox-community/netbox/issues/5479) - Allow custom job timeouts for scripts & reports +* [#8920](https://github.com/netbox-community/netbox/issues/8920) - Limit number of non-racked devices displayed +* [#8956](https://github.com/netbox-community/netbox/issues/8956) - Retain old script/report results for configured lifetime * [#8973](https://github.com/netbox-community/netbox/issues/8973) - Display VLAN group count under site view * [#9081](https://github.com/netbox-community/netbox/issues/9081) - Add `fhrpgroup_id` filter for IP addresses * [#9099](https://github.com/netbox-community/netbox/issues/9099) - Enable display of installed module serial & asset tag in module bays list From 99e7e241ce05722922147a0565a6d29a2337c7c1 Mon Sep 17 00:00:00 2001 From: Joe Izzard Date: Tue, 12 Apr 2022 17:06:33 +0100 Subject: [PATCH 16/28] fix: standardisation --- netbox/dcim/choices.py | 30 +++++++++++++++--------------- 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/netbox/dcim/choices.py b/netbox/dcim/choices.py index 1bfbcbc94..b0aa1c60c 100644 --- a/netbox/dcim/choices.py +++ b/netbox/dcim/choices.py @@ -345,10 +345,10 @@ class PowerPortTypeChoices(ChoiceSet): TYPE_DC = 'dc-terminal' # Proprietary TYPE_SAF_D_GRID = 'saf-d-grid' - TYPE_NEUTRIK_POWERCON = 'neutrik-powercon' + TYPE_NEUTRIK_POWERCON_20A = 'neutrik-powercon-20' TYPE_NEUTRIK_POWERCON_32A = 'neutrik-powercon-32' - TYPE_NEUTRIK_TRUE1 = 'neutrik-true1' - TYPE_NEUTRIK_TRUE1_TOP = 'neutrik-true1-top' + TYPE_NEUTRIK_POWERCON_TRUE1 = 'neutrik-powercon-true1' + TYPE_NEUTRIK_POWERCON_TRUE1_TOP = 'neutrik-powercon-true1-top' # Other TYPE_HARDWIRED = 'hardwired' @@ -460,10 +460,10 @@ class PowerPortTypeChoices(ChoiceSet): )), ('Proprietary', ( (TYPE_SAF_D_GRID, 'Saf-D-Grid'), - (TYPE_NEUTRIK_POWERCON, 'Neutrik powerCon'), - (TYPE_NEUTRIK_POWERCON_32A, 'Neutrik powerCon (32A)'), - (TYPE_NEUTRIK_TRUE1, 'Neutrik powerCon TRUE1'), - (TYPE_NEUTRIK_TRUE1_TOP, 'Neutrik powerCon TRUE1 TOP'), + (TYPE_NEUTRIK_POWERCON_20A, 'Neutrik powerCON (20A)'), + (TYPE_NEUTRIK_POWERCON_32A, 'Neutrik powerCON (32A)'), + (TYPE_NEUTRIK_POWERCON_TRUE1, 'Neutrik powerCON TRUE1'), + (TYPE_NEUTRIK_POWERCON_TRUE1_TOP, 'Neutrik powerCON TRUE1 TOP'), )), ('Other', ( (TYPE_HARDWIRED, 'Hardwired'), @@ -569,10 +569,10 @@ class PowerOutletTypeChoices(ChoiceSet): # Proprietary TYPE_HDOT_CX = 'hdot-cx' TYPE_SAF_D_GRID = 'saf-d-grid' - TYPE_NEUTRIK_POWERCON = 'neutrik-powercon' - TYPE_NEUTRIK_POWERCON_32A = 'neutrik-powercon-32' - TYPE_NEUTRIK_TRUE1 = 'neutrik-true1' - TYPE_NEUTRIK_TRUE1_TOP = 'neutrik-true1-top' + TYPE_NEUTRIK_POWERCON_20A = 'neutrik-powercon-20a' + TYPE_NEUTRIK_POWERCON_32A = 'neutrik-powercon-32a' + TYPE_NEUTRIK_POWERCON_TRUE1 = 'neutrik-powercon-true1' + TYPE_NEUTRIK_POWERCON_TRUE1_TOP = 'neutrik-powercon-true1-top' # Other TYPE_HARDWIRED = 'hardwired' @@ -677,10 +677,10 @@ class PowerOutletTypeChoices(ChoiceSet): ('Proprietary', ( (TYPE_HDOT_CX, 'HDOT Cx'), (TYPE_SAF_D_GRID, 'Saf-D-Grid'), - (TYPE_NEUTRIK_POWERCON, 'Neutrik powerCon'), - (TYPE_NEUTRIK_POWERCON_32A, 'Neutrik powerCon (32A)'), - (TYPE_NEUTRIK_TRUE1, 'Neutrik powerCon TRUE1'), - (TYPE_NEUTRIK_TRUE1_TOP, 'Neutrik powerCon TRUE1 TOP'), + (TYPE_NEUTRIK_POWERCON_20A, 'Neutrik powerCON (20A)'), + (TYPE_NEUTRIK_POWERCON_32A, 'Neutrik powerCON (32A)'), + (TYPE_NEUTRIK_POWERCON_TRUE1, 'Neutrik powerCON TRUE1'), + (TYPE_NEUTRIK_POWERCON_TRUE1_TOP, 'Neutrik powerCON TRUE1 TOP'), )), ('Other', ( (TYPE_HARDWIRED, 'Hardwired'), From 3c5c9a8ea0067f9a61be8c885e0df8bd0e011001 Mon Sep 17 00:00:00 2001 From: jeremystretch Date: Tue, 12 Apr 2022 14:14:51 -0400 Subject: [PATCH 17/28] Changelog for #9110 --- docs/release-notes/version-3.2.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/release-notes/version-3.2.md b/docs/release-notes/version-3.2.md index d3af481d7..d4efe536f 100644 --- a/docs/release-notes/version-3.2.md +++ b/docs/release-notes/version-3.2.md @@ -10,6 +10,7 @@ * [#8973](https://github.com/netbox-community/netbox/issues/8973) - Display VLAN group count under site view * [#9081](https://github.com/netbox-community/netbox/issues/9081) - Add `fhrpgroup_id` filter for IP addresses * [#9099](https://github.com/netbox-community/netbox/issues/9099) - Enable display of installed module serial & asset tag in module bays list +* [#9110](https://github.com/netbox-community/netbox/issues/9110) - Add Neutrik proprietary power connectors ### Bug Fixes From 0f6c72d52f416ec9c2ab7eb14e4debf3c9c4e2bf Mon Sep 17 00:00:00 2001 From: jeremystretch Date: Wed, 13 Apr 2022 13:43:18 -0400 Subject: [PATCH 18/28] Fixes #9118: Fix validation error when importing VM child interfaces --- docs/release-notes/version-3.2.md | 1 + netbox/dcim/forms/bulk_import.py | 10 +++++----- netbox/virtualization/forms/bulk_import.py | 12 ++++++++++++ 3 files changed, 18 insertions(+), 5 deletions(-) diff --git a/docs/release-notes/version-3.2.md b/docs/release-notes/version-3.2.md index d4efe536f..c5c20379a 100644 --- a/docs/release-notes/version-3.2.md +++ b/docs/release-notes/version-3.2.md @@ -23,6 +23,7 @@ * [#9096](https://github.com/netbox-community/netbox/issues/9096) - Remove duplicate filter tag when filtering by "none" * [#9100](https://github.com/netbox-community/netbox/issues/9100) - Include position field in module type YAML export * [#9116](https://github.com/netbox-community/netbox/issues/9116) - `assigned_to_interface` filter for IP addresses should not match FHRP group assignments +* [#9118](https://github.com/netbox-community/netbox/issues/9118) - Fix validation error when importing VM child interfaces --- diff --git a/netbox/dcim/forms/bulk_import.py b/netbox/dcim/forms/bulk_import.py index d9c738cc2..b28c16fad 100644 --- a/netbox/dcim/forms/bulk_import.py +++ b/netbox/dcim/forms/bulk_import.py @@ -651,11 +651,11 @@ class InterfaceCSVForm(NetBoxModelCSVForm): super().__init__(data, *args, **kwargs) if data: - # Limit interface choices for parent, bridge and lag to device only - params = {} - if data.get('device'): - params[f"device__{self.fields['device'].to_field_name}"] = data.get('device') - if params: + # Limit choices for parent, bridge, and LAG interfaces to the assigned device + if device := data.get('device'): + params = { + f"device__{self.fields['device'].to_field_name}": device + } self.fields['parent'].queryset = self.fields['parent'].queryset.filter(**params) self.fields['bridge'].queryset = self.fields['bridge'].queryset.filter(**params) self.fields['lag'].queryset = self.fields['lag'].queryset.filter(**params) diff --git a/netbox/virtualization/forms/bulk_import.py b/netbox/virtualization/forms/bulk_import.py index b0315dd95..eab6fc9e7 100644 --- a/netbox/virtualization/forms/bulk_import.py +++ b/netbox/virtualization/forms/bulk_import.py @@ -136,6 +136,18 @@ class VMInterfaceCSVForm(NetBoxModelCSVForm): 'vrf', ) + def __init__(self, data=None, *args, **kwargs): + super().__init__(data, *args, **kwargs) + + if data: + # Limit interface choices for parent & bridge interfaces to the assigned VM + if virtual_machine := data.get('virtual_machine'): + params = { + f"virtual_machine__{self.fields['virtual_machine'].to_field_name}": virtual_machine + } + self.fields['parent'].queryset = self.fields['parent'].queryset.filter(**params) + self.fields['bridge'].queryset = self.fields['bridge'].queryset.filter(**params) + def clean_enabled(self): # Make sure enabled is True when it's not included in the uploaded data if 'enabled' not in self.data: From 8ded5ecf65109e39f96c4d6db2292ba925ff4259 Mon Sep 17 00:00:00 2001 From: Tyler Bigler Date: Thu, 14 Apr 2022 00:58:17 -0400 Subject: [PATCH 19/28] Add filters to VLAN selection group --- netbox/wireless/forms/models.py | 61 ++++++++++++++++++++++++++++++--- 1 file changed, 56 insertions(+), 5 deletions(-) diff --git a/netbox/wireless/forms/models.py b/netbox/wireless/forms/models.py index 64c9e96ef..7c5c048d6 100644 --- a/netbox/wireless/forms/models.py +++ b/netbox/wireless/forms/models.py @@ -1,6 +1,6 @@ -from dcim.models import Device, Interface, Location, Site +from dcim.models import Device, Interface, Location, Region, Site, SiteGroup from extras.models import Tag -from ipam.models import VLAN +from ipam.models import VLAN, VLANGroup from netbox.forms import NetBoxModelForm from utilities.forms import DynamicModelChoiceField, DynamicModelMultipleChoiceField, SlugField, StaticSelect from wireless.models import * @@ -31,22 +31,73 @@ class WirelessLANForm(NetBoxModelForm): queryset=WirelessLANGroup.objects.all(), required=False ) + + region = DynamicModelChoiceField( + queryset=Region.objects.all(), + required=False, + initial_params={ + 'sites': '$site' + } + ) + site_group = DynamicModelChoiceField( + queryset=SiteGroup.objects.all(), + required=False, + initial_params={ + 'sites': '$site' + } + ) + site = DynamicModelChoiceField( + queryset=Site.objects.all(), + required=False, + null_option='None', + query_params={ + 'region_id': '$region', + 'group_id': '$site_group', + } + ) + vlan_group = DynamicModelChoiceField( + queryset=VLANGroup.objects.all(), + required=False, + label='VLAN group', + null_option='None', + query_params={ + 'site': '$site' + }, + initial_params={ + 'vlans': '$vlan' + } + ) vlan = DynamicModelChoiceField( queryset=VLAN.objects.all(), required=False, - label='VLAN' + label='VLAN', + query_params={ + 'site_id': '$site', + 'group_id': '$vlan_group', + } ) fieldsets = ( ('Wireless LAN', ('ssid', 'group', 'description', 'tags')), - ('VLAN', ('vlan',)), + ('VLAN', ('region', 'site_group', 'site', 'vlan_group', 'vlan',)), ('Authentication', ('auth_type', 'auth_cipher', 'auth_psk')), ) class Meta: model = WirelessLAN fields = [ - 'ssid', 'group', 'description', 'vlan', 'auth_type', 'auth_cipher', 'auth_psk', 'tags', + 'ssid', + 'group', + 'description', + 'region', + 'site_group', + 'site', + 'vlan_group', + 'vlan', + 'auth_type', + 'auth_cipher', + 'auth_psk', + 'tags', ] widgets = { 'auth_type': StaticSelect, From a9f8b6fe8b2ee8d068a83e72aeb5b427e63fb6f7 Mon Sep 17 00:00:00 2001 From: jeremystretch Date: Thu, 14 Apr 2022 08:37:58 -0400 Subject: [PATCH 20/28] Changelog for #8543 & cleanup --- docs/release-notes/version-3.2.md | 1 + netbox/wireless/forms/models.py | 17 +++-------------- 2 files changed, 4 insertions(+), 14 deletions(-) diff --git a/docs/release-notes/version-3.2.md b/docs/release-notes/version-3.2.md index c5c20379a..43c6469ba 100644 --- a/docs/release-notes/version-3.2.md +++ b/docs/release-notes/version-3.2.md @@ -5,6 +5,7 @@ ### Enhancements * [#5479](https://github.com/netbox-community/netbox/issues/5479) - Allow custom job timeouts for scripts & reports +* [#8543](https://github.com/netbox-community/netbox/issues/8543) - Improve filtering for wireless LAN VLAN selection * [#8920](https://github.com/netbox-community/netbox/issues/8920) - Limit number of non-racked devices displayed * [#8956](https://github.com/netbox-community/netbox/issues/8956) - Retain old script/report results for configured lifetime * [#8973](https://github.com/netbox-community/netbox/issues/8973) - Display VLAN group count under site view diff --git a/netbox/wireless/forms/models.py b/netbox/wireless/forms/models.py index 7c5c048d6..6d7dc84a9 100644 --- a/netbox/wireless/forms/models.py +++ b/netbox/wireless/forms/models.py @@ -1,8 +1,7 @@ from dcim.models import Device, Interface, Location, Region, Site, SiteGroup -from extras.models import Tag from ipam.models import VLAN, VLANGroup from netbox.forms import NetBoxModelForm -from utilities.forms import DynamicModelChoiceField, DynamicModelMultipleChoiceField, SlugField, StaticSelect +from utilities.forms import DynamicModelChoiceField, SlugField, StaticSelect from wireless.models import * __all__ = ( @@ -86,18 +85,8 @@ class WirelessLANForm(NetBoxModelForm): class Meta: model = WirelessLAN fields = [ - 'ssid', - 'group', - 'description', - 'region', - 'site_group', - 'site', - 'vlan_group', - 'vlan', - 'auth_type', - 'auth_cipher', - 'auth_psk', - 'tags', + 'ssid', 'group', 'description', 'region', 'site_group', 'site', 'vlan_group', 'vlan', 'auth_type', + 'auth_cipher', 'auth_psk', 'tags', ] widgets = { 'auth_type': StaticSelect, From 7c9197066845f1ab55d6b1d933d6b60ae1f38aed Mon Sep 17 00:00:00 2001 From: jeremystretch Date: Thu, 14 Apr 2022 10:54:07 -0400 Subject: [PATCH 21/28] Closes #9123: Improve appearance of SSO login providers --- docs/release-notes/version-3.2.md | 1 + netbox/netbox/authentication.py | 39 ++++++++++++++++++++++++++++++- netbox/templates/login.html | 10 ++++---- netbox/users/views.py | 7 +++++- 4 files changed, 51 insertions(+), 6 deletions(-) diff --git a/docs/release-notes/version-3.2.md b/docs/release-notes/version-3.2.md index 43c6469ba..33cfd140d 100644 --- a/docs/release-notes/version-3.2.md +++ b/docs/release-notes/version-3.2.md @@ -12,6 +12,7 @@ * [#9081](https://github.com/netbox-community/netbox/issues/9081) - Add `fhrpgroup_id` filter for IP addresses * [#9099](https://github.com/netbox-community/netbox/issues/9099) - Enable display of installed module serial & asset tag in module bays list * [#9110](https://github.com/netbox-community/netbox/issues/9110) - Add Neutrik proprietary power connectors +* [#9123](https://github.com/netbox-community/netbox/issues/9123) - Improve appearance of SSO login providers ### Bug Fixes diff --git a/netbox/netbox/authentication.py b/netbox/netbox/authentication.py index acb04ce34..6367d6d70 100644 --- a/netbox/netbox/authentication.py +++ b/netbox/netbox/authentication.py @@ -13,8 +13,45 @@ from utilities.permissions import permission_is_exempt, resolve_permission, reso UserModel = get_user_model() +AUTH_BACKEND_ATTRS = { + # backend name: title, MDI icon name + 'amazon': ('Amazon AWS', 'aws'), + 'apple': ('Apple', 'apple'), + 'auth0': ('Auth0', None), + 'azuread-oauth2': ('Microsoft Azure AD', 'microsoft'), + 'azuread-b2c-oauth2': ('Microsoft Azure AD', 'microsoft'), + 'azuread-tenant-oauth2': ('Microsoft Azure AD', 'microsoft'), + 'bitbucket': ('BitBucket', 'bitbucket'), + 'bitbucket-oauth2': ('BitBucket', 'bitbucket'), + 'digitalocean': ('DigitalOcean', 'digital-ocean'), + 'docker': ('Docker', 'docker'), + 'github': ('GitHub', 'docker'), + 'github-app': ('GitHub', 'github'), + 'github-org': ('GitHub', 'github'), + 'github-team': ('GitHub', 'github'), + 'github-enterprise': ('GitHub Enterprise', 'github'), + 'github-enterprise-org': ('GitHub Enterprise', 'github'), + 'github-enterprise-team': ('GitHub Enterprise', 'github'), + 'gitlab': ('GitLab', 'gitlab'), + 'google-oauth2': ('Google', 'google'), + 'google-openidconnect': ('Google', 'google'), + 'hubspot': ('HubSpot', 'hubspot'), + 'keycloak': ('Keycloak', None), + 'microsoft-graph': ('Microsoft Graph', 'microsoft'), + 'okta': ('Okta', None), + 'salesforce-oauth2': ('Salesforce', 'salesforce'), +} -class ObjectPermissionMixin(): + +def get_auth_backend_display(name): + """ + Return the user-friendly name and icon name for a remote authentication backend, if known. Defaults to the + raw backend name and no icon. + """ + return AUTH_BACKEND_ATTRS.get(name, (name, None)) + + +class ObjectPermissionMixin: def get_all_permissions(self, user_obj, obj=None): if not user_obj.is_active or user_obj.is_anonymous: diff --git a/netbox/templates/login.html b/netbox/templates/login.html index 9cf882e9c..f4dd9c696 100644 --- a/netbox/templates/login.html +++ b/netbox/templates/login.html @@ -39,11 +39,13 @@
- {# TODO: Improve the design & layout #} {% if auth_backends %} -
Or use an SSO provider:
- {% for name, backend in auth_backends.items %} -

{{ name }}

+
Or use a single sign-on (SSO) provider:
+ {% for name, display in auth_backends.items %} +
+ {% if display.1 %}{% endif %} + {{ display.0 }} +
{% endfor %} {% endif %} diff --git a/netbox/users/views.py b/netbox/users/views.py index 04c0c5155..6a923e77e 100644 --- a/netbox/users/views.py +++ b/netbox/users/views.py @@ -16,6 +16,7 @@ from social_core.backends.utils import load_backends from extras.models import ObjectChange from extras.tables import ObjectChangeTable +from netbox.authentication import get_auth_backend_display from netbox.config import get_config from utilities.forms import ConfirmationForm from .forms import LoginForm, PasswordChangeForm, TokenForm, UserConfigForm @@ -43,9 +44,13 @@ class LoginView(View): logger = logging.getLogger('netbox.auth.login') return self.redirect_to_next(request, logger) + auth_backends = { + name: get_auth_backend_display(name) for name in load_backends(settings.AUTHENTICATION_BACKENDS).keys() + } + return render(request, self.template_name, { 'form': form, - 'auth_backends': load_backends(settings.AUTHENTICATION_BACKENDS), + 'auth_backends': auth_backends, }) def post(self, request): From d58529eb479d9d87c222bafe2a1654ee4dea47ef Mon Sep 17 00:00:00 2001 From: jeremystretch Date: Thu, 14 Apr 2022 11:13:04 -0400 Subject: [PATCH 22/28] Fixes #9128: Resolve component labels per module bay position when installing modules --- docs/release-notes/version-3.2.md | 1 + .../dcim/models/device_component_templates.py | 19 ++++++++++++------- 2 files changed, 13 insertions(+), 7 deletions(-) diff --git a/docs/release-notes/version-3.2.md b/docs/release-notes/version-3.2.md index 33cfd140d..e73c3048e 100644 --- a/docs/release-notes/version-3.2.md +++ b/docs/release-notes/version-3.2.md @@ -26,6 +26,7 @@ * [#9100](https://github.com/netbox-community/netbox/issues/9100) - Include position field in module type YAML export * [#9116](https://github.com/netbox-community/netbox/issues/9116) - `assigned_to_interface` filter for IP addresses should not match FHRP group assignments * [#9118](https://github.com/netbox-community/netbox/issues/9118) - Fix validation error when importing VM child interfaces +* [#9128](https://github.com/netbox-community/netbox/issues/9128) - Resolve component labels per module bay position when installing modules --- diff --git a/netbox/dcim/models/device_component_templates.py b/netbox/dcim/models/device_component_templates.py index b363d6ea4..647abe148 100644 --- a/netbox/dcim/models/device_component_templates.py +++ b/netbox/dcim/models/device_component_templates.py @@ -124,6 +124,11 @@ class ModularComponentTemplateModel(ComponentTemplateModel): return self.name.replace('{module}', module.module_bay.position) return self.name + def resolve_label(self, module): + if module: + return self.label.replace('{module}', module.module_bay.position) + return self.label + class ConsolePortTemplate(ModularComponentTemplateModel): """ @@ -147,7 +152,7 @@ class ConsolePortTemplate(ModularComponentTemplateModel): def instantiate(self, **kwargs): return self.component_model( name=self.resolve_name(kwargs.get('module')), - label=self.label, + label=self.resolve_label(kwargs.get('module')), type=self.type, **kwargs ) @@ -175,7 +180,7 @@ class ConsoleServerPortTemplate(ModularComponentTemplateModel): def instantiate(self, **kwargs): return self.component_model( name=self.resolve_name(kwargs.get('module')), - label=self.label, + label=self.resolve_label(kwargs.get('module')), type=self.type, **kwargs ) @@ -215,7 +220,7 @@ class PowerPortTemplate(ModularComponentTemplateModel): def instantiate(self, **kwargs): return self.component_model( name=self.resolve_name(kwargs.get('module')), - label=self.label, + label=self.resolve_label(kwargs.get('module')), type=self.type, maximum_draw=self.maximum_draw, allocated_draw=self.allocated_draw, @@ -286,7 +291,7 @@ class PowerOutletTemplate(ModularComponentTemplateModel): power_port = None return self.component_model( name=self.resolve_name(kwargs.get('module')), - label=self.label, + label=self.resolve_label(kwargs.get('module')), type=self.type, power_port=power_port, feed_leg=self.feed_leg, @@ -326,7 +331,7 @@ class InterfaceTemplate(ModularComponentTemplateModel): def instantiate(self, **kwargs): return self.component_model( name=self.resolve_name(kwargs.get('module')), - label=self.label, + label=self.resolve_label(kwargs.get('module')), type=self.type, mgmt_only=self.mgmt_only, **kwargs @@ -397,7 +402,7 @@ class FrontPortTemplate(ModularComponentTemplateModel): rear_port = None return self.component_model( name=self.resolve_name(kwargs.get('module')), - label=self.label, + label=self.resolve_label(kwargs.get('module')), type=self.type, color=self.color, rear_port=rear_port, @@ -437,7 +442,7 @@ class RearPortTemplate(ModularComponentTemplateModel): def instantiate(self, **kwargs): return self.component_model( name=self.resolve_name(kwargs.get('module')), - label=self.label, + label=self.resolve_label(kwargs.get('module')), type=self.type, color=self.color, positions=self.positions, From 2d5e9e40740ef7813e7c7c2d9d9a2497cb80c08c Mon Sep 17 00:00:00 2001 From: jeremystretch Date: Thu, 14 Apr 2022 13:58:18 -0400 Subject: [PATCH 23/28] Release v3.2.1 --- .github/ISSUE_TEMPLATE/bug_report.yaml | 2 +- .github/ISSUE_TEMPLATE/feature_request.yaml | 2 +- docs/release-notes/version-3.2.md | 2 +- netbox/netbox/settings.py | 2 +- requirements.txt | 6 +++--- 5 files changed, 7 insertions(+), 7 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/bug_report.yaml b/.github/ISSUE_TEMPLATE/bug_report.yaml index 65097e9be..b5de9bfee 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.yaml +++ b/.github/ISSUE_TEMPLATE/bug_report.yaml @@ -14,7 +14,7 @@ body: attributes: label: NetBox version description: What version of NetBox are you currently running? - placeholder: v3.2.0 + placeholder: v3.2.1 validations: required: true - type: dropdown diff --git a/.github/ISSUE_TEMPLATE/feature_request.yaml b/.github/ISSUE_TEMPLATE/feature_request.yaml index 1ce4c0a11..138e0f9b4 100644 --- a/.github/ISSUE_TEMPLATE/feature_request.yaml +++ b/.github/ISSUE_TEMPLATE/feature_request.yaml @@ -14,7 +14,7 @@ body: attributes: label: NetBox version description: What version of NetBox are you currently running? - placeholder: v3.2.0 + placeholder: v3.2.1 validations: required: true - type: dropdown diff --git a/docs/release-notes/version-3.2.md b/docs/release-notes/version-3.2.md index e73c3048e..cd19a6d65 100644 --- a/docs/release-notes/version-3.2.md +++ b/docs/release-notes/version-3.2.md @@ -1,6 +1,6 @@ # NetBox v3.2 -## v3.2.1 (FUTURE) +## v3.2.1 (2022-04-14) ### Enhancements diff --git a/netbox/netbox/settings.py b/netbox/netbox/settings.py index 04c0e9c3d..4e3017d8d 100644 --- a/netbox/netbox/settings.py +++ b/netbox/netbox/settings.py @@ -26,7 +26,7 @@ django.utils.encoding.force_text = force_str # Environment setup # -VERSION = '3.2.1-dev' +VERSION = '3.2.1' # Hostname HOSTNAME = platform.node() diff --git a/requirements.txt b/requirements.txt index ce0e52087..35867410b 100644 --- a/requirements.txt +++ b/requirements.txt @@ -1,4 +1,4 @@ -Django==4.0.3 +Django==4.0.4 django-cors-headers==3.11.0 django-debug-toolbar==3.2.4 django-filter==21.1 @@ -18,7 +18,7 @@ gunicorn==20.1.0 Jinja2==3.0.3 Markdown==3.3.6 markdown-include==0.6.0 -mkdocs-material==8.2.8 +mkdocs-material==8.2.9 mkdocstrings==0.17.0 netaddr==0.8.0 Pillow==9.1.0 @@ -27,7 +27,7 @@ PyYAML==6.0 social-auth-app-django==5.0.0 social-auth-core==4.2.0 svgwrite==1.4.2 -tablib==3.2.0 +tablib==3.2.1 tzdata==2022.1 # Workaround for #7401 From 1a1fe1faaa75e5a3258fd32e21e6447235589cfe Mon Sep 17 00:00:00 2001 From: jeremystretch Date: Thu, 14 Apr 2022 14:15:48 -0400 Subject: [PATCH 24/28] PRVB --- docs/release-notes/version-3.2.md | 4 ++++ netbox/netbox/settings.py | 2 +- 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/release-notes/version-3.2.md b/docs/release-notes/version-3.2.md index cd19a6d65..e1d68a093 100644 --- a/docs/release-notes/version-3.2.md +++ b/docs/release-notes/version-3.2.md @@ -1,5 +1,9 @@ # NetBox v3.2 +## v3.2.2 (FUTURE) + +--- + ## v3.2.1 (2022-04-14) ### Enhancements diff --git a/netbox/netbox/settings.py b/netbox/netbox/settings.py index 4e3017d8d..e83ccdc73 100644 --- a/netbox/netbox/settings.py +++ b/netbox/netbox/settings.py @@ -26,7 +26,7 @@ django.utils.encoding.force_text = force_str # Environment setup # -VERSION = '3.2.1' +VERSION = '3.2.2-dev' # Hostname HOSTNAME = platform.node() From b4545838487e9cbd5c6e4fb1824950ebc605d857 Mon Sep 17 00:00:00 2001 From: jeremystretch Date: Thu, 14 Apr 2022 14:24:34 -0400 Subject: [PATCH 25/28] Restore documentation search function --- mkdocs.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/mkdocs.yml b/mkdocs.yml index 3af855d3b..88bd229f2 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -19,6 +19,7 @@ theme: icon: material/lightbulb name: Switch to Light Mode plugins: + - search - mkdocstrings: handlers: python: From 8cd1122f383972f8b276bd8da467601037da95f0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Markku=20Leini=C3=B6?= Date: Thu, 14 Apr 2022 22:01:21 +0300 Subject: [PATCH 26/28] Require Python 3.8+ to run upgrade.sh --- upgrade.sh | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/upgrade.sh b/upgrade.sh index 301225958..61e6106cd 100755 --- a/upgrade.sh +++ b/upgrade.sh @@ -3,23 +3,23 @@ # its most recent release. # This script will invoke Python with the value of the PYTHON environment -# variable (if set), or fall back to "python3". Note that NetBox v3.0+ requires -# Python 3.7 or later. +# variable (if set), or fall back to "python3". Note that NetBox v3.2+ requires +# Python 3.8 or later. cd "$(dirname "$0")" VIRTUALENV="$(pwd -P)/venv" PYTHON="${PYTHON:-python3}" # Validate the minimum required Python version -COMMAND="${PYTHON} -c 'import sys; exit(1 if sys.version_info < (3, 7) else 0)'" +COMMAND="${PYTHON} -c 'import sys; exit(1 if sys.version_info < (3, 8) else 0)'" PYTHON_VERSION=$(eval "${PYTHON} -V") eval $COMMAND || { echo "--------------------------------------------------------------------" echo "ERROR: Unsupported Python version: ${PYTHON_VERSION}. NetBox requires" - echo "Python 3.7 or later. To specify an alternate Python executable, set" + echo "Python 3.8 or later. To specify an alternate Python executable, set" echo "the PYTHON environment variable. For example:" echo "" - echo " sudo PYTHON=/usr/bin/python3.7 ./upgrade.sh" + echo " sudo PYTHON=/usr/bin/python3.8 ./upgrade.sh" echo "" echo "To show your current Python version: ${PYTHON} -V" echo "--------------------------------------------------------------------" From a24ef83b7b74b6316866341481bcd8d4af30a2ce Mon Sep 17 00:00:00 2001 From: jeremystretch Date: Thu, 14 Apr 2022 15:51:26 -0400 Subject: [PATCH 27/28] Changelog for #9133 --- docs/release-notes/version-3.2.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/release-notes/version-3.2.md b/docs/release-notes/version-3.2.md index e1d68a093..97cedf0f5 100644 --- a/docs/release-notes/version-3.2.md +++ b/docs/release-notes/version-3.2.md @@ -2,6 +2,10 @@ ## v3.2.2 (FUTURE) +### Bug Fixes + +* [#9133](https://github.com/netbox-community/netbox/issues/9133) - Upgrade script should require Python 3.8 or later + --- ## v3.2.1 (2022-04-14) From 4979d1c9b6a81b511c727f048793733f6be486a9 Mon Sep 17 00:00:00 2001 From: jeremystretch Date: Thu, 14 Apr 2022 21:41:43 -0400 Subject: [PATCH 28/28] Closes #9136: Add SSO configuration guide for Microsoft Azure AD --- .../authentication/microsoft-azure-ad.md | 79 ++++++++++++++++++ .../overview.md} | 4 +- .../azure_ad_add_app_registration.png | Bin 0 -> 11227 bytes .../azure_ad_add_client_secret.png | Bin 0 -> 17922 bytes .../azure_ad_app_registration.png | Bin 0 -> 55210 bytes .../azure_ad_app_registration_created.png | Bin 0 -> 21150 bytes .../authentication/azure_ad_client_secret.png | Bin 0 -> 8697 bytes .../azure_ad_client_secret_created.png | Bin 0 -> 21621 bytes .../authentication/azure_ad_login_portal.png | Bin 0 -> 25261 bytes .../authentication/netbox_azure_ad_login.png | Bin 0 -> 17925 bytes mkdocs.yml | 4 +- 11 files changed, 84 insertions(+), 3 deletions(-) create mode 100644 docs/administration/authentication/microsoft-azure-ad.md rename docs/administration/{authentication.md => authentication/overview.md} (91%) create mode 100644 docs/media/authentication/azure_ad_add_app_registration.png create mode 100644 docs/media/authentication/azure_ad_add_client_secret.png create mode 100644 docs/media/authentication/azure_ad_app_registration.png create mode 100644 docs/media/authentication/azure_ad_app_registration_created.png create mode 100644 docs/media/authentication/azure_ad_client_secret.png create mode 100644 docs/media/authentication/azure_ad_client_secret_created.png create mode 100644 docs/media/authentication/azure_ad_login_portal.png create mode 100644 docs/media/authentication/netbox_azure_ad_login.png diff --git a/docs/administration/authentication/microsoft-azure-ad.md b/docs/administration/authentication/microsoft-azure-ad.md new file mode 100644 index 000000000..b2de148ac --- /dev/null +++ b/docs/administration/authentication/microsoft-azure-ad.md @@ -0,0 +1,79 @@ +# Microsoft Azure AD + +This guide explains how to configure single sign-on (SSO) support for NetBox using [Microsoft Azure Active Directory (AD)](https://azure.microsoft.com/en-us/services/active-directory/) as an authentication backend. + +## Azure AD Configuration + +### 1. Create a test user (optional) + +Create a new user in AD to be used for testing. You can skip this step if you already have a suitable account created. + +### 2. Create an app registration + +Under the Azure Active Directory dashboard, navigate to **Add > App registration**. + +![Add an app registration](../../media/authentication/azure_ad_add_app_registration.png) + +Enter a name for the registration (e.g. "NetBox") and ensure that the "single tenant" option is selected. + +Under "Redirect URI", select "Web" for the platform and enter the path to your NetBox installation, ending with `/oauth/complete/azuread-oauth2/`. Note that this URI **must** begin with `https://` unless you are referencing localhost (for development purposes). + +![App registration parameters](../../media/authentication/azure_ad_app_registration.png) + +Once finished, make note of the application (client) ID; this will be used when configuring NetBox. + +![Completed app registration](../../media/authentication/azure_ad_app_registration_created.png) + +!!! tip "Multitenant authentication" + NetBox also supports multitenant authentication via Azure AD, however it requires a different backend and an additional configuration parameter. Please see the [`python-social-auth` documentation](https://python-social-auth.readthedocs.io/en/latest/backends/azuread.html#tenant-support) for details concerning multitenant authentication. + +### 3. Create a secret + +When viewing the newly-created app registration, click the "Add a certificate or secret" link under "Client credentials". Under the "Client secrets" tab, click the "New client secret" button. + +![Add a client secret](../../media/authentication/azure_ad_add_client_secret.png) + +You can optionally specify a description and select a lifetime for the secret. + +![Client secret parameters](../../media/authentication/azure_ad_client_secret.png) + +Once finished, make note of the secret value (not the secret ID); this will be used when configuring NetBox. + +![Client secret parameters](../../media/authentication/azure_ad_client_secret_created.png) + +## NetBox Configuration + +### 1. Enter configuration parameters + +Enter the following configuration parameters in `configuration.py`, substituting your own values: + +```python +REMOTE_AUTH_BACKEND = 'social_core.backends.azuread.AzureADOAuth2' +SOCIAL_AUTH_AZUREAD_OAUTH2_KEY = '{APPLICATION_ID}' +SOCIAL_AUTH_AZUREAD_OAUTH2_SECRET = '{SECRET_VALUE}' +``` + +### 2. Restart NetBox + +Restart the NetBox services so that the new configuration takes effect. This is typically done with the command below: + +```no-highlight +sudo systemctl restart netbox +``` + +## Testing + +Log out of NetBox if already authenticated, and click the "Log In" button at top right. You should see the normal login form as well as an option to authenticate using Azure AD. Click that link. + +![NetBox Azure AD login form](../../media/authentication/netbox_azure_ad_login.png) + +You should be redirected to Microsoft's authentication portal. Enter the username/email and password of your test account to continue. You may also be prompted to grant this application access to your account. + +![NetBox Azure AD login form](../../media/authentication/azure_ad_login_portal.png) + +If successful, you will be redirected back to the NetBox UI, and will be logged in as the AD user. You can verify this by navigating to your profile (using the button at top right). + +This user account has been replicated locally to NetBox, and can now be assigned groups and permissions within the NetBox admin UI. + +!!! note "Troubleshooting" + If you are redirected to the NetBox UI after authenticating, but are _not_ logged in, double-check the configured backend and app registration. The instructions in this guide pertain only to the `azuread.AzureADOAuth2` backend using a single-tenant app registration. diff --git a/docs/administration/authentication.md b/docs/administration/authentication/overview.md similarity index 91% rename from docs/administration/authentication.md rename to docs/administration/authentication/overview.md index 31983be0b..b405ed09a 100644 --- a/docs/administration/authentication.md +++ b/docs/administration/authentication/overview.md @@ -4,7 +4,7 @@ Local user accounts and groups can be created in NetBox under the "Authentication and Authorization" section of the administrative user interface. This interface is available only to users with the "staff" permission enabled. -At a minimum, each user account must have a username and password set. User accounts may also denote a first name, last name, and email address. [Permissions](./permissions.md) may also be assigned to users and/or groups within the admin UI. +At a minimum, each user account must have a username and password set. User accounts may also denote a first name, last name, and email address. [Permissions](../permissions.md) may also be assigned to users and/or groups within the admin UI. ## Remote Authentication @@ -16,7 +16,7 @@ NetBox may be configured to provide user authenticate via a remote backend in ad REMOTE_AUTH_BACKEND = 'netbox.authentication.LDAPBackend' ``` -NetBox includes an authentication backend which supports LDAP. See the [LDAP installation docs](../installation/6-ldap.md) for more detail about this backend. +NetBox includes an authentication backend which supports LDAP. See the [LDAP installation docs](../../installation/6-ldap.md) for more detail about this backend. ### HTTP Header Authentication diff --git a/docs/media/authentication/azure_ad_add_app_registration.png b/docs/media/authentication/azure_ad_add_app_registration.png new file mode 100644 index 0000000000000000000000000000000000000000..4cc4fc81e49cfdf103d2cff21ad0a3469966620b GIT binary patch literal 11227 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 Y@@4R4UDUo44DFIA$t%m{${0WUFBY^(9{>OV literal 0 HcmV?d00001 diff --git a/docs/media/authentication/azure_ad_add_client_secret.png b/docs/media/authentication/azure_ad_add_client_secret.png new file mode 100644 index 0000000000000000000000000000000000000000..93f4eb776bcce074ed90df4c5c05fa6d21e032e4 GIT binary patch literal 17922 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 ap4YlwRf-aL5#Q~?apsh|Qp(9|_x}g`@0I%i literal 0 HcmV?d00001 diff --git a/docs/media/authentication/azure_ad_app_registration.png b/docs/media/authentication/azure_ad_app_registration.png new file mode 100644 index 0000000000000000000000000000000000000000..eb1634e96bce8c75fd932b421b01c486c0a17874 GIT binary patch literal 55210 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 literal 0 HcmV?d00001 diff --git a/docs/media/authentication/azure_ad_client_secret.png b/docs/media/authentication/azure_ad_client_secret.png new file mode 100644 index 0000000000000000000000000000000000000000..bebae388b4a99fd463a67c058785414a6603fd2e GIT binary patch literal 8697 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 EKrVXfKE(HLV%rIo*J+sj zUE{h*WiYW+L;XNT_qUfELbvrQ9_tMvTstoFe@s@*k2LXWkp_d%4u+zum5`tVdh}?Z zEvPj}A)694UR}#XS@sF4I;gEbU#R5h$Bpe?;?sja<#RoXg(sih0oYaodNnOwucK=o z0Z4ZC0QS#lHt?Uq8O!TL~V$qV?)LnG&8d$BG^$L)x|W z#ocuoK}@2-I2$MsKv2T~^gsfXyYiMnG5(kDP&Hc#z~;u^vTOe9U4YQj(XN&0NZk9? zRlKWy7q2SnSe=IxuI0QmQ=8NoL;zU=p;VgdenCm;HO^sU)w>e4Z8IV=hWGrX;FPk5 zqx5o_MLP&7&=oZYLm}U@Q`&vIAM_9n{z6Leu^|aQc2YrS=0{osp!IdbIc@|EurfIh zAnp+yz=?{U*gYKuGho4g+SdQO%T{35nOQ|OC%f^4iW5%Zm6=_{h|f9yVC8zM&_Y+@ zn|On9DZhJgio37E`CWjfj((f*tcT&$9hokSZG>x6DuyYINmSQ2PLR|-LcZh40&{iJ zB8E%$L_8FU+-}b``SX<4zJK>qBSK=f7B{J9QW@myx(0ttf>FPf$jy3H1^aJ(dZe6g z1;Ai<&wu_!hX0I){%d!AFQUAZgf-(wt7o&F)-Sp!HSzbNKw6n2iD%kG=Y$y;hgLJo zOEsUMc!yPxlSR{ee<%06Us``=N@?5Oz0;f2YBh@yX|U;$AUWb%^fhQ;+0a{b#{|&p z!of_-OWM!9;cYe|H-#d1*^l8bEWKlj4)a>Rq33or#aX6$OoW14hb36%X~4Q6&)dH^ zVfSNws|^y3c08RA_khTI5j|`1Qz9|{rhqRL19jKEx2liV*=Hp(%l(r3Jx9^cLrJTo z9Mbz$2IJBS{no#Oxt&OCl^BCtT{peG^&Z@D zBJrvrqkUkG^kvm22yQKxFe63*du}Q%Y4BKr3pcMDDgM))=+shS!y^*XmY{>YK@coT zQwm4hJdm9~5v85OQ-%4m8y$ZaxjBLT_@ij|-?@qt!4d{BXMd5KDpkj1S+z)#=3K+2 z1U%l~81eK09LPD7QLdwp<#dLVTfot+Yje?@?f(DX-1)9-Wn^BO=wZOUAD#WCVZDwI z-Tdjfh)?()Sc+bK--+8hG4v;#@pd6=-#?3`@T~jj~`d>!n;~+{Ogw*cd7pI24(%TDhA5iPJD0Y7(y27YUg3!4vH*Tto)f_H8eMOoZ zNLO;^X8Yiuc;D1B>y39rLRmE`CCd_F*87Y&5S7>F59lnTGK(3i-Y~jW=ip~uGr+ux zug>yo35#ET1)>+y^3imiMFbb}hTzv^rmZ#-LXor(_PZ44JlQaEg&5US8XsuqQhl_M zF7^Ds))BynQwG0-AI&TLC8~XHpy7ZPlSK-H*`r-p(kHux8Bp4?kTDbq#4?nIXX5G{ z$wia}e>eTOq1Qzd`FhL$bCuq+?C3^aa)`0Va`JX}`ck9o?Ra79{=JR2H2OC_e9wkb z*y{0Btj;J$V8&McY#zOWUc@_yUJVABK{n7^+Y-wlhID=LVsB>VJX#ZBCZE%9ybj$dX!&0r@p59jthtWXOZZ0Wo=_^4+ot)v5@>ei5&WYjeiCQtml=kxJ}g&;<*P8L_b zJK<|-6S=B_qQ9DaRAzJH+P`4K9U`=MGT|!IJoJ6U<>%ldkY_xI#XNM1`dzE*E9^91HMOR15kq>) z{&alnXJ88F?feq2ao_U*57Oqo;VI0yGEagv+4Dm;0&aapTQ^c#=Li9il?x66IE2xr zmU;go3tlR8y$$#fUP9^ZP0iZg4H)zv-X%8WOf6BuQstPrZau3pmeOeTyi_DjLxG-J zF06dxJRT%euJQ0kduiVdc6}+t?j1H+fh&p z9$wu`&*#WR03jQ9wWqX+fTL@E{rr~O=z&7JcFq*VsogGM03V?6temeiw0!!DRN%qh z{IFs!E0(O^r@H)Nv{>aM<#YW4!?6OoAk)tPW*e4dVWBGfGm`7O_!Nvs?sCX{=k;7? z(`f@{Bs_P2%!7;=&I7M*pupk4rooo+?rU5iF5)yx#iZcWFAx4h_|AgBi4==Xq^xiL zlea=>FGwKaZY6Nk4cHHfkH#`F(P}Eyuo6^oK2-h3|!PDmf9HEzFmGNYKvCsqNlA z9lM0^0`DeyBh8H`!cd}ji}8ne51n8fzXeUg-@e7kb50+uvctId0CNt&x zm2;ov{BY7g-zW8;7wQbrp3&7Yerb`LSx!_m;nKpD@yy$y_nvXp0WEC1xx0~!T2Qd$ zDQ-p7nTrbSfXb;eAxp0dUCRUf(>mX)KvH=>piGmq_+rZtfQ^;sqzabm&M3za)mnq$1zNazKSyXV}L|mq+ z(QTt&l3C*obm=-KN^LNmyhSXd?d!AR>oWiAP1gW;-y@7m-TT!%N3mI@ zf=4>JVPF_0!cydl*_-!fpM^g)b6VQ2`IRUL+e!nTe1Xu}d~db!*~qJip)~<-mNT+* zJFw9^zi#1;B9-|g%Pd#<+q$#xb+~C35*Yx)j3fR@dAbxeYw;yTg2A}qaY=qHO-jvH z$LxE}y_{oD8N^>PW#uko^DYy~Lg;wQXdk2fpD*FfeZBnU_A`&Q&|lsc4E494Mk6x6 zR;X9ZhjiU3zOcKOo{YYc+y6OY=*^CT?{Bfr4<&aND*hs>{dHzSnr!?ozfA&fDWFY= z>rZ^2bQfbZ%WW3|RJ3&?!h89O=gPrh=&Pka1^4!VH*|)dZf_VRjhnB$oc5BDwg{7nlxvnWHh9gM%Z7LA_@Nq}Y5) zVBnSbDLFcoprDC@;80LN$Xvu9XT0tjU_X8nADJb`n; z;g+qy#NCb@`}IFDfda95Pxm%bcCY}?9ZZdOmOdYzoyCRxYO)p19kQ^B5&HNjjpNZN}JMGW4JZ=`oI<>yD zGbtlisw#moG+1~CCK`$Y-}(>dgzy{riPZcXpz4T-^+7wSnHTQEvzq= zMK`6V5CTV2ANbSN`CuMtA;V?Qj4MJj_O^S)K1)JHLD9z~rho97w~V~yL6=oj zWLi1u*R2Hy9?S2qE_9dfF@i5w%Hvt40&-P1ty#&sj9a+a}o@xEh^3& zn+yS;Jp*`%8i$}P^~{@-XC>-KM@LH|+}!-vWUWN3jw&^G+xVfGS>H8Y*Dc3B#b(`U zx&~Voh5Kf;G}k~t;u8}bw`TyKiFhqN?X+z`?smu0TaKH(`rX+1S=5VN+-2@<$7)en z*vHnkHOsb-k|ZNj|&C3H{VBq&j=t~T;CSK!qzin@?3d29OoJ|>83{v zzlF@g)6-czw)}F8ajf=_p6tzjpM)5v_u&!X(a9igRQ?uLP=0y8H20fz-a^vnyVj-4 zGUaQj_e;*Q2WIvL35zJH0y-Ph5c8(*x$kJ}{mq+Szq3%By19FRR)s0X{+8JzRtLX# zMb4%`LWCD%#Eb<0#_YV;RPcWB^Zvf`irv%EyNdw!AUnT@0FUpUjOq>e$obhhI|c*9 zyi;m7$eZB{O@ygU)I$~zzU+IS|0(#Lto8zJfaMtz!>AWX6to#?fV7^1nx2XHGDanC zxx0RTfvjc}UrHl4EOP1VNN-xO&KlD4C?WkMy!=gA*l5l_FYfZ|{_d(t3$V<}snQaii;rS_=2GqN z2fXOCZ8opPX6go6;Q}QVPuMDt<@zFDlwbT$4WyIn^smYKN2&B$PZdG2*bg5{PWcBZ zb&1$I{)L%x**^fvCL{Yg*XMNILz3ez1D2+H`kxki9r#!cN!ptnqY(>;e1ESuufNum zS{&A{zc=lZaCwBxhMH@OJ$L-Yxd7Pfq(3=YMblEj)vi`W^Zb}Fuq`gm))*EuBUAzm0ioR zpHpDpNMQ0(lEBOt7F0`b4G#|!wN!+#1KzOMP0ji}J3Gs<77BaSYC8dAlE;uJ>t4R| z@?Rnc>BbhT3IJh|#n>ItFg#zGU^YH)jnr*_l-p+CK6p`87hv? zg0W?&QF!ie(a7||X!`j}KO(lg2Gz+$wYwhkFUH*)Pk;M`JK6vy31`KF*g3dNH2Tey z+e=$KyCj2T=GKsbi61@E09*N5H~x9^x-OZWbq}94+Xe&hmJF%OQEHq6=B1bFQOAU{8Io*_z{DviZ2|Idv>AKpc2Y~c`{jkIqx7+f;Ge`>(PyPk^qa=?Y zKZ2;5ft*dEMpo3Gp=Ntm$;Co$gOOqQ=g)9rYX9QiNfSx%X7MQ(qu>H78FMG-83k+H z{;mrDAMg~N`2OW4??P*acX=6S{Bq>P&A1>J17_%c zp9orB9O`?&1@v>u$5tIhZnS}JqWei&h4JOUu_50y!@Tzzp3~e?=={7K&|ssSj{*)z zzvgbxdeUvmobMBNV(VBPBh?aP%`MiDZ1eI}>u8^8jJ2mS5|rlBxWv2x%+Tzq!#&$` zpm$hNgS3l%h>5&c^B`d321}rCA*P1plc|UEIIJYWx)>c9`2-F)679lgdOQiM9VuMw z`o2(e^!z})%S4=-6IImNnh~{Fz&pglKzv)hZC|)4iWa%qpAo5ov_a8gq2XW>GJcon zUD$15WH@O`jpLwop+WkY;PClWxWQ)e8!^AX1-v{0e1@<9Z2KpMy0t&oW%p{(^do5E zbXH;7viyUD*Z6)j3R*r){JXv~Haq(cz%QJ$`*E^72~p!m_0d47MLkk+^~mHzy~TlkW~0VSvoXzp0FcGh(Q@7t2&4Rw9`>RsD_8CZJTKDte7* zP$YquvGkP8jM0wIB!5*x3T%Et;*r8ZY!xAUY z#q-fOSpAk0y@loUd%uPB52Pnzp@WBJ*#6vUW+}AD9xeHtLI3Xenz^a*_n?f*u@Y0| zocDq`duZY$~49y=t^*m%x7zSJ4jV-(AE?tNn0|7`bs_`~jXA;Qq-Kqy~fe*Z?TM0&}! ztlskI_m@`77{kNE`-Qk7>^HBa0kc|7|Fx~~y-*z}RSuecAOe=v`n(_@9s}2uvLH9*yMTPP_?t*8XEeZk6_%bM^e2u9N zzyy0hAx}UPE%N#|4BKymauGo431V>Fl`y6|C3gdDS)mx^Y8==_x9Q>^o2j*DTeBqv z1!Dg;(%WUn9Q!6UD)N@5YdK;Vm#YJhe#`TBrlinGb7aRMwgmjwFe7}>3J%<-1d~xQ3rX<2KKn+J)sRG+h*co6aH2BAaoPe zH$dz^S1$T6U1H$lnBsA}51U_M-IDyU$t9pAkJPo*RA14_9WUSkhJ&jpPg|U@2&FVt zRn;tYx6AXRt4nips&1%7XMFz>l?|IC>GevjwB0!dduSWbr`*A|#>?~;71N061Yl)fpPpk(FM3?bV*MQV4m|Yj=;C&GoB{qC8<(gpF5dEQX@*ko9jX7Y znHdX?y|dWa&T;wu8N6GHGCJT+R)OZuQ_AI=@nxjqPSXS+4&&Y~Q;tN$%~_IjfZoRu z4o)uFP2?wYe3Z?mw_l(qvj#8=GVEX0nhnLyeVhq*C6FAszbc{{XoDf=-ESxZ8%#O~ zZMk49cb3{0R#_PpuE~+d4apqT7;sRfh`81TVth$8}zjhcE*f8lLAHER=!sJTG)s-g%=nDW7c7RUF2?WMA0E@sW)PEH4hv zF~SulHTMiO<6M?U^wC>R4h#C)r8oYKWWcl~BP=^ICO&w3Pwv+HlD61Br()TQn{>NU zrHlxmh|zI+_Bfm8N=If(c%ks}m>dNf%Qdceao)8O7d*KKoJ)aF+PzRQj>}_1O8&>1 zJkVR|c}Ts)u7xssL6`S>eW5BMQhzVpl6T*SH3#rzRgj!Cl@Tp?Bq|m-z26YmdLA3E zzH0kZaB^grw`^rRBVjcCh`!?B6OlUZk+R0gu`|b|OLbV~t@eF$K|DGZ8n>%%wA<%( z;brAQ>t)9cTi%jaS+49iplsRQKM@xfcEUdsStKLuQF=%Mbk@X7~IrKEvY*-1TdIjB4S| zvr5Peq|<1byl>pOq(sXJTq<NdXQr011}%R)r>o%Vb%#d@nxu) z6Zztp=Jv^G^&Y0v0Ab6dZ=4dHFW^vLwH!ESyTjBV#M%9(63&q`unxz~_K|)rCmN(GNt9`g}&+ z!o9ss9zZsO7j$7;83CmX*nVWQ&L?>k5qK&I_Fzsf?OY26wkQ(xR^0a+8&V-_f5aeH zRSF%ZN^?CE)4U7RM&sWk8RB597h3TAyPM6k{+L z#_ohOJ}*@-+Uwf;YBC)barL+lQOSC8cGznz&I1XYw`*8aw-DS76>}eOTP5!>Mx8Yn zaNvFyNRmtuoh8Z6Weyh^e;KG%exXFE#{)f^Szq#jj`d_XH@&QD1RaoQPoLkZE;0%* z)uOxWP2}ls>G20|&~Z#vcOVe_D(wFSpkJk@v44C8WO8_Z{<#NZHY&xKdR@xdqyp#?#f&!Cc@6nLD|kr-d=L3 zL%HKTbDyd)H>B_Ws;pTtYmd3SKNjSJsYmZezD2LqRd4i>UJsf~a`(;h9oyO5>Onw< z-A!2wJTVN+86m$Ccly*&2ZQT!BTu#x&$OalY|GV<%t~w9)){*LIMR|}PZ$T&Muc7+ z{@Ep#-7-Zj9Q7WT#Gzr%az(ag{I@9NHTJn`FBJ0vNtR!f(2)ZZ?zr8M4)fXkD< z{+a^Vqvw3-Pp(Ow$q+u|H^JAT_Ec`mGT{Y$?ccxSSR)pFFU zR>DNljzz!SaQbVVY3Vo9naLI>)ZL>V2}GiOXaxxFLvrwRB54WzAwypZ=7;2V_pWb3 zi=hrwHJ*?3ZgdF2ri7C3G7jBy}8-cMOz{FkL8y6M?kEli&2luS53hwCpYg~x|k zn8|Qza+K<_%gBX^`GYKaj+%F9g}#?SLJcrhW)jSC8a3julN#&CbiU>AP5*B~*`JBI ziB9lU)1cY>Bl1lZ&m+^v_fX*MMrXXII2Q4|*L1-l?kfGVDfQ zj(fSOSC{g2A}9=>5H-Eilg?AKYC4G{Q?Ab9{J>rE1uH1CgIHlm|AMgPr(%z6?!)Me=5MCc2NH#k7=;X@Mb`=8IdGH`8G3BC>_)e7E41$$$3Zo|2plYwQ0;w* zWHrws10pPoI-99p3Q7EA25`_z4~Zfl*Sf-RQtqV3ma{)>iwH$++vX;J62vg5SRHw} zKl{CvBwPzb{nEPOeCkQI$qX1QNnQ(vO6a;buQod+-cFNS{sI|y79lSM^bQwpyA5+y zZIdrf@-xbb_6-OEuQi1XT+Yzd;cUdQ5&JNZz6uRJ&10z?Npt%1bxGmc52f~`tJ4Cz zk%i-z8@r2?3fEXJv@Bc(e27~mf-K9_y)U^(WO!OBF}UdC{cbVPIaQ#tQiVRFs~eF4 z2_aI{xt<@Z)47A+nMGV61l!j-)|Wb2FYi3ZxDf|3$8PWV^Ulw_1r(o-W){J{TCv8$ zlj!-_>px-GS8c2rm=FCdF&w6QeXfBPrfB?^IDyo+mnw!(3iyB+=_+_brDLI4T;Be? zB&Z$3h?D3ov`VqK6QV$~wEA)l$lz7|vyK#Qu5nc^NAN5!c#rCGh#M__<Py3G`_3Pf*#pT9sDLT*?VBvsh>c=+m(Zd-LR!f3q06i<(AukN z1LXMC4r{N^Nm=QmWU+-rmb$ObA*x=;7^k}Y;_>K!^1+3ZUin|t7dDupL()4(pa-(r zB$LPPp~t;#Fw)>ib|m$3EZ$Z}FI)GJ13o+YKVSYS8#Hc+v=P~^VFUO4Z)~Ppt_Y=# XU|#bTZLZ+oyFk=c9xInBTD|)pO`#c% literal 0 HcmV?d00001 diff --git a/mkdocs.yml b/mkdocs.yml index 88bd229f2..7db4d24d7 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -118,7 +118,9 @@ nav: - GraphQL API: 'plugins/development/graphql-api.md' - Background Tasks: 'plugins/development/background-tasks.md' - Administration: - - Authentication: 'administration/authentication.md' + - Authentication: + - Overview: 'administration/authentication/overview.md' + - Microsoft Azure AD: 'administration/authentication/microsoft-azure-ad.md' - Permissions: 'administration/permissions.md' - Housekeeping: 'administration/housekeeping.md' - Replicating NetBox: 'administration/replicating-netbox.md'