Substitution variables

Source developers can specify "substitution variables" in any of the string fields in the source json object.

They should be formatted as follows:

  • #IKANOW{xxx}, where "xxx" is in one of the following formats:
    • <sourceid>.<field-path-in-dot-notation>
      • Example: "542052833568db029d8aac56.my_password" looks for the field "my_password" in the source with "_id" ObjectId("542052833568db029d8aac56")
      • The <sourceid> has to point to a JSON source
    • <source-type>.<field-path-in-dot-notation>
      • Example "password_shares.social_credentials.twitter.access_key" looks in all shares of type "password_shares", and grabs the nested field "access_key" from the "twitter" sub-object of the object "social_credentials"
{
//...
	"social_credentials": {
	//...
		"twitter": {
		//...
			"access_key": "547658774e5r43532543654",
//...
      • Only shares in your personal community are searched (otherwise it's too easy for someone to add a share with the same field and silently cause shares that depend on it to fail).
  • #LOGSTASH{host} - see Logstash extractor

Example:

{
//...
	"processingPipeline": [
		{
			"file": {
//...
				"password": "#IKANOW(542052833568db029d8aac56.my_password)"
//...
			}
		},
//...