Sign-in instructions for the Azure Toolkit for Eclipse

The Azure Toolkit for Eclipse provides two methods for signing into your Azure account:

Sign out methods are also provided.

Prerequisites

To complete the steps in this article, you will need to install the Azure Toolkit for Eclipse, which requires the following software components:

Note

The Azure Toolkit for Eclipse page at the Eclipse Marketplace lists the builds that are compatible with the toolkit.

Sign in to your Azure account by Device Login

To sign in Azure by device login, do the following:

  1. Open your project with Eclipse.

  2. Click Tools, then click Azure, and then click Sign In. Eclipse Menu for Azure Sign In

  3. In the Azure Sign In window, select Device Login, and then click Sign in.

    The Azure Sign In window with device login selected

  4. Click Copy&Open in Azure Device Login dialog .

    The Azure Login Dialog window

Note

If the browser doesn't open, configure Eclipse to use an external browser like Internet Explorer, Firefox, or Chrome:

  1. Open Preferences -> General -> Web Browser -> Use external web browser in Eclipse

  2. Select the browser you prefer to use

  1. In the browser, paste your device code (which has been copied when you clicked Copy&Open in last step) and then click Next.

    The device login browser

  2. Finally, in the Select Subscriptions dialog box, select the subscriptions that you want to use, then click OK.

    The Select Subscriptions dialog box

Sign in to your Azure account by Service Principal

This section walks you through creating a credentials file that contains your service principal data. After you have completed this process, Eclipse uses the credentials file to automatically sign you in to Azure when open your project.

  1. Open your project with Eclipse.

  2. Click Tools, then click Azure, and then click Sign In. The Eclipse Azure Sign In command

  3. In the Azure Sign In window, select Service Principal. If you do not have the service principal authentication file yet, click New to create one. Otherwise you can click Browse to open it and jump to step 8.

    The Azure Sign In window with service principal selected

  4. Click Copy&Open in Azure Device Login dialog.

    The Azure Login Dialog window

Note

If the browser doesn't open, configure eclipse to use an external browser like IE or Chrome:

  1. Open Preferences -> General -> Web Browser -> Use external web browser in Eclipse

  2. Select the browser you prefer to use

  1. In the browser, paste your device code (which has been copied when you click Copy&Open in last step) and then click Next.

    The device login browser

  2. In the Create Authentication Files window, select the subscriptions that you want to use, choose your destination directory, and then click Start.

    The Create Authentication Files window

  3. In the Service Principal Creation Status dialog box, click OK after your files have been created successfully.

    The Service Principal Creation Status dialog box

  4. Address of the created file will be automatically filled in the Azure Sign In window, now click Sign in.

    Azure Log In Dialog Box

  5. Finally, in the Select Subscriptions dialog box, select the subscriptions that you want to use, then click OK.

    The Select Subscriptions dialog box

Sign out of your Azure account

After you have configured your account by preceding steps, you will be automatically signed in each time you start Eclipse. However, if you want to sign out of your Azure account, use the following steps.

  1. In Eclipse, click Tools, then click Azure, and then click Sign Out.

    Eclipse Menu for Azure Sign Out

  2. When the Azure Sign Out dialog box appears, click Yes.

    Sign Out Dialog Box

Next steps

To report bugs or request new features, create issues on our GitHub repository. Or, ask questions on Stack Overflow with tag azure-java-tools.

For more information about using Java with Azure, see the following links: