AI Coding Assistant Lingma:Log on to Enterprise Dedicated Edition

Step 1: Before you start

• Set up a user account for the Enterprise Dedicated Edition. If you do not have one, contact your enterprise administrator. If Single Sign-On (SSO) is set up for your enterprise, you can use your enterprise credentials to log on.

• Get developer permissions of Lingma. If you do not have one, contact your enterprise administrator. Check Manage authorization for more details.

• Install the Lingma IDE plugin for JetBrains IDEs, Visual Studio Code, or Visual Studio. Or download and install Lingma IDE. See Install Lingma for more details.

Step 2: Configure the domain URL

Before you log on to Lingma, you need to set up the domain URL address for Enterprise Dedicated Edition first.

1. Contact your admin for the domain URL. If you are the admin, here is the guide on how to get your domain URL:

   1. Log on to the Alibaba Cloud Management Console and navigate to the console.

   2. In the left-side navigation pane, click Instances.

   3. On the page that appears, select the Dedicated tab and go to the instance details page to see Public Domain and VPC Domain.

   

2. Go to your IDE, configure the domain URL parameters in Lingma:

   • Visual Studio Code:

     1. Select Lingma in the left-side panel.

     2. Navigate to the settings page.

     3. Enter the dedicated domain URL.

     4. Save the changes and reload.

     

   • JetBrains IDEs:

     1. Go to IntelliJ IDEA > Preferences.

     2. Select Lingma in the left-side navigation bar.

     3. Select Dedicated Domain for Account, and enter the dedicated domain URL.

     4. Restart IntelliJ IDEA.

     

Step 3: Log on to Lingma

You can log on to Lingma via either of these options:

• Use your Alibaba Cloud account. If SSO is enabled, you can use your enterprise account.

• Use your access token for Enterprise Dedicated Edition.

Option 1: Log on from the logon page

On your first launch after installation, you can log on to Lingma following these steps:

1. Open Lingma and choose Log in with Enterprise Dedicated URL from the list.

   

2. Auto-complete organization authentication on the logon page. Check whether the logon account has been added to an organization:

   • Single organization: The logon is auto-completed as the current developer of the organization.

   • Multiple organizations: Select a team to proceed.

   

Option 2: Use access tokens for remote development

When you code on a remote computer using connection tools like remote Secure Shell (SSH), Windows Subsystem for Linux (WSL), or Docker in Visual Studio Code, use your access token to log on to Lingma. Here are the steps:

1. In the Lingma chat panel, click Log in. Open Settings and locate Dedicated Domain URL under Extension.

2. Generate an access token:

   1. Go to the console and navigate to Personal Settings page.

   2. Select Access Token, and click Create Access Token.

   3. Enter the name, description, and expiration date of the access token, and select the Read-only permission for Users under Administration.

   4. Copy the access token you created.

3. Paste the access token into the IDE, and validate the connection.

   • VS Code and Lingma IDE:

     1. Use the following shortcut key to open the command palette:

        macOS	Windows
        ⌘ ⇧ P	Ctrl Shift P

     2. Search for Lingma to find the option Log in with Access Token.

     3. Paste the access token you copied in the previous step.

     4. Depending on your account:

        • If your account is only linked to one organization, press Enter to log on.

        • If your account is linked to multiple organizations, press Enter and choose the one you want to log on.

   • JetBrains IDEs:

     1. Go to the settings page.

     2. Under Other Settings > Lingma, find the option Log in with Access Token.

     3. Paste the access token you copied in the previous step.

     4. Depending on your account:

        • If your account is only linked to one organization, click Log in.

        • If your account is linked to multiple organizations, choose the one you want and then click Log in.

     

You are now ready to start using Lingma.