External vault integration

There are three options to authenticate to your AWS vault from Inso CLI:

• Temporary security credentials:

  export INSOMNIA_AWS_TYPE='temporary'
  export INSOMNIA_AWS_ACCESSKEYID='YOUR AWS ACCESS KEY ID'
  export INSOMNIA_AWS_SECRETACCESSKEY='YOUR AWS ACCESS SECRET ACCESS KEY'
  export INSOMNIA_AWS_SESSIONTOKEN = 'YOUR AWS SESSION TOKEN'
  export INSOMNIA_AWS_REGION = 'YOUR AWS REGION'
  

  Copied!
• Credentials file:

  export INSOMNIA_AWS_TYPE='file'
  export INSOMNIA_AWS_SECTION='SECTION NAME IN YOUR AWS CREDENTIALS FILE'
  export INSOMNIA_AWS_FILEPATH='PATH TO YOUR AWS CREDENTIALS FILE'
  export INSOMNIA_AWS_ENABLECACHE='BOOLEAN, ENABLES FILE CACHE IF SET TO TRUE'
  export INSOMNIA_AWS_REGION = 'YOUR AWS REGION'
  

  Copied!
• SSO credentials:

  export INSOMNIA_AWS_TYPE='file'
  export INSOMNIA_AWS_SECTION='SECTION NAME IN YOUR AWS CREDENTIALS FILE'
  export INSOMNIA_AWS_CONFIGFILEPATH='PATH TO THE AWS CONFIG FILE'
  export INSOMNIA_AWS_FILEPATH='PATH TO YOUR AWS CREDENTIALS FILE'
  export INSOMNIA_AWS_ENABLECACHE='BOOLEAN, ENABLES FILE CACHE IF SET TO TRUE'
  export INSOMNIA_AWS_REGION = 'YOUR AWS REGION'
  

  Copied!

The INSOMNIA_AWS_CONFIGFILEPATH, INSOMNIA_AWS_FILEPATH, and INSOMNIA_AWS_ENABLECACHE variables are optional. If they aren’t provided, Insomnia will use the default AWS CLI values.

For HashiCorp, the environment variables to define for Inso CLI depend on the platform and authentication method:

• HashiCorp Cloud Platform

  export INSOMNIA_HASHICORP_TYPE = 'cloud'
  export INSOMNIA_HASHICORP_CLIENT_ID = 'HASHICORP SERVICE PRINCIPAL CLIENT ID'
  export INSOMNIA_HASHICORP_CLIENT_SECRET = 'HASHICORP SERVICE PRINCIPAL CLIENT SECRET'
  

  Copied!
• HashiCorp Vault Server
  • AppRole authentication:

    export INSOMNIA_HASHICORP_TYPE = 'onPrem'
    export INSOMNIA_HASHICORP_AUTHMETHOD = 'appRole'
    export INSOMNIA_HASHICORP_SERVERADDRESS = 'HASHICORP VAULT SERVER ADDRESS'
    export INSOMNIA_HASHICORP_ROLE_ID = 'HASHICORP VAULT SERVER APP ROLE ID'
    export INSOMNIA_HASHICORP_SECRET_ID = 'HASHICORP VAULT SERVER APP ROLE SECRET ID'
    

    Copied!
  • Token authentication:

    export INSOMNIA_HASHICORP_TYPE = 'onPrem'
    export INSOMNIA_HASHICORP_AUTHMETHOD = 'token'
    export INSOMNIA_HASHICORP_SERVERADDRESS = 'HASHICORP VAULT SERVER ADDRESS'
    export INSOMNIA_HASHICORP_ACCESS_TOKEN = 'HASHICORP VAULT SERVER ACCESS TOKEN'
    

    Copied!