PAM Actionコマンド

PAMリソースの検出、認証情報のローテーション、サービスアカウント管理

Action Rotateコマンド

Keeperゲートウェイを介して、単一のボルトレコード、またはUIDやタイトルパターンに一致する共有フォルダ内のすべての pamUser レコードに対して、オンデマンドで認証情報のローテーションを実行します。この操作はゲートウェイジョブをスケジュールするだけで、ローテーションスケジュール自体の設定は行いません (スケジュールの設定には pam-rotation edit を使用)。認証情報のローテーションを許可するエンタープライズ強制設定が必要です。

DotNet CLI

コマンド: pam-action rotate

別名: pam-act rotate / pam-act r

パラメーター:

パラメーター	説明
--record-uid, -r	ローテーション対象のレコードUID
--folder, -f	共有フォルダのUIDまたはタイトルの正規表現パターン。一致するフォルダ内のすべてのpamUserレコードをローテーション
--dry-run, -n	フォルダモード専用。ジョブをスケジュールせずに、ローテーション対象となるフォルダ/レコード数を確認

*--record-uid または --folder のいずれかが必須です。

例:

My Vault> pam-action rotate --record-uid <RECORD_UID>
My Vault> pam-action rotate -r <RECORD_UID>
My Vault> pam-action rotate --folder <SHARED_FOLDER_UID>
My Vault> pam-action rotate -f "Prod.*" --dry-run
My Vault> pam-act r -r <RECORD_UID>

DotNet SDK

関数:

using KeeperSecurity.Plugins.PAM;

// Single-record on-demand rotate
var rotateResult = await ActionUtils.RotateAsync(vault, new PamRotateOptions
{
    RecordUid = "<RECORD_UID>"
});

if (rotateResult.RecordResult?.IsScheduled == true)
{
    var jobId = rotateResult.RecordResult.ConversationId;
    var gatewayUid = rotateResult.RecordResult.GatewayUid;
    Console.WriteLine($"Scheduled action id: {jobId}");

    var job = await ActionUtils.GetJobInfoAsync(vault.Auth, jobId, gatewayUid);
    if (job.JobInfo != null)
    {
        Console.WriteLine($"Status: {job.JobInfo.Status}");
        Console.WriteLine($"Duration: {job.JobInfo.Duration}");
        Console.WriteLine($"Message: {job.JobInfo.ResponseMessage}");
    }
}

// Folder-mode dry run (pamUser records only)
var folderPreview = await ActionUtils.RotateAsync(vault, new PamRotateOptions
{
    Folder = "<SHARED_FOLDER_UID_OR_TITLE_PATTERN>",
    DryRun = true
});
Console.WriteLine(
    $"Folders: {folderPreview.FolderResult.FolderCount}, Records: {folderPreview.FolderResult.RecordCount}");

// Folder-mode live rotate
var folderLive = await ActionUtils.RotateAsync(vault, new PamRotateOptions
{
    Folder = "<SHARED_FOLDER_UID_OR_TITLE_PATTERN>",
    DryRun = false
});

Power Commander

コマンド: Invoke-KeeperPamActionRotate

別名: pam-action-rotate パラメーター:

パラメーター	説明
-RecordUid, -r	ローテーション対象のPAMユーザーレコードUID
-Folder, -f	共有フォルダのUIDまたはタイトルパターン (pamUserレコードをローテーション)
-DryRun, -n	フォルダモード専用。ローテーションを実行せずに選択内容を一覧表示

例:

PS > Invoke-KeeperPamActionRotate -RecordUid "32gU_yrxxWdOCqkiWW4gRw"
Scheduled action id: <conversation-id>
The action has been scheduled, use command 'Get-KeeperPamActionJobInfo -JobId "<conversation-id>"' to get status of the scheduled action

PS > Invoke-KeeperPamActionRotate -Folder "tVjvRq_gbPBRF5kO3noYGw" -DryRun
Selected for rotation - folders: 1, records: 7

PS > pam-action-rotate -r "32gU_yrxxWdOCqkiWW4gRw"

Python CLI

コマンド: 近日公開

Python SDK

コマンド: 近日公開

Action Job-infoコマンド

以前にスケジュールされたPAMゲートウェイジョブ (pam-action rotate の実行後など) のステータスを確認します。ジョブIDに / が含まれる場合は引用符で囲んでください。複数のゲートウェイが稼働している場合は --gateway を指定します。

DotNet CLI

コマンド: pam-action job-info

別名: pam-act job-info / pam-act ji

パラメーター:

パラメーター	説明
<job_id> (positional)	rotateなど、他のゲートウェイアクションが返すconversation ID / ジョブID
--gateway, -g	複数のゲートウェイが利用可能な場合のゲートウェイUID

例:

My Vault> pam-action job-info "<JOB_ID>"
My Vault> pam-action job-info "<JOB_ID>" --gateway <GATEWAY_UID>
My Vault> pam-act ji "<JOB_ID>" -g <GATEWAY_UID>

DotNet SDK

関数:

    public static Dictionary<string, TypedRecord> GetConfigurationRecords(VaultOnline vault)
    {
      if (vault == null)
      {
        return new Dictionary<string, TypedRecord>();
      }

      return vault.KeeperRecords
        .OfType<TypedRecord>()
        .Where(x => PamRecordTypes.Configuration.Contains(x.TypeName ?? ""))
        .ToDictionary(x => x.Uid, x => x);
    }

Power Commander

コマンド: Get-KeeperPamActionJobInfo

別名: pam-action-job-info

パラメーター:

パラメーター	説明
-JobId, -j	スケジュール済みアクション / conversation ID (/を含む場合は引用符で囲む)
-Gateway, -g	複数のゲートウェイが存在する場合のゲートウェイUID

例:

PS > Get-KeeperPamActionJobInfo -JobId "<conversation-id>"
Job id to check [<conversation-id>]
Execution Details
-------------------------
        Status              : finished
        Duration            : 00:00:12
        Response Message    : ...

PS > pam-action-job-info -j "<conversation-id>" -Gateway "9uUuUYaQThmhKSjQ8foCdw"

Python CLI

コマンド: 近日公開

Python SDK

コマンド: 近日公開