Deploy a GCP server with an enrollment token

This topic explains how to deploy an Ubuntu or Debian Google Cloud Platform (GCP) server with systemd using user data and an Advanced Server Access enrollment token. You may need to modify this process to fit your specific needs

Creating a cloud server with user data means that the Advanced Server Access agent is simultaneously installed when you create a server with a cloud provider. Using user data to install software on a new cloud server can be done through any cloud provider, although user data helps dictate the specific software that you want on your servers. Installing the Advanced Server Access agent on a cloud server doesn't have to be done when the cloud server is created, but running the installation as a startup script alongside a server's creation ensures that your cloud deployment is as safe and secure as possible.


Google Cloud Platform



Google Cloud Platform account A Google Cloud Platform account is needed to access the GCP console, where you create virtual machines for your team.

Advanced Server Access



Advanced Server Access team The top-level object that represents an Okta org within Advanced Server Access.
Advanced Server Access project The authorization-scope of your team, organizing your users, groups, and servers.

Create an Advanced Server Access enrollment token

  1. From the Advanced Server Access dashboard, click Projects.
  2. Select the project you want to add the server to.
  3. Go to the Enrollment tab and click Create Enrollment Token.

    Note: You can use the same enrollment token every time you add a server to your team. If you have already created an enrollment token, skip this step.

  4. Enter a description for the token, then click Submit.

After the token has been successfully created, note the string of characters from the Token field and store them in a safe location.

Create a GCP project

  1. Navigate to the Google Cloud Platform console and sign in to your account.
  2. From the Select a project menu, click New Project.
  3. Create a new name for your project and use the Location field to set its parent organization or folder .
  4. Click Create when you've finished creating your project.
  5. From the dashboard of your new project, copy the Project ID number from the Project Info section and store it in a safe location.

    Note: To locate the project dashboard, use the Select a project field at the top of the console.

Create and enroll a virtual machine using user data

  1. From the GCP Console, select Compute Engine and then VM instances.
  2. If prompted, select your new project from the Select a project dropdown.
  3. Click Create.
  4. Create a name for your new server and set its region and zone. These options determine where your server is located.
  5. Click Management, security, disks, networking, sole tenancy to expand it.
  6. When creating a server in your GCP console, you must install Advanced Server Access server agent. Use the Startup Script field to install the Advanced Server Access server agent. See Install the Advanced Server Access server agent for instructions.

  7. Click Create.

After your server is finished being created on the VM instances page, confirm that the server is listed in the Server tab of your Advanced Server Access project before you attempt to connect to it.

Next steps

Verify server enrollment