First steps as a user

Logging In

Each LAVA instance offers a Local User Account and may also be configured to an alternative authentication method:

OpenID is no longer available for all installations of LAVA. Incompatible changes in the underlying django support made it impossible to support OpenID since the 2015.12 release.

See also

Configuring user authentication for more information.

LDAP authentication relies on local configuration and may involve obtaining a privileged access token from the LDAP administrators.

Local accounts remain available for all instances.

Whichever authentication method is used, there is no difference in how users interact with LAVA once logged in.

Local User Account

A local user account may be created by an administrator within LAVA. The administrator may grant different permissions to the user to perform various operations within LAVA. A typical login screen will look something like the following.

_images/local-user-login.png

To log in with a username and password, enter your credentials in the provided text boxes and click “Sign in with username and password” button.

Local user accounts can be particularly useful for automated users like build systems or continuous integration scripts using the XML-RPC API. The local admin can create the user with a secure password, log in as that user to create a token and then supply the token to the scripts.

Linaro lab users

Linaro’s central validation lab in Cambridge is accessible via https://validation.linaro.org/ . It is Linaro’s core production instance of LAVA.

This lab is configured to use Linaro LDAP. To log in, enter your details in the LDAP login fields.

Note

If your Linaro email is first.second@linaro.org then use first.second as your username.

_images/ldap-user-login.png

A successful authentication will redirect you to https://validation.linaro.org/

If you do not have a Linaro LDAP account, you can Register with Linaro as a Community contributor.

After loggig in, the LAVA scheduler page will look something like the following:

_images/lava-scheduler-page.png

Authentication Tokens

In order to securely access LAVA resources via XML-RPC APIs using lava-tool or XML-RPC clients, users first need to create an authentication token.

Once logged in to a LAVA instance (e.g. https://validation.linaro.org/), click on the “API” link then on the “Authentication Tokens” link from the drop down menu. The following page will appear

_images/authentication-tokens-page.png

Click on the “New” button on the above page which raises a dialog box asking for a “Description” of the token to help you identify and delete tokens - if required at a later stage.

_images/create-new-authentication-token.png

Click on the “Create” button to generate the token. The token will be assigned a token number (which is autogenerated by LAVA).

_images/sample-token-page.png

To display the token that was generated above click on the green “Display this token” button in the Actions column on the above page.

_images/token-display-page.png

If a token is compromised, it can be removed by clicking on the red “delete this token” button in the Actions column. Anyone using that token will then no longer be able to authenticate as you in the system.