Citrix Virtual Apps and Desktops

Connexion à Oracle C3 (Aperçu)

L’article (/fr-fr/citrix-virtual-apps-desktops/install-configure/connections) décrit le flux de travail générique de connexion. Les informations suivantes couvrent les détails spécifiques à Oracle C3.

Remarque :

Avant de créer une connexion à Oracle C3, terminez la configuration de votre environnement Oracle C3. Consultez (/fr-fr/citrix-virtual-apps-desktops/install-configure/install-prepare/oracle-c3.html).

Créer une connexion

Vous pouvez créer une connexion à Oracle C3 à l’aide de :

  • Web Studio
  • Commandes PowerShell

Créer une connexion à l’aide de Web Studio

  1. Dans Ajouter une connexion et des ressources, sélectionnez Oracle C3 comme type de connexion.
  2. Sous Configuration Oracle Compute Cloud@Customer, sélectionnez Importer la configuration et collez le contenu du fichier de configuration Oracle C3 (.ini).
  3. Sous Clé privée, sélectionnez Ajouter une clé et collez le contenu de la clé privée du fichier d’informations d’identification (.pem).
  4. Saisissez un Nom de connexion convivial.
  5. Poursuivez avec l’assistant et validez la connectivité.

Remarque :

L’ID du compte de service est extrait de la configuration importée et ne peut pas être modifié directement dans Web Studio. Le point de terminaison Oracle C3 est également dérivé de la valeur region dans la configuration importée et ne peut pas être saisi manuellement dans ce flux. Saisissez region au format Oracle C3 comme <service_name>.<domain_name> (valeur de style FQDN).

Lorsque vous importez la configuration dans Web Studio, seules les clés suivantes sont importées. Toutes les autres clés sont ignorées :

  • user
  • fingerprint
  • tenancy
  • region

La configuration de la connexion peut s’arrêter dans les scénarios de certificat suivants :

  • La validation du certificat ou la vérification de l’empreinte échoue : la création de la connexion est bloquée jusqu’à ce que le problème soit résolu.

Créer une connexion à l’aide de commandes PowerShell

Lors de la création d’une connexion à l’aide de PowerShell, fournissez :

  • L’adresse du point de terminaison Oracle C3, généralement https://iaas.<service_name>.<domain_name>.
  • L’OCID utilisateur Oracle C3 du fichier de configuration (user).
  • Contenu de la clé privée du fichier d’informations d’identification (.pem), transmis sous forme de chaîne sécurisée.
  • Le fichier XML CustomProperties contenant TenancyOcid, Fingerprint et Region.
  • L’empreinte SSL pour la validation de la confiance du certificat, si nécessaire.

Exemple de modèle :

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

Remarque :

Définissez $Region sur la valeur de la région Oracle C3 au format <service_name>.<domain_name>. Utilisez -SslThumbprint lorsque votre politique de confiance des certificats l’exige.

Validation des certificats et des empreintes numériques

Pour une connexion Oracle C3 réussie, la validation du certificat doit réussir et les valeurs d’empreinte numérique doivent être correctes si nécessaire.

Gérer les connexions

Cette section couvre :

  • Résoudre les problèmes de certificat à l’aide de Web Studio
  • Mettre à jour les valeurs d’empreinte numérique à l’aide de PowerShell

Résoudre les problèmes de certificat

Lorsque des problèmes de certificat surviennent, Citrix bloque la connexion Oracle C3 pour protéger les opérations de charge de travail. Une icône d’erreur apparaît à côté de la connexion dans la liste Connexions d’hôte.

Pour corriger :

  1. Ouvrez la connexion à partir de Connexions d’hôte.
  2. Affichez les détails de Dépannage et identifiez le problème de certificat.
  3. Sélectionnez Modifier la connexion > Modifier les paramètres.
  4. Pour Oracle C3, réimportez la configuration et la clé privée si vous y êtes invité. Lorsque les deux sont disponibles, enregistrez les modifications pour déclencher une nouvelle validation du certificat, comme lors de la création de la connexion, et validez/approuvez l’empreinte numérique du certificat mise à jour lorsqu’elle est présentée.

Mettre à jour les valeurs d’empreinte numérique

Vous pouvez mettre à jour les valeurs d’empreinte numérique après la création en utilisant Set-Item.

  1. Obtenir les détails de la connexion.

    Get-Item -LiteralPath xdhyp:\connections\<OracleC3ConnectionName>
    <!--NeedCopy-->
    
  2. Mettre à jour la valeur d’empreinte numérique.

    Set-Item -LiteralPath xdhyp:\connections\<OracleC3ConnectionName> `
    
    -Username <UserName> `
    
    -SslThumbprint <ThumbprintValue>
    <!--NeedCopy-->
    
  3. Vérifier la valeur mise à jour :

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

Remarque :

La mise à jour échoue si l’empreinte numérique fournie est incorrecte ou ne correspond pas à la confiance du certificat de serveur.

Où aller ensuite

Plus d’informations

Connexion à Oracle C3 (Aperçu)