Azure Sign In Instructions for the Azure Toolkit for Eclipse

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

  • Automated - when you are using this method, you will create a credentials file which contains your service principal data, after which you can use the credentials file to automatically sign into your Azure account.
  • Interactive - when you are using this method, you will enter your Azure credentials each time you sign into your Azure account.

The steps in the following sections will describe how to use each method.

Prerequisites

The Azure Toolkit for Eclipse requires the following software components:

  • Eclipse IDE for Java EE Developers, Mars, or later. You can download it from the Eclipse website.

  • A Java Developer Kit (JDK), version 1.8 or later.

  • An operating system. The Azure Toolkit for Eclipse has been tested on the following operating systems:

    • Windows 10, Windows 8.1, Windows 8, and Windows 7
    • Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2, and Windows Server 2008
    • Mac OS X version "Yosemite" and later
    • Ubuntu Linux version 14, 15, and 16

For more information, see the Azure Toolkit for Eclipse page at the Eclipse Marketplace.

Signing into your Azure account automatically and creating a credentials file to use in the future

The following steps will walk you through creating a credentials file which contains your service principal data. Once you have completed these steps, Eclipse will automatically use the credentials file to automatically sign you into Azure each time you open your project.

  1. Open your project with Eclipse.

  2. Click Tools, then click Azure, and then click Sign In.

    Eclipse Menu for Azure Sign In

  3. When the Azure Sign In dialog box appears, select Automated, and then click New.

    Sign In Dialog Box

  4. When the Azure Log In dialog box appears, enter your Azure credentials, and then click Sign In.

    Azure Log In Dialog Box

  5. When the Create authentication files dialog box appears, select the subscriptions that you want to use, choose your destination directory, and then click Start.

    Azure Log In Dialog Box

  6. The Service Principal Creatation Status dialog box will be displayed, and after your files have been created successfully, click OK.

    Service Principal Creatation Status Dialog Box

  7. When the Azure Sign In dialog box appears, click Sign In.

    Azure Log In Dialog Box

  8. When the Select Subscriptions dialog box appears, select the subscriptions that you want to use, and then click OK.

    Select Subscriptions Dialog Box

Signing out of your Azure account when you signed in automatically

After you have configured the steps in the previous section, the Azure Toolkit will automatically sign you into your Azure account each time you restart Eclipse. However, to sign out of your Azure account and prevent the Azure Toolkit from signing you in automatically, 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

Signing into your Azure account automatically using a credentials file which you have already created

If you sign out of Azure when you are using Eclipse, you will need to reconfigure the Azure Toolkit for Eclipse to use a credentials file which have created before you can automatically sign into your Azure acccount. The following steps will walk you through configuring the Azure Toolkit to use an existing credentials file.

  1. Open your project with Eclipse.

  2. Click Tools, then click Azure, and then click Sign In.

    Eclipse Menu for Azure Sign In

  3. When the Azure Sign In dialog box appears, select Automated, and then click Browse.

    Sign In Dialog Box

  4. When the Select Authenticated File dialog box appears, select a credentials file which you created earlier, and then click Select.

    Sign In Dialog Box

  5. When the Azure Sign In dialog box appears, click Sign In.

    Azure Log In Dialog Box

  6. When the Select Subscriptions dialog box appears, select the subscriptions that you want to use, and then click OK.

    Select Subscriptions Dialog Box

Signing into your Azure account interactively

The following steps will illustrate how to sign into Azure by manually entering your Azure credentials.

  1. Open your project with Eclipse.

  2. Click Tools, then click Azure, and then click Sign In.

    Eclipse Menu for Azure Sign In

  3. When the Azure Sign In dialog box appears, select Interactive, and then click Sign In.

    Sign In Dialog Box

  4. When the Azure Log In dialog box appears, enter your Azure credentials, and then click Sign In.

    Azure Log In Dialog Box

  5. When the Select Subscriptions dialog box appears, select the subscriptions that you want to use, and then click OK.

    Select Subscriptions Dialog Box

Signing out of your Azure account when you signed in interactively

After you have configured the steps in the previous section, you will automatically signed out of your Azure account each time you restart Eclipse. However, if you want to sign out of your Azure account without restarting Eclipse, 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

For more information about the Azure toolkits for Java IDEs, see the following links:

For more information about using Java with Azure, see the Azure Java Developer Center and the Java Tools for Visual Studio Team Services.