ViewOnce
Securely distribute messages such as passwords using temporary time-bound, access limited tokens. Using ViewOnce eliminates risks associated with exchanging sensitive material over email, instance messenger and other protocols that could result in exposure.
Actions
ViewOnce Set
Create a new message to shared securely. This action will return the URL that can then be used to access the value.
Input
| Name | Description | Type | Required | Syntax |
|---|---|---|---|---|
| Message | Message you want to tokenize for secure exchange. | input | True | True |
| Expiry | Time in seconds before the message is deleted and unrecoverable. Default 86400 seconds which is 1 day. | input | True | False |
| Access Count | Number of times the message can be viewed before it is deleted and unrecoverable. | input | True | True |
| Public Access | When True access to the ViewOnce message will be permitted using token based authentication. This option should be used if the receiver does not have an A-Ops account within your tenancy. | group-checkbox | False | False |
| Access Token | When Public Access is True you should provide the corresponding Access Token for the anonymous ViewOnce user. | input | False | False |
| Authorization | Optional list of users, groups or roles that the receiver of the message must have in-order to view the message. Please use the following defined formats within the list when defining authorization. ["user: |
json-input | False | True |
| Revalidate | Optional security check to enforce MFA recheck of the logged in A-Ops user when attempting to retrieve this message. | checkbox | False | False |
Output
| Name | Description | Type | always_present | values |
|---|---|---|---|---|
| result | Returns True when successful. | boolean | True | {"True": {"description": "Successful."}, "False": {"description": "Failure."}} |
| rc | Returns the exit code for the action. | number | True | {"0": {"description": "Successful."}, "403": {"description": "Failure."}} |
| _id | When successful the _id of the ViewOnce is returned. | text | False | {} |
| token | When successful the access token of the ViewOnce is returned. | text | False | {} |
| url | When successful the URL for access is returned. | text | False | {} |
ViewOnce Get
Get the ViewOnce message using the ViewOnce generated details.
Input
| Name | Description | Type | Required | Syntax |
|---|---|---|---|---|
| Token | The access token you were provided when creating the ViewOnce message. | input | True | True |
| ViewOnce Secure Data | The secure ViewOnce information that can be found within the encData argument in the URL. | input | True | True |
Output
| Name | Description | Type | always_present | values |
|---|---|---|---|---|
| result | Returns True when successful. | boolean | True | {"True": {"description": "Successful."}, "False": {"description": "Failure."}} |
| rc | Returns the exit code for the action. | number | True | {"0": {"description": "Successful."}, "403": {"description": "Failure."}, "404": {"description": "ViewOnce message could not be located using the token provided."}} |
| viewonceData | Message. | text | False | {} |
ViewOnce Cleanup
Processes outstanding ViewOnce protected secrets and deletes them once expired.
Output
| Name | Description | Type | always_present | values |
|---|---|---|---|---|
| result | Returns True when successful. | boolean | True | {"True": {"description": "Successful."}, "False": {"description": "Failure."}} |
| rc | Returns the exit code for the action. | number | True | {"0": {"description": "Successful."}} |