feat(jira): return projects in test_connection (#8634)

Author: pedrooot

prowler/CHANGELOG.md

@@ -5,24 +5,8 @@ All notable changes to the **Prowler SDK** are documented in this file.
 
 ### Added
 - Get Jira Project's metadata [(#8630)](https://github.com/prowler-cloud/prowler/pull/8630)
-
-
-### Changed
-
-### Fixed
-
----
-
-## [v5.11.1] (Prowler UNRELEASED)
-
-### Fixed
-
----
-
-## [v5.12.0] (Prowler UNRELEASED)
-
-### Added
 - Add more fields for the Jira ticket and handle custom fields errors [(#8601)](https://github.com/prowler-cloud/prowler/pull/8601)
+- Get Jira projects from test_connection [(#8634)](https://github.com/prowler-cloud/prowler/pull/8634)
 
 ### Changed
 

prowler/lib/outputs/jira/jira.py

@@ -1,5 +1,6 @@
 import base64
 import os
+from dataclasses import dataclass
 from datetime import datetime, timedelta
 from typing import Dict
 
@@ -35,6 +36,17 @@
 from prowler.providers.common.models import Connection
 
 
+@dataclass
+class JiraConnection(Connection):
+    """
+    Represents a Jira connection object.
+    Attributes:
+        projects (dict): Dictionary of projects in Jira.
+    """
+
+    projects: dict = None
+
+
 class Jira:
     """
     Jira class to interact with the Jira API
@@ -463,7 +475,7 @@ def test_connection(
         api_token: str = None,
         domain: str = None,
         raise_on_exception: bool = True,
-    ) -> Connection:
+    ) -> JiraConnection:
         """Test the connection to Jira
 
         Args:
@@ -476,14 +488,16 @@ def test_connection(
             - raise_on_exception: Whether to raise an exception or not
 
         Returns:
-            - Connection: The connection object
+            - JiraConnection: The connection object
 
         Raises:
             - JiraGetCloudIDNoResourcesError: No resources were found in Jira when getting the cloud id
             - JiraGetCloudIDResponseError: Failed to get the cloud ID, response code did not match 200
             - JiraGetCloudIDError: Failed to get the cloud ID from Jira
             - JiraAuthenticationError: Failed to authenticate
             - JiraTestConnectionError: Failed to test the connection
+            - JiraNoProjectsError: No projects found in Jira
+            - JiraGetProjectsResponseError: Failed to get projects from Jira, response code did not match 200
         """
         try:
             jira = Jira(
@@ -494,68 +508,59 @@ def test_connection(
                 api_token=api_token,
                 domain=domain,
             )
-            access_token = jira.get_access_token()
-
-            if not access_token:
-                return ValueError("Failed to get access token")
-
-            if jira.using_basic_auth:
-                headers = {"Authorization": f"Basic {access_token}"}
-            else:
-                headers = {"Authorization": f"Bearer {access_token}"}
-
-            response = requests.get(
-                f"https://api.atlassian.com/ex/jira/{jira.cloud_id}/rest/api/3/myself",
-                headers=headers,
-            )
+            projects = jira.get_projects()
 
-            if response.status_code == 200:
-                return Connection(is_connected=True)
-            else:
-                return Connection(is_connected=False, error=response.json())
-        except JiraGetCloudIDNoResourcesError as no_resources_error:
+            return JiraConnection(is_connected=True, projects=projects)
+        except JiraNoProjectsError as no_projects_error:
             logger.error(
-                f"{no_resources_error.__class__.__name__}[{no_resources_error.__traceback__.tb_lineno}]: {no_resources_error}"
+                f"{no_projects_error.__class__.__name__}[{no_projects_error.__traceback__.tb_lineno}]: {no_projects_error}"
             )
             if raise_on_exception:
-                raise no_resources_error
-            return Connection(error=no_resources_error)
+                raise no_projects_error
+            return JiraConnection(error=no_projects_error)
         except JiraGetCloudIDResponseError as response_error:
             logger.error(
                 f"{response_error.__class__.__name__}[{response_error.__traceback__.tb_lineno}]: {response_error}"
             )
             if raise_on_exception:
                 raise response_error
-            return Connection(error=response_error)
+            return JiraConnection(error=response_error)
         except JiraGetCloudIDError as cloud_id_error:
             logger.error(
                 f"{cloud_id_error.__class__.__name__}[{cloud_id_error.__traceback__.tb_lineno}]: {cloud_id_error}"
             )
             if raise_on_exception:
                 raise cloud_id_error
-            return Connection(error=cloud_id_error)
+            return JiraConnection(error=cloud_id_error)
         except JiraAuthenticationError as auth_error:
             logger.error(
                 f"{auth_error.__class__.__name__}[{auth_error.__traceback__.tb_lineno}]: {auth_error}"
             )
             if raise_on_exception:
                 raise auth_error
-            return Connection(error=auth_error)
+            return JiraConnection(error=auth_error)
         except JiraBasicAuthError as basic_auth_error:
             logger.error(
                 f"{basic_auth_error.__class__.__name__}[{basic_auth_error.__traceback__.tb_lineno}]: {basic_auth_error}"
             )
             if raise_on_exception:
                 raise basic_auth_error
-            return Connection(error=basic_auth_error)
+            return JiraConnection(error=basic_auth_error)
+        except JiraGetProjectsResponseError as projects_response_error:
+            logger.error(
+                f"{projects_response_error.__class__.__name__}[{projects_response_error.__traceback__.tb_lineno}]: {projects_response_error}"
+            )
+            if raise_on_exception:
+                raise projects_response_error
+            return JiraConnection(error=projects_response_error)
         except Exception as error:
             logger.error(f"Failed to test connection: {error}")
             if raise_on_exception:
                 raise JiraTestConnectionError(
                     message="Failed to test connection on the Jira integration",
                     file=os.path.basename(__file__),
                 )
-            return Connection(is_connected=False, error=error)
+            return JiraConnection(is_connected=False, error=error)
 
     def get_projects(self) -> Dict[str, str]:
         """Get the projects from Jira