cm: iamclient: add initial IAM client interface

Signed-off-by: Oleksandr Grytsov <[email protected]>

Author: al1img

src/core/cm/CMakeLists.txt

@@ -19,6 +19,7 @@ set(HEADERS config.hpp)
 set(INSTALL_HEADERS
     aos_core_cm_communication
     aos_core_cm_fileserver
+    aos_core_cm_iamclient
     aos_core_cm_imagemanager
     aos_core_cm_launcher
     aos_core_cm_networkmanager
@@ -28,7 +29,7 @@ set(INSTALL_HEADERS
     aos_core_cm_storagestate
 )
 
-set(INSTALL_LIBRARIES)
+set(INSTALL_LIBRARIES aos_core_cm_imagemanager aos_core_cm_storagestate)
 
 if(WITH_TEST)
     list(APPEND INSTALL_HEADERS aos_core_cm_tests_mocks)
@@ -53,6 +54,7 @@ set(TARGET_PREFIX ${TARGET_PREFIX}_cm)
 
 add_subdirectory(communication)
 add_subdirectory(fileserver)
+add_subdirectory(iamclient)
 add_subdirectory(imagemanager)
 add_subdirectory(launcher)
 add_subdirectory(networkmanager)

src/core/cm/iamclient/CMakeLists.txt

@@ -0,0 +1,31 @@
+#
+# Copyright (C) 2025 EPAM Systems, Inc.
+#
+# SPDX-License-Identifier: Apache-2.0
+#
+
+# ######################################################################################################################
+# Target name
+# ######################################################################################################################
+
+set(TARGET_NAME iamclient)
+
+# ######################################################################################################################
+# Headers
+# ######################################################################################################################
+
+set(HEADERS itf/iamclient.hpp)
+
+# ######################################################################################################################
+# Target
+# ######################################################################################################################
+
+add_module(TARGET_NAME ${TARGET_NAME} HEADERS ${HEADERS})
+
+# ######################################################################################################################
+# Tests
+# ######################################################################################################################
+
+if(WITH_TEST)
+    add_subdirectory(tests)
+endif()

src/core/cm/iamclient/iamclient.md

@@ -0,0 +1,45 @@
+# IAM client
+
+Provides access to IAM services.
+
+It implements the following interfaces:
+
+* [aos::iamclient::CertHandlerItf](../../common/iamclient/itf/certhandler.hpp) -
+  handles keys and certificates (renew, provisioning);
+* [aos::iamclient::CertProviderItf](../../common/iamclient/itf/certprovider.hpp) -
+  provides info about current keys and certificates;
+* [aos::iamclient::NodeHandlerItf](../../common/iamclient/itf/nodehandler.hpp) - handles nodes states (pause, resume);
+* [aos::iamclient::NodeInfoProviderItf](../../common/iamclient/itf/nodeinfoprovider.hpp) - provides nodes info;
+* [aos::iamclient::ProvisioningItf](../../common/iamclient/itf/provisioning.hpp) - performs node provisioning.
+
+```mermaid
+classDiagram
+    class IAMClient ["aos::cm::iamclient::IAMClient"] {
+    }
+
+    class CertHandlerItf ["aos::iamclient::CertHandlerItf"] {
+        <<interface>>
+    }
+
+    class CertProviderItf ["aos::iamclient::CertProviderItf"] {
+        <<interface>>
+    }
+
+    class NodeHandlerItf ["aos::iamclient::NodeHandlerItf"] {
+        <<interface>>
+    }
+
+    class NodeInfoProviderItf ["aos::iamclient::NodeInfoProviderItf"] {
+        <<interface>>
+    }
+
+    class ProvisioningItf ["aos::iamclient::ProvisioningItf"] {
+        <<interface>>
+    }
+
+    IAMClient <|.. CertHandlerItf
+    IAMClient <|.. CertProviderItf
+    IAMClient <|.. NodeHandlerItf
+    IAMClient <|.. NodeInfoProviderItf
+    IAMClient <|.. ProvisioningItf
+```

src/core/cm/iamclient/itf/iamclient.hpp

@@ -0,0 +1,41 @@
+/*
+ * Copyright (C) 2025 EPAM Systems, Inc.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#ifndef AOS_CORE_CM_IAMCLIENT_ITF_IAMCLIENT_HPP_
+#define AOS_CORE_CM_IAMCLIENT_ITF_IAMCLIENT_HPP_
+
+#include <core/common/iamclient/itf/certhandler.hpp>
+#include <core/common/iamclient/itf/certprovider.hpp>
+#include <core/common/iamclient/itf/nodehandler.hpp>
+#include <core/common/iamclient/itf/nodeinfoprovider.hpp>
+#include <core/common/iamclient/itf/provisioning.hpp>
+
+namespace aos::cm::iamclient {
+
+/** @addtogroup cm Communication Manager
+ *  @{
+ */
+
+/**
+ * IAM client interface.
+ */
+class IAMClientItf : public aos::iamclient::CertHandlerItf,
+                     public aos::iamclient::CertProviderItf,
+                     public aos::iamclient::NodeHandlerItf,
+                     public aos::iamclient::NodeInfoProviderItf,
+                     public aos::iamclient::ProvisioningItf {
+public:
+    /**
+     * Destructor.
+     */
+    virtual ~IAMClientItf() = default;
+};
+
+/** @}*/
+
+} // namespace aos::cm::iamclient
+
+#endif

src/core/cm/iamclient/tests/CMakeLists.txt

@@ -0,0 +1,33 @@
+#
+# Copyright (C) 2025 EPAM Systems, Inc.
+#
+# SPDX-License-Identifier: Apache-2.0
+#
+
+set(TARGET_NAME iamclient_test)
+
+# ######################################################################################################################
+# Sources
+# ######################################################################################################################
+
+set(SOURCES iamclient.cpp)
+
+# ######################################################################################################################
+# Libraries
+# ######################################################################################################################
+
+set(LIBRARIES GTest::gmock_main)
+
+# ######################################################################################################################
+# Target
+# ######################################################################################################################
+
+add_test(
+    TARGET_NAME
+    ${TARGET_NAME}
+    LOG_MODULE
+    SOURCES
+    ${SOURCES}
+    LIBRARIES
+    ${LIBRARIES}
+)

src/core/cm/iamclient/tests/iamclient.cpp

@@ -0,0 +1,7 @@
+/*
+ * Copyright (C) 2025 EPAM Systems, Inc.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+#include <core/cm/iamclient/itf/iamclient.hpp>