add: add get_report_tls_certificates GMP request

Implement the get_report_tls_certificates GMP request command.

Add unit tests to verify required arguments, filters,
pagination handling, and details output.

Author: ozgen

gvm/protocols/gmp/_gmpnext.py

@@ -24,6 +24,7 @@
     ReportHosts,
     ReportOperatingSystems,
     ReportPorts,
+    ReportTlsCertificates,
     Tasks,
 )
 from .requests.v224 import HostsOrdering
@@ -1088,6 +1089,36 @@ def get_report_ports(
             )
         )
 
+    def get_report_tls_certificates(
+        self,
+        report_id: EntityID,
+        *,
+        filter_string: str | None = None,
+        filter_id: str | None = None,
+        ignore_pagination: bool | None = None,
+        details: bool | None = True,
+    ) -> T:
+        """Request TLS certificates of a single report.
+
+        Args:
+            report_id: UUID of an existing report.
+            filter_string: Filter term to use to filter results in the report
+            filter_id: UUID of filter to use to filter results in the report
+            ignore_pagination: Whether to ignore the filter terms "first" and
+                "rows".
+            details: Request additional report TLS certificate information details.
+                Defaults to True.
+        """
+        return self._send_request_and_transform_response(
+            ReportTlsCertificates.get_report_tls_certificates(
+                report_id=report_id,
+                filter_string=filter_string,
+                filter_id=filter_id,
+                ignore_pagination=ignore_pagination,
+                details=details,
+            )
+        )
+
     def get_report_applications(
         self,
         report_id: EntityID,

gvm/protocols/gmp/requests/next/__init__.py

@@ -29,6 +29,9 @@
 from gvm.protocols.gmp.requests.next._report_ports import (
     ReportPorts,
 )
+from gvm.protocols.gmp.requests.next._report_tls_certificates import (
+    ReportTlsCertificates,
+)
 from gvm.protocols.gmp.requests.next._tasks import Tasks
 
 from .._entity_id import EntityID
@@ -156,6 +159,7 @@
     "ReportHosts",
     "ReportOperatingSystems",
     "ReportPorts",
+    "ReportTlsCertificates",
     "Reports",
     "ResourceNames",
     "ResourceType",

gvm/protocols/gmp/requests/next/_report_tls_certificates.py

@@ -0,0 +1,47 @@
+from gvm.errors import RequiredArgument
+from gvm.protocols.core import Request
+from gvm.protocols.gmp.requests import EntityID
+from gvm.utils import to_bool
+from gvm.xml import XmlCommand
+
+
+class ReportTlsCertificates:
+    @classmethod
+    def get_report_tls_certificates(
+        cls,
+        report_id: EntityID,
+        *,
+        filter_string: str | None = None,
+        filter_id: str | None = None,
+        ignore_pagination: bool | None = None,
+        details: bool | None = True,
+    ) -> Request:
+        """Request TLS certificates of a single report.
+
+        Args:
+            report_id: UUID of an existing report.
+            filter_string: Filter term to use to filter results in the report
+            filter_id: UUID of filter to use to filter results in the report
+            ignore_pagination: Whether to ignore the filter terms "first" and
+                "rows".
+            details: Request additional report TLS certificate information details.
+                Defaults to True.
+        """
+        cmd = XmlCommand("get_report_tls_certificates")
+
+        if not report_id:
+            raise RequiredArgument(
+                function=cls.get_report_tls_certificates.__name__,
+                argument="report_id",
+            )
+
+        cmd.set_attribute("report_id", str(report_id))
+
+        cmd.add_filter(filter_string, filter_id)
+
+        if ignore_pagination is not None:
+            cmd.set_attribute("ignore_pagination", to_bool(ignore_pagination))
+
+        cmd.set_attribute("details", to_bool(details))
+
+        return cmd

tests/protocols/gmpnext/entities/report_tls_certificates/test_get_report_tls_certificates.py

@@ -0,0 +1,61 @@
+# SPDX-FileCopyrightText: 2026 Greenbone AG
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+
+from gvm.errors import RequiredArgument
+
+
+class GmpGetReportTlsCertificatesTestMixin:
+    def test_get_report_tls_certificates_without_id(self):
+        with self.assertRaises(RequiredArgument):
+            self.gmp.get_report_tls_certificates(None)
+
+        with self.assertRaises(RequiredArgument):
+            self.gmp.get_report_tls_certificates("")
+
+    def test_get_report_tls_certificates_with_filter_string(self):
+        self.gmp.get_report_tls_certificates(
+            report_id="r1", filter_string="name=foo"
+        )
+
+        self.connection.send.has_been_called_with(
+            b'<get_report_tls_certificates report_id="r1" filter="name=foo" details="1"/>'
+        )
+
+    def test_get_report_tls_certificates_with_filter_id(self):
+        self.gmp.get_report_tls_certificates(report_id="r1", filter_id="f1")
+
+        self.connection.send.has_been_called_with(
+            b'<get_report_tls_certificates report_id="r1" filt_id="f1" details="1"/>'
+        )
+
+    def test_get_report_tls_certificates_with_ignore_pagination(self):
+        self.gmp.get_report_tls_certificates(
+            report_id="r1", ignore_pagination=True
+        )
+
+        self.connection.send.has_been_called_with(
+            b'<get_report_tls_certificates report_id="r1" ignore_pagination="1" details="1"/>'
+        )
+
+        self.gmp.get_report_tls_certificates(
+            report_id="r1", ignore_pagination=False
+        )
+
+        self.connection.send.has_been_called_with(
+            b'<get_report_tls_certificates report_id="r1" ignore_pagination="0" details="1"/>'
+        )
+
+    def test_get_report_tls_certificates_with_details(self):
+        self.gmp.get_report_tls_certificates(report_id="r1", details=True)
+
+        self.connection.send.has_been_called_with(
+            b'<get_report_tls_certificates report_id="r1" details="1"/>'
+        )
+
+        self.gmp.get_report_tls_certificates(report_id="r1", details=False)
+
+        self.connection.send.has_been_called_with(
+            b'<get_report_tls_certificates report_id="r1" details="0"/>'
+        )

tests/protocols/gmpnext/entities/test_report_tls_certificates.py

@@ -0,0 +1,15 @@
+# SPDX-FileCopyrightText: 2026 Greenbone AG
+#
+# SPDX-License-Identifier: GPL-3.0-or-later
+#
+
+from ...gmpnext import GMPTestCase
+from .report_tls_certificates.test_get_report_tls_certificates import (
+    GmpGetReportTlsCertificatesTestMixin,
+)
+
+
+class GmpGetReportTlsCertificatesTestCase(
+    GmpGetReportTlsCertificatesTestMixin, GMPTestCase
+):
+    pass