1. RESTfulサービス管理者ガイド
  2. Oracle Key Vaultのこのリリースでの変更点

Oracle Key Vaultのこのリリースでの変更点

Oracle Key Vaultのこのリリースでは、大規模な企業でOracle Key Vaultの使用を強化する新機能が導入されています。

Oracle Key Vaultリリース21.9での変更点

Oracle Key Vaultリリース21.9には、いくつかの新機能が導入されています。

親トピック: Oracle Key Vaultのこのリリースの変更点

RESTfulサービス・ユーティリティ・コマンドを使用したオブジェクトのウォレット・メンバーシップのリスト

Oracle Key Vaultリリース21.9以降、特定の管理対象オブジェクトのすべてのウォレット・メンバーシップをリストできるようになりました。

この拡張をサポートするために、RESTfulサービス・ユーティリティに次のコマンドが追加されました:
okv manage-access wallet list-object-wallets --uuid <uuid>

RESTfulサービス・ユーティリティ・コマンドはユーザーが実行します。このユーザーがアクセスできるウォレットのみがリストされます。オブジェクトは、コマンドを実行しているユーザーがアクセス権を持たないウォレットのメンバーである可能性があります。これらのウォレットはリストされません。

親トピック: Oracle Key Vaultリリース21.9での変更点

承認済RESTful接続のリストの許可

Oracle Key Vaultリリース21.9以降、許可されたIPアドレスからのみRESTfulサービス・ユーティリティへのアクセスを有効にできます。

この新機能では、構成済リストのIPアドレスのみがRESTfulサービス・ユーティリティを使用できます。以前のOracle Key Vaultリリースでは、RESTfulサービス・ユーティリティの有効化または無効化のみを実行できました。

親トピック: Oracle Key Vaultリリース21.9での変更点

Oracle Key Vaultリリース21.8での変更点

Oracle Key Vaultリリース21.8では、いくつかの新機能が導入されています。

  • RESTfulサービス・ユーティリティ・コマンドのサーバー側フィルタリング
    Oracle Key Vaultリリース21.8以降では、エンドポイントやウォレットのリスト、エンドポイントでアクセスできるオブジェクトのリスト、ウォレット内のオブジェクトのリスト、および完了したバックアップのリストのRESTfulサービス・ユーティリティ・コマンドに対して、サーバー側フィルタリングを実行するオプションを指定できるようになりました。
  • RESTfulサービス・ユーティリティ・コマンドでのカスタム属性のサポート
    Oracle Key Vaultリリース21.8以降、add、modify、delete、getなどのRESTfulサービス・ユーティリティ・コマンドを使用するときに、セキュリティ・オブジェクトのカスタム属性およびKMIP属性をコマンドライン・オプションとして指定できます。fetchコマンドとlocateコマンドでは、コマンドラインでその他の属性もサポートされています。

親トピック: Oracle Key Vaultのこのリリースの変更点

RESTfulサービス・ユーティリティ・コマンドのサーバー側フィルタリング

Oracle Key Vaultリリース21.8以降では、エンドポイントやウォレットのリスト、エンドポイントでアクセスできるオブジェクトのリスト、ウォレット内のオブジェクトのリスト、および完了したバックアップのリストのRESTfulサービス・ユーティリティ・コマンドに対して、サーバー側フィルタリングを実行するオプションを指定できるようになりました。

エンドポイントのリストは、プラットフォーム、タイプまたは登録ステータスを基準にフィルタできます。ウォレットのリストは、それらのタイプ(汎用ウォレットまたはSSHサーバー・ウォレットのどちらか)を基準にフィルタできます。エンドポイントでアクセスできるオブジェクトのリストをフィルタすることや、タイプ(シークレットや証明書など)または状態(アクティブや侵害など)を基準にしてウォレット内のオブジェクトをリストすることができます。特定のバックアップ先について完了済バックアップのリストをフィルタすることや、それらをタイプ(1回かぎり、または定期的)を基準にフィルタすることや、単にバックアップ名を基準にフィルタすることができます。フィルタリングに複数のオプションを指定でき、フィルタリング・オプションに複数の値を指定することもできます。たとえば、次のコマンドをフィルタ・オプションとともに使用することで、LinuxおよびMicrosoft Windowsプラットフォーム上のすべてのエンドポイントをリストできます。

--platform "LINUX64, WINDOWS"
次のコマンドでは、この拡張機能がサポートされています。
  • okv admin endpoint list
  • okv admin endpoint list-objects
  • okv manage-access wallet list
  • okv manage-access wallet list-objects
  • okv backup history list

親トピック: Oracle Key Vaultリリース21.8での変更点

RESTfulサービス・ユーティリティ・コマンドでのカスタム属性のサポート

Oracle Key Vaultリリース21.8以降、add、modify、delete、getなどのRESTfulサービス・ユーティリティ・コマンドを使用するときに、セキュリティ・オブジェクトのカスタム属性およびKMIP属性をコマンドライン・オプションとして指定できます。fetchコマンドとlocateコマンドでは、コマンドラインでその他の属性もサポートされています。

activation dateやdeactivation dateなどのKMIP属性は、それぞれコマンドライン・オプション--activation-dateおよび--deactivation-dateとして使用できるようになりました。新しいコマンドライン・オプション--custom-attributeを使用して、カスタム属性を渡すことができます。

次のコマンドでは、この拡張機能がサポートされています。
  • okv managed-object attribute add
  • okv managed-object attribute modify
  • okv managed-object attribute delete
  • okv managed-object attribute get
  • okv managed-object custom-attribute add
  • okv managed-object custom-attribute modify
  • okv managed-object custom-attribute delete
  • okv managed-object custom-attribute get
  • okv managed-object object locate
  • okv managed-object object fetch

親トピック: Oracle Key Vaultリリース21.8での変更点

Oracle Key Vaultリリース21.7での変更点

Oracle Key Vaultリリース21.7には、いくつかの新機能が導入されています。

親トピック: Oracle Key Vaultのこのリリースの変更点

SSHキー管理をサポートするためのRESTfulサービス・ユーティリティの変更

リリース21.7以降では、Oracle Key VaultのRESTfulサービス・ユーティリティを使用してSSHキーを作成および登録し、SSHサーバー・ウォレットおよびSSHサーバー・エンドポイントを管理できます。

次のOracle Key Vault RESTfulサービス・ユーティリティ・コマンドが更新され、SSHキー・ペアの作成とSSH秘密キーおよび公開キーの登録がサポートされるようになりました。
  • okv managed-object key-pair create
  • okv managed-object private-key register
  • okv managed-object public-key register

これらのコマンドに新しいオプション--ssh-userが追加されます。このオプションを使用すると、下層にある公開キー・オブジェクトと秘密キー・オブジェクトがSSHキーとして識別されます。

SSHサーバー・エンドポイントおよびSSHサーバー・ウォレットの作成をサポートするために、次のコマンドが更新されました:
  • okv admin endpoint create
  • okv manage-access wallet create

親トピック: Oracle Key Vaultリリース21.7での変更点

Oracle Key Vaultリリース21.6での変更点

Oracle Key Vaultリリース21.6には、いくつかの新機能が導入されています。

親トピック: Oracle Key Vaultのこのリリースの変更点

endpoint get RESTfulコマンドに追加されたエンドポイントIPアドレス属性

Oracle Key Vaultは、endpoint get RESTfulコマンドでエンドポイントIPアドレスをサポートします。

登録時に使用したエンドポイントIPアドレスが記録されるようになり、okv admin endpoint get --endpoint endpoint_nameコマンドで表示されるようになりました。

親トピック: Oracle Key Vaultリリース21.6での変更点

Oracle Key Vaultでの署名操作と検証操作

Oracle Key Vaultリリース21.6以降、署名および検証操作をOracle Key VaultのRESTfulサービスまたはOracle Key Vaultクライアント・ツールokvutilを使用して実行できます:

Oracle Key Vault RESTful APIとOracle Key Vaultクライアント・ユーティリティokvutilの両方に、署名と検証の機能があります。

新規または更新されたコマンドは次のとおりです。
  • okv crypto data sign
  • okv crypto data sign-verify
  • okv crypto data sign
  • okv crypto data sign-verify
  • okvutil sign
  • okvutil sign-verify

親トピック: Oracle Key Vaultリリース21.6での変更点

Oracle Key Vaultリリース21.5での変更点

Oracle Key Vaultリリース21.5には、このガイドに影響する複数の新機能が導入されています。

親トピック: Oracle Key Vaultのこのリリースの変更点

RESTfulサービス・ユーティリティを使用したクラスタ管理およびモニタリングのサポート

Oracle Key Vaultリリース21.5以降、RESTfulサービス・ユーティリティを使用してマルチマスター・クラスタをデプロイ、管理およびモニターできます。

RESTfulサービス・ユーティリティを使用して、クラスタの作成、ノードの追加または削除、ノードの有効化または無効化など、いくつかのクラスタ管理操作を実行できるようになりました。RESTfulサービス・ユーティリティを使用して、クラスタ・サービスおよびノード間のレプリケーション・リンクをモニターおよび管理することもできます。

新しいコマンドは次のとおりです。

  • okv cluster node create
  • okv cluster node status
  • okv cluster node add
  • okv cluster node abort-pairing
  • okv cluster node enable
  • okv cluster node disable
  • okv cluster node cancel-disable
  • okv cluster node update
  • okv cluster service start
  • okv cluster service stop
  • okv cluster service monitor
  • okv cluster link enable
  • okv cluster link disable
  • okv cluster link monitor

関連トピック

親トピック: Oracle Key Vaultリリース21.5での変更点

RESTfulサービス・ユーティリティを使用したシステム・リソース・モニタリングのサポート

Oracle Key Vaultリリース21.5以降、RESTfulサービス・ユーティリティを使用して、CPUやメモリーなどのシステム・リソースの現在および過去の使用率メトリックを取得できます。これらのシステム・メトリックは、デプロイメントのパフォーマンスおよびスケーラビリティの要件を満たすように、Oracle Key Vaultサーバーのシステム・リソースを適切に構成するのに役立ちます。

RESTfulサービス・ユーティリティを使用して、次の情報を取得できます。
  • 構成されたシステム・リソース(CPUとメモリー)
  • ロード平均など、指定した期間のCPUおよびメモリー使用率メトリック

新規または更新されたコマンドは次のとおりです。

  • okv metrics server get
  • okv server status get
  • okv server info get

関連トピック

親トピック: Oracle Key Vaultリリース21.5での変更点

RESTfulサービス・ユーティリティ・コマンドによる中間JSONファイルの必要性の低減

Oracle Key Vaultリリース21.5以降では、RESTfulサービス・ユーティリティを使用してセキュリティ・オブジェクトを作成、登録、フェッチおよび検索するときに、コマンドライン・オプションとしてカスタム属性および特定のKMIP属性を指定できます。

以前のリリースでは、属性またはカスタム属性を使用するコマンドは、JSON入力メソッドのみを使用して実行できました。RESTfulサービス・ユーティリティは、セキュリティ・オブジェクトを作成または登録するコマンドのコマンドライン・オプションとして、属性およびカスタム属性の受渡しをサポートするように拡張されています。これらのコマンドは、複雑な入力の簡略化されたバリアントもサポートします。

KMIP属性の"activation date"および"deactivation date"は、それぞれコマンドライン・オプション--activation-dateおよび--deactivation-dateとして公開されています。新しいコマンドライン・オプション--custom-attributeを使用して、カスタム属性を渡すことができます。複数のRESTfulサービス・ユーティリティ・コマンドでは、名前およびカスタム属性に関する簡略化された形式および複雑な形式もサポートされています。

この機能拡張に対応するために、次のコマンドが更新されました。

  • okv managed-object key create
  • okv managed-object key register
  • okv managed-object secret register
  • okv managed-object certificate register
  • okv managed-object certificate-request register
  • okv managed-object opaque register
  • okv managed-object public-key register
  • okv managed-object private-key register
  • okv managed-object object fetch
  • okv managed-object object locate

関連トピック

親トピック: Oracle Key Vaultリリース21.5での変更点

RESTfulサービス・ユーティリティでのテキスト出力形式のサポート

Oracle Key Vaultリリース21.5以降、いくつかのRESTfulサービス・ユーティリティ・コマンドは、テキスト形式の出力をサポートするように拡張されています。

以前のリリースでは、RESTfulサービス・ユーティリティ・コマンドは常にJSON形式で出力を生成していました。現在は、新しいコマンドライン・オプション-output_formatを使用して、テキスト形式でコマンド出力を生成できるようになりました。テキスト出力形式は、コマンドの出力が別のコマンドの入力として機能する場合など、自動化スクリプトの作成を簡略化するのに役立ちます。

--output_formatオプションでサポートされる値は次のとおりです。
  • json (デフォルト値)
  • text

この機能拡張に対応するために、次のコマンドが更新されました。

  • okv managed-object certificate get
  • okv managed-object certificate register
  • okv managed-object certificate-request get
  • okv managed-object certificate-request register
  • okv managed-object key create
  • okv managed-object key get
  • okv managed-object key register
  • okv managed-object object activate
  • okv managed-object object destroy
  • okv managed-object object locate
  • okv managed-object object revoke
  • okv managed-object opaque get
  • okv managed-object private-key register
  • okv managed-object public-key get
  • okv managed-object public-key register
  • okv managed-object secret get
  • okv managed-object secret register
  • okv managed-object wallet add-member
  • okv managed-object wallet delete-member
  • okv managed-object wallet list

関連トピック

親トピック: Oracle Key Vaultリリース21.5での変更点

Oracle Key Vaultリリース21.4での変更点

Oracle Key Vaultリリース21.4には、このガイドに影響する複数の新機能が導入されています。

親トピック: Oracle Key Vaultのこのリリースの変更点

対称暗号化キーの抽出可能属性をサポートするRESTfulサービス・ユーティリティ・コマンド

Oracle Key Vaultリリース21.4以降では、対称キーの保護を強化するために、抽出可能属性を設定することで、これらのキーに対してOracle Key Vaultからの移動を制限できるようになりました。

この機能拡張に対応するために、次のコマンドが更新されました。

  • okv managed-object attribute get
  • okv managed-object attribute get-all
  • okv managed-object attribute list
  • okv managed-object attribute modify
  • okv managed-object key create
  • okv managed-object key register
  • okv managed-object object locate

関連トピック

親トピック: Oracle Key Vaultリリース21.4での変更点

RESTfulサービス・ユーティリティでの暗号化操作のサポート

Oracle Key Vaultリリース21.4では、Oracle Key Vault内で暗号操作を実行するためのサポートが追加されています。

RESTfulサービス・ユーティリティ・コマンドまたはCおよびJava SDKを使用して、暗号化および復号化操作を実行できます。

この機能拡張は、Oracle Key Vaultから抽出されないように構成された対称キーの使用に対応しています。

新しいコマンドは次のとおりです。

  • okv crypto data decrypt
  • okv crypto data encrypt

関連トピック

親トピック: Oracle Key Vaultリリース21.4での変更点

RESTfulサービス・ユーティリティでの古いOracle Key Vaultバックアップのポリシー・ベース自動パージのサポート

Oracle Key Vaultリリース21.4以降では、1つ以上のリモート・バックアップの削除をスケジュールするポリシーを作成できます。

次のコマンドが更新されました。

  • okv backup destination create
  • okv backup destination update

次のコマンドが新しく導入されました。

  • okv backup destination delete-backup
  • okv backup destination-policy create
  • okv backup destination-policy delete
  • okv backup destination-policy get
  • okv backup destination-policy list
  • okv backup destination-policy list-purged-backups
  • okv backup destination-policy update
  • okv backup destination resume-policy
  • okv backup destination suspend-policy

関連トピック

親トピック: Oracle Key Vaultリリース21.4での変更点

エンドポイント、エンドポイント・グループおよびウォレット関連のRESTfulサービス・ユーティリティ・コマンドの機能拡張

Oracle Key Vaultリリース21.4以降、エンドポイント、エンドポイント・グループおよびウォレットでより多くの操作を実行できるように、追加のコマンドが提供されています。

新しいコマンドは次のとおりです。

  • okv admin endpoint get
  • okv admin endpoint list
  • okv admin endpoint list-objects
  • okv admin endpoint resume
  • okv admin endpoint suspend
  • okv manage-access endpoint-group get
  • okv manage-access endpoint-group list
  • okv manage-access wallet add-object
  • okv manage-access wallet get
  • okv manage-access wallet list
  • okv manage-access wallet list-objects
  • okv manage-access wallet remove-object

エンドポイントのオブジェクトをリストするコマンド(okv admin endpoint list-objects)およびウォレットのオブジェクトをリストするコマンド(okv admin wallet list-objects)には、オブジェクトのウォレット・メンバーシップを表示または非表示にするオプションがあります。オブジェクトのウォレット・メンバーシップ情報を省略すると、コマンドのパフォーマンスを向上させることができます。

関連トピック

親トピック: Oracle Key Vaultリリース21.4での変更点

RESTfulサービス・ユーティリティを使用したエンドポイント構成のサポート

Oracle Key Vaultリリース21.4以降、RESTfulサービス・ユーティリティ・コマンドokv admin endpoint updateを使用して、エンドポイント構成パラメータと、エンドポイントのキーおよびシークレットに関するエンドポイント設定を更新できます。

エンドポイント構成パラメータには様々なPKCS#11設定が含まれ、キーとシークレットに関するエンドポイント設定には、新しい対称キーのextractable属性設定が含まれます。

関連トピック

親トピック: Oracle Key Vaultリリース21.4での変更点

日付および時刻を設定するRESTfulコマンドがISO 8601標準に対応

Oracle Key Vaultリリース21.4以降では、durationの時間間隔設定はISO 8601標準のサブセットに準拠しており、RESTfulコマンドを使用する際の日付時刻設定の固定書式はISO 8601と互換性があります。

次の書式を指定できます。

  • duration (ISO 8601標準のサブセットに準拠)
  • timestamp (ISO 8601標準と互換性がある書式)
  • now (コマンド実行時の現在の時刻を表します)

これらの書式を次のように組み合せて使用できます。

  • timestamp
  • now
  • timestamp + duration
  • now + duration

以前のリリースで使用されていたtimestamp書式は、引き続きサポートされます。

この機能拡張のために、次のコマンドが更新されました。

  • okv backup schedule create
  • okv backup schedule update
  • okv managed-object attribute add
  • okv managed-object attribute delete
  • okv managed-object attribute modify
  • okv managed-object certificate-request register
  • okv managed-object key register
  • okv managed-object object locate
  • okv managed-object opaque register
  • okv managed-object private_key register
  • okv managed-object public-key register
  • okv managed-object secret register

関連トピック

親トピック: Oracle Key Vaultリリース21.4での変更点

RESTfulサービス・ユーティリティのコマンドライン・ヘルプのサポート

Oracle Key Vaultリリース21.4以降、RESTfulサービス・ユーティリティ・コマンドに関するコマンドライン・ヘルプ情報を確認できます。

この機能拡張により、すべてのOracle Key Vault RESTfulサービス・ユーティリティ・コマンドでサポートされている様々なカテゴリ、リソースおよびアクションについての詳細なヘルプ情報を参照できます。ヘルプ情報には、コマンドの構文および使用可能なカテゴリ、リソース、アクションの定義と、すべてのコマンドに適用可能な構成パラメータが表示されます。

関連トピック

親トピック: Oracle Key Vaultリリース21.4での変更点

Oracle Key Vaultリリース21.3での変更点

Oracle Key Vaultリリース21.3では、このガイドに影響を与える1つの新機能が導入されています。

親トピック: Oracle Key Vaultのこのリリースの変更点

登録に使用されるRESTfulサービス・ユーティリティ・コマンドの拡張機能

Oracle Key Vaultリリース21.3では、管理対象オブジェクトの登録に使用されるRESTfulサービス・ユーティリティ・コマンドに追加の属性があります。

影響を受けるコマンドは次のとおりです。

  • okv managed-object certificate register
  • okv managed-object certificate-request register
  • okv managed-object key register
  • okv managed-object opaque register
  • okv managed-object private-key register
  • okv managed-object public-key register
  • okv managed-object secret register

以前のリリースでは、これらのコマンドは2つの属性nameおよびcontactInfoを提供していました。このリリースでは、これら2つの属性に加えて、次の新しい属性が含まれています。

  • activationDate
  • deactivationDate
  • processStartDate
  • protectStopDate

関連トピック

親トピック: Oracle Key Vaultリリース21.3での変更点