Skip to content

Installation

Johannes Passing edited this page Jun 16, 2022 · 13 revisions

Prerequisites

To install IAP Desktop, you'll need:

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

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

To use IAP Desktop, you'll 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,tcp:22 \
        --source-ranges=35.235.240.0/20
    

    For further details on 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

    Start installer

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

    Finish installer

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, select the Google Cloud project that contains the instances that yout want to connect to, then click Add project.

    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