Start a new topic

Secrets and Constant replacement

This is a detailed topic in our support portal in the Using migFx series and assumes that you have some prior knowledge or experience using migFx. If you want to know more about hopp tech and migFx, our comprehensive solution for complex data migration, please visit our web site hopp.tech


From migFx version 1.11, you can use monikers to place Constants and Secrets into Literal values and Constant values


By monikers, we mean one of these 2 options:


{constant:ConstantName}  



For instance, you can assign a Literal value like "cast('{constant:MigrationDate}' as date)".

Both static constants and Run Parameters can be referenced this way.

{secret:SecretName}   
For instance, you can edit the value of a Run Parameter in Director to contain "Data Source=ServerName;User ID=SqlUser; Password={secret:SqlPassword}"


Constants

At runtime, migFx will resolve the constant monikers and replace the monikers with the actual constant values. 


This resolution is recursive, so it is entirely possible to use monikers to reference constants that themselves contains monikers to reference other constants.


Constant resolution and replacement always takes place - contrary to Secret replacement that only takes place when calling DataServices, see below.


Secrets

migFx loads Metadata and dynamic Valuesets from DataService Provider extensions. A Provider to read Metadata and Valuesets from Excel is baked into migFx from the beginning. Hopp can provide additional DataService Providers to get Metadata and Valuesets from for instance Sql Server, Oracle or DB2. Finally, bespoke DataService Providers can be developed to get Metadata and Valuesets from other sources.


The Sql Server, Oracle and DB2 DataServices from hopp all require a connection string as parameter. In some cases, it may be necessary to add sensitive information - a password - to a connection string. Other DataServices may also require sensitive information in parameters. 


This poses a problem, because the DataServices parameters are visible to all users in Studio and - if provided via a Runtime Constant - also visible to all users in Director and even Business Users in the Portal.


Administration of Secrets

To get around this, migFx 'supports Secrets. A secret is a named value, and the value of the secret is maintained in the Director Administration:


Secrets are stored in the Directors Master database with an encrypted secret value.


Using Secrets

A secret can be used in input parameters for DataServices by using this moniker in curly braces: 


{secret:name}


where name is the name of the Secret in the Director Administration.


The secret moniker can be used either directly in a Literal Value:


Or the moniker can be used indirectly in a Constant:


Resolving Secrets

Secrets must be resolved when the DataSevices Provider is invoked, and the parameters passed. Either by the Director Runtime or in Studio, when Metadata is imported or Valuesets are tested.


Resolving Sercrets in Director Runtime

When a Dynamic Valueset is loaded in the Director, the Director Runtime will parse the parameters for the provider and replace all secrets with their actual values. The Director Runtime will fail the job if a secret is not found.


OBS: For secrets in Runtime Constants, it is important to stress that secrets are only parsed by the Director Runtime when calling DataServices. If a Constant is used elsewhere - in the mapping - no parsing and replacement will take place. This is contrary to the replacement of Constant references, that always takes place - see above.


Resolving Secrets in Studio

The user can replace the secret moniker in Studio when loading Metadata:


And when testing a Dynamic Valueset


Login or Signup to post a comment