Genericrequest

plugins/action/auth_token.py

@@ -0,0 +1,32 @@
+# Copyright 2024, Itential Inc. All Rights Reserved
+
+# GNU General Public License v3.0+ (see LICENSES/GPL-3.0-or-later.txt or https://www.gnu.org/licenses/gpl-3.0.txt)
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+# Generates an auth token. No parameters required.
+# Example:
+#   - name: Generate auth token
+#     itential.platform.auth_token:
+
+from ansible.plugins.action import ActionBase
+from ansible.module_utils.common import yaml
+from ansible_collections.itential.platform.plugins.module_utils.login import login
+from ansible_collections.itential.platform.plugins.module_utils import host as spec
+from ansible_collections.itential.core.plugins.module_utils import hosts
+
+class ActionModule(ActionBase):
+
+    _supports_check_mode = False
+    _supports_async = False
+    _requires_connection = False
+
+    def run(self, tmp=None, task_vars=None):
+        inventory_hostname = task_vars["inventory_hostname"]
+        hostvars = task_vars["hostvars"].get(inventory_hostname)
+
+        schema = yaml.yaml_load(spec.DOCUMENTATION)
+        host = hosts.new(schema, hostvars)
+
+        auth_token = login(host)
+
+        return {"auth_token": auth_token}

plugins/action/generic_request.py

@@ -0,0 +1,34 @@
+# Copyright 2024, Itential Inc. All Rights Reserved
+
+# GNU General Public License v3.0+ (see LICENSES/GPL-3.0-or-later.txt or https://www.gnu.org/licenses/gpl-3.0.txt)
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+from ansible.plugins.action import ActionBase
+from ansible.errors import AnsibleError
+from ansible_collections.itential.platform.plugins.module_utils.request import make_request
+
+class ActionModule(ActionBase):
+
+    _supports_check_mode = False
+    _supports_async = False
+    _requires_connection = False
+
+    ALLOWED_METHODS = {"GET", "PUT", "POST", "DELETE"}
+
+    def run(self, tmp=None, task_vars=None):
+
+        module_args = self._task.args
+
+        method = module_args.get("method", "GET")
+        endpoint = module_args.get("endpoint")
+
+        if method not in self.ALLOWED_METHODS:
+            raise AnsibleError(f"Invalid HTTP method '{method}'. Allowed values: {', '.join(self.ALLOWED_METHODS)}")
+
+        if not endpoint:
+            raise AnsibleError("'endpoint' must be provided.")
+
+        params = module_args.get("params", None)
+        data = module_args.get("data", None)
+
+        return make_request(task_vars, method, endpoint, params=params, data=data)

plugins/modules/auth_token.py

@@ -0,0 +1,37 @@
+#!/usr/bin/python
+
+# Copyright 2024, Itential Inc. All Rights Reserved
+# GNU General Public License v3.0+ (see LICENSES/GPL-3.0-or-later.txt or https://www.gnu.org/licenses/gpl-3.0.txt)
+# SPDX-License-Identifier: GPL-3.0-or-later
+
+from __future__ import absolute_import, division, print_function
+
+__metaclass__ = type
+
+DOCUMENTATION = """
+---
+module: itential.platform.auth_token
+author: Itential
+
+short_description: Generate an authentication token for IAP.
+
+description:
+  - The M(itential.platform.auth_token) module generates an authentication token for an IAP system.
+  - This token can be used to authenticate API requests within the platform.
+  - The module does not require any input parameters.
+
+options: {}
+
+"""
+
+EXAMPLES = """
+  - name: Generate auth token
+    itential.platform.auth_token:
+"""
+
+RETURN = """
+auth_token:
+  description: The generated authentication token.
+  type: str
+  returned: always
+"""