SST: Add asset authentication token in the APIs

This patch adds asset authentication token in the APIs to be used in
the future for asset key derivation. It also updates all files which
depend on these APIs and their documentation

Change-Id: I53e193b3dd3151798588c5515cd5198270836acf
Signed-off-by: Marc Moreno <marc.morenoberengue@arm.com>
diff --git a/interface/include/tfm_sst_defs.h b/interface/include/tfm_sst_defs.h
index 52e41b3..5e1f869 100644
--- a/interface/include/tfm_sst_defs.h
+++ b/interface/include/tfm_sst_defs.h
@@ -54,6 +54,24 @@
 };
 
 /*!
+ * \struct tfm_sst_token_t
+ *
+ * \brief Structure to store the asset's token.
+ *
+ */
+struct tfm_sst_token_t {
+    const uint8_t  *token;  /*!< Pointer to the asset's token to be used to
+                             *   generate the asset key to encrypt and decrypt
+                             *   the asset data. This is an optional parameter
+                             *   that has to be NULL in case the token is not
+                             *   provied.
+                             */
+    uint32_t token_size;    /*!< Token size. In case the token is not provided
+                             *   the token size has to be 0.
+                             */
+};
+
+/*!
  * \struct tfm_sst_buf_t
  *
  * \brief Structure to store data information to read/write from/to asset.