ssl_external_kms_info

機能の概要

ssl_external_kms_info構成パラメータは、OceanBaseデータベースのSSL機能の実行に依存する情報を記録するために使用されます。JSON文字列を用いて、SSLの使用方法ごとの依存関係の設定を記録し、JSONには少なくともssl_modeフィールドが含まれている必要があります。

権限要件

• パラメータの確認

  sysテナントとすべてのユーザーテナントはSHOW PARAMETERSステートメント、またはGV$OB_PARAMETERSビューを使用してこのパラメータを確認できます。

• パラメータの変更

  この構成パラメータはsysテナントのみが変更でき、ユーザーテナントでは変更できません。

プロパティの説明

使用方法

• この構成パラメータのデフォルト値は空文字列です。SSLスイッチをオンにすると、SSLはデフォルトパスのデフォルトファイルからキーを取得します。

• この構成パラメータの値は有効なJSONである必要があります。そうでない場合、設定チェックに失敗します。

• 現在、この構成パラメータはssl_modeを指定するためのfileとbkmiの2つの値のみをサポートしています。

  • fileを指定した場合、ローカルのデフォルトパスからSSLキーと証書ファイルを読み取ります。追加のJSONフィールドの設定は不要です。

  • bkmiを指定した場合、ランタイム時にbkmiからSSLファイルを取得し、ローカルには永続的に保存しません。同時に、JSON文字列にはアプリケーション名、bkmi URL、bkmiルート証書、アイデンティティ秘密鍵、アイデンティティ秘密鍵のパスワード、SSL秘密鍵の名前、SSL秘密鍵のバージョン番号、SSL証書の名前など、完全な情報を提供する必要があります。これらの情報が有効で利用可能であることを確認し、それによってbkmiから秘密鍵と証書を取得できる必要があります。そうでない場合、エラーコードが返されます。

  他の外部証明書発行システムをサポートするために、ssl_external_kms_infoは他の内容のJSON文字列にカスタマイズ拡張することもできます。

設定例

SSL証書の設定にfileモードを採用します。

obclient> ALTER SYSTEM SET ssl_external_kms_info = '
          {
          "ssl_mode":"file"
          }';