Citrix Virtual Apps and Desktops

Oracle C3 への接続 (プレビュー)

接続とリソースの作成および管理の記事では、一般的な接続ワークフローについて説明しています。以下の情報は、Oracle C3固有の詳細を扱っています。

注:

Oracle C3への接続を作成する前に、Oracle C3環境のセットアップを完了してください。Oracle C3仮想化環境を参照してください。

接続を作成する

Oracle C3への接続は、次の方法で作成できます。

  • ウェブスタジオ
  • PowerShellコマンド

Web Studioを使用して接続を作成する

  1. 接続とリソースの追加で、接続タイプとしてOracle C3を選択します。
  2. Oracle Compute Cloud@Customer構成で、構成のインポートを選択し、Oracle C3構成ファイル (.ini) のコンテンツを貼り付けます。
  3. 秘密鍵で、鍵の追加を選択し、資格情報ファイル (.pem) から秘密鍵のコンテンツを貼り付けます。
  4. わかりやすい接続名を入力します。
  5. ウィザードを続行し、接続を検証します。

注:

サービスアカウントIDは、インポートされた構成から抽出されるため、Web Studioで直接編集することはできません。Oracle C3エンドポイントも、インポートされた構成のregion値から派生するため、このフローで手動で入力することはできません。Oracle C3形式でregion<service_name>.<domain_name>(FQDN形式の値)として入力してください。

Web Studioで構成をインポートすると、次のキーのみがインポートされます。その他のキーはすべて無視されます。

  • user
  • fingerprint
  • tenancy
  • region

接続設定は、次の証明書シナリオで停止する可能性があります。

  • 証明書の検証またはサムプリントの確認に失敗した場合:問題が解決されるまで、接続の作成はブロックされます。

PowerShell コマンドを使用して接続を作成する

PowerShell を使用して接続を作成する場合、以下を指定します。

  • Oracle C3 エンドポイントアドレス。通常は https://iaas.<service_name>.<domain_name> です。
  • 構成ファイルからの Oracle C3 ユーザー OCID (user)。
  • 資格情報ファイルからの秘密鍵の内容 (.pem)。セキュア文字列として渡されます。
  • TenancyOcidFingerprint、および Region を含む CustomProperties XML。
  • 必要に応じて、証明書の信頼性検証のための SSL サムプリント。

例のパターン:

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

注:

$Region<service_name>.<domain_name> 形式の Oracle C3 リージョン値に設定します。証明書信頼ポリシーで必要な場合は -SslThumbprint を使用します。

証明書とサムプリントの検証

Oracle C3 接続を成功させるには、証明書の検証が成功し、必要な場合はサムプリント値が正しい必要があります。

接続の管理

このセクションでは、以下について説明します。

  • Web Studio を使用して証明書の問題を修正する
  • PowerShell を使用してサムプリント値を更新する

証明書の問題を修正する

証明書の問題が発生した場合、Citrix はワークロード操作を保護するために Oracle C3 接続をブロックします。ホスト接続リストの接続の横にエラーアイコンが表示されます。

修正するには:

  1. ホスト接続から接続を開きます。
  2. トラブルシューティングの詳細を表示し、証明書の問題を特定します。
  3. 接続の編集 > 設定の編集を選択します。
  4. Oracle C3 の場合、プロンプトが表示されたら、構成と秘密鍵を再インポートしてください。両方が利用可能になったら、変更を保存して、接続作成時と同様に、新たな証明書検証をトリガーし、提示された更新された証明書のサムプリントを検証/信頼してください。

サムプリント値を更新する

作成後にSet-Itemを使用してサムプリント値を更新できます。

  1. 接続の詳細を取得します。

    Get-Item -LiteralPath xdhyp:\connections\<OracleC3ConnectionName>
    <!--NeedCopy-->
    
  2. サムプリント値を更新します。

    Set-Item -LiteralPath xdhyp:\connections\<OracleC3ConnectionName> `
    
    -Username <UserName> `
    
    -SslThumbprint <ThumbprintValue>
    <!--NeedCopy-->
    
  3. 更新された値を確認します:

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

注:

指定されたサムプリントが正しくないか、サーバー証明書の信頼と一致しない場合、更新は失敗します。

次のステップ

詳細情報

Oracle C3 への接続 (プレビュー)