request.clients.est_client
==========================

.. py:module:: request.clients.est_client

.. autoapi-nested-parse::

   EST (Enrollment over Secure Transport) client implementation.









Module Contents
---------------

.. py:data:: DEFAULT_EST_PORT
   :value: 443


.. py:data:: DEFAULT_EST_TIMEOUT
   :value: 30


.. py:exception:: EstClientError

   Bases: :py:obj:`Exception`


   Base exception for EST client errors.


.. py:class:: EstClient(context, timeout = DEFAULT_EST_TIMEOUT)

   Bases: :py:obj:`trustpoint.logger.LoggerMixin`


   EST client for communicating with EST servers according to RFC 7030.

   This client implements the EST protocol for certificate enrollment,
   specifically supporting the simpleenroll operation.

   The client uses an EstBaseRequestContext to configure the connection
   and authentication parameters.


   .. py:attribute:: context


   .. py:attribute:: timeout
      :value: 30



   .. py:method:: simple_enroll(csr)

      Perform simple enrollment by sending a CSR to the EST server.

      This implements the /simpleenroll operation defined in RFC 7030 section 4.2.

      :param csr: The Certificate Signing Request to enroll.

      :returns: The issued certificate from the EST server.

      :raises EstClientError: If the enrollment fails.



   .. py:method:: get_ca_certs()

      Retrieve CA certificates from the EST server.

      This implements the /cacerts operation defined in RFC 7030 section 4.1.

      :returns: List of CA certificates from the server.

      :raises EstClientError: If the operation fails.