request.gds_push.gds_push_service
=================================

.. py:module:: request.gds_push.gds_push_service

.. autoapi-nested-parse::

   Service for OPC UA GDS Push operations.







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

.. py:exception:: GdsPushError

   Bases: :py:obj:`Exception`


   Exception raised for GDS Push operation failures.


.. py:class:: GdsPushService(device, *, insecure = False)

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


   Service for managing OPC UA GDS Push operations.

   This service handles secure communication with OPC UA servers and implements
   GDS Push workflows for certificate and trustlist management.

   Architecture:
   - Device provides connection info (IP, port)
   - Device's domain provides the CA hierarchy
   - Domain credential provides client authentication
   - Truststore (opc_trust_store) provides server validation
   - TrustList (CA chain + CRLs) gets pushed to server


   .. py:attribute:: device
      :type:  devices.models.DeviceModel


   .. py:attribute:: server_url
      :type:  str


   .. py:attribute:: domain_credential
      :type:  pki.models.IssuedCredentialModel | None


   .. py:attribute:: server_truststore
      :type:  pki.models.truststore.TruststoreModel | None


   .. py:method:: discover_server()
      :async:


      Discover OPC UA server information without authentication.

      :returns: bool, message: str, server_info: dict | None).
      :rtype: Tuple of (success



   .. py:method:: update_trustlist()
      :async:


      Update server trustlist with CA chain and CRLs.

      Implements OPC UA Part 12 Section 7.7.3 UpdateTrustList workflow.

      :returns: bool, message: str).
      :rtype: Tuple of (success



   .. py:method:: update_server_certificate()
      :async:


      Update server certificate using CSR-based workflow.

      Implements OPC UA Part 12 Section 7.7.4 UpdateCertificate workflow.

      :returns: bool, message: str, certificate: bytes | None).
      :rtype: Tuple of (success