Telepresence Login

Description

Use telepresence login to explicitly authenticate with Ambassador Cloud. Unless the skipLogin option is set, other commands will automatically invoke the telepresence login interactive login procedure as necessary, so it is rarely necessary to explicitly run telepresence login; it should only be truly necessary to explictly run telepresence login when you require a non-interactive login.

The normal interactive login procedure involves launching a web browser, a user interacting with that web browser, and finally having the web browser make callbacks to the local Telepresence process. If it is not possible to do this (perhaps you are using a headless remote box via SSH, or are using Telepresence in CI), then you may instead have Ambassador Cloud issue an API key that you pass to telepresence login with the --apikey flag.

Acquiring an API key

1. Log in to Ambassador Cloud at https://app.getambassador.io/ .

2. Click on your profile icon in the upper-left:

3. Click on the "API Keys" menu button:

4. Click on the "generate new key" button in the upper-right:

5. Enter a description for the key (perhaps the name of your laptop, or perhaps the "CI"), and click "generate api key" to create it.

You may now pass the API key as KEY to telepresence login --apikey=KEY.

Telepresence will use that "master" API key to create narrower keys for different components of Telepresence. You will see these appear in the Ambassador Cloud web interface.