For the complete documentation index, see llms.txt. This page is also available as Markdown.

既存のモデルへのPAMリソースの追加

新規モデルではなく既存のPAM構成へコンテンツを追加する

PAMのコンテンツを手動で作成した場合、または pam project import コマンドで作成した場合のいずれでも、その後は pam project extend コマンドでさらにコンテンツを追加できます。

pam project extend コマンドは、Keeperコマンダー17.2.8以降で利用できます。

JSONテンプレート

この手続きでは、PAMリソースのインポートの手順で生成されるものと同様の pam_import.json テンプレートが必要です。ただし、以下の点が異なります。

  • テンプレートには pam_data オブジェクトのみを含めればよい。extend での追加ではプロジェクト情報は不要 (含めても処理は失敗しない)

  • PAMディレクトリレコードは再作成されないが、接続の管理用認証情報 (ADドメイン管理者) を参照できるようにするため、ディレクトリ定義をテンプレートに含める必要がある

  • 新規の pamMachine / pamUsertitle は、ファイル内および既存のPAMモデル全体で一意 (競合防止)

{
  "pam_data": {
    "resources": [
      {
        "type": "pamDirectory",
        "title": "My Domain Controller",
        "directory_type": "active_directory",
        "host": "lureydemo.local",
        "port": "636",
        "use_ssl": true,
        "domain_name": "lureydemo.local",
        "pam_settings": {
          "options": {
            "rotation": "on",
            "connections": "on",
            "tunneling": "on",
            "graphical_session_recording": "on"
          },
          "connection": {
            "protocol": "rdp",
            "port": "3389",
            "security": "any",
            "ignore_server_cert": true,
            "administrative_credentials": "My Domain Admin"
          }
        },
        "users": [
          {
            "type": "pamUser",
            "title": "My Domain Admin",
            "login": "administrator@lureydemo.local",
            "password": "YourExistingDomainPassword",
            "rotation_settings": {
              "rotation": "general",
              "enabled": "on",
              "schedule": {
                "type": "on-demand"
              }
            }
          }
        ]
      },
      {
        "type": "pamMachine",
        "title": "extended_machine_1",
        "host": "desktop-machine1",
        "port": "5986",
        "ssl_verification": true,
        "operating_system": "Windows",
        "pam_settings": {
          "options": {
            "rotation": "on",
            "connections": "on",
            "tunneling": "on",
            "graphical_session_recording": "on"
          },
          "connection": {
            "protocol": "rdp",
            "port": "3389",
            "security": "any",
            "ignore_server_cert": true,
            "administrative_credentials": "My Domain Controller.My Domain Admin"
          }
        },
        "users": [
          {
            "type": "pamUser",
            "title": "user_extended_machine_1",
            "login": "extended_user",
            "password": "LocalAdminPassword123",
            "rotation_settings": {
              "rotation": "general",
              "enabled": "on",
              "schedule": {
                "type": "on-demand"
              }
            }
          }
        ]
      }
    ]
  }
}

このテンプレートを使うと、既存のモデルに新しい pamMachine および pamUser レコードが1件ずつインポートされます。テンプレートの構造については、PAMリソースのインポートをご参照ください。わかりやすさのためコメントは省いており、掲載している値はサンプル実行の例と同じです。

フォルダ管理

JSONの各オブジェクト (リソースおよびユーザー) に folder_path 属性を追加すると、インポートする新しいレコードの共有フォルダおよび個人用フォルダの保存場所を指定できます。

pam project extend によるフォルダ管理

補足

  • 共有フォルダが既定の2つより多い構成のPAMモデルでは、各レコードへの folder_path 指定が必須

  • 指定する共有フォルダは事前に存在していること

  • ネストした個人用フォルダが未作成の場合は自動的に作成される

インポートの実行

上記のJSONテンプレートファイルの用意ができたら、ボルトまたはコマンダーからPAM構成のUIDを取得します。このUIDが、追加先となる既存のPAMモデルへの参照になります。

  • ボルトでの確認

ボルトのPAM構成UID
  • コマンダーでの確認

コマンダーでは、以下のコマンドで pam project extend によるインポートを実行します。

ドライラン

インポートを実行する前に --dry-run フラグを付けると、作成されるレコードとフォルダを確認できます。

最終更新