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. There are several options for how to store and then reference the username and password; see Authenticating to a Website. One option is to use the HTTP datasource properties → Secret Key section to create a key associated with the username or password, which is encrypted and stored in the PhixFlow database.
Property Pane Toolbar
For information about the toolbar options, see the Common Properties page, Toolbars and Controls section.
Secret Key Properties Tab
Parent Details
If this item is within or belongs to another, it's parent name is shown here. See the Common Properties page, Parent Details section for more details.
Basic Settings
Field
Description
Name
Enter a name. Save the properties. Use this name in expressions to refer to this key using ${_datasource.key} .
Key
Read-only. When you save the secret key, PhixFlow automatically generates a unique key in this field. The key is a combination of the Name and the internal ID of the HTTP datasource.
This key remains the same if you change the name of the secret key.
Enabled
Tick to indicate you have completed configuring the secret key and associated local secret value, and it is ready to use. The local secret value may be null.
Untick means a reference to this secret key in an expression will fail.
Secret
Click Add New to create a local secret item, where you can enter the value, such as a password, that is paired with this secret key; see Local Secret Properties, below.
When you save the local secret, PhixFlow displays asterisks here to show that the secret value has been encrypted.
To edit a secret value, click Edit. To delete a secret value, click Delete.
We recommend that you always enter a description to explain the purpose of this item.
Audit Tab
Audit Summary
See the Common Properties page, Audit Summary section.
Local Secret Properties Tab
Field
Description
Key
Read only. The same automatically-generated key in the secret key paired with this local secret.
Secret
Enter the value that you want to encrypt, such as a password. To switch between displaying or hiding the value, click Show/Hide Password.
PhixFlow encrypts the value when storing it in the database, but when it is required to authenticate to an external site, PhixFlow supplies the unencrypted string.
Audit Tab
Audit Summary
See the Common Properties page, Audit Summary section.
Using a Secret
For HTTP objects connected to the HTTP datasource, you can reference a secret in:
HTTP collectors and HTTP exporters → URL ExpressionorStatement Expression
HTTP Headers Properties →Basic Settings →Value.
Error rendering macro 'excerpt-include' : No link could be created for 'Authenticating to a Website'.