netbox-user-credentials-plugin 0.1.0__py3-none-any.whl

netbox_user_credentials_plugin/__init__.py

@@ -0,0 +1,16 @@
+from netbox.plugins import PluginConfig
+
+
+class UserCredentialsConfig(PluginConfig):
+    name = "netbox_user_credentials_plugin"
+    verbose_name = "NetBox User Credentials"
+    description = "NetBox plugin for managing virtual machine users credentials"
+    author = "Dmitry Konyushenko"
+    author_email = "konyushenko.dmitriy@gmail.com"
+    version = "0.1.0"
+    base_url = "netbox_user_credentials_plugin"
+    min_version = "4.5.0"
+    max_version = "4.6.2"
+
+
+config = UserCredentialsConfig

netbox_user_credentials_plugin/api/__init__.py

@@ -0,0 +1,6 @@
+"""
+REST API for NetBox User Credentials Plugin.
+
+For more information on developing NetBox REST APIs, see:
+https://docs.netbox.dev/en/stable/plugins/development/rest-api/
+"""

netbox_user_credentials_plugin/api/serializers.py

@@ -0,0 +1,38 @@
+"""
+API serializers for NetBox User Credentials Plugin.
+
+Serializers are required for NetBox event handling (webhooks, change logging).
+They also power the REST API endpoints.
+
+For more information on NetBox REST API serializers, see:
+https://docs.netbox.dev/en/stable/plugins/development/rest-api/#serializers
+
+For Django REST Framework serializers, see:
+https://www.django-rest-framework.org/api-guide/serializers/
+"""
+
+from netbox.api.serializers import NetBoxModelSerializer
+from rest_framework import serializers
+
+from ..models import UserCredentials
+
+
+class UserCredentialsSerializer(NetBoxModelSerializer):
+    url = serializers.HyperlinkedIdentityField(
+        view_name="plugins-api:netbox_user_credentials_plugin-api:usercredentials-detail"
+    )
+
+    class Meta:
+        model = UserCredentials
+        fields = ("id", 
+            "url",
+            "display",
+            "username",
+            "virtual_machine",
+            "contact",
+            "password_valid_from",
+            "password_valid_to",
+            "tags", 
+            "custom_fields", 
+            "created", 
+            "last_updated")

netbox_user_credentials_plugin/api/urls.py

@@ -0,0 +1,21 @@
+"""
+API URL patterns for NetBox User Credentials Plugin.
+
+For more information on NetBox REST API routing, see:
+https://docs.netbox.dev/en/stable/plugins/development/rest-api/#routers
+
+For Django REST Framework routers, see:
+https://www.django-rest-framework.org/api-guide/routers/
+"""
+
+from netbox.api.routers import NetBoxRouter
+
+from .views import UserCredentialsViewSet
+
+app_name = "netbox_user_credentials_plugin"
+
+router = NetBoxRouter()
+router.register("user-credentials", UserCredentialsViewSet)
+
+urlpatterns = router.urls
+

netbox_user_credentials_plugin/api/views.py

@@ -0,0 +1,20 @@
+"""
+API viewsets for NetBox User Credentials Plugin.
+
+For more information on NetBox REST API viewsets, see:
+https://docs.netbox.dev/en/stable/plugins/development/rest-api/#viewsets
+
+For Django REST Framework viewsets, see:
+https://www.django-rest-framework.org/api-guide/viewsets/
+"""
+
+from netbox.api.viewsets import NetBoxModelViewSet
+
+from ..models import UserCredentials
+from .serializers import UserCredentialsSerializer
+
+
+class UserCredentialsViewSet(NetBoxModelViewSet):
+    queryset = UserCredentials.objects.all()
+    serializer_class = UserCredentialsSerializer
+

netbox_user_credentials_plugin/filtersets.py

@@ -0,0 +1,20 @@
+from netbox.filtersets import NetBoxModelFilterSet
+
+from .models import UserCredentials
+
+
+class UserCredentialsFilterSet(NetBoxModelFilterSet):
+    class Meta:
+        model = UserCredentials
+        fields = [
+            "username",
+            "virtual_machine",
+            "contact",
+            "password_valid_from",
+            "password_valid_to",
+            "last_login_at",
+            "last_login_ip",
+        ]
+
+    def search(self, queryset, username, value):
+        return queryset.filter(username__icontains=value)

netbox_user_credentials_plugin/forms.py

@@ -0,0 +1,128 @@
+from django import forms
+from netbox.forms import (
+    NetBoxModelBulkEditForm,
+    NetBoxModelFilterSetForm,
+    NetBoxModelForm,
+)
+from tenancy.models import Contact
+from utilities.forms.fields import (
+    DynamicModelChoiceField,
+    DynamicModelMultipleChoiceField,
+)
+from utilities.forms.widgets import DatePicker
+from virtualization.models import VirtualMachine
+from ipam.models import IPAddress
+
+from .models import UserCredentials
+
+
+class UserCredentialsForm(NetBoxModelForm):
+
+    class Meta:
+        model = UserCredentials
+        fields = (
+            "username",
+            "virtual_machine",
+            "contact",
+            "password_valid_from",
+            "password_valid_to",
+            "last_login_at",
+            "last_login_ip",
+            "comments",
+        )
+        widgets = {
+            "password_valid_from": DatePicker(),
+            "password_valid_to": DatePicker(),
+            "last_login_at": DatePicker(),
+        }
+
+
+class UserCredentialsFilterForm(NetBoxModelFilterSetForm):
+    model = UserCredentials
+
+    username = forms.CharField(
+        required=False,
+        label="Username",
+    )
+
+    virtual_machine = DynamicModelMultipleChoiceField(
+        queryset=VirtualMachine.objects.all(),
+        required=False,
+    )
+
+    contact = DynamicModelMultipleChoiceField(
+        queryset=Contact.objects.all(),
+        required=False,
+    )
+
+    last_login_ip = DynamicModelMultipleChoiceField(
+        queryset=IPAddress.objects.all(),
+        required=False,
+    )
+
+    password_valid_from = forms.DateField(
+        required=False,
+        widget=DatePicker(),
+    )
+
+    password_valid_to = forms.DateField(
+        required=False,
+        widget=DatePicker(),
+    )
+
+    last_login_at = forms.DateField(
+        required=False,
+        widget=DatePicker(),
+    )
+
+
+class UserCredentialsBulkEditForm(NetBoxModelBulkEditForm):
+
+    username = forms.CharField(
+        required=False,
+    )
+
+    virtual_machine = DynamicModelChoiceField(
+        queryset=VirtualMachine.objects.all(),
+        required=False,
+    )
+
+    contact = DynamicModelChoiceField(
+        queryset=Contact.objects.all(),
+        required=False,
+    )
+
+    password_valid_from = forms.DateField(
+        required=False,
+        widget=DatePicker(),
+    )
+
+    password_valid_to = forms.DateField(
+        required=False,
+        widget=DatePicker(),
+    )
+
+    last_login_at = forms.DateField(
+        required=False,
+        widget=DatePicker(),
+    )
+
+    last_login_ip = forms.GenericIPAddressField(
+        required=False,
+    )
+
+    comments = forms.CharField(
+        required=False,
+        widget=forms.Textarea,
+    )
+
+    model = UserCredentials
+
+    nullable_fields = (
+        "contact",
+        "password_valid_from",
+        "password_valid_to",
+        "last_login_at",
+        "last_login_ip",
+        "comments",
+    )

netbox_user_credentials_plugin/migrations/0001_initial.py

@@ -0,0 +1,34 @@
+# Generated by Django 6.0.5 on 2026-06-14 20:13
+
+import netbox.models.deletion
+import taggit.managers
+import utilities.json
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+        ('extras', '0138_customfieldchoiceset_choice_colors'),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='Usercredentials',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False)),
+                ('created', models.DateTimeField(auto_now_add=True, null=True)),
+                ('last_updated', models.DateTimeField(auto_now=True, null=True)),
+                ('custom_field_data', models.JSONField(blank=True, default=dict, encoder=utilities.json.CustomFieldJSONEncoder)),
+                ('name', models.CharField(max_length=100, unique=True)),
+                ('tags', taggit.managers.TaggableManager(through='extras.TaggedItem', to='extras.Tag')),
+            ],
+            options={
+                'verbose_name_plural': 'Usercredentialss',
+                'ordering': ('name',),
+            },
+            bases=(netbox.models.deletion.DeleteMixin, models.Model),
+        ),
+    ]

netbox_user_credentials_plugin/migrations/0002_alter_usercredentials_options_and_more.py

@@ -0,0 +1,76 @@
+# Generated by Django 6.0.5 on 2026-06-15 18:06
+
+import django.db.models.deletion
+import netbox.models.deletion
+import taggit.managers
+import utilities.json
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('extras', '0138_customfieldchoiceset_choice_colors'),
+        ('netbox_user_credentials_plugin', '0001_initial'),
+        ('tenancy', '0024_default_ordering_indexes'),
+        ('virtualization', '0056_virtualmachine_render_config_permission'),
+    ]
+
+    operations = [
+        migrations.AlterModelOptions(
+            name='usercredentials',
+            options={'ordering': ('username',)},
+        ),
+        migrations.RenameField(
+            model_name='usercredentials',
+            old_name='name',
+            new_name='username',
+        ),
+        migrations.AddField(
+            model_name='usercredentials',
+            name='comments',
+            field=models.TextField(blank=True),
+        ),
+        migrations.AddField(
+            model_name='usercredentials',
+            name='contact',
+            field=models.ForeignKey(default=None, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='user_credentials_contact', to='tenancy.contact'),
+        ),
+        migrations.AddField(
+            model_name='usercredentials',
+            name='password_valid_from',
+            field=models.DateField(blank=True, default=None, null=True),
+        ),
+        migrations.AddField(
+            model_name='usercredentials',
+            name='password_valid_to',
+            field=models.DateField(blank=True, default=None, null=True),
+        ),
+        migrations.AddField(
+            model_name='usercredentials',
+            name='virtual_machine',
+            field=models.OneToOneField(default=1, on_delete=django.db.models.deletion.CASCADE, related_name='user_credentials_virtual_machine', to='virtualization.virtualmachine'),
+            preserve_default=False,
+        ),
+        migrations.CreateModel(
+            name='UserGroups',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False)),
+                ('created', models.DateTimeField(auto_now_add=True, null=True)),
+                ('last_updated', models.DateTimeField(auto_now=True, null=True)),
+                ('custom_field_data', models.JSONField(blank=True, default=dict, encoder=utilities.json.CustomFieldJSONEncoder)),
+                ('name', models.CharField(max_length=100, unique=True)),
+                ('comments', models.TextField(blank=True)),
+                ('tags', taggit.managers.TaggableManager(through='extras.TaggedItem', to='extras.Tag')),
+            ],
+            options={
+                'abstract': False,
+            },
+            bases=(netbox.models.deletion.DeleteMixin, models.Model),
+        ),
+        migrations.AddField(
+            model_name='usercredentials',
+            name='groups',
+            field=models.ManyToManyField(blank=True, related_name='user_credentials_groups', to='netbox_user_credentials_plugin.usergroups'),
+        ),
+    ]

netbox_user_credentials_plugin/migrations/0003_rename_usergroups_usercredentialgroups_and_more.py

@@ -0,0 +1,25 @@
+# Generated by Django 6.0.5 on 2026-06-16 18:40
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('extras', '0138_customfieldchoiceset_choice_colors'),
+        ('netbox_user_credentials_plugin', '0002_alter_usercredentials_options_and_more'),
+        ('tenancy', '0024_default_ordering_indexes'),
+    ]
+
+    operations = [
+        migrations.RenameModel(
+            old_name='UserGroups',
+            new_name='UserCredentialGroups',
+        ),
+        migrations.AlterField(
+            model_name='usercredentials',
+            name='contact',
+            field=models.ForeignKey(blank=True, default=None, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='user_credentials_contact', to='tenancy.contact'),
+        ),
+    ]

netbox_user_credentials_plugin/migrations/0004_remove_usercredentials_groups_and_more.py

@@ -0,0 +1,20 @@
+# Generated by Django 6.0.5 on 2026-06-17 19:35
+
+from django.db import migrations
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('netbox_user_credentials_plugin', '0003_rename_usergroups_usercredentialgroups_and_more'),
+    ]
+
+    operations = [
+        migrations.RemoveField(
+            model_name='usercredentials',
+            name='groups',
+        ),
+        migrations.DeleteModel(
+            name='UserCredentialGroups',
+        ),
+    ]

netbox_user_credentials_plugin/migrations/0005_alter_usercredentials_username.py

@@ -0,0 +1,18 @@
+# Generated by Django 6.0.5 on 2026-06-17 19:41
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('netbox_user_credentials_plugin', '0004_remove_usercredentials_groups_and_more'),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name='usercredentials',
+            name='username',
+            field=models.CharField(max_length=101, unique=True),
+        ),
+    ]

netbox_user_credentials_plugin/migrations/0006_alter_usercredentials_virtual_machine.py

@@ -0,0 +1,20 @@
+# Generated by Django 6.0.5 on 2026-06-18 19:49
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('netbox_user_credentials_plugin', '0005_alter_usercredentials_username'),
+        ('virtualization', '0056_virtualmachine_render_config_permission'),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name='usercredentials',
+            name='virtual_machine',
+            field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='user_credentials_virtual_machine', to='virtualization.virtualmachine'),
+        ),
+    ]

netbox_user_credentials_plugin/migrations/0007_alter_usercredentials_username.py

@@ -0,0 +1,18 @@
+# Generated by Django 6.0.5 on 2026-06-21 10:03
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('netbox_user_credentials_plugin', '0006_alter_usercredentials_virtual_machine'),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name='usercredentials',
+            name='username',
+            field=models.CharField(max_length=101),
+        ),
+    ]

netbox_user_credentials_plugin/migrations/0008_usercredentials_netbox_user_credentials_plugin_usercredentials_unique_usercredentials.py

@@ -0,0 +1,20 @@
+# Generated by Django 6.0.5 on 2026-06-21 18:29
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('extras', '0138_customfieldchoiceset_choice_colors'),
+        ('netbox_user_credentials_plugin', '0007_alter_usercredentials_username'),
+        ('tenancy', '0024_default_ordering_indexes'),
+        ('virtualization', '0056_virtualmachine_render_config_permission'),
+    ]
+
+    operations = [
+        migrations.AddConstraint(
+            model_name='usercredentials',
+            constraint=models.UniqueConstraint(fields=('username', 'virtual_machine'), name='netbox_user_credentials_plugin_usercredentials_unique_usercredentials'),
+        ),
+    ]

netbox_user_credentials_plugin/migrations/0009_usercredentials_last_logon_and_more.py

@@ -0,0 +1,23 @@
+# Generated by Django 6.0.5 on 2026-06-22 16:50
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('netbox_user_credentials_plugin', '0008_usercredentials_netbox_user_credentials_plugin_usercredentials_unique_usercredentials'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='usercredentials',
+            name='last_logon',
+            field=models.DateField(blank=True, default=None, null=True),
+        ),
+        migrations.AlterField(
+            model_name='usercredentials',
+            name='username',
+            field=models.CharField(max_length=100),
+        ),
+    ]

netbox_user_credentials_plugin/migrations/0010_rename_last_logon_usercredentials_last_login_at_and_more.py

@@ -0,0 +1,25 @@
+# Generated by Django 6.0.5 on 2026-06-22 17:18
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('ipam', '0090_vlangroup_recompute_total_vlan_ids'),
+        ('netbox_user_credentials_plugin', '0009_usercredentials_last_logon_and_more'),
+    ]
+
+    operations = [
+        migrations.RenameField(
+            model_name='usercredentials',
+            old_name='last_logon',
+            new_name='last_login_at',
+        ),
+        migrations.AddField(
+            model_name='usercredentials',
+            name='last_login_ip',
+            field=models.ForeignKey(blank=True, default=None, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='user_credentials_contact', to='ipam.ipaddress'),
+        ),
+    ]

netbox_user_credentials_plugin/migrations/0011_alter_usercredentials_last_login_ip.py

@@ -0,0 +1,20 @@
+# Generated by Django 6.0.5 on 2026-06-22 17:24
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('ipam', '0090_vlangroup_recompute_total_vlan_ids'),
+        ('netbox_user_credentials_plugin', '0010_rename_last_logon_usercredentials_last_login_at_and_more'),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name='usercredentials',
+            name='last_login_ip',
+            field=models.ForeignKey(blank=True, default=None, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='user_credentials_last_login_ip', to='ipam.ipaddress'),
+        ),
+    ]

netbox_user_credentials_plugin/migrations/__init__.py

@@ -0,0 +1,7 @@
+"""
+Django migrations for NetBox User Credentials Plugin.
+
+This directory contains database migrations for the plugin.
+For more information on Django migrations, see:
+https://docs.djangoproject.com/en/stable/topics/migrations/
+"""

netbox_user_credentials_plugin/models.py

@@ -0,0 +1,83 @@
+from django.db import models
+from django.urls import reverse
+from django.utils.translation import gettext_lazy as _
+from netbox.models import NetBoxModel
+from tenancy.models import *
+
+
+class UserCredentials(NetBoxModel):
+    username = models.CharField(
+        max_length=100, verbose_name=_("Username"), help_text=_("System login username")
+    )
+    virtual_machine = models.ForeignKey(
+        to="virtualization.VirtualMachine",
+        on_delete=models.CASCADE,
+        related_name="user_credentials_virtual_machine",
+        verbose_name=_("Virtual Machine"),
+        help_text=_("Virtual machine associated with these credentials"),
+    )
+    contact = models.ForeignKey(
+        to="tenancy.Contact",
+        on_delete=models.SET_NULL,
+        blank=True,
+        null=True,
+        default=None,
+        related_name="user_credentials_contact",
+        verbose_name=_("Contact"),
+        help_text=_("Associated contact entity"),
+    )
+    password_valid_from = models.DateField(
+        blank=True,
+        null=True,
+        default=None,
+        verbose_name=_("Password valid from"),
+        help_text=_("Date from which password becomes valid"),
+    )
+    password_valid_to = models.DateField(
+        blank=True,
+        null=True,
+        default=None,
+        verbose_name=_("Password valid to"),
+        help_text=_("Last logon time"),
+    )
+    last_login_at = models.DateField(
+        blank=True,
+        null=True,
+        default=None,
+        verbose_name=_("Last login timestamp"),
+        help_text=_("Date until which password is valid"),
+    )
+    last_login_ip = models.ForeignKey(
+        to="ipam.IPAddress",
+        on_delete=models.SET_NULL,
+        blank=True,
+        null=True,
+        default=None,
+        related_name="user_credentials_last_login_ip",
+        verbose_name=_("Last login IP"),
+        help_text=_("Last login IP"),
+    )
+    comments = models.TextField(
+        blank=True,
+        verbose_name=_("Comments"),
+        help_text=_("Additional notes or remarks"),
+    )
+
+    class Meta:
+        app_label = "netbox_user_credentials_plugin"
+        ordering = ("username",)
+        verbose_name_plural = _("User credentials")
+        constraints = [
+            models.UniqueConstraint(
+                fields=["username", "virtual_machine"],
+                name="%(app_label)s_%(class)s_unique_usercredentials",
+            )
+        ]
+
+    def get_absolute_url(self):
+        return reverse(
+            "plugins:netbox_user_credentials_plugin:usercredentials", args=[self.pk]
+        )
+
+    def __str__(self):
+        return self.username

netbox_user_credentials_plugin/navigation.py

@@ -0,0 +1,28 @@
+from django.utils.translation import gettext_lazy as _
+from netbox.plugins import PluginMenu, PluginMenuButton, PluginMenuItem
+
+plugin_buttons = [
+    PluginMenuButton(
+        link="plugins:netbox_user_credentials_plugin:usercredentials_add",
+        title=_("Add"),
+        icon_class="mdi mdi-plus-thick",
+    )
+]
+
+usercredentials_item = PluginMenuItem(
+    link="plugins:netbox_user_credentials_plugin:usercredentials_list",
+    link_text=_("Users"),
+    buttons=plugin_buttons,
+)
+
+
+menu = PluginMenu(
+    label=_("User Credentials"),
+    groups=(
+        (
+            _("User Credentials"),
+            (usercredentials_item,),
+        ),
+    ),
+    icon_class="mdi mdi-card-account-details",
+)

netbox_user_credentials_plugin/search.py

@@ -0,0 +1,71 @@
+from netbox.search import SearchIndex
+
+from .models import UserCredentials
+
+
+class UserСredentialsIndex(SearchIndex):
+    """
+    Search index for Usercredentials model.
+
+    This enables Usercredentials objects to appear in NetBox's global
+    search results.
+    """
+
+    model = UserCredentials
+
+    # Fields to index for search with their weights
+    # Higher weight = higher priority in search results
+    #
+    # Weight Guidelines:
+    #   50   - Unique serialized attribute (e.g., asset_tag)
+    #   60   - Unique per related object (e.g., serial)
+    #   100  - Primary human identifier (e.g., name)
+    #   110  - Slug fields
+    #   200  - Secondary identifier
+    #   300  - Highly unique descriptive text
+    #   500  - Description field
+    #   1000 - Custom field default
+    #   2000 - Other discrete attributes
+    #   5000 - Comments field
+    fields = (
+        ("username", 100),  # Primary identifier
+        # ('slug', 110),        # Uncomment if your model has a slug field
+        # ('description', 500), # Uncomment if your model has a description field
+        # ('comments', 5000),   # Uncomment if your model has a comments field
+    )
+
+    # Optional: Fields to display in search results (not indexed, just shown)
+    # These help users identify the correct result
+    # Foreign key fields are automatically prefetched for efficiency
+    display_attrs = (
+        # 'status',      # Example: Display status
+        # 'tenant',      # Example: Display tenant relationship
+        # 'description', # Example: Display description
+    )
+
+    # Optional: Custom category label for grouping in search UI
+    # If not specified, defaults to the app's verbose name
+    # category = 'NetBox User Credentials Plugin'
+
+
+# Register all search indexes for this plugin
+# The PluginConfig will automatically load these indexes
+indexes = (UserСredentialsIndex,)
+
+
+# Example: Multiple models with different search configurations
+#
+# class AnotherModelIndex(SearchIndex):
+#     """Search index for another model."""
+#     model = AnotherModel
+#     fields = (
+#         ('name', 100),
+#         ('identifier', 200),
+#         ('description', 500),
+#     )
+#     display_attrs = ('status', 'type')
+#
+# indexes = (
+#     UsercredentialsIndex,
+#     AnotherModelIndex,
+# )

netbox_user_credentials_plugin/tables.py

@@ -0,0 +1,98 @@
+import django_tables2 as tables
+from netbox.tables import NetBoxTable, columns
+
+from .models import UserCredentials
+
+
+class UserCredentialsTable(NetBoxTable):
+    username = tables.Column(linkify=True)
+    virtual_machine = tables.Column(linkify=True)
+    contact = tables.Column(linkify=True)
+    last_login_ip = tables.Column(linkify=True)
+    tags = columns.TagColumn()
+    comments = columns.MarkdownColumn()
+
+    class Meta(NetBoxTable.Meta):
+        model = UserCredentials
+        fields = (
+            "pk",
+            "id",
+            "username",
+            "virtual_machine",
+            "contact",
+            "password_valid_from",
+            "password_valid_to",
+            "last_login_at",
+            "last_login_ip",
+            "comments",
+            "tags",
+            "created",
+            "last_updated",
+        )
+        default_columns = (
+            "username",
+            "virtual_machine",
+            "password_valid_from",
+            "password_valid_to",
+        )
+
+
+class VirtualMachineUserCredentialsTable(NetBoxTable):
+    username = tables.Column(linkify=True)
+    contact = tables.Column(linkify=True)
+    last_login_ip = tables.Column(linkify=True)
+    tags = columns.TagColumn()
+    comments = columns.MarkdownColumn()
+
+    class Meta(NetBoxTable.Meta):
+        model = UserCredentials
+        fields = (
+            "pk",
+            "id",
+            "username",
+            "contact",
+            "password_valid_from",
+            "password_valid_to",
+            "last_login_at",
+            "last_login_ip",
+            "comments",
+            "tags",
+            "created",
+            "last_updated",
+        )
+        default_columns = (
+            "username",
+            "last_login_at",
+            "last_login_ip",
+        )
+
+
+class ContactUserCredentialsTable(NetBoxTable):
+    username = tables.Column(linkify=True)
+    virtual_machine = tables.Column(linkify=True)
+    last_login_ip = tables.Column(linkify=True)
+    tags = columns.TagColumn()
+    comments = columns.MarkdownColumn()
+
+    class Meta(NetBoxTable.Meta):
+        model = UserCredentials
+        fields = (
+            "pk",
+            "id",
+            "username",
+            "virtual_machine",
+            "password_valid_from",
+            "password_valid_to",
+            "last_login_at",
+            "last_login_ip",
+            "comments",
+            "tags",
+            "created",
+            "last_updated",
+        )
+        default_columns = (
+            "username",
+            "virtual_machine",
+            "password_valid_from",
+            "password_valid_to",
+        )

netbox_user_credentials_plugin/templates/netbox_user_credentials_plugin/usercredentials.html

@@ -0,0 +1,43 @@
+
+{% 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">NetBox User Credentials Plugin</h5>
+
+        <table class="table table-hover attr-table">
+          <tr>
+            <th scope="row">Username</th>
+            <td>{{ object.username }}</td>
+          </tr>
+          <tr>
+            <th scope="row">Virtual Machine</th>
+            <td>{{ object.virtual_machine|linkify }}</td>
+          </tr>
+          <tr>
+            <th scope="row">Contact</th>
+            <td>{{ object.contact|linkify }}</td>
+          </tr>
+          <tr>
+            <th scope="row">Password valid from</th>
+            <td>{{ object.password_valid_from|placeholder }}</td>
+          </tr>
+          <tr>
+            <th scope="row">Password valid to</th>
+            <td>{{ object.password_valid_to|placeholder }}</td>
+          </tr>
+        </table>
+      </div>
+      {% include 'inc/panels/custom_fields.html' %}
+    </div>
+    <div class="col col-md-6">
+      {% include 'inc/panels/tags.html' %}
+      {% include 'inc/panels/comments.html' %}
+    </div>
+  </div>
+{% endblock content %}
+

netbox_user_credentials_plugin/templates/netbox_user_credentials_plugin/virtual_machine_user_credentials.html

@@ -0,0 +1,5 @@
+{% extends 'generic/object_children.html' %}
+
+{% block content %}
+  {{ block.super }}
+{% endblock %}

netbox_user_credentials_plugin/urls.py

@@ -0,0 +1,48 @@
+from django.urls import path
+from netbox.views.generic import ObjectChangeLogView
+
+from . import models, views
+
+urlpatterns = (
+    path(
+        "user-credentials/",
+        views.UserCredentialsListView.as_view(),
+        name="usercredentials_list",
+    ),
+    path(
+        "user-credentials/add/",
+        views.UserCredentialsEditView.as_view(),
+        name="usercredentials_add",
+    ),
+    path(
+        "user-credentials/edit/",
+        views.UserCredentialsBulkEditView.as_view(),
+        name="usercredentials_bulk_edit",
+    ),
+    path(
+        "user-credentials/delete/",
+        views.UserCredentialsBulkDeleteView.as_view(),
+        name="usercredentials_bulk_delete",
+    ),
+    path(
+        "user-credentials/<int:pk>/",
+        views.UserCredentialsView.as_view(),
+        name="usercredentials",
+    ),
+    path(
+        "user-credentials/<int:pk>/edit/",
+        views.UserCredentialsEditView.as_view(),
+        name="usercredentials_edit",
+    ),
+    path(
+        "user-credentials/<int:pk>/delete/",
+        views.UserCredentialsDeleteView.as_view(),
+        name="usercredentials_delete",
+    ),
+    path(
+        "usercredentials/<int:pk>/changelog/",
+        ObjectChangeLogView.as_view(),
+        name="usercredentials_changelog",
+        kwargs={"model": models.UserCredentials},
+    ),
+)

netbox_user_credentials_plugin/views.py

@@ -0,0 +1,85 @@
+from netbox.views import generic
+from tenancy.models import Contact
+from utilities.views import ViewTab, register_model_view
+from virtualization.models import VirtualMachine
+
+from . import filtersets, forms, models, tables
+
+
+@register_model_view(models.UserCredentials)
+class UserCredentialsView(generic.ObjectView):
+    queryset = models.UserCredentials.objects.all()
+
+
+@register_model_view(models.UserCredentials, name="list", path="", detail=False)
+class UserCredentialsListView(generic.ObjectListView):
+    queryset = models.UserCredentials.objects.all()
+    table = tables.UserCredentialsTable
+    filterset = filtersets.UserCredentialsFilterSet
+    filterset_form = forms.UserCredentialsFilterForm
+
+
+@register_model_view(VirtualMachine, name="usercredentials", path="user-credentials")
+class VirtualMachineCredentialsView(generic.ObjectChildrenView):
+    queryset = VirtualMachine.objects.all()
+
+    child_model = models.UserCredentials
+    table = tables.VirtualMachineUserCredentialsTable
+    filterset = filtersets.UserCredentialsFilterSet
+
+    tab = ViewTab(
+        label="User Credentials",
+        badge=lambda obj: models.UserCredentials.objects.filter(
+            virtual_machine=obj
+        ).count(),
+        hide_if_empty=False,
+    )
+
+    def get_children(self, request, parent):
+        qs = models.UserCredentials.objects.filter(virtual_machine=parent)
+
+        return self.filterset(request.GET, qs).qs
+
+
+@register_model_view(Contact, name="usercredentials", path="user-credentials")
+class ContactCredentialsView(generic.ObjectChildrenView):
+    queryset = Contact.objects.all()
+
+    child_model = models.UserCredentials
+    table = tables.ContactUserCredentialsTable
+    filterset = filtersets.UserCredentialsFilterSet
+
+    tab = ViewTab(
+        label="User Credentials",
+        badge=lambda obj: models.UserCredentials.objects.filter(contact=obj).count(),
+        hide_if_empty=False,
+    )
+
+    def get_children(self, request, parent):
+        qs = models.UserCredentials.objects.filter(contact=parent)
+
+        return self.filterset(request.GET, qs).qs
+
+
+@register_model_view(models.UserCredentials, name="add", detail=False)
+@register_model_view(models.UserCredentials, name="edit")
+class UserCredentialsEditView(generic.ObjectEditView):
+    queryset = models.UserCredentials.objects.all()
+    form = forms.UserCredentialsForm
+
+
+@register_model_view(models.UserCredentials, name="delete")
+class UserCredentialsDeleteView(generic.ObjectDeleteView):
+    queryset = models.UserCredentials.objects.all()
+
+
+class UserCredentialsBulkDeleteView(generic.BulkDeleteView):
+    queryset = models.UserCredentials.objects.all()
+    table = tables.UserCredentialsTable
+
+
+class UserCredentialsBulkEditView(generic.BulkEditView):
+    queryset = models.UserCredentials.objects.all()
+    form = forms.UserCredentialsBulkEditForm
+    table = tables.UserCredentialsTable
+    filterset = filtersets.UserCredentialsFilterSet

netbox_user_credentials_plugin-0.1.0.dist-info/METADATA

@@ -0,0 +1,97 @@
+Metadata-Version: 2.4
+Name: netbox-user-credentials-plugin
+Version: 0.1.0
+Summary: NetBox plugin for User Credentials
+Author-email: Dmitry Konyushenko <konyushenko.dmitriy@gmail.com>
+License-Expression: WTFPL
+Project-URL: Homepage, https://github.com/ilyjorsey/netbox-user-credentials-plugin
+Project-URL: Documentation, https://github.com/ilyjorsey/netbox-user-credentials-plugin/blob/main/README.md
+Project-URL: Source, https://github.com/ilyjorsey/netbox-user-credentials-plugin
+Project-URL: Tracker, https://github.com/ilyjorsey/netbox-user-credentials-plugin/issues
+Keywords: netbox,netbox-plugin
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 5.1
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: Intended Audience :: Telecommunications Industry
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: System :: Networking
+Requires-Python: >=3.12.0
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: test
+Requires-Dist: check-manifest==0.51; extra == "test"
+Requires-Dist: ruff==0.14.14; extra == "test"
+Requires-Dist: pre-commit==6.0.0; extra == "test"
+Requires-Dist: pytest==9.0.2; extra == "test"
+Dynamic: license-file
+
+# NetBox User Credentials Plugin
+
+NetBox plugin for managing User Credentials.
+
+The standard NetBox VM model only allows contacts to be assigned. However, if you need to keep an inventory of users associated with virtual machines, including multiple users linked to the same contact, NetBox does not provide sufficient functionality out of the box. The User Credentials plugin helps solve this problem.
+
+- Free software: WTFPL
+- Documentation: https://ilyjorsey.github.io/netbox-user-credentials-plugin/
+
+## Screenshots
+
+
+| User Credentials page |
+|:---:|
+![User Credential](docs/images/uc_view.png)
+
+| Contact page - User Credentials | Virtual Machine page - User Credentials |
+|:---:|:---:|
+| ![Contact User Credentials](docs/images/contact_uc_view.png) | ![Virtual Machine User Credentials](docs/images/vm_uc_view.png) |
+
+## Compatibility
+
+This plugin requires **NetBox 4.5** or later.
+
+| NetBox Version | Plugin Version |
+|----------------|----------------|
+|     4.5+       |      0.1.0     |
+
+For more detailed compatibility information, see [COMPATIBILITY.md](COMPATIBILITY.md).
+
+## REST API
+
+This plugin provides a REST API endpoint for managing User Credentials resources:
+
+- `/api/plugins/netbox_user_credentials_plugin/user-credentials/` - List and create plugin objects
+
+
+
+## Installing
+
+For adding to a NetBox Docker setup see
+[the general instructions for using netbox-docker with plugins](https://github.com/netbox-community/netbox-docker/wiki/Using-Netbox-Plugins).
+
+Enable the plugin in `/opt/netbox/netbox/netbox/configuration.py`,
+ or if you use netbox-docker, your `/configuration/plugins.py` file :
+
+```python
+PLUGINS = [
+    'netbox_user_credentials_plugin'
+]
+
+PLUGINS_CONFIG = {
+    "netbox_user_credentials_plugin": {},
+}
+```
+
+## Usage
+
+For detailed usage instructions, please refer to the [documentation](https://ilyjorsey.github.io/netbox-user-credentials-plugin/).
+
+
+### Feature Requests & Reporting Bugs
+
+Feature Requests & Reporting Bugs can be submitted as [GitHub Issues](https://github.com/ilyjorsey/netbox-user-credentials-plugin/issues).

netbox_user_credentials_plugin-0.1.0.dist-info/RECORD

@@ -0,0 +1,32 @@
+netbox_user_credentials_plugin/__init__.py,sha256=RwmA1Ozb5_ofRshGIoExDarYIO0q6azenMRm4ra1jr0,495
+netbox_user_credentials_plugin/filtersets.py,sha256=GFpb34WtP8o7wrtESQUD3l4WWPLld7yQnBO3Ds4n20s,533
+netbox_user_credentials_plugin/forms.py,sha256=7rNAJGP5MY5t-_s3eCWfOOo36g08zZrgrfxrKMxlajU,2862
+netbox_user_credentials_plugin/models.py,sha256=N1XsuOfiDtE0z4V016slj8kqMEY3_5B5y3p1sJD84Ic,2597
+netbox_user_credentials_plugin/navigation.py,sha256=GgISIJ8PIOXDNTEaaS1RDDJ5n0LHiG3Fwfhy2_e-nLg,701
+netbox_user_credentials_plugin/search.py,sha256=e7JrdQ6YD_b-QJIJd0r06d0eEPNOgEMzGrQMsbb0cNU,2282
+netbox_user_credentials_plugin/tables.py,sha256=aQlkrMyN0T_iLVOWOFi6ezGnY2Wf-EdvmSuIbeJ0cow,2617
+netbox_user_credentials_plugin/urls.py,sha256=-scpxiWeXU2fxveTIOZSmHv7ojw8inKctjSzC5mVYiM,1320
+netbox_user_credentials_plugin/views.py,sha256=VvY069geQbCXsledUGgQVHSClsfoWZVa50DQXF5cmMQ,2933
+netbox_user_credentials_plugin/api/__init__.py,sha256=AqFpJz8ZzL96Yvmu2L4zu00frn3f4l1Lc6lvHDQvB4s,176
+netbox_user_credentials_plugin/api/serializers.py,sha256=GwIbriW5_YKWshyKxUihnScZl_rVIfLl1nFhAcSCrRg,1123
+netbox_user_credentials_plugin/api/urls.py,sha256=X3RuUj4lY_PiZV9qq33mq3Zpk7W7KvumuonBvis2xRY,532
+netbox_user_credentials_plugin/api/views.py,sha256=baQHR4h7_ynmR8dX4L9aAYiVSNAWW9Fxe-cU8DezauM,574
+netbox_user_credentials_plugin/migrations/0001_initial.py,sha256=VVmq-f1NUMyhys_ld6Hhp3KsNwOqaoHQjakEiLEVqX0,1233
+netbox_user_credentials_plugin/migrations/0002_alter_usercredentials_options_and_more.py,sha256=Ua7XFFMJXhwB9TmiWv1JkYht2i7TtkcYZsnmaEd9RxY,3123
+netbox_user_credentials_plugin/migrations/0003_rename_usergroups_usercredentialgroups_and_more.py,sha256=riQw2hPsWHZvMViPDFMC75DleWFNx3FuwyhHYxP8hcs,844
+netbox_user_credentials_plugin/migrations/0004_remove_usercredentials_groups_and_more.py,sha256=zTz3KXeQrP6LMTtJtYUq8RFm-E4nuPk8XOFxzEiBgrQ,473
+netbox_user_credentials_plugin/migrations/0005_alter_usercredentials_username.py,sha256=kYisqfjOAjYhH92Pn2P9zBzNtlLtpndYm9lqP99XOik,454
+netbox_user_credentials_plugin/migrations/0006_alter_usercredentials_virtual_machine.py,sha256=cX4ulboGJ4jQzNVsoVB4bhqjNKmc57n3X2BmZCSdUOw,664
+netbox_user_credentials_plugin/migrations/0007_alter_usercredentials_username.py,sha256=l9y-RsTBkkrk6Hqp3jDB3G2QiNh7cDzee2Ru2H-fV8g,440
+netbox_user_credentials_plugin/migrations/0008_usercredentials_netbox_user_credentials_plugin_usercredentials_unique_usercredentials.py,sha256=aJTjXVtfbPO0d5rEbSLZAAznJROfTEMA0WpND7YrKKE,714
+netbox_user_credentials_plugin/migrations/0009_usercredentials_last_logon_and_more.py,sha256=U9Xi_xKYNMJkDFLZWOR8Crpz5s90iOoYmgUb-GnmNZg,674
+netbox_user_credentials_plugin/migrations/0010_rename_last_logon_usercredentials_last_login_at_and_more.py,sha256=YmzG2ChKWQZgPPlm0Y3blQvCyWkF_x7d5dcnI9m5igs,823
+netbox_user_credentials_plugin/migrations/0011_alter_usercredentials_last_login_ip.py,sha256=dvhq7sKcRdiSHG2ctO84EYa8e7594-kPaRNlCEJC5rs,694
+netbox_user_credentials_plugin/migrations/__init__.py,sha256=yBmHL8jr2-nqgxu8OcVgyWN0aqYKFSdfmteGAi7dXTo,231
+netbox_user_credentials_plugin/templates/netbox_user_credentials_plugin/usercredentials.html,sha256=2cbE01av8X324495KSw680oWMH1cO1sZ2IltlILAxEQ,1236
+netbox_user_credentials_plugin/templates/netbox_user_credentials_plugin/virtual_machine_user_credentials.html,sha256=EgIGZW__mV7NbnfWcxvqT5d-toVS5HSunXlQpa8z0Rw,100
+netbox_user_credentials_plugin-0.1.0.dist-info/licenses/LICENSE,sha256=29F5Z4mEpyEsjtOcm4owWEMeALuucOJlFEY0NpdqcyA,506
+netbox_user_credentials_plugin-0.1.0.dist-info/METADATA,sha256=t_afC7P9lIG1UcM0uQXdNgA8UuvN_td7ykDUgfuVEjY,3566
+netbox_user_credentials_plugin-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+netbox_user_credentials_plugin-0.1.0.dist-info/top_level.txt,sha256=TXlUuLfQZMNpDhNEhLwO7-4CWp0rnd6AZEvIrGfvfD8,31
+netbox_user_credentials_plugin-0.1.0.dist-info/RECORD,,

netbox_user_credentials_plugin-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

netbox_user_credentials_plugin-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,13 @@
+              DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+                    Version 2, December 2004
+
+ Copyright (C) 2026 Dmitry Konyushenko <konyushenko.dmitriy@gmail.com>
+
+ Everyone is permitted to copy and distribute verbatim or modified
+ copies of this license document, and changing it is allowed as long
+ as the name is changed.
+
+            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
+   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+  0. You just DO WHAT THE FUCK YOU WANT TO.

netbox_user_credentials_plugin-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+netbox_user_credentials_plugin