Diff: simple-mbed-cloud-client/mbed-cloud-client/source/include/EstClient.h

Revision:

0:8f0bb79ddd48

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/simple-mbed-cloud-client/mbed-cloud-client/source/include/EstClient.h	Tue May 04 08:55:12 2021 +0000
@@ -0,0 +1,90 @@
+// ----------------------------------------------------------------------------
+// Copyright 2018 ARM Ltd.
+//
+// SPDX-License-Identifier: Apache-2.0
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+// ----------------------------------------------------------------------------
+
+#ifndef __EST_CLIENT_H__
+#define __EST_CLIENT_H__
+
+#include "mbed-client/m2minterface.h"
+#include "est_defs.h"
+
+#include <stdint.h>
+#include <stddef.h>
+
+class ConnectorClient;
+
+/**
+ * \brief EstClient
+ * This class is an interface towards the EST service and is used to enroll
+ * certificates using a CSR.
+ */
+class EstClient {
+
+public:
+
+    /**
+     * \brief Constructor.
+     */
+    EstClient(ConnectorClient& connector_client);
+
+    /**
+     * \brief Destructor.
+     */
+    ~EstClient();
+
+    /**
+     * \brief Request certificate enrollment from the EST service.
+     * \param cert_name, The name of certificate to enroll. Null enrolls a LwM2M certificate.
+     * \param cert_name_length, The length of cert_name buffer.
+     * \param csr_length, The length of the certificate signing request within csr buffer.
+     * \param csr, A buffer containing the certificate signing request.
+     * \param result_cb, The callback function that is called when EST enrollment has completed.
+     * \param context, The user context that is passed to the result_cb callback.
+     */
+    est_status_e est_request_enrollment(const char *cert_name,
+                                        const size_t cert_name_length,
+                                        uint8_t *csr,
+                                        const size_t csr_length,
+                                        est_enrollment_result_cb result_cb,
+                                        void *context) const;
+
+    static void free_cert_chain_context(cert_chain_context_s *context);
+
+protected:
+    static void est_post_data_cb(const uint8_t *buffer,
+                                 size_t buffer_size,
+                                 size_t total_size,
+                                 bool last_block,
+                                 void *context);
+
+    static void est_post_data_error_cb(get_data_req_error_t error_code,
+                                       void *context);
+
+private:
+
+    static char* make_est_uri(const char *cert_name,
+                              const size_t cert_name_length);
+
+    static cert_chain_context_s* parse_cert_chain(uint8_t *cert_chain_data,
+                                                  uint16_t cert_chain_data_len);
+
+private:
+    ConnectorClient           &_connector_client;
+
+};
+
+#endif // !__EST_CLIENT_H__