This page is for data modellers who need to provide securely-stored credentials to access data via HTTP.

Overview

When importing data via HTTP, you sometimes need to provide authentication to an external site. To provide a username and/or password securely, configure a key/value pair.  

1. In a HTTP Datasource properties → Secret Key Details, create a secret key.
2. In the Secret field, click

   Insert excerpt
   _add _add nopanel true

    to create a new Local Secret item.
3. In the local secret → Secret field, add the value, which PhixFlow stores encrypted.

You can use the secret key name to refer to the encrypted value in:

• HTTP collectors and exporters → URL Expression or Statement Expression fields in
• HTTP Headers Properties → Basic Settings → Value.

by specifying ${_datasource.key}  where key is the Name of the secret key.                                                                                                                                                         

When you run analysis, PhixFlow uses the secret key Name to find the key, which finds the encrypted secret. It then provides the de-encrypted value to authenticate to the external site.

To create a key/value pair, in an HTTP datasource properties → Secret Key Details section, click 

Secret Key 

Insert excerpt
_property_tabs _property_tabs name basic-h nopanel true

Basic Settings

Local Secret 

Insert excerpt
_property_tabs _property_tabs name basic-h nopanel true

 

Anchor
value value

Using a Keystore

todo-fiona

Internal IDs

If you have configured a Java keystore Configure a Keystore and Aliases and Adding Data to a Keystore  you can use this to store secure credentials instead of using a Local Secret. 

Datasource and HTTP Datasource modelling objects have properties → Advanced → Internal ID.

This is a read-only field that provides the database identifier for the datasource. 

You can supply a key-value pair to the keystore. However, the username and password key or value requires the datasource ID.

EG. Datasource needs a username XYZ and password ABC 

Key datasource1-username - internalIDXYZ

Key datasource1-pw - internalIABC

Datasource 

1. Store the username key-value pair in the keystore.
2. Store the password key-value pair in the keystore.
3. To reference them, in the expressions, use ${_datasource.key}  where key is the key.