DOC-3143: add partial file for expected data structure for auth token.

Author: kemister85

modules/ROOT/pages/exportpdf.adoc

@@ -49,7 +49,7 @@ For more infomation on the exportpdf_token_provider option, see xref:exportpdf.a
 The {pluginname} plugin **requires** JWT authentication when using the {companyname} Cloud service.
 
 * Configure the `{plugincode}_token_provider` option to specify the endpoint for retrieving a valid JWT token.
-* If hosting locally, use the format `+http://localhost:[port]/jwt+`, ensuring the endpoint returns a JSON object containing the token.
+* If hosting locally, use the format `+http://localhost:[port]/jwt+`, ensuring the endpoint returns a xref:importword.adoc#data-structure[valid JSON object] containing the token.
 
 For more information on how to set up JWT authentication with {pluginname}, see examples:
 
@@ -64,6 +64,8 @@ For more information on how to set up JWT authentication with {pluginname}, see
 * Attempting to use JWT authentication during the trial will result in an _error_.
 ====
 
+include::partial$misc/admon-document-converters-jwt-expected-data-structure.adoc[]
+
 == Basic setup using the self-hosted service
 
 To use the self-hosted version of the {pluginname} plugin, you need to set the `exportpdf_service_url` option to the URL of the service.

modules/ROOT/pages/exportword.adoc

@@ -55,7 +55,7 @@ For more infomation on the exportword_token_provider option, see xref:exportword
 The {pluginname} plugin **requires** JWT authentication when using the {companyname} Cloud service.
 
 * Configure the `{plugincode}_token_provider` option to specify the endpoint for retrieving a valid JWT token.
-* If hosting locally, use the format `+http://localhost:[port]/jwt+`, ensuring the endpoint returns a JSON object containing the token.
+* If hosting locally, use the format `+http://localhost:[port]/jwt+`, ensuring the endpoint returns a xref:exportword.adoc#data-structure[valid JSON object] containing the token.
 
 For more information on how to set up JWT authentication with {pluginname}, see examples:
 
@@ -70,6 +70,8 @@ For more information on how to set up JWT authentication with {pluginname}, see
 * Attempting to use JWT authentication during the trial will result in an _error_.
 ====
 
+include::partial$misc/admon-document-converters-jwt-expected-data-structure.adoc[]
+
 
 
 

modules/ROOT/pages/importword.adoc

@@ -50,7 +50,7 @@ For more infomation on the importword_token_provider option, see xref:importword
 The {pluginname} plugin **requires** JWT authentication when using the {companyname} Cloud service.
 
 * Configure the `{plugincode}_token_provider` option to specify the endpoint for retrieving a valid JWT token.
-* If hosting locally, use the format `+http://localhost:[port]/jwt+`, ensuring the endpoint returns a JSON object containing the token.
+* If hosting locally, use the format `+http://localhost:[port]/jwt+`, ensuring the endpoint returns a xref:importword.adoc#data-structure[valid JSON object] containing the token.
 
 For more information on how to set up JWT authentication with {pluginname}, see examples:
 
@@ -65,6 +65,8 @@ For more information on how to set up JWT authentication with {pluginname}, see
 * Attempting to use JWT authentication during the trial will result in an _error_.
 ====
 
+include::partial$misc/admon-document-converters-jwt-expected-data-structure.adoc[]
+
 == Basic setup using the self-hosted service
 
 To use the self-hosted version of the {pluginname} plugin, you need to set the `importword_service_url` option to the URL of the service.

modules/ROOT/partials/misc/admon-document-converters-jwt-expected-data-structure.adoc

@@ -0,0 +1,16 @@
+== Data structure
+
+The JSON data containing the valid encoded token must match the following structure:
+
+[source,json]
+----
+{
+  "token": "<encoded JWT string>"
+}
+----
+
+[cols="1,1,1,3",options="header"]
+|===
+|Field |Type |Required? |Description
+|`+token+` |`+string+` |required |A Base64-encoded JSON Web Token (JWT) used for authentication and authorization.
+|===