Provide secure information to pipelines

This page describes how to provide secure information, such as credentials and password, to Data Fusion pipelines. This can be done by using the secure store REST API.

Use secure information in pipelines

In the Data Fusion UI, go to the System Admin link in the top right hand side corner. Select Configuration and go to Make HTTP Calls link.
Make an HTTP call to create a secure key.
You can now use the secure key name in the pipelines to retrieve the credentials.
The Wrangler can use the secure key to retrieve the password by clicking on the shield button and select the corresponding secure key.
The secure key can also be provided as a secure macro in the pipeline config. The secure macro has the format ${secure(<secure-key-name>)}.

Manage the secure information

In addition, the following REST calls can be used to manage the secure information:

Save the secure information:
```
PUT  /namespaces/<namespace-id>/securekeys/<key-name>
```
Where namespace-id is the namespace name, key-name is a key for your credentials. This key needs to be provided to pipelines to use the credentials. The call needs a JSON body with the format:
```
{
  "description": "your description",
  "data": "your password",
  "properties": {
    "<property-key>": "<property-value>"
  }
}
```
Retrieve the secure information.

to retrieve the secure information based on a single key name:
```
GET  /namespaces/<namespace-id>/securekeys/<key-name>
```
to retrieve the secure information for all keys:
```
GET  /namespaces/<namespace-id>/securekeys
```
to retrieve the properties and creation time of secure information:
```
GET  /namespaces/<namespace-id>/securekeys/<key-name>/metadata
```

Delete the secure information:

DELETE /namespaces/<namespace-id>/securekeys/<key-name>