Encrypting using Ambience/Repertoire 202x

Ambience 2020+
1

This entry guides you through on using the encryption feature in Ambience/Repertoire v202x.

On Linux Environment:

For Ambience 202x

  1. Open a command line console & navigate to /Ambience-202x/bin of your Ambience installation path.
  2. Execute the command below:
    ./ambience-cli encrypt <your-secret-key>

For Repertoire 202x

  1. Open a command line console & navigate to /Repertoire-202x/bin of your Repertoire installation path.
  2. Execute the command below:
    ./repertoire-cli encrypt <your-secret-key>

On Windows Environment:

For Ambience 202x

  1. Open a command line console & navigate to /Ambience-202x/bin directory of your Ambience installation path.
  2. Execute the command below:
    ambience-cli.bat encrypt <your-secret-key>

For Repertoire 202x

  1. Open a command line console & navigate to /Repertoire-202x/bin directory of your Repertoire installation path.
  2. Execute the command below:
    repertoire-cli.bat encrypt <your-secret-key>
  • Output Example, (using mypassword as a plain text password example.)
    ./ambience-cli encrypt mypassword
    mypassword = {enc:elx-2.0}1aaafeF9iFTAgrLlNpsjSfbbbwWo=
  • For plain-text password with special characters, we strongly advise encrypting the whole MongoDB connectionString instead. Example as shown below:
    connectionString = “mongodb://admin:ab@cd$@localhost:27017”
    ./ambience-cli encrypt "mongodb://admin:ab@cd$@localhost:27017"

Output will be as follows:
mongodb://admin:ab@cd$@localhost:27017 = {enc:elx-2.0}fxxfGHDkxxxOGdxxxwVWRo=

Additional Notes

  • Encrypting the same input will produce a different output each time.
  • To include in spaces in your secret key, do wrap up the entire key with double quotes (" ") which would not be considered part of the key.
  • For further details, do view the following post: Encrypting using Ambience/Repertoire 202x - #2 by jpriddey
2

If you try the above example using “mypassword” you will get a different result.

The same input will produce different output each time. This means that if someone else happens to use the same secret key as you, they won’t know, because they will see a different encrypted value every time:

./ambience-cli encrypt “sample string”
sample string = {enc:elx-2.0}97Fl8uEfflvpVebF5yuGIx1pAIcb8Fo0/bZvLRVeWE8=
./ambience-cli encrypt “sample string”
sample string = {enc:elx-2.0}WR6uuoVZ1sC4LEGat9Z2RlK22kc5EqNAiSz/Ea2c860=

Both results will be decoded by any instance of Ambience back to the same secret key.

This example also shows that to include spaces in your secret key, you should wrap the entire key with quotes (which are not considered part of the key).

1 Like