LGTM Enterprise 1.24

Managing your account

You can configure your account via the Account settings page, including:

To display your Account settings page, log in to LGTM, click your full name in the top right of the menu bar, and then click Account settings.

Changing your profile information

The Public information section of the account settings page summarizes the information shown on your public profile page in LGTM. You can edit any of the fields displayed. When you have finished editing the information, click Save changes to save the information. Your profile is updated immediately.

Changing your user name

You can change your user name by editing the Username field in the Public information section of the account settings page, as described above.

Edit your Username with care. This controls the URL for your profile page.

Adding a password

You may want to add an account password. The way to proceed depends on whether you have a default email address set up for your account in LGTM.

If you don't have an email address linked to your LGTM account you first need to add an email address to your account and make it the default address. Then follow the instructions below.

If you have an email address linked to your LGTM account:

  1. Go to your Account settings page.
  2. Scroll to Account Security.
  3. Click Add Account password. We send a link to your default email address with instructions for adding a password.
  4. In your email inbox, find the email and click the provided link.
  5. In the displayed page, type your new password and repeat it on the line below.
  6. Adding a new password

  7. Click Save password.

    Your password won't be accepted if it previously appeared in a data breach. If that's the case, choose a different, stronger password.

  8. A "Successful" message is displayed. It informs you that the password has been successfully added to your account and that you can use it to log in to LGTM.
  9. Click on Continue. This takes you to the LGTM home page.

Changing your password

To change your password:

  1. Go to your Account settings page.
  2. Scroll to Account Security.
  3. In the Change password section, type your current password on the first line.
  4. Changing your password

  5. Type your new password where instructed.
  6. Repeat your new password at the bottom.

    Your password won't be accepted if it previously appeared in a data breach. If that's the case, choose a different, stronger password.

  7. Click Save.
  8. A message indicating that the password change was successful is displayed in LGTM.

Managing external accounts

The options available for logging in to LGTM Enterprise are determined by your system configuration. Typically, you can log in to LGTM Enterprise using the repository host account you use to access your code repository.

In LGTM, such accounts are referred to as external accounts.

Logging in to LGTM Enterprise using an external account has the following advantages:

  • Fast authentication—when you're logged in to the external account, you can log in to LGTM with one click. There's no need to remember a separate user name and password.
  • Profile link—your LGTM profile includes a link to the profile page for your Bitbucket or GitHub account.
  • Add projects—you can add projects that your external account has read access to.
  • Automated code review of pull requests—an option to configure analysis of pull requests for repositories you own (available for projects in Git repositories), or have administrator permissions for. If you've connected an existing external repository account (for example, your GitHub or Bitbucket account) to LGTM, or logged in using that external account, LGTM will get details about you from that repository host. This information allows LGTM to determine whether you are an administrator or the owner of that repository. If you are, you can enable automated code review of pull requests for that repository in LGTM. For more details, see About automated code review.
Some systems are set up so that you see little or no information unless you're logged in using an external account, or your account is connected to an external account.

Connecting external accounts to existing LGTM accounts

In the External accounts section of the Account settings page, click the Connect with <external> button. If your browser session is already authenticated with the account, it is automatically connected to your LGTM account. Otherwise, a login screen is displayed for that account. Log in to complete the connection. When an account is connected, the following message is displayed in LGTM: The <external> account <account-name> is currently connected to your account.

If your external account is already connected to a different LGTM account (perhaps you also used a Log in with <external> option), an error page is displayed. You can only connect an external account to one LGTM account. If you want to move the connection to a different LGTM account, you need to disconnect it from the other account first.

Refreshing OAuth tokens

If for some reason, the OAuth access token for one of your external accounts becomes invalid, you can refresh it in LGTM:

  1. Go to your Account settings page.
  2. Scroll to External accounts.
  3. The Your external accounts section lists your external accounts that are currently linked with your LGTM account. Click the External account options button for the external account of interest.
  4. Click Refresh your OAuth token.

Disconnecting an external account from LGTM

You can disconnect an external account from LGTM using the Your external accounts section of the Account settings page at any time. However, you must first ensure that:

  • The LGTM account it's currently connected to has an alternate method for authentication, that is, the external account is not the only way to log in.
  • Any automated code reviews you set up using that account are disabled (see Enabling automated code review).

If the current LGTM account meets these criteria, click the External account options button, displayed at the end of the row. Then click Remove external account to disconnect the external account. The account is disconnected immediately, and is available for you to connect to a different LGTM account.

Managing automated code review for pull requests

If you've enabled automated code review for pull requests on any of your projects on LGTM, the projects are listed. You can manage the integrations from the project settings pages.

Automated code review doesn't currently apply to projects stored in Subversion.

  1. Click a project name to display the project page.
  2. Click the Settings button to display the Project settings page.
  3. Edit the settings and click Back to project to redisplay the project page.

For information about automated code review for pull requests, see About automated code review and Managing automated code review.

Managing authorized applications

This section shows client applications that you have granted access to LGTM information using tokens. This may include:

  • OAuth tokens created by the LGTM plugins/extensions when you authorize them to access LGTM. For more information, see IDE integration for LGTM.
  • Access tokens you create using the Create token button when you want to use the LGTM API. For more information, see Managing access tokens.

You can see which applications have access to LGTM, as well as the scopes granted:

Revoking OAuth tokens

Click Revoke to delete the token for an application you no longer want to access your LGTM data. You are asked for confirmation before the token is revoked.

You can manage email addresses associated with your account from the Account Settings page. This typically means that you can add email addresses to your LGTM account.

LGTM uses the email addresses that you associate with your account to determine projects that you contribute to. If you contribute to projects using more than one email address (or if you've previously used a different email address), we recommend you add those email addresses to your account on LGTM. That way, LGTM will show all your contributions.

Adding email addresses to your account

  1. Click your user name on the top right corner of the page.
  2. In the drop-down list, click Account settings.
  3. Scroll down to the Email addresses area to see which email addresses are already associated with your account.
  4. In the Add an email address text field, type an address that you want to add and click Add ( below) to send a verification email to the email address.

    Managing email addresses

  5. When you receive the "Confirm your email address" message, click the link to confirm that you want to associate it with your LGTM account.

    If you haven't received the confirmation message, click Verify ( above) to resend it.

  6. The additional email address is verified and a success screen is displayed. Click Continue. This takes you to the LGTM home page.

Currently it may take up to 6 hours to merge the data associated with the new email address into your account. After this time, you will see the projects or data associated with the additional email address in your Project lists, Alerts, and Your profile pages.

Each email address can only be associated with one LGTM account. So, if you have previously logged in to LGTM with the additional email address, an error message is displayed when you try to verify the address. You'll need to disconnect the LGTM account for that email address before retrying the addition.

Deleting your LGTM account

You can delete your LGTM account at any time using options on your Account settings page. This deletes your account settings, including any OAuth tokens, and unlinks any email addresses associated with the account.

The most common reason for deleting an LGTM account is to enable you to add the email address to another LGTM account. For example, if you've logged in using both your GitHub and Bitbucket accounts (which use different email addresses) and want to show information from both accounts together in LGTM.

  1. In the top right corner, click your user name and then click Account settings to display the settings page.
  2. Scroll down to the Delete account area and click the Delete my account button to display the Delete account page.
  3. Check that you're happy with the information you are about to delete from LGTM.
  4. When you are ready to delete your LGTM account, enter the confirmation code displayed in the final paragraph into the Enter confirmation text text box.
  5. Click Delete account.

Your account is deleted and the log in page is displayed.