Authorization
How to login to Kyso with the Kyso CLI
Before executing any action using Kyso CLI, an authentication and authorization process must be fulfilled.
Kyso offers different ways to authenticate for, and brings an interactive mode to allow users to do so easily.
To execute the interactive authentication mode just execute
kyso login
and follow the instructions.$ kyso login
? What is the url of your kyso installation? https://kyso.io
? Select a provider (Use arrow keys)
❯ Kyso
Access token
Google
Github
We do not support logging in with Bitbucket from the CLI due to a limitation of Bitbucket. Bitbucket only accepts one callback url to verify a login, which is handled by Kyso's API. If you've created a Kyso account on the UI with Bitbucket, you can create an access token (see below) and use this token to log in from the command line.
First, kyso will ask you for the URL of your Kyso installation. Kyso can run as a SaaS, but as an On Premise tool as well. So for that reason, before doing any operation, the Kyso CLI must know where to point. Once that field is fulfilled, a set of authentication systems can be used.
Remember to include the https:// in this field!
Open your browser, log in with your user at Kyso and go to your personal settings. Click on the "Token" tab in your personal settings

Token's section in your personal profile
Click on "Generate new Token" button. A new form will appear in your window, asking for the name of your token. Put a descriptive name and click on "Create".

Token creation form
A new token will be created and shown at your screen. Be aware, as this token will not be shown anymore. Copy it in a secure place and open your terminal

New generated token
Open your terminal, execute
kyso login
and select Access token as the provider.kyso login
? Select a provider (Use arrow keys)
Kyso
❯ Access token
Google
Github
BitbucketExplicit mode
You will be asked for your username and your password, and if they are correct, you will be successfully logged into Kyso.
kyso login
? What is the url of your kyso installation? https://kyso.io
? Select a provider Access token
? What is your email? [email protected]_domain.io
? What is your access token (Get one from https://dev.kyso.io/settings )?
bfca17ef-ed71-44b8-be95-971ae64aba10
Logged successfully
kyso login --kysoInstallUrl https://kyso.io
--provider kyso --username [email protected]
--token bfca17ef-ed71-44b8-be95-971ae64aba10
Open your terminal, execute
kyso login
and select Kyso as the provider.kyso login
? Select a provider (Use arrow keys)
❯ Kyso
Access token
Google
Github
BitbucketExplicit mode
You will be asked for your username and your password, and if they are correct, you will be successfully logged into Kyso.
kyso login
? Select a provider Kyso
? What is your username? [email protected]
? What is your password? *******
Logged successfully
Open your terminal and execute the next command:
kyso login --kysoInstallUrl https://kyso.io
--provider kyso --username [email protected]
--password your_password
Using your password in command line tools is not the best secure practice, specially if you are using it in a CI/CD environment. We strongly recommend to use the Access Token alternative instead!
Open your terminal, execute
kyso login
and select Google as your provider.kyso login
? Select a provider (Use arrow keys)
Kyso
Access token
❯ Google
Github
Bitbucket
Open your terminal, execute
kyso login
and select Github as your provider.kyso login
? Select a provider (Use arrow keys)
Kyso
Access token
Google
❯ Github
Bitbucket
Open your terminal, execute
kyso login
and select Bitbucket as your provider.kyso login
? Select a provider (Use arrow keys)
Kyso
Access token
Google
Github
❯ Bitbucket
Open your terminal, execute
kyso login
and select Bitbucket as your provider.kyso login
? Select a provider (Use arrow keys)
Kyso
Access token
Google
Github
❯ Bitbucket
Last modified 5mo ago