diff --git a/api-tokens/object.html b/api-tokens/object.html new file mode 100644 index 0000000..5f53b64 --- /dev/null +++ b/api-tokens/object.html @@ -0,0 +1,36 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/api-tokens/object.json b/api-tokens/object.json new file mode 100644 index 0000000..cf61ce5 --- /dev/null +++ b/api-tokens/object.json @@ -0,0 +1,109 @@ +{ + "name": "API Tokens", + "image": "object.png", + "readme": "object.md", + "statuses": [ + { + "id": "s-a-pending", + "name": "Pending", + "mapping": { + "left": "21.87%", + "top": "20.14%", + "width": "15.18%", + "height": "24.75%" + } + }, + { + "id": "s-b-active", + "name": "Active", + "mapping": { + "left": "51.65%", + "top": "19.71%", + "width": "15.18%", + "height": "24.75%" + } + }, + { + "id": "s-c-inactive", + "name": "Inactive", + "mapping": { + "left": "82.86%", + "top": "19.6%", + "width": "15.18%", + "height": "24.75%" + } + }, + { + "id": "s-d-deleted", + "name": "Deleted", + "mapping": { + "left": "51.85%", + "top": "71.34%", + "width": "15.18%", + "height": "24.75%" + } + } + ], + "transitions": [ + { + "id": "t-1-new-pending", + "from": "New", + "to": "Pending", + "name": "1. Token Creation", + "mapping": { + "left": "11.4%", + "top": "21.69%", + "width": "8.86%", + "height": "8.62%" + } + }, + { + "id": "t-2-pen-active", + "from": "Pending", + "to": "Active", + "name": "2. Token Activation", + "mapping": { + "left": "39.97%", + "top": "21.69%", + "width": "8.86%", + "height": "8.62%" + } + }, + { + "id": "t-3-act-inactive", + "from": "Active", + "to": "Inactive", + "name": "3. Token Deactivation", + "mapping": { + "left": "70.76%", + "top": "22.44%", + "width": "8.86%", + "height": "8.62%" + } + }, + { + "id": "t-4-in-active", + "from": "Inactive", + "to": "Active", + "name": "4. Token Reactivation", + "mapping": { + "left": "70.59%", + "top": "0.32%", + "width": "8.86%", + "height": "8.62%" + } + }, + { + "id": "t-5-token-deleted", + "from": "Pending", + "to": "Deleted", + "name": "5. Token Removal", + "mapping": { + "left": "53.26%", + "top": "54.31%", + "width": "11.77%", + "height": "9.27%" + } + } + ] + } diff --git a/api-tokens/object.md b/api-tokens/object.md new file mode 100644 index 0000000..e309a8e --- /dev/null +++ b/api-tokens/object.md @@ -0,0 +1,8 @@ +# Token Objects +## Overview +Tokens represent objects on the CloudBlue Connect platform that are generated by platform users for various operations and implementing integrations through API. Namely, a token object contains *API Key/Handle* that allows applications to bypass the authorization and access the required API. +It is highly important to note that token objects are assigned to module permissions on Connect. Such permissions can be disabled or enabled for each individual module on the platform. Thus, for example, in case your application tries to access a module with disabled permissions, it will return the corresponding error. +Token objects can also be assigned to different extensions that are provided by the Connect platform. However, the workflow of such tokens remains the same. + +## Learn more +Refer to the [API Tokens documentation](https://connect.cloudblue.com/community/modules/extensions/api-tokens/) to learn how to create and manage your tokens. diff --git a/api-tokens/object.png b/api-tokens/object.png new file mode 100644 index 0000000..58dcb66 Binary files /dev/null and b/api-tokens/object.png differ diff --git a/api-tokens/object.pptx b/api-tokens/object.pptx new file mode 100644 index 0000000..06e5d10 Binary files /dev/null and b/api-tokens/object.pptx differ diff --git a/api-tokens/s-a-pending.md b/api-tokens/s-a-pending.md new file mode 100644 index 0000000..56e7fe2 --- /dev/null +++ b/api-tokens/s-a-pending.md @@ -0,0 +1,12 @@ +# Pending Status +## Description +Once a new token is created, the system assigns the *Pending* status to this object. This status indicates that the system is processing your token object. Therefore, when the system successfully processes your token, it will be assigned to the following state. +## Prerequisites +A new created token object is required. +## Transferable statuses +Once the system processes the pending token object, it is assigned to the [Active](s-b-active.html) state. +In case operators decide to delete their pending token, this token is assigned to the [Deleted](s-d-deleted.html) state. +## Associated transitions +* [Token Creation](t-1-new-pending.html) +* [Token Activation](t-2-pen-active.html) +* [Token Removal](t-5-token-deleted.html) diff --git a/api-tokens/s-a-pending.png b/api-tokens/s-a-pending.png new file mode 100644 index 0000000..b22819a Binary files /dev/null and b/api-tokens/s-a-pending.png differ diff --git a/api-tokens/s-b-active.md b/api-tokens/s-b-active.md new file mode 100644 index 0000000..7a3fc9b --- /dev/null +++ b/api-tokens/s-b-active.md @@ -0,0 +1,14 @@ +# Active Status +## Description +The *Active* status indicates that your API token can be used for subsequent operations. This status is automatically assigned to pending token objects by the system, once they are processed successfully. The system enables users to disable their active tokens. Users can also reactivate their inactive tokens if necessary. +## Prerequisites +A new token with the [Pending](s-a-pending.html) status. +Operators can also reactivate their tokens in the [Inactive](s-c-inactive.html) state. +## Transferable statuses +In case your token object is disabled, it is transferred to the [Inactive](s-c-inactive.html) state. +If operators decide to delete their active token, this token is assigned to the [Deleted](s-d-deleted.html) state. +## Associated transitions +* [Token Activation](t-2-pen-active.html) +* [Token Deactivation](t-3-act-inactive.html) +* [Token Reactivation](t-4-in-active.html) +* [Token Removal](t-5-token-deleted.html) diff --git a/api-tokens/s-b-active.png b/api-tokens/s-b-active.png new file mode 100644 index 0000000..b8b9e8c Binary files /dev/null and b/api-tokens/s-b-active.png differ diff --git a/api-tokens/s-c-inactive.md b/api-tokens/s-c-inactive.md new file mode 100644 index 0000000..6b0690d --- /dev/null +++ b/api-tokens/s-c-inactive.md @@ -0,0 +1,12 @@ +# Inactive Status +## Description +In case operators disable their token on the Connect platform, the system assigns the *Inactive* status to this token. This status indicates that your token cannot be used for integrations or any other operations with API. In case an inactive token is used for such operations, the system will return an error. Inactive tokens can be activated again or removed if necessary +## Prerequisites +A token object with the [Active](s-b-active.html) status. +# Transferable statuses +In case your token object is enabled again, the system transfers it the [Active](s-b-active.html) state. +If operators decide to delete their inactive token, this token is assigned to the [Deleted](s-d-deleted.html) state. +## Associated transitions +* [Token Deactivation](t-3-act-inactive.html) +* [Token Reactivation](t-4-in-active.html) +* [Token Removal](t-5-token-deleted.html) diff --git a/api-tokens/s-c-inactive.png b/api-tokens/s-c-inactive.png new file mode 100644 index 0000000..b6cc965 Binary files /dev/null and b/api-tokens/s-c-inactive.png differ diff --git a/api-tokens/s-d-deleted.md b/api-tokens/s-d-deleted.md new file mode 100644 index 0000000..2d55459 --- /dev/null +++ b/api-tokens/s-d-deleted.md @@ -0,0 +1,7 @@ +# Deleted Status +## Description +The *Deleted* status, as the name implies, is displayed in case operators removed their token. Therefore, this token cannot be used for any operations with API. Note that *Deleted* status represents a terminal state. However, the system allows reviewing creation date, assigned permissions and other general object data of your deleted tokens. +## Prerequisites +A token object in the [Active](s-b-active.html), [Inactive](s-c-inactive.html) , or [Pending](s-a-pending.html) state. +## Associated transitions +* [Token Removal](t-5-token-deleted.html) diff --git a/api-tokens/s-d-deleted.png b/api-tokens/s-d-deleted.png new file mode 100644 index 0000000..64a46d8 Binary files /dev/null and b/api-tokens/s-d-deleted.png differ diff --git a/api-tokens/t-1-new-pending.md b/api-tokens/t-1-new-pending.md new file mode 100644 index 0000000..c4424fb --- /dev/null +++ b/api-tokens/t-1-new-pending.md @@ -0,0 +1,7 @@ +# Token Creation +## Description +This transition indicates that a new token object is generated on the CloudBlue Connect platform. Therefore, the system starts processing this token assigns it to the *Pending* state. +## Prerequisites +A new generated token object is required for this transition. +## Operation results +A token object with the [Pending](s-a-pending.html) status. diff --git a/api-tokens/t-1-new-pending.png b/api-tokens/t-1-new-pending.png new file mode 100644 index 0000000..1fb9ffb Binary files /dev/null and b/api-tokens/t-1-new-pending.png differ diff --git a/api-tokens/t-2-pen-active.md b/api-tokens/t-2-pen-active.md new file mode 100644 index 0000000..d6051be --- /dev/null +++ b/api-tokens/t-2-pen-active.md @@ -0,0 +1,7 @@ +# Token Activation +## Description +This transition indicates that the system successfully processed a pending token on the Connect platform. Consequently, this token is automatically assigned to the *Active* state and can be used for the following operations through API. +## Prerequisites +A token object with [Pending](s-a-pending.html) status is required for this transition. +## Operation results +A token object in the [Active](s-b-active.html) state. diff --git a/api-tokens/t-2-pen-active.png b/api-tokens/t-2-pen-active.png new file mode 100644 index 0000000..177adb4 Binary files /dev/null and b/api-tokens/t-2-pen-active.png differ diff --git a/api-tokens/t-3-act-inactive.md b/api-tokens/t-3-act-inactive.md new file mode 100644 index 0000000..886b108 --- /dev/null +++ b/api-tokens/t-3-act-inactive.md @@ -0,0 +1,7 @@ +# Token Deactivation +## Description +This transition implies that operators disabled their token on the CloudBlue Connect platform. Thus, this token is assigned to the *Inactive* state. Furthermore, this token cannot be used for any operations through API. If an inactive token is used for such operations, the system will return a corresponding error. +## Prerequisites +A token object with the [Active](s-b-active.html) status is required. +## Operation results +A token object in the [Inactive](s-c-inactive.html) state. diff --git a/api-tokens/t-3-act-inactive.png b/api-tokens/t-3-act-inactive.png new file mode 100644 index 0000000..de41409 Binary files /dev/null and b/api-tokens/t-3-act-inactive.png differ diff --git a/api-tokens/t-4-in-active.md b/api-tokens/t-4-in-active.md new file mode 100644 index 0000000..90e1a2f --- /dev/null +++ b/api-tokens/t-4-in-active.md @@ -0,0 +1,7 @@ +# Token Reactivation +## Description +This transition indicates that operators enabled their token on the Connect platform once again. Therefore, this inactive token is automatically reassigned to the *Active* state and can once again be used for the subsequent operations through API. +## Prerequisites +A token object in the [Inactive](s-c-inactive.html) state is required for this transition. +## Operation results +A token object with the [Active](s-b-active.html) status. diff --git a/api-tokens/t-4-in-active.png b/api-tokens/t-4-in-active.png new file mode 100644 index 0000000..f434c4a Binary files /dev/null and b/api-tokens/t-4-in-active.png differ diff --git a/api-tokens/t-5-token-deleted.md b/api-tokens/t-5-token-deleted.md new file mode 100644 index 0000000..7d87c8d --- /dev/null +++ b/api-tokens/t-5-token-deleted.md @@ -0,0 +1,7 @@ +# Token Removal +## Description +This transition implies that operators decided to delete their token object. As a result, the system assigns the *Deleted* status to this token and it cannot be used for any operations through API. Note, however, that the system allows reviewing general object information of your deleted tokens. +## Prerequisites +A token in the [Active](s-b-active.html), [Inactive](s-c-inactive.html) , or [Pending](s-a-pending.html) state. +## Operation results +A deleted token object. diff --git a/api-tokens/t-5-token-deleted.png b/api-tokens/t-5-token-deleted.png new file mode 100644 index 0000000..832154d Binary files /dev/null and b/api-tokens/t-5-token-deleted.png differ diff --git a/modules.json b/modules.json index 736c0f7..f992dfc 100644 --- a/modules.json +++ b/modules.json @@ -45,8 +45,11 @@ ] }, "Integrations": { - "description": "Create and manage API tokens, access information, and other integrations with the Extensions Management module.", - "icon": "power" + "description": "Create and manage access tokens, define webhooks, and learn more about extensions with the Integrations Management module.", + "icon": "power", + "objects":[ + "api-tokens/object.json" + ] }, "Hubs": { "description": "Register and manage instances of your Commerce Management systems with the Hubs Management module.",