Skip to content

Installation

Johannes Passing edited this page Aug 20, 2020 · 13 revisions

Prerequisites

To install IAP Desktop, you'll need:

  • Desktop: Windows 8 or higher
  • Server: Windows Server 2012 or higher
  • Internet access (at least to Google APIs), either directly, via NAT, or proxy

You do not need admin rights unless you are installing on Windows Server.

To use IAP Desktop, you also need:

  • A Google Cloud project. If you are a Project Owner of the project, you have all permissions needed to use IAP Desktop. Otherwise, you need a combination of the following roles:

  • A firewall rule that permits access from Identity-Aware-Proxy to VM instances. You can create such a firewall rule by using the following command:

    gcloud compute firewall-rules create allow-rdp-ingress-from-iap \
        --direction=INGRESS \
        --action=allow \
        --rules=tcp:3389 \
        --source-ranges=35.235.240.0/20
    

    For further details setting up permissions and firewall rules, see Preparing your project for IAP TCP forwarding.

Installing IAP Desktop

To install IAP Desktop on your computer, follow these steps:

  1. Double-click the downloaded installer package

  2. Follow the instructions of the installer. Once you reach the Completed IAP Desktop Setup Wizard step, click Finish to launch IAP Desktop:

    MSI

Connecting to your Google Cloud project

You now set up IAP Desktop for first use:

  1. On the Sign-in dialog, click Sign in with Google:

    Sign in

  2. Follow the instructions in the browser to authorize IAP Desktop to access your Google Cloud project.

  3. In the Add project dialog, type the name or ID of a Google Cloud project that contains Windows VM instances, then click OK.

    Select project

  4. Notice that the project and all Windows VM instances are added to the Project Explorer window:

    Select project

This completes the installation of IAP Desktop.

What's next

Clone this wiki locally