Setup Bitsrc.io Authentication
Before working with bitsrc.io, configure your Bit client with your Bit account.
Signup to bitsrc.io
Connect Bit CLI to your Bit account
There are two methods to authenticate a local Bit client to your bitsrc.io account.
Bit communication protocol
Bit uses SSH as its network protocol, as in most cases it is already set up, and if not, it's easy to do so. SSH is also an authenticated network protocol; and because it’s ubiquitous, it’s generally easy to set up and use. This makes SSH the preferred method for collaboration.
Authenticate Bit using 'bit login'
Use bit login to generate an authentication token for a [bitsrc.io]. Bit uses the token to configure the local Bit configuration.
To authenticate your Bit client, run the following command:
$ bit login Your browser has been opened to visit: http://bitsrc.io/bit-login?redirect_uri=http://localhost:8085...
Manage authenticated devices
To see a list of all logged-in devices, go to profile settings.
You can remove tokens, forcing Bit clients to re-authenticate themselves with your account.
Authenticate Bit using SSH key-pair
If you know how to generate your SSH key, you can skip the next part and move to authenticate your SSH Key to bitsrc.io.
Generate SSH key for macOS/Linux
To generate an SSH key follow these steps:
- Open a terminal application.
- Run this command (replace ‘email’ with the email associated with your BitSrc account):
ssh-keygen -t rsa -b 4096 -C "firstname.lastname@example.org"
- Accept the default location for the key file.
- To add a private key to the SSH-agent please follow the steps below:
Start the SSH agent:
eval "$(ssh-agent -s)"
Add the private key we’ve created in the last step:
Generate SSH key for Windows
To generate an SSH key, please follow these steps:
- Download and start the puttygen.exe generator.
- In the "Parameters" section choose SSH2 DSA and press Generate.
- Move your mouse on the small screen to generate the key pairs.
- Enter a key comment, which identifies the key (useful when you use several SSH keys).
- Click "Save private key" to save your private key.
- Click "Save public key" to save your public key.
Upload public SSH key to bitsrc.io
- Log in to your bitsrc.io account.
- Click on the user icon to open the user actions menu.
- Click on the ‘Settings’ link to reach the user settings section. Once inside, click on ‘SSH Keys’ in the left pane.
- In the ‘SSH Keys’ section, click on ‘new SSH key’.
- Type a name for the key. The key name documents the key, and will not affect the behavior of the system.
Key- Copy the content of the file
- Click on ‘Add SSH key’.
A new item is added to the SSH key list. This means that you are now connected via SSH and can export and import components from the bitsrc.io community hub.
Configure your local Bit client
To set your username and email in Bit, use the bit config command.
- If you've used
bit loginto authenticate, the username and email is set according to the Bit account.
- If no configuration values are defined for Bit, it falls back to read the values from
$ bit config set user.name "mickey mouse" $ bit config set user.email email@example.com