Authenticating to Review Board¶
Most RBTools commands require authenticating to a Review Board server. If you are not currently logged in, RBTools will prompt you to do so.
Login Sessions¶
When running a command which requires authenticating with the server, RBTools
will either direct you to log in via the Review Board web site, or prompt you
for your username and password. This depends on whether WEB_LOGIN
is set in .reviewboardrc.
You can also log in by explicitly by running rbt login, which has
the --web option for enabling web-based login.
After logging in, your session will be stored in the .rbtools-cookies
file. Depending on how the server is set up, these sessions will periodically
expire.
Using API Tokens¶
Instead of web-based login or a username and password, RBTools can authenticate to the server using an API token. This has the additional benefit that tokens can be limited in their scope, and can be individually created and revoked as necessary.
API Tokens can be created inside Review Board by selecting My Account, and then choosing Authentication. See Creating API Tokens for details.
After you have an API token, you can either pass it to rbt login, or
you can store it in your personal .reviewboardrc file.
$ rbt login --api-token <token>
In .reviewboardrc:
API_TOKEN = "<token>"