Connect a Managed VM

Open Cloud Manager

Log in to Thinfinity Workspace as an administrator, click the profile icon, and then click Cloud Manager in the right sidebar.

Cloud Manager opens.

Add OCI Credentials

Cloud Manager needs OCI API Key credentials to communicate with your Oracle Cloud account. If you have already saved a valid OCI credential set in Cloud Manager (for example, from a previous Quick Start track or from earlier configuration work), skip to Step 3.

Otherwise, register your credentials now:

1. From the top right of the screen, select Credentials.
2. Click + New from the top right of the screen to open the credential form.
3. Select Oracle Cloud as the provider.

4. Leave Use Instance Principal off — this Quick Start uses API Key authentication, which works in every deployment topology. Instance Principal is an alternative for Thinfinity Workspace servers that run on an OCI Compute instance — see Oracle Cloud Credentials → Option B.
5. Fill in the following fields.

6. Click Save. Cloud Manager validates the credentials immediately and adds the entry to the Credentials list with a Valid status badge. If the badge instead shows Invalid, the most common causes are a mismatched fingerprint or the wrong private key file — see the linked guide below for the full error reference.

Register the Existing VM

With credentials in place, you can now bring your existing OCI Compute instance under Cloud Manager management.

In the left navigation panel, expand the Managed VMs section and click the + Add button next to the section header. The Managed VM Configuration Wizard opens.

Provider selection step

Select the provider where your VM is hosted. For our example, choose Oracle Cloud and click Next.

Authentication step

Existing option is selected by default, choose the OCI credentials set you created in Step 2 then click Next.

Search parameters step

1. In the Compartment Path field enter the name of the compartment where the VM lives.
2. In the Instance pattern field, enter the complete name or part of the instance name to filter the results. Leave it blank to list all instances available in the selected compartment.
3. Click Next.

Access step

Leave the default Connection Mode as Public IP and click Next.

Power options step

Enable On Demand to allow Cloud Manager to start the VM automatically when a user requests a session then click Next.

Name step

Enter a descriptive Name for this connection (for example, OCI-Finance-VM) and click Finish.

Select the Instance to Manage

The wizard has created the provider connection. Now you have to select the specific OCI instance you want to bring under management.

1. In the Managed VMs tab, select the connection you just created.
2. Click Manage Instances at the top right of Instances tab.
3. In the Instances Manager window, check the OCI Compute instance you want to manage.
4. Click Save.

The instance appears in the Instances tab with its current status.

Create an Access Profile

An Access Profile makes the instance visible and launchable in the Thinfinity® Workspace portal for end users.

1. From the Instances tab, select the instance then from the options available to the right for it, click New Profile to launch the Access Profile wizard.
2. In the first step of the wizard select the type of Access Profile you want to create for your instance. For our example, choose RDC then click Next.

3. In Set up the Connection step:
   • Confirm the name of the selected instance is displayed in the Available Instances field.
   • Set Stop after disconnect to 5 (minutes) to keep the VM running briefly after the user disconnects. This grace period prevents the VM from powering down immediately when the user closes their session, which is useful if they need to reconnect quickly. Tune the value to your workload — shorter delays (1–2 minutes) minimize idle compute cost; longer delays (10–15 minutes) keep the VM ready for users who reconnect frequently. Click Next when done.

4. In Authentication Options leave the default option, Ask for new credentials (the user will enter their Windows or Linux credentials at session start), and click Next.
5. In Permissions, add the user or group that should have access to this profile then click Next.
6. Enter a Name for the profile (for example, OCI Finance Desktop), and then click Next. A confirmation message is displayed, click Done to leave the wizard.

You will be presented with the Public Profiles tab where all Access Profiles created in this installation are available.

1. Check that the new Access Profile appears in the list then make sure to click Apply. The profile is not active and users will not see it in the portal until you click Apply.

Test the Connection

1. Open the Thinfinity Workspace portal in a new browser tab (or in a different browser as the target end user).
2. Log in with the credentials of the user you granted access to in Step 5.
3. Locate the OCI Finance Desktop tile on the portal home screen.
4. Click the tile and enter the VM credentials when prompted.

The remote session opens in the browser. Track A is complete.