OneTimeSecret REST API vRO Package
• Craig
I sometimes use OneTimeSecret.com to send passwords or secrets around. It feels like a nice way to get the job done.
It turns out that their API is pretty simple too. So I decided it would be fun to create a package to demonstrate how easy it is to extend vRealize Orchestrator with third party RESTful services.
In this post I’m going to go through setting up a new connection to the OTS API and each operation that the package provides.
The package can be downloaded from FlowGrab.com.
There is an obvious disclaimer that goes with this post. It’s intended as a proof of concept so don’t use it to send company details, unless your security policy allows it.
Get a OneTimeSecret account
Before you begin using the OneTimeSecret package you will need to create an account at onetimesecret.com and generate an API key.
To get your API key:
- Sign up for a free account
- Login and select the Account link
- Click the API Key tab & generate a new key
Now that you have your API key, import the package accepting all messages.
Setting up a new OneTimeSecret host in vRO
From the OneTimeSecret/Configuration folder, run the Add OneTimeSecret API Host workflow. This will configure a new REST host, using the builtin REST plugin and also create all of the necessary REST operations for OneTimeSecret.
Enter the email address used to sign up to OneTimeSecret and the API key generated in the steps above.
The proxy & certificate settings can be left as default, unless you have a requirement to change them.
Once the workflow has completed, verify that the REST host along with it’s operations exist in the inventory tab.
Workflow Operations
For a full description of the query parameters & attributes provided for each method please see the API docs for secrets here.
Share a Secret
Use this workflow to store a secret value and share it with a recepiant
Generate a Secret
Generate a short, unique secret. Useful for temporary passwords, one-time pads, salts etc.
Retrieve a Secret
Use this to retrieve a stored secret. You need the secret ID for this. You’ll find it in the response body of Generate and Share a secret.
Retrieve Metadata
Used to retrieve basic information about a secret and is usually kept private. You need the metadata key for this, which can be found in the response body.
Retrieve Recent Metadata
This appears to be broken in the API currently, but would normally be used by executing the workflow. No inputs are required.
Cool code
Parsing responses
Most of the above methods will return a response as a JSON string. However, strings can be hard to work with, this is why I like to parse them to an object. You can then easily access the attributes and use them in other parts of your workflows.
I use this action to parse the response with json.parse() then loop through each attribute.
You can see that the for loop accesses each attribute and logs it to the console using jsonResponse[i] (where i is equal to the attribute name e.g. jsonResponse[‘value’]).
Getting REST hosts and operations by name
The following two pieces of code were taken from the Big Data Extensions plugin. They remove the need to update each workflow with the host and operation object after configuration.
Each workflow has a string attribute for restHostName and operationName. These names are predefined by the Add OneTimeSecret API Host workflow.
Using the Generate a Secret workflow as an example:
- restHostName is passed to the Get REST Host By Name workflow
- This returns the OneTimeSecret API RESTHost object
- The restHost, along with the operationName are then passed to the Get REST Operation By Name workflow
- This returns the RESTOperation object
- With this, we can then execute our operation in the rest call
It may seem long winded, but it removes the need to manually configure each workflow after running the Add OneTimeSecret API Host workflow. Thus creating a portable workflow with one click configuration.