pki.views.issuing_cas

Views for Issuing CA management.

Module Contents

class pki.views.issuing_cas.CmpContextParams

Bases: NamedTuple

Parameters for creating a CMP certificate request context.

subject: cryptography.x509.Name

public_key: cryptography.hazmat.primitives.asymmetric.rsa.RSAPublicKey | cryptography.hazmat.primitives.asymmetric.ec.EllipticCurvePublicKey

private_key: cryptography.hazmat.primitives.asymmetric.rsa.RSAPrivateKey | cryptography.hazmat.primitives.asymmetric.ec.EllipticCurvePrivateKey

recipient_name: str

extensions: list[cryptography.x509.Extension[cryptography.x509.ExtensionType]] | None

sender_kid: int | None

class pki.views.issuing_cas.IssuingCaContextMixin

Bases: trustpoint.views.base.ContextDataMixin

Mixin which adds context_data for the PKI -> Issuing CAs pages.

context_page_category = 'pki'

context_page_name = 'cas'

class pki.views.issuing_cas.KeylessCaContextMixin

Bases: trustpoint.views.base.ContextDataMixin

Mixin which adds context_data for the PKI -> Keyless CAs pages.

context_page_category = 'pki'

context_page_name = 'cas'

class pki.views.issuing_cas.IssuingCaTableView

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

Issuing CA Table View.

model

template_name = 'pki/issuing_cas/issuing_cas.html'

context_object_name = 'issuing_ca'

paginate_by = 50

default_sort_param = 'created_at'

get_queryset()

Return only issuing CAs.

Return type:

django.db.models.QuerySet[pki.models.CaModel, pki.models.CaModel]

get_context_data(*args, **kwargs)

Add sorting information to the context.

Parameters:

• args (Any)

• kwargs (Any)

Return type:

dict[str, Any]

class pki.views.issuing_cas.IssuingCaAddMethodSelectView

Bases: IssuingCaContextMixin, django.views.generic.edit.FormView[pki.forms.IssuingCaAddMethodSelectForm]

View to select the method to add an Issuing CA.

template_name = 'pki/issuing_cas/add/method_select.html'

form_class

form_valid(form)

Redirect to the next step based on the selected method.

Parameters:

form (pki.forms.IssuingCaAddMethodSelectForm)

Return type:

django.http.HttpResponseRedirect

class pki.views.issuing_cas.IssuingCaAddFileImportPkcs12View

Bases: IssuingCaContextMixin, django.views.generic.edit.FormView[pki.forms.IssuingCaAddFileImportPkcs12Form]

View to import an Issuing CA from a PKCS12 file.

template_name = 'pki/issuing_cas/add/file_import.html'

form_class

success_url

form_valid(form)

Handle the case where the form is valid.

Parameters:

form (pki.forms.IssuingCaAddFileImportPkcs12Form)

Return type:

django.http.HttpResponse

class pki.views.issuing_cas.IssuingCaAddFileImportSeparateFilesView

Bases: IssuingCaContextMixin, django.views.generic.edit.FormView[pki.forms.IssuingCaAddFileImportSeparateFilesForm]

View to import an Issuing CA from separate PEM files.

template_name = 'pki/issuing_cas/add/file_import.html'

form_class

success_url

form_valid(form)

Handle the case where the form is valid.

Parameters:

form (pki.forms.IssuingCaAddFileImportSeparateFilesForm)

Return type:

django.http.HttpResponse

class pki.views.issuing_cas.IssuingCaAddRequestEstView

Bases: IssuingCaContextMixin, django.views.generic.edit.FormView[pki.forms.IssuingCaAddRequestEstForm]

View to request an Issuing CA certificate using EST.

form_class

template_name = 'pki/issuing_cas/add/request_est.html'

form_valid(form)

Handle successful form submission.

Parameters:

form (pki.forms.IssuingCaAddRequestEstForm)

Return type:

django.http.HttpResponse

class pki.views.issuing_cas.IssuingCaTruststoreAssociationView

Bases: IssuingCaContextMixin, django.views.generic.edit.FormView[pki.forms.IssuingCaTruststoreAssociationForm]

View for associating a truststore with an Issuing CA.

form_class

template_name = 'pki/issuing_cas/truststore_association.html'

get_ca()

Get the CA from the URL parameters.

Return type:

pki.models.CaModel

get_form_kwargs()

Add the CA instance to the form kwargs.

Return type:

dict[str, Any]

post(request, *args, **kwargs)

Handle both association and import form submissions.

Parameters:

• request (django.http.HttpRequest)

• args (Any)

• kwargs (Any)

Return type:

django.http.HttpResponse

get_context_data(**kwargs)

Add the CA and import form to the context.

Parameters:

kwargs (Any)

Return type:

dict[str, Any]

form_valid(form)

Handle successful form submission.

Parameters:

form (pki.forms.IssuingCaTruststoreAssociationForm)

Return type:

django.http.HttpResponse

class pki.views.issuing_cas.IssuingCaDefineCertContentMixin

Bases: trustpoint.logger.LoggerMixin, IssuingCaContextMixin

Mixin for defining certificate content using a certificate profile.

ca_type_filter: pki.models.CaModel.CaTypeChoice

redirect_url_name: str

available_profiles: list[pki.models.cert_profile.CertificateProfileModel]

dispatch(request, *args, **kwargs)

Dispatch the request, ensuring the CA and profile exist.

Parameters:

• request (django.http.HttpRequest)

• args (Any)

• kwargs (Any)

Return type:

django.http.HttpResponse

get_form_kwargs()

Get form kwargs, including the profile.

Return type:

dict[str, Any]

get_context_data(**kwargs)

Add additional context data.

Parameters:

kwargs (Any)

Return type:

dict[str, Any]

form_invalid(form)

Handle the case where the form is invalid.

Parameters:

form (pki.forms.CertificateIssuanceForm)

Return type:

django.http.HttpResponse

form_valid(form)

Handle the case where the form is valid.

Parameters:

form (pki.forms.CertificateIssuanceForm)

Return type:

django.http.HttpResponse

get_success_message()

Get the success message for the form submission.

Return type:

str

class pki.views.issuing_cas.IssuingCaDefineCertContentEstView

Bases: IssuingCaDefineCertContentMixin, django.views.generic.edit.FormView[pki.forms.CertificateIssuanceForm]

View to define certificate content using the issuing_ca profile before requesting via EST.

form_class

template_name = 'pki/issuing_cas/define_cert_content_est.html'

ca_type_filter

redirect_url_name = 'pki:issuing_cas-request-cert-est'

get_success_message()

Get the success message for the form submission.

Return type:

str

class pki.views.issuing_cas.RemoteRaAddRequestCmpMixin

Bases: IssuingCaContextMixin

Mixin for CMP RA configuration views.

form_valid(form)

Handle successful CMP RA configuration submission.

Parameters:

form (pki.forms.IssuingCaAddRequestCmpForm)

Return type:

django.http.HttpResponse

class pki.views.issuing_cas.IssuingCaAddRequestCmpView

Bases: IssuingCaContextMixin, django.views.generic.edit.FormView[pki.forms.IssuingCaAddRequestCmpForm]

View to request an Issuing CA certificate using CMP.

form_class

template_name = 'pki/issuing_cas/add/request_cmp.html'

form_valid(form)

Handle successful form submission.

Parameters:

form (pki.forms.IssuingCaAddRequestCmpForm)

Return type:

django.http.HttpResponse

class pki.views.issuing_cas.RemoteRaAddRequestCmpView

Bases: RemoteRaAddRequestCmpMixin, django.views.generic.edit.FormView[pki.forms.IssuingCaAddRequestCmpForm]

View to configure a remote CMP RA (Registration Authority).

form_class

template_name = 'pki/issuing_cas/add/cmp_ra.html'

class pki.views.issuing_cas.RemoteRaAddRequestEstMixin

Bases: IssuingCaContextMixin

Mixin for EST RA configuration views.

form_valid(form)

Handle successful EST RA configuration submission.

Parameters:

form (pki.forms.IssuingCaAddRequestEstForm)

Return type:

django.http.HttpResponse

class pki.views.issuing_cas.RemoteRaAddRequestEstView

Bases: RemoteRaAddRequestEstMixin, django.views.generic.edit.FormView[pki.forms.IssuingCaAddRequestEstForm]

View to configure a remote EST RA (Registration Authority).

form_class

template_name = 'pki/issuing_cas/add/est_ra.html'

class pki.views.issuing_cas.IssuingCaDefineCertContentCmpView

Bases: IssuingCaDefineCertContentMixin, django.views.generic.edit.FormView[pki.forms.CertificateIssuanceForm]

View to define certificate content using the issuing_ca profile before requesting via CMP.

form_class

template_name = 'pki/issuing_cas/define_cert_content_cmp.html'

ca_type_filter

redirect_url_name = 'pki:issuing_cas-request-cert-cmp'

get_success_message()

Get the success message for the form submission.

Return type:

str

class pki.views.issuing_cas.IssuingCaConfigView

Bases: trustpoint.logger.LoggerMixin, IssuingCaContextMixin, django.views.generic.detail.DetailView[pki.models.CaModel]

View to display the details of an Issuing CA.

model

success_url

ignore_url

template_name = 'pki/issuing_cas/config.html'

context_object_name = 'issuing_ca'

get_queryset()

Return only issuing CAs.

Return type:

django.db.models.QuerySet[pki.models.CaModel, pki.models.CaModel]

get_context_data(**kwargs)

Adds the issued certificates to the context.

Parameters:

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

Returns:

The context to render the page.

Return type:

dict[str, Any]

get(request, *args, **kwargs)

Handle GET requests.

Parameters:

• request (django.http.HttpRequest)

• args (Any)

• kwargs (Any)

Return type:

django.http.HttpResponse

post(request, *_args, **_kwargs)

Handle POST request to update CRL cycle settings.

Parameters:

• request (django.http.HttpRequest)

• _args (Any)

• _kwargs (Any)

Return type:

django.http.HttpResponse

class pki.views.issuing_cas.IssuingCaRequestCertMixin

Bases: trustpoint.logger.LoggerMixin, IssuingCaContextMixin

Mixin for certificate request views for EST and CMP protocols.

context_object_name = 'issuing_ca'

ca_type_filter: pki.models.CaModel.CaTypeChoice

redirect_url_name: str

get_queryset()

Return only CAs matching the protocol-specific type filter.

Return type:

django.db.models.QuerySet[pki.models.CaModel, pki.models.CaModel]

get_context_data(**kwargs)

Add the issuing_ca certificate profile and cert content summary to the context.

Parameters:

kwargs (Any)

Return type:

dict[str, Any]

post(request, *_args, **_kwargs)

Handle POST request to request certificate.

Parameters:

• request (django.http.HttpRequest)

• _args (Any)

• _kwargs (Any)

Return type:

django.http.HttpResponse

get_not_implemented_message()

Get the not implemented message for the specific protocol.

Return type:

str

class pki.views.issuing_cas.IssuingCaRequestCertEstView

Bases: IssuingCaRequestCertMixin, django.views.generic.detail.DetailView[pki.models.CaModel]

View to display the EST certificate request page.

template_name = 'pki/issuing_cas/request_cert_est.html'

ca_type_filter

redirect_url_name = 'pki:issuing_cas-request-cert-est'

get_not_implemented_message()

Get the not implemented message for EST.

Return type:

str

post(request, *_args, **_kwargs)

Handle POST request to request certificate via EST.

Parameters:

• request (django.http.HttpRequest)

• _args (Any)

• _kwargs (Any)

Return type:

django.http.HttpResponse

class pki.views.issuing_cas.IssuingCaRequestCertCmpView

Bases: IssuingCaRequestCertMixin, django.views.generic.detail.DetailView[pki.models.CaModel]

View to display the CMP certificate request page.

template_name = 'pki/issuing_cas/request_cert_cmp.html'

ca_type_filter

redirect_url_name = 'pki:issuing_cas-request-cert-cmp'

get_not_implemented_message()

Get the not implemented message for CMP.

Return type:

str

post(request, *_args, **_kwargs)

Handle POST request to request certificate via CMP.

Parameters:

• request (django.http.HttpRequest)

• _args (Any)

• _kwargs (Any)

Return type:

django.http.HttpResponse

class pki.views.issuing_cas.KeylessCaConfigView

Bases: trustpoint.logger.LoggerMixin, KeylessCaContextMixin, django.views.generic.detail.DetailView[pki.models.CaModel]

View to display the details of a Keyless CA.

http_method_names = ('get',)

model

success_url

ignore_url

template_name = 'pki/keyless_cas/config.html'

context_object_name = 'keyless_ca'

get_queryset()

Return only keyless CAs.

Return type:

django.db.models.QuerySet[pki.models.CaModel, pki.models.CaModel]

get_context_data(**kwargs)

Add active CRL information to the context.

Parameters:

kwargs (Any)

Return type:

dict[str, Any]

class pki.views.issuing_cas.IssuedCertificatesListView

Bases: IssuingCaContextMixin, django.views.generic.list.ListView[pki.models.CertificateModel]

View to display all certificates issued by a specific Issuing CA.

model

template_name = 'pki/issuing_cas/issued_certificates.html'

context_object_name = 'issued_certificates'

get_queryset()

Gets the required and filtered QuerySet.

Returns:

The filtered QuerySet.

Return type:

django.db.models.QuerySet[pki.models.CertificateModel, pki.models.CertificateModel]

get_context_data(**kwargs)

Adds the issuing ca model object to the context.

Parameters:

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

Returns:

The context to render the page.

Return type:

dict[str, Any]

class pki.views.issuing_cas.IssuingCaDetailView

Bases: IssuingCaContextMixin, django.views.generic.detail.DetailView[pki.models.CaModel]

Detail view for an Issuing CA.

model

success_url

ignore_url

template_name = 'pki/issuing_cas/details.html'

context_object_name = 'issuing_ca'

get_queryset()

Return only issuing CAs (excluding RAs and keyless CAs).

Return type:

django.db.models.QuerySet[pki.models.CaModel, pki.models.CaModel]

class pki.views.issuing_cas.IssuingCaBulkDeleteConfirmView

Bases: IssuingCaContextMixin, trustpoint.views.base.BulkDeleteView

View to confirm the deletion of multiple Issuing CAs.

model

success_url

ignore_url

template_name = 'pki/issuing_cas/confirm_delete.html'

context_object_name = 'issuing_cas'

get(request, *args, **kwargs)

Handle GET requests.

Parameters:

• request (django.http.HttpRequest)

• args (Any)

• kwargs (Any)

Return type:

django.http.HttpResponse

get_queryset()

Return only issuing CAs.

Return type:

django.db.models.QuerySet[pki.models.CaModel, pki.models.CaModel]

form_valid(form)

Delete the selected Issuing CAs on valid form.

Parameters:

form (django.forms.Form)

Return type:

django.http.HttpResponse

class pki.views.issuing_cas.IssuingCaCrlGenerationView

Bases: IssuingCaContextMixin, django.views.generic.detail.DetailView[pki.models.CaModel]

View to manually generate a CRL for an Issuing CA.

model

success_url

ignore_url

context_object_name = 'issuing_ca'

http_method_names = ('get',)

get_queryset()

Return only issuing CAs.

Return type:

django.db.models.QuerySet[pki.models.CaModel, pki.models.CaModel]

get(request, *args, **kwargs)

Generate a CRL for the Issuing CA (should be POST!).

Parameters:

• request (django.http.HttpRequest)

• args (Any)

• kwargs (Any)

Return type:

django.http.HttpResponse

class pki.views.issuing_cas.CrlDownloadView

Bases: IssuingCaContextMixin, django.views.generic.detail.DetailView[pki.models.CaModel]

Unauthenticated view to download the certificate revocation list of any CA.

http_method_names = ('get',)

model

success_url

ignore_url

context_object_name = 'ca'

get_queryset()

Return all CAs.

Return type:

django.db.models.QuerySet[pki.models.CaModel, pki.models.CaModel]

get(request, *args, **kwargs)

Download the CRL of the CA.

Parameters:

• request (django.http.HttpRequest)

• args (Any)

• kwargs (Any)

Return type:

django.http.HttpResponse

class pki.views.issuing_cas.IssuingCaViewSet(**kwargs)

Bases: trustpoint.logger.LoggerMixin, rest_framework.viewsets.ReadOnlyModelViewSet[pki.models.CaModel]

ViewSet for managing Issuing CA instances via REST API.

queryset

serializer_class

permission_classes

filter_backends

filterset_fields: ClassVar = ['unique_name', 'is_active']

search_fields: ClassVar = ['unique_name', 'credential__certificate__common_name']

ordering_fields: ClassVar = ['unique_name', 'created_at', 'updated_at']

list(_request)

API endpoint to get all Issuing CAs.

Parameters:

_request (rest_framework.request.Request)

Return type:

rest_framework.response.Response

retrieve(request)

API endpoint to get a single Issuing CA by ID.

Parameters:

request (rest_framework.request.Request)

Return type:

rest_framework.response.Response

generate_crl(_request, pk=None, **_kwargs)

Generate a new CRL for this Issuing CA.

Parameters:

• _request (rest_framework.request.Request)

• pk (int | None)

• _kwargs (Any)

Return type:

rest_framework.response.Response

crl(request, pk=None, **_kwargs)

Download the CRL for this Issuing CA.

Parameters:

• request (rest_framework.request.Request)

• pk (int | None)

• _kwargs (Any)

Return type:

rest_framework.response.Response | django.http.HttpResponse