Add app custom trust anchor CAPI headers

Change-Id: I59a3fa636deca37e1a3df27198d0bf3a6161f96c
Signed-off-by: sangwan.kwon <sangwan.kwon@samsung.com>

diff --git a/src/transec/acta/acta-error.h b/src/transec/acta/acta-error.h
new file mode 100644 (file)
index 0000000..5089b69
--- /dev/null
+++ b/src/transec/acta/acta-error.h
@@ -0,0 +1,55 @@
+/*
+ * Copyright (c) 2017 Samsung Electronics Co., Ltd All Rights Reserved
+ *
+ *    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.
+ */
+
+
+/**
+ * @file acta_error.h
+ * @brief Error enums and defines.
+ */
+
+
+#ifndef ACTA_ERROR_H
+#define ACTA_ERROR_H
+
+
+#include <errno.h>
+
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+
+#define ACTA_ERROR_BASE -0x01000000
+
+
+/**
+ * @brief Enumeration for ACTA error values.
+ */
+typedef enum {
+       ACTA_ERROR_NONE = 0,
+       ACTA_ERROR_INVALID_PARAMETER = -EINVAL,
+       ACTA_ERROR_OUT_OF_MEMORY = -ENOMEM,
+       ACTA_ERROR_INTERNAL = ACTA_ERROR_BASE | 0x01
+} acta_error_e;
+
+
+#ifdef __cplusplus
+} /* extern */
+#endif
+
+
+#endif /* ACTA_ERROR_H */

diff --git a/src/transec/acta/app-custom-trust-anchor.h b/src/transec/acta/app-custom-trust-anchor.h
new file mode 100644 (file)
index 0000000..810e172
--- /dev/null
+++ b/src/transec/acta/app-custom-trust-anchor.h
@@ -0,0 +1,152 @@
+/*
+ * Copyright (c) 2017 Samsung Electronics Co., Ltd All Rights Reserved
+ *
+ *    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.
+ */
+
+
+/**
+ * @file app-custom-trust-anchor.h
+ * @brief App custom trust anchor CAPI header.
+ */
+
+
+#ifndef APP_CUSTOM_TRUST_ANCHOR_H
+#define APP_CUSTOM_TRUST_ANCHOR_H
+
+
+#include <stddef.h>
+#include <sys/types.h>
+
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+
+/**
+ * @brief Install app custom trust anchor for global app.
+ * @details App custom certificates would be installed on system.
+ *          This function should be called before acta_global_launch().
+ * @param[in] package_id Global package id
+ * @param[in] app_certificates_path App custom certificates path
+ * @param[in] with_system_certificates Whether system certificates use or not
+ * @return #ACTA_ERROR_NONE on success,
+ *         negative on error
+ * @retval #ACTA_ERROR_NONE Successful
+ * @retval #ACTA_ERROR_OUT_OF_MEMORY Out of memory error
+ * @retval #ACTA_ERROR_INTERNAL Internal error
+ * @see acta_global_launch()
+ * @see acta_global_uninstall()
+ */
+int acta_global_install(const char *package_id,
+                                               const char *app_certificates_path,
+                                               bool with_system_certificates);
+
+
+/**
+ * @brief Install app custom trust anchor for user app.
+ * @details App custom certificates would be installed on system.
+ *          This function should be called before acta_usr_launch().
+ * @param[in] package_id User package id
+ * @param[in] app_certificates_path App custom certificates path
+ * @param[in] uid user id
+ * @param[in] with_system_certificates Whether system certificates use or not
+ * @return #ACTA_ERROR_NONE on success,
+ *         negative on error
+ * @retval #ACTA_ERROR_NONE Successful
+ * @retval #ACTA_ERROR_OUT_OF_MEMORY Out of memory error
+ * @retval #ACTA_ERROR_INTERNAL Internal error
+ * @see acta_usr_launch()
+ * @see acta_usr_uninstall()
+ */
+int acta_usr_install(const char *package_id,
+                                        const char *app_certificates_path,
+                                        uid_t uid,
+                                        bool with_system_certificates);
+
+
+/**
+ * @brief Launch app custom trust anchor for global app.
+ * @details After lauching app custom trust anchor, app can use custom certificates.
+ * @param[in] package_id Global package id
+ * @param[in] app_certificates_path App custom certificates path
+ * @param[in] with_system_certificates Whether system certificates use or not
+ * @return #ACTA_ERROR_NONE on success,
+ *         negative on error
+ * @retval #ACTA_ERROR_NONE Successful
+ * @retval #ACTA_ERROR_OUT_OF_MEMORY Out of memory error
+ * @retval #ACTA_ERROR_INTERNAL Internal error
+ * @see acta_global_install()
+ */
+int acta_global_launch(const char *package_id,
+                                          const char *app_certificates_path,
+                                          bool with_system_certificates);
+
+
+/**
+ * @brief Launch app custom trust anchor for user app.
+ * @details After lauching app custom trust anchor, app can use custom certificates.
+ * @param[in] package_id User package id
+ * @param[in] app_certificates_path App custom certificates path
+ * @param[in] with_system_certificates Whether system certificates use or not
+ * @return #ACTA_ERROR_NONE on success,
+ *         negative on error
+ * @retval #ACTA_ERROR_NONE Successful
+ * @retval #ACTA_ERROR_OUT_OF_MEMORY Out of memory error
+ * @retval #ACTA_ERROR_INTERNAL Internal error
+ * @see acta_global_install()
+ */
+int acta_usr_launch(const char *package_id,
+                                       const char *app_certificates_path,
+                                       uid_t uid,
+                                       bool with_system_certificates);
+
+
+/**
+ * @brief Uninstall app custom trust anchor for global app.
+ * @param[in] package_id Global package id
+ * @param[in] app_certificates_path App custom certificates path
+ * @return #ACTA_ERROR_NONE on success,
+ *         negative on error
+ * @retval #ACTA_ERROR_NONE Successful
+ * @retval #ACTA_ERROR_OUT_OF_MEMORY Out of memory error
+ * @retval #ACTA_ERROR_INTERNAL Internal error
+ * @see acta_global_install()
+ */
+int acta_global_uninstall(const char *package_id,
+                                                 const char *app_certificates_path);
+
+
+/**
+ * @brief Uninstall app custom trust anchor for user app.
+ * @param[in] package_id User package id
+ * @param[in] app_certificates_path App custom certificates path
+ * @return #ACTA_ERROR_NONE on success,
+ *         negative on error
+ * @retval #ACTA_ERROR_NONE Successful
+ * @retval #ACTA_ERROR_OUT_OF_MEMORY Out of memory error
+ * @retval #ACTA_ERROR_INTERNAL Internal error
+ * @see acta_usr_install()
+ */
+int acta_usr_uninstall(const char *package_id,
+                                          const char *app_certificates_path,
+                                          uid_t uid);
+
+
+#ifdef __cplusplus
+} /* extern */
+#endif
+
+
+#endif /* APP_CUSTOM_TRUST_ANCHOR_H */