Documentação de produtos
Citrix Virtual Apps and Desktops
Serviço 2607 LTSR Versão Atual 2511 2507 LTSR 2503 2411 2407 2402 LTSR 2311 2203 LTSR
Ver PDF

Conexão com Oracle C3 (Pré-visualização)

September 15, 2026
Contribuição de: 
C

O artigo Criar e gerenciar conexões e recursos descreve o fluxo de trabalho de conexão genérico. As informações a seguir cobrem detalhes específicos do Oracle C3.

Nota:

Antes de criar uma conexão com o Oracle C3, conclua a configuração do seu ambiente Oracle C3. Consulte Ambientes de virtualização Oracle C3.

Criar uma conexão

Você pode criar uma conexão com o Oracle C3 usando:

  • Web Studio
  • Comandos PowerShell

Criar uma conexão usando o Web Studio

  1. Em Adicionar Conexão e Recursos, selecione Oracle C3 como o tipo de conexão.
  2. Em Configuração do Oracle Compute Cloud@Customer, selecione Importar configuração e cole o conteúdo do arquivo de configuração do Oracle C3 (.ini).
  3. Em Chave privada, selecione Adicionar chave e cole o conteúdo da chave privada do arquivo de credenciais (.pem).
  4. Insira um Nome da conexão amigável.
  5. Continue com o assistente e valide a conectividade.

Nota:

ID da conta de serviço é extraído da configuração importada e não pode ser editado diretamente no Web Studio. O endpoint do Oracle C3 também é derivado do valor region na configuração importada e não pode ser inserido manualmente neste fluxo. Insira region no formato Oracle C3 como <service_name>.<domain_name> (valor estilo FQDN).

Ao importar a configuração no Web Studio, apenas as seguintes chaves são importadas. Todas as outras chaves são ignoradas:

  • user
  • fingerprint
  • tenancy
  • region

A configuração da conexão pode parar nos seguintes cenários de certificado:

  • A validação do certificado ou a verificação da impressão digital falha: a criação da conexão é bloqueada até que o problema seja resolvido.

Criar uma conexão usando comandos PowerShell

Ao criar uma conexão usando PowerShell, forneça:

  • Endereço do endpoint Oracle C3, tipicamente https://iaas.<service_name>.<domain_name>.
  • OCID do usuário Oracle C3 do arquivo de configuração (user).
  • Conteúdo da chave privada do arquivo de credenciais (.pem), passado como uma string segura.
  • XML CustomProperties contendo TenancyOcid, Fingerprint e Region.
  • Impressão digital SSL para validação de confiança do certificado, quando necessário.

Padrão de exemplo:

$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-->

Nota:

Defina $Region para o valor da região Oracle C3 no formato <service_name>.<domain_name>. Use -SslThumbprint quando exigido pela sua política de confiança de certificado.

Validação de certificado e impressão digital

Para uma conexão Oracle C3 bem-sucedida, a validação do certificado deve ser bem-sucedida e os valores da impressão digital devem estar corretos onde for necessário.

Gerenciar conexões

Esta seção aborda:

  • Corrigir problemas de certificado usando o Web Studio
  • Atualizar valores de impressão digital usando o PowerShell

Corrigir problemas de certificado

Quando ocorrem problemas de certificado, a Citrix bloqueia a conexão Oracle C3 para proteger as operações da carga de trabalho. Um ícone de erro aparece ao lado da conexão na lista Conexões de host.

Para corrigir:

  1. Abra a conexão em Conexões de host.
  2. Visualize os detalhes de Solução de problemas e identifique o problema do certificado.
  3. Selecione Editar conexão > Editar configurações.
  4. Para Oracle C3, reimporte a configuração e a chave privada se solicitado. Quando ambos estiverem disponíveis, salve as alterações para acionar uma nova rodada de validação de certificado, como durante a criação da conexão, e valide/confie na impressão digital do certificado atualizado quando apresentada.

Atualizar valores de impressão digital

Você pode atualizar os valores de impressão digital após a criação usando Set-Item.

  1. Obter detalhes da conexão.

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

  2. Atualizar valor da impressão digital.

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

-Username <UserName> `

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

  3. Verificar valor atualizado:

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

Nota:

A atualização falha se a impressão digital fornecida estiver incorreta ou não corresponder à confiança do certificado do servidor.

Onde ir em seguida

Mais informações

Conexão com Oracle C3 (Pré-visualização)
September 15, 2026
Contribuição de: 
C
September 15, 2026
Contribuição de: 
C

Neste artigo

Feedback do site | Your privacy choices footer linkSuas escolhas de privacidade | Privacidade e termos legais | Preferências de cookies | Configurações de consentimento | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.