95

I'd like to use travis-ci for one of my projects.

The project is an API wrapper, so many of the tests rely on the use of secret API keys. To test locally, I just store them as environment variables. What's a safe way to use those keys on Travis?

0

4 Answers 4

101

Travis has a feature to encrypt environment variables ("Encrypting environment variables"). This can be used to protect your secret API keys. I've successfully used this for my Heroku API key.

All you have to do is install the travis gem, encrypt the string you want and add the encrypted string in your .travis.yml. The encryption is only valid for one repository. The travis command gets your public key for your repo and can then decrypt the string during the build.

gem install --user travis
travis encrypt MY_SECRET_ENV=super_secret -r my_username/my_repo

This gives you the following output:

Please add the following to your .travis.yml file:

  secure: "OrEeqU0z6GJdC6Sx/XI7AMiQ8NM9GwPpZkVDq6cBHcD6OlSppkSwm6JvopTR\newLDTdtbk/dxKurUzwTeRbplIEe9DiyVDCzEiJGfgfq7woh+GRo+q6+UIWLE\n3nowpI9AzXt7iBhoKhV9lJ1MROrnn4DnlKxAEUlHTDi4Wk8Ei/g="
14
  • 13
    Don't forget to document what variables you are using, and why, because once encrypted them only someone with the original keys can recover them.
    – jerseyboy
    Jul 20, 2013 at 15:06
  • 3
    With the option --add env.global to the travis command, it will amend your .travis.yml automatically.
    – Thomas
    Sep 30, 2015 at 10:59
  • 1
    @RamIdavalapati: since the secrets are encrypted, this is considered safe, yes.
    – Odi
    Sep 9, 2018 at 13:18
  • 1
    @Ramesh-X: yes since this encryption is for TravisCI. If someone has control over TravisCI, they could obtain SECRET_ENV
    – Odi
    Nov 12, 2019 at 9:59
  • 1
    @Michael Goerz: Yes, simply add the env variables via the Travis web interface
    – Odi
    Dec 27, 2019 at 5:57
7

according to this in travis ci documentation it's said that :

If you have both the Heroku and Travis CI command line clients installed, you can get your key, encrypt it and add it to your .travis.yml by running the following command from your project directory:

travis encrypt $(heroku auth:token) --add deploy.api_key

refer to the following tutorial to install heroku client according to your OS

1
  • I just want to verify: the key it adds to your file is safe to upload to version control, right?
    – vapurrmaid
    Mar 3, 2018 at 23:46
5

You can also define secret variables in repository settings:

Variables defined in repository settings are the same for all builds, and when you restart an old build, it uses the latest values. These variables are not automatically available to forks.

Define variables in the Repository Settings that:

  • differ per repository.
  • contain sensitive data, such as third-party credentials.

To define variables in Repository Settings, make sure you’re logged in, navigate to the repository in question, choose “Settings” from the cog menu, and click on “Add new variable” in the “Environment Variables” section.

2
  • 1
    Didn't understand how to create secret variables. When googling that, results explain how to encrypt. Aug 12, 2017 at 16:44
  • @XedinUnknown This can be used for secret variables. From the link: "By default, the value of these new environment variables is hidden from the export line in the logs. This corresponds to the behavior of encrypted variables in your .travis.yml. The variables are stored encrypted in our systems, and get decrypted when the build script is generated."
    – bmaupin
    Jan 25, 2018 at 18:28
0

Use a different set of API keys and do it the same way. Your travis box gets setup for your build run and then completely torn down again after your build has finished. You have root access to your box during the build, so you can do whatever you want with it.

2
  • 4
    What do you mean by "do it the same way"? I don't really like the idea of storing API keys in the repo itself (i.e. in the .travis.yml file), but there doesn't seem to be another way to configure environment variables on travis.
    – BM5k
    Jul 11, 2012 at 5:15
  • The env variable will get encrypted with a public key, so only the owner of the secret key can decrypt it. You should not use an important token. In my case I used the one which travis already had for GitHub. This worked quite well and from within github I can revoke that token whenever I feel travis be a risk. Having the encrypted token in my repo doesnt make me sleep bad. github.com/ecki/GCViewer/blob/topic-ciupload/.travis.yml
    – eckes
    Feb 19, 2013 at 1:17

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.