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"
          }';