netbox-ddns 1.4.0__tar.gz → 1.5.0__tar.gz

{netbox_ddns-1.4.0/netbox_ddns.egg-info → netbox_ddns-1.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: netbox-ddns
-Version: 1.4.0
+Version: 1.5.0
 Summary: Dynamic DNS Connector for NetBox
 Home-page: https://github.com/sjm-steffann/netbox-ddns
 Author: Sander Steffann

{netbox_ddns-1.4.0 → netbox_ddns-1.5.0}/netbox_ddns/__init__.py

@@ -1,4 +1,4 @@
-VERSION = '1.4.0'
+VERSION = '1.5.0'
 
 try:
     from netbox.plugins import PluginConfig
@@ -13,7 +13,7 @@ class NetBoxDDNSConfig(PluginConfig):
     verbose_name = 'Dynamic DNS'
     version = VERSION
     min_version = '4.0.0'
-    max_version = '4.1.999'
+    max_version = '4.2.999'
     author = 'Sander Steffann'
     author_email = 'sander@steffann.nl'
     description = 'Dynamic DNS Connector for NetBox'

{netbox_ddns-1.4.0 → netbox_ddns-1.5.0}/netbox_ddns/api/serializers.py

@@ -2,16 +2,34 @@ from rest_framework import serializers
 from rest_framework.relations import PrimaryKeyRelatedField
 from ipam.models import IPAddress
 from netbox.api.serializers import NetBoxModelSerializer
-from ..models import ExtraDNSName
+from ..models import ExtraDNSName, Server, Zone, ReverseZone
 
 
 class ExtraDNSNameSerializer(NetBoxModelSerializer):
     url = serializers.HyperlinkedIdentityField(
         view_name='plugins-api:netbox_ddns-api:extradnsname-detail'
     )
-    ip_address = PrimaryKeyRelatedField(queryset=IPAddress.objects.all(),)
+    ip_address = PrimaryKeyRelatedField(queryset=IPAddress.objects.all())
 
     class Meta:
         model = ExtraDNSName
         fields = ('id', 'ip_address', 'name', 'url')
         read_only_fields = ('id', 'url')
+
+
+class ServerSerializer(NetBoxModelSerializer):
+    class Meta:
+        model = Server
+        fields = ('server', 'server_port', 'tsig_key_name', 'tsig_algorithm', "tsig_key")
+
+
+class ZoneSerializer(NetBoxModelSerializer):
+    class Meta:
+        model = Zone
+        fields = ('name', 'ttl', 'server')
+
+
+class ReverseZoneSerializer(NetBoxModelSerializer):
+    class Meta:
+        model = ReverseZone
+        fields = ('name', 'prefix', 'ttl', 'server')

{netbox_ddns-1.4.0 → netbox_ddns-1.5.0}/netbox_ddns/api/views.py

@@ -8,3 +8,4 @@ class ExtraDNSNameViewSet(NetBoxModelViewSet):
     queryset = ExtraDNSName.objects.all()
     serializer_class = ExtraDNSNameSerializer
     filterset_class = ExtraDNSNameFilterSet
+

netbox_ddns-1.5.0/netbox_ddns/filtersets.py

@@ -0,0 +1,30 @@
+import django_filters
+
+from netbox.filtersets import NetBoxModelFilterSet
+from .models import ExtraDNSName, Server, Zone, ReverseZone
+
+
+class ExtraDNSNameFilterSet(NetBoxModelFilterSet):
+    class Meta:
+        model = ExtraDNSName
+        fields = ('id', 'name', 'ip_address', 'forward_rcode')
+
+
+class ServerFilterSet(NetBoxModelFilterSet):
+    class Meta:
+        model = Server
+        fields = ('id', 'server', 'server_port', 'tsig_key_name', 'tsig_algorithm', "tsig_key")
+
+
+class ZoneFilterSet(NetBoxModelFilterSet):
+    class Meta:
+        model = Zone
+        fields = ('id', 'name', 'ttl', 'server')
+
+
+class ReverseZoneFilterSet(NetBoxModelFilterSet):
+    prefix = django_filters.CharFilter(lookup_expr='icontains')
+
+    class Meta:
+        model = ReverseZone
+        fields = ('id', 'name', 'prefix', 'ttl', 'server')

netbox_ddns-1.5.0/netbox_ddns/forms.py

@@ -0,0 +1,60 @@
+from django.forms import IntegerField
+
+from ipam.models import IPAddress
+from netbox.forms import NetBoxModelForm, NetBoxModelBulkEditForm
+from netbox_ddns.models import ExtraDNSName, Server, Zone, ReverseZone
+from utilities.forms.fields import DynamicModelChoiceField
+from utilities.forms.rendering import FieldSet
+
+
+class ReverseZoneForm(NetBoxModelForm):
+    class Meta:
+        model = ReverseZone
+        fields = ('prefix', 'name', 'ttl', 'server')
+
+
+class ZoneForm(NetBoxModelForm):
+    class Meta:
+        model = Zone
+        fields = ('name', 'ttl', 'server')
+
+
+class ZoneBulkEditForm(NetBoxModelBulkEditForm):
+    model = Zone
+
+    ttl = IntegerField(
+        min_value=1,
+        required=False
+    )
+    server = DynamicModelChoiceField(
+        queryset=Server.objects.all(),
+        required=False
+    )
+
+
+class ServerForm(NetBoxModelForm):
+    fieldsets = (
+        FieldSet('server', 'server_port', name='Server'),
+        FieldSet('tsig_key_name', 'tsig_algorithm', "tsig_key", name='Authentication'),
+    )
+
+    class Meta:
+        model = Server
+        fields = ('server', 'server_port', 'tsig_key_name', 'tsig_algorithm', "tsig_key")
+
+
+class ExtraDNSNameIPAddressForm(NetBoxModelForm):
+    class Meta:
+        model = ExtraDNSName
+        fields = ['name']
+
+
+class ExtraDNSNameForm(NetBoxModelForm):
+    ip_address = DynamicModelChoiceField(
+        queryset=IPAddress.objects.all(),
+        required=True
+    )
+
+    class Meta:
+        model = ExtraDNSName
+        fields = ['name', "ip_address"]

netbox_ddns-1.5.0/netbox_ddns/migrations/0011_server_created_server_custom_field_data_and_more.py

@@ -0,0 +1,36 @@
+# Generated by Django 5.0.9 on 2025-01-08 11:03
+
+import taggit.managers
+import utilities.json
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('extras', '0122_charfield_null_choices'),
+        ('netbox_ddns', '0010_extradnsname_created_extradnsname_custom_field_data_and_more'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='server',
+            name='created',
+            field=models.DateTimeField(auto_now_add=True, null=True),
+        ),
+        migrations.AddField(
+            model_name='server',
+            name='custom_field_data',
+            field=models.JSONField(blank=True, default=dict, encoder=utilities.json.CustomFieldJSONEncoder),
+        ),
+        migrations.AddField(
+            model_name='server',
+            name='last_updated',
+            field=models.DateTimeField(auto_now=True, null=True),
+        ),
+        migrations.AddField(
+            model_name='server',
+            name='tags',
+            field=taggit.managers.TaggableManager(through='extras.TaggedItem', to='extras.Tag'),
+        ),
+    ]

netbox_ddns-1.5.0/netbox_ddns/migrations/0012_zone_created_zone_custom_field_data_and_more.py

@@ -0,0 +1,36 @@
+# Generated by Django 5.0.9 on 2025-01-08 18:46
+
+import taggit.managers
+import utilities.json
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('extras', '0122_charfield_null_choices'),
+        ('netbox_ddns', '0011_server_created_server_custom_field_data_and_more'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='zone',
+            name='created',
+            field=models.DateTimeField(auto_now_add=True, null=True),
+        ),
+        migrations.AddField(
+            model_name='zone',
+            name='custom_field_data',
+            field=models.JSONField(blank=True, default=dict, encoder=utilities.json.CustomFieldJSONEncoder),
+        ),
+        migrations.AddField(
+            model_name='zone',
+            name='last_updated',
+            field=models.DateTimeField(auto_now=True, null=True),
+        ),
+        migrations.AddField(
+            model_name='zone',
+            name='tags',
+            field=taggit.managers.TaggableManager(through='extras.TaggedItem', to='extras.Tag'),
+        ),
+    ]

netbox_ddns-1.5.0/netbox_ddns/migrations/0013_reversezone_created_reversezone_custom_field_data_and_more.py

@@ -0,0 +1,36 @@
+# Generated by Django 5.0.9 on 2025-01-08 19:51
+
+import taggit.managers
+import utilities.json
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('extras', '0122_charfield_null_choices'),
+        ('netbox_ddns', '0012_zone_created_zone_custom_field_data_and_more'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='reversezone',
+            name='created',
+            field=models.DateTimeField(auto_now_add=True, null=True),
+        ),
+        migrations.AddField(
+            model_name='reversezone',
+            name='custom_field_data',
+            field=models.JSONField(blank=True, default=dict, encoder=utilities.json.CustomFieldJSONEncoder),
+        ),
+        migrations.AddField(
+            model_name='reversezone',
+            name='last_updated',
+            field=models.DateTimeField(auto_now=True, null=True),
+        ),
+        migrations.AddField(
+            model_name='reversezone',
+            name='tags',
+            field=taggit.managers.TaggableManager(through='extras.TaggedItem', to='extras.Tag'),
+        ),
+    ]

{netbox_ddns-1.4.0 → netbox_ddns-1.5.0}/netbox_ddns/models.py

@@ -4,6 +4,7 @@ import logging
 import socket
 from django.core.exceptions import ValidationError
 from django.db import models
+from django.db.models import Q
 from django.db.models.functions import Length
 from django.utils.html import format_html
 from django.utils.translation import gettext_lazy as _
@@ -15,8 +16,10 @@ from typing import Optional
 from netbox.models import NetBoxModel
 from ipam.fields import IPNetworkField
 from ipam.models import IPAddress
+from utilities.querysets import RestrictedQuerySet
 from .utils import normalize_fqdn
-from .validators import HostnameAddressValidator, HostnameValidator, validate_base64, MinValueValidator, MaxValueValidator
+from .validators import HostnameAddressValidator, HostnameValidator, validate_base64, MinValueValidator, \
+    MaxValueValidator
 
 logger = logging.getLogger('netbox_ddns')
 
@@ -62,7 +65,7 @@ def get_rcode_display(code):
         return _('Unknown response: {}').format(code)
 
 
-class Server(models.Model):
+class Server(NetBoxModel):
     server = models.CharField(
         verbose_name=_('DDNS Server'),
         max_length=255,
@@ -111,12 +114,12 @@ class Server(models.Model):
         # Ensure trailing dots from domain-style fields
         self.tsig_key_name = normalize_fqdn(self.tsig_key_name.lower().rstrip('.'))
 
+    def get_absolute_url(self):
+        return reverse('plugins:netbox_ddns:server', args=[self.pk])
+
     @property
     def address(self) -> Optional[str]:
-        addrinfo = socket.getaddrinfo(self.server, self.server_port, proto=socket.IPPROTO_UDP)
-        for family, _, _, _, sockaddr in addrinfo:
-            if family in (socket.AF_INET, socket.AF_INET6) and sockaddr[0]:
-                return sockaddr[0]
+        return socket.gethostbyname(self.server)
 
     def create_update(self, zone: str) -> dns.update.Update:
         return dns.update.Update(
@@ -129,7 +132,7 @@ class Server(models.Model):
         )
 
 
-class ZoneQuerySet(models.QuerySet):
+class ZoneQuerySet(RestrictedQuerySet):
     def find_for_dns_name(self, dns_name: str) -> Optional['Zone']:
         # Generate all possible zones
         zones = []
@@ -141,7 +144,7 @@ class ZoneQuerySet(models.QuerySet):
         return self.filter(name__in=zones).order_by(Length('name').desc()).first()
 
 
-class Zone(models.Model):
+class Zone(NetBoxModel):
     name = models.CharField(
         verbose_name=_('zone name'),
         max_length=255,
@@ -167,6 +170,28 @@ class Zone(models.Model):
     def __str__(self):
         return self.name
 
+    def get_managed_ip_address(self):
+        # Find all more-specific zones
+        more_specifics = Zone.objects.filter(name__endswith=self.name).exclude(pk=self.pk)
+
+        # Find all IPAddress objects in this self but not in the more-specifics
+        ip_addresses = IPAddress.objects.filter(Q(dns_name__endswith=self.name) |
+                                                Q(dns_name__endswith=self.name.rstrip('.')))
+        for more_specific in more_specifics:
+            ip_addresses = ip_addresses.exclude(Q(dns_name__endswith=more_specific.name) |
+                                                Q(dns_name__endswith=more_specific.name.rstrip('.')))
+        return ip_addresses
+
+    def get_managed_extra_dns_name(self):
+        # Find all more-specific zones
+        more_specifics = Zone.objects.filter(name__endswith=self.name).exclude(pk=self.pk)
+
+        # Find all ExtraDNSName objects in this zone but not in the more-specifics
+        extra_names = ExtraDNSName.objects.filter(name__endswith=self.name)
+        for more_specific in more_specifics:
+            extra_names = extra_names.exclude(name__endswith=more_specific.name)
+        return extra_names
+
     def clean(self):
         # Ensure trailing dots from domain-style fields
         self.name = normalize_fqdn(self.name)
@@ -174,8 +199,11 @@ class Zone(models.Model):
     def get_updater(self):
         return self.server.create_update(self.name)
 
+    def get_absolute_url(self):
+        return reverse('plugins:netbox_ddns:zone', args=[self.pk])
+
 
-class ReverseZoneQuerySet(models.QuerySet):
+class ReverseZoneQuerySet(RestrictedQuerySet):
     def find_for_address(self, address: ip.IPAddress) -> Optional['ReverseZone']:
         # Find the zone, if any
         zones = list(ReverseZone.objects.filter(prefix__net_contains=address))
@@ -186,7 +214,7 @@ class ReverseZoneQuerySet(models.QuerySet):
         return zones[-1]
 
 
-class ReverseZone(models.Model):
+class ReverseZone(NetBoxModel):
     prefix = IPNetworkField(
         verbose_name=_('prefix'),
         unique=True,
@@ -214,7 +242,19 @@ class ReverseZone(models.Model):
         verbose_name_plural = _('reverse zones')
 
     def __str__(self):
-        return f'for {self.prefix}'
+        return f'{self.prefix}'
+
+    def get_managed_ip_address(self):
+        # Find all more-specific zones
+        more_specifics = ReverseZone.objects.filter(prefix__net_contained=self.prefix).exclude(pk=self.pk)
+        # Find all IPAddress objects in this zone but not in the more-specifics
+        ip_addresses = IPAddress.objects.filter(address__net_contained_or_equal=self.prefix)
+        for more_specific in more_specifics:
+            ip_addresses = ip_addresses.exclude(address__net_contained_or_equal=more_specific.prefix)
+        return ip_addresses
+
+    def get_absolute_url(self):
+        return reverse('plugins:netbox_ddns:reversezone', args=[self.pk])
 
     def record_name(self, address: ip.IPAddress):
         record_name = self.name
@@ -367,7 +407,7 @@ class ExtraDNSName(NetBoxModel):
         return self.name
 
     def get_absolute_url(self):
-        return reverse('plugins:netbox_ddns:extradnsname', args=[self.ip_address.pk, self.pk])
+        return reverse('plugins:netbox_ddns:extradnsname', args=[self.pk])
 
     def clean(self):
         # Ensure trailing dots from domain-style fields

netbox_ddns-1.5.0/netbox_ddns/navigation.py

@@ -0,0 +1,58 @@
+from netbox.plugins import PluginMenuItem, PluginMenuButton, PluginMenu
+
+menu = PluginMenu(
+    label='DDNS',
+    groups=(
+        ('Configuration', (
+            PluginMenuItem(
+                link='plugins:netbox_ddns:server_list',
+                link_text='DDNS Servers',
+                buttons=[
+                    PluginMenuButton(
+                        link='plugins:netbox_ddns:server_add',
+                        title='Add',
+                        icon_class='mdi mdi-plus-thick',
+                    )
+                ]
+            ),
+            PluginMenuItem(
+                link='plugins:netbox_ddns:zone_list',
+                link_text='Forward Zones',
+                buttons=[
+                    PluginMenuButton(
+                        link='plugins:netbox_ddns:zone_add',
+                        title='Add',
+                        icon_class='mdi mdi-plus-thick',
+                    )
+                ]
+            ),
+            PluginMenuItem(
+                link='plugins:netbox_ddns:reversezone_list',
+                link_text='Reverse Zones',
+                buttons=[
+                    PluginMenuButton(
+                        link='plugins:netbox_ddns:reversezone_add',
+                        title='Add',
+                        icon_class='mdi mdi-plus-thick',
+                    )
+                ]
+            ),
+        ),
+         ),
+        ('Extra DNS Names', (
+            PluginMenuItem(
+                link='plugins:netbox_ddns:extradnsname_list',
+                link_text='Extra DNS names',
+                buttons=[
+                    PluginMenuButton(
+                        link='plugins:netbox_ddns:extradnsname_add',
+                        title='Add',
+                        icon_class='mdi mdi-plus-thick',
+                    )
+                ]
+            ),
+        ),
+         ),
+    ),
+    icon_class='mdi mdi-router'
+)

netbox_ddns-1.5.0/netbox_ddns/tables.py

@@ -0,0 +1,51 @@
+import django_tables2 as tables
+from django_tables2 import LinkColumn, RelatedLinkColumn
+
+from netbox_ddns.models import ExtraDNSName, Server, ReverseZone, Zone
+
+from netbox.tables import NetBoxTable
+
+FORWARD_DNS = """
+    {% if record.forward_action is not None %}
+        {{ record.get_forward_action_display }}:
+        {{ record.get_forward_rcode_html_display }}
+    {% else %}
+        <span class="text-muted">Not created</span>
+    {% endif %}
+"""
+
+
+class ReverseZoneTable(NetBoxTable):
+    name = LinkColumn()
+    server = RelatedLinkColumn()
+
+    class Meta(NetBoxTable.Meta):
+        model = ReverseZone
+        fields = ("id", "name", "prefix", "server", "ttl")
+
+
+class ZoneTable(NetBoxTable):
+    name = LinkColumn()
+    server = RelatedLinkColumn()
+
+    class Meta(NetBoxTable.Meta):
+        model = Zone
+        fields = ("id", "name", "server", "ttl")
+
+
+class ServerTable(NetBoxTable):
+    server = LinkColumn()
+
+    class Meta(NetBoxTable.Meta):
+        model = Server
+        fields = ("id", "server", "server_port", "tsig_key_name", "tsig_algorithm")
+
+
+class ExtraDNSNameTable(NetBoxTable):
+    ip_address = RelatedLinkColumn()
+    name = LinkColumn()
+    forward_dns = tables.TemplateColumn(template_code=FORWARD_DNS)
+
+    class Meta(NetBoxTable.Meta):
+        model = ExtraDNSName
+        fields = ('id', 'name', 'ip_address', 'last_update', 'forward_dns')

netbox_ddns-1.5.0/netbox_ddns/template_content.py

@@ -0,0 +1,65 @@
+from django.contrib.auth.context_processors import PermWrapper
+from django.template.context_processors import csrf
+
+from netbox.plugins.templates import PluginTemplateExtension
+from . import tables
+
+
+class ReverseZoneRecreate(PluginTemplateExtension):
+    model = 'netbox_ddns.reversezone'
+
+    def buttons(self):
+        """
+        A button to force DNS re-provisioning
+        """
+        context = {
+            'perms': PermWrapper(self.context['request'].user),
+        }
+        context.update(csrf(self.context['request']))
+        return self.render('netbox_ddns/update_reverse_zone.html', context)
+
+
+class ZoneRecreate(PluginTemplateExtension):
+    model = 'netbox_ddns.zone'
+
+    def buttons(self):
+        """
+        A button to force DNS re-provisioning
+        """
+        context = {
+            'perms': PermWrapper(self.context['request'].user),
+        }
+        context.update(csrf(self.context['request']))
+        return self.render('netbox_ddns/update_zone.html', context)
+
+
+class DNSInfo(PluginTemplateExtension):
+    model = 'ipam.ipaddress'
+
+    def buttons(self):
+        """
+        A button to force DNS re-provisioning
+        """
+        context = {
+            'perms': PermWrapper(self.context['request'].user),
+        }
+        context.update(csrf(self.context['request']))
+        return self.render('netbox_ddns/ipaddress/dns_refresh_button.html', context)
+
+    def left_page(self):
+        """
+        An info-box with the status of the DNS modifications and records
+        """
+        extra_dns_name_table = tables.ExtraDNSNameTable(list(self.context['object'].extradnsname_set.all()),
+                                                        exclude=["id", "ip_address"], orderable=False)
+
+        return (
+                self.render('netbox_ddns/ipaddress/dns_info.html') +
+                self.render('netbox_ddns/ipaddress/dns_extra.html', {
+                    'perms': PermWrapper(self.context['request'].user),
+                    'extra_dns_name_table': extra_dns_name_table,
+                })
+        )
+
+
+template_extensions = [DNSInfo, ZoneRecreate, ReverseZoneRecreate]

netbox_ddns-1.5.0/netbox_ddns/templates/netbox_ddns/extradnsname.html

@@ -0,0 +1,61 @@
+{% extends 'generic/object.html' %}
+{% load render_table from django_tables2 %}
+
+{% block content %}
+    <div class="row mb-3">
+        <div class="col col-md-6">
+            <div class="card">
+                <h5 class="card-header">Extra DNS name</h5>
+                <div class="card-body">
+                    <table class="table table-hover attr-table">
+                        <tr>
+                            <th scope="row">Name</th>
+                            <td>{{ object.name }}</td>
+                        </tr>
+                        <tr>
+                            <th scope="row">IP Address</th>
+                            <td>
+                                <a href="{{ object.ip_address.get_absolute_url }}">{{ object.ip_address }}</a>
+                            </td>
+                        </tr>
+                        <tr>
+                            <th scope="row">Last update</th>
+                            <td>{{ object.last_update|isodatetime }}</td>
+                        </tr>
+                        <tr>
+                            <th scope="row">Forward DNS</th>
+                            <td>
+                                {% if object.forward_action is not None %}
+                                    {{ object.get_forward_action_display }}:
+                                    {{ object.get_forward_rcode_html_display }} {% else %}
+                                    <span class="text-muted">Not created</span>
+                                {% endif %}
+                            </td>
+                        </tr>
+                    </table>
+                </div>
+            </div>
+            <div class="card">
+                <h5 class="card-header">Managed by</h5>
+                <div class="card-body">
+                    <table class="table table-hover attr-table">
+                        <tr>
+                            <th scope="row">DDNS Server</th>
+                            <td>
+                                <a href="{{ server.get_absolute_url }}">{{ server }}</a>
+                            </td>
+                        </tr>
+                        <tr>
+                            <th scope="row">Zone</th>
+                            <td>
+                                <a href="{{ zone.get_absolute_url }}">{{ zone }}</a>
+                            </td>
+                        </tr>
+                    </table>
+                </div>
+            </div>
+            {% include 'inc/panels/custom_fields.html' %}
+        </div>
+        <div class="col col-md-6">{% include 'inc/panels/tags.html' %}</div>
+    </div>
+{% endblock content %}

{netbox_ddns-1.4.0 → netbox_ddns-1.5.0}/netbox_ddns/templates/netbox_ddns/ipaddress/dns_extra.html

@@ -10,7 +10,7 @@
 
         {% if perms.netbox_ddns.add_extradnsname %}
             <div class="card-footer text-right noprint">
-                <a href="{% url 'plugins:netbox_ddns:extradnsname_create' ipaddress_pk=object.pk %}"
+                <a href="{% url 'plugins:netbox_ddns:extradnsname_ip_address_create' ipaddress_pk=object.pk %}"
                    class="btn btn-primary">
                     <span class="mdi mdi-plus" aria-hidden="true"></span>Add extra DNS name
                 </a>