Authentication
You can install and import public components on anonymous mode, i.e. without authenticating with bit.dev.
To export components to bit.dev and to import from private scopes you need to setup a free account on bit.dev.
Exporting components to bit.dev requires that Bit client (Bit cli) on your machine is logged in to the account.
A token or a key is associated with a single user, and the privileges, such as scopes visibility and access, are determined according to that user's privileges.
bit.dev server is using the following IP addresses: 35.184.176.52:443
#
Authenticate with TokenUse bit login
to generate an authentication token for a [bit.dev]. Bit uses the token to configure the local Bit configuration.
To authenticate your Bit client, run the following command:
bit login
The browser opens to a login page. Enter your bit.dev account credentials. The authentication token is generated and configured to bit config
.
#
Additional Tokensbit.dev stores a token per machine. When re-logging on the same machine, the previous token expires and a new token is created. If you want to a permanent token (e.g. for CI), you can set a machine name in the login. The token will be associated with that machine name, and only expires when performing another login with the same machine name:
bit login --machine-name=ci_server
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 the account.
You can send a specific token for each command you are running and is accessing a remote scope by specifying the
--token
flag with the relevant token.
#
Authenticating package managersIt is possible to consume components exported to bit.dev using npm
or yarn
.
When you run bit login
, Bit automatically configures your token in your users' npmrc file. Once done, any npm i
or yarn add
operation can fetch components from Bit.
#
Configure local Bit clientTo set your username and email in Bit, use the bit config command
.
- If you've used
bit login
to 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
git config
.
bit config set user.name "mickey mouse"bit config set user.email mickey@example.com
#
Authentication issuesSeveral things you can do if you encounter the fatal: permission to Scope <scopename> was denied
error message:
#
Timeout after a long hang timeBit uses HTTPS to communicate with remote servers. A long hang time and authentication failure is usually the result of a firewall blocking the relevant port (443).
To see if that's the case, try and connect to the Bit remote server directly. If you are unable to connect, check the firewall configuration. If this test passes, email us at support@bit.dev.
#
Bit.dev account issuesSome issues may relate to simple account configuration issues.
#
You are not signed up to bit.devIn order to import/export components hosted on bit.dev you need an to have an active account.
If you haven't signed up already, head over here.
#
Wrong username/password combinationWhen authenticating via bit login
, Bit will ask for your username/password combination for the relevant bit.dev account. Make sure you have provided the login command with the correct combination.
In case you have forgotten your password, head over to your settings page to reset it.
#
No permissions for the ScopeIt may be that you do not have permissions to access the Scope in question.
- If the Scope is public, you can import component from it, but you have to have write permissions to export to it.
- If the Scope is private, you must have read/write permission in order to import/export components from/to it.