Citrix Virtual Apps and Desktops

Connection to Oracle C3 (Preview)

April 28, 2026

Contributed by:

The Create and manage connections and resources article describes the generic connection workflow. The following information covers Oracle C3-specific details.

Note:

Before creating a connection to Oracle C3, finish setting up your Oracle C3 environment. See Oracle C3 virtualization environments.

Create a connection

You can create a connection to Oracle C3 using:

Web Studio
PowerShell commands

Create a connection using Web Studio

In Add Connection and Resources, select Oracle C3 as the connection type.
Under Oracle Compute Cloud@Customer configuration, select Import configuration, and paste the Oracle C3 configuration file (.ini) content.
Under Private key, select Add key, and paste the private key content from the credential file (.pem).
Enter a friendly Connection name.
Continue with the wizard and validate connectivity.

Note:

Service account ID is extracted from the imported configuration and cannot be edited directly in Web Studio. The Oracle C3 endpoint is also derived from the region value in the imported configuration and can’t be entered manually in this flow. Enter region in Oracle C3 format as <service_name>.<domain_name> (FQDN-style value).

When you import configuration in Web Studio, the following keys are only imported. All other keys are ignored:

user
fingerprint
tenancy
region

Connection setup can stop in the following certificate scenarios:

Certificate validation or thumbprint verification fails: connection creation is blocked until the issue is resolved.

Create a connection using PowerShell commands

When creating a connection using PowerShell, provide:

Oracle C3 endpoint address, typically https://iaas.<service_name>.<domain_name>.
Oracle C3 user OCID from the configuration file (user).
Private key content from the credential file (.pem), passed as a secure string.
CustomProperties XML containing TenancyOcid, Fingerprint, and Region.
SSL thumbprint for certificate trust validation, when required.

Example pattern:

$CustomProperties = '<CustomProperties xmlns="http://schemas.citrix.com/2014/xd/machinecreation" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">' +

'<Property xsi:type="StringProperty" Name="TenancyOcid" Value="' + $TenancyOcid + '" />' +

'<Property xsi:type="StringProperty" Name="Fingerprint" Value="' + $Fingerprint + '" />' +

'<Property xsi:type="StringProperty" Name="Region" Value="' + $Region + '" />' +

'</CustomProperties>'

$PrivateKey = ConvertTo-SecureString $PrivateKeyContent -AsPlainText -Force

New-Item -ConnectionType "Custom" `

-HypervisorAddress $Endpoint `

-Path @("XDHyp:\Connections\$ConnectionName") `

-Persist `

-PluginId "OracleC3PluginFactory" `

-CustomProperties $CustomProperties `

-SecurePassword $PrivateKey `

-UserName $UserOcid `

-SslThumbprint $SslThumbprint

<!--NeedCopy-->

Note:

Set $Region to the Oracle C3 region value in <service_name>.<domain_name> format. Use -SslThumbprint when required by your certificate trust policy.

Certificate and thumbprint validation

For a successful Oracle C3 connection, certificate validation must succeed and thumbprint values must be correct where required.

Manage connections

This section covers:

Fix certificate issues using Web Studio
Update thumbprint values using PowerShell

Fix certificate issues

When certificate issues occur, Citrix blocks the Oracle C3 connection to protect workload operations. An error icon appears next to the connection in the Host connections list.

To fix:

Open the connection from Host connections.
View Troubleshoot details and identify the certificate problem.
Select Edit Connection > Edit settings.
For Oracle C3, re-import the configuration and private key if prompted. When both are available, save changes to trigger a new round of certificate validation, as during connection creation, and validate/trust the updated certificate thumbprint when presented.

Update thumbprint values

You can update thumbprint values after creation by using Set-Item.

Get connection details.

Get-Item -LiteralPath xdhyp:\connections\<OracleC3ConnectionName>
<!--NeedCopy-->

Update thumbprint value.

Set-Item -LiteralPath xdhyp:\connections\<OracleC3ConnectionName> `

-Username <UserName> `

-SslThumbprint <ThumbprintValue>
<!--NeedCopy-->

Verify updated value:

Get-Item -LiteralPath xdhyp:\connections\<OracleC3ConnectionName>
<!--NeedCopy-->

Note:

Update fails if the supplied thumbprint is incorrect or does not match server certificate trust.

Where to go next

If you’re in the initial deployment process, see Create machine catalogs
For Oracle C3 specific information, see Create an Oracle C3 machine catalog

More information

The official version of this content is in English. Some of the Cloud Software Group documentation content is machine translated for your convenience only. Cloud Software Group has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Cloud Software Group product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Cloud Software Group, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Cloud Software Group will not be held responsible for any damage or issues that may arise from using machine-translated content.

Was this helpful

Connection to Oracle C3 (Preview)

April 28, 2026

Contributed by:

April 28, 2026

Contributed by:

Connection to Oracle C3 (Preview)

Create a connection

Create a connection using Web Studio

Create a connection using PowerShell commands

Certificate and thumbprint validation

Manage connections

Fix certificate issues

Update thumbprint values

Where to go next

More information

In this article