pki.views.certificates

This module contains all views concerning the PKI -> Certificates section.

Attributes

OID_MAP

Classes

CertificatesRedirectView	View that redirects to the index of the PKI Issuing CA application: Issuing CAs.
CertificatesContextMixin	Mixin which adds data to the context for the PKI -> Certificates application.
CertificateTableView	Certificate Table View.
CertificateDetailView	The certificate detail view.
IssuingCaCertificateDownloadView	View for downloading a single certificate.
CertificateDownloadView	View for downloading a single certificate.
CertificateMultipleDownloadView	View for downloading multiple certificates at once as archived files.
TlsServerCertificateDownloadView	View for downloading the TLS server certificate of trustpoint.
CertificateViewSet	ViewSet for managing Certificate instances.

Module Contents

class pki.views.certificates.CertificatesRedirectView(**kwargs)

Bases: django.views.generic.base.RedirectView

View that redirects to the index of the PKI Issuing CA application: Issuing CAs.

permanent = False

pattern_name = 'pki:certificates'

class pki.views.certificates.CertificatesContextMixin

Bases: trustpoint.page_context.PageContextMixin

Mixin which adds data to the context for the PKI -> Certificates application.

page_category = 'pki'

page_name = 'certificates'

class pki.views.certificates.CertificateTableView

Bases: CertificatesContextMixin, trustpoint.views.base.SortableTableMixin[pki.models.CertificateModel], django.views.generic.list.ListView[pki.models.CertificateModel]

Certificate Table View.

model

template_name = 'pki/certificates/certificates.html'

context_object_name = 'certificates'

paginate_by = 50

default_sort_param = 'common_name'

pki.views.certificates.OID_MAP

class pki.views.certificates.CertificateDetailView

Bases: CertificatesContextMixin, django.views.generic.detail.DetailView[pki.models.CertificateModel]

The certificate detail view.

model

success_url

ignore_url

template_name = 'pki/certificates/details.html'

context_object_name = 'cert'

get_context_data(**kwargs)

Adding map of attribute and its oid with its values.

Parameters:

**kwargs (Any) – Keyword arguments passed to super().get_context_data().

Returns:

The context data.

Return type:

dict

class pki.views.certificates.IssuingCaCertificateDownloadView

Bases: CertificatesContextMixin, django.views.generic.detail.DetailView[pki.models.CertificateModel]

View for downloading a single certificate.

model

context_object_name = 'certificate'

get(request, *args, **kwargs)

HTTP GET Method.

If only the certificate primary key are passed in the url, the download summary will be displayed. If value for file_format is also provided, a file download will be performed.

Compare the re_path regex in the pki.urls package.

Parameters:

• request (django.http.HttpRequest) – The HttpRequest object.

• pk – A string containing the certificate primary key.

• *args (Any) – Positional arguments.

• **kwargs (Any) – Keyword arguments.

Returns:

The HTTP response with either the download summary or a file download.

Return type:

HttpResponse

Raises:

Http404 –

class pki.views.certificates.CertificateDownloadView

Bases: CertificatesContextMixin, django.views.generic.detail.DetailView[pki.models.CertificateModel]

View for downloading a single certificate.

model

success_url

ignore_url

template_name = 'pki/certificates/download.html'

context_object_name = 'certificate'

get(request, pk=None, file_format=None, *args, **kwargs)

HTTP GET Method.

If only the certificate primary key are passed in the url, the download summary will be displayed. If value for file_format is also provided, a file download will be performed.

Compare the re_path regex in the pki.urls package.

Parameters:

• request (django.http.HttpRequest) – The HttpRequest object.

• pk (str | None) – A string containing the certificate primary key.

• file_format (str | None) – The format of the certificate to download.

• *args (tuple[Any]) – Positional arguments.

• **kwargs (dict[str, Any]) – Keyword arguments.

Returns:

The HTTP response with either the download summary or a file download.

Return type:

HttpResponse

Raises:

Http404 –

class pki.views.certificates.CertificateMultipleDownloadView

Bases: CertificatesContextMixin, trustpoint.views.base.PrimaryKeyListFromPrimaryKeyString, django.views.generic.list.ListView[pki.models.CertificateModel]

View for downloading multiple certificates at once as archived files.

model

success_url

ignore_url

template_name = 'pki/certificates/download_multiple.html'

context_object_name = 'certificates'

get_context_data(*args, **kwargs)

Adding the part of the url to the context, that contains the certificate primary keys.

This is used for the {% url }% tags in the template to download files.

Parameters:

• *args (Any) – Positional arguments passed to super().get_context_data().

• **kwargs (Any) – Keyword arguments passed to super().get_context_data().

Returns:

The context data.

Return type:

dict

get(request, pks=None, file_format=None, archive_format=None, *args, **kwargs)

HTTP GET Method.

If only certificate primary keys are passed in the url, the download summary will be displayed. If value for file_format and archive_format are also provided, a file download will be performed.

Compare the re_path regex in the pki.urls package.

Parameters:

• request (django.http.HttpRequest) – The HttpRequest object.

• pks (str | None) – A string containing the certificate primary keys, e.g. 1/2/3/4/5

• file_format (None | str) – The format of the archived certificate files.

• archive_format (None | str) – The archive format that will be provided as download.

• *args (tuple[Any]) – Positional arguments.

• **kwargs (dict[str, Any]) – Keyword arguments.

Returns:

The HTTP response with either the download summary or a file download.

Return type:

HttpResponse

Raises:

Http404 –

class pki.views.certificates.TlsServerCertificateDownloadView

Bases: CertificatesContextMixin, django.views.generic.detail.DetailView[pki.models.CertificateModel]

View for downloading the TLS server certificate of trustpoint.

model

context_object_name = 'certificate'

get(request, *args, **kwargs)

Download the active Trustpoint TLS server certificate.

Parameters:

• request (django.http.HttpRequest)

• args (Any)

• kwargs (Any)

Return type:

django.http.HttpResponse

class pki.views.certificates.CertificateViewSet(**kwargs)

Bases: rest_framework.viewsets.ModelViewSet[pki.models.CertificateModel]

ViewSet for managing Certificate instances.

Supports standard CRUD operations such as list, retrieve, create, update, and delete.

queryset

serializer_class

permission_classes

filter_backends

filterset_fields: ClassVar = ['serial_number', 'not_valid_before']

search_fields: ClassVar = ['common_name', 'sha256_fingerprint']

ordering_fields: ClassVar = ['common_name', 'created_at']

list(request, *args, **_kwargs)

API endpoint to get all certificates.

Parameters:

• request (django.http.HttpRequest)

• args (Any)

• _kwargs (Any)

Return type:

django.http.HttpResponse