PAM Workflowコマンド

PAMリソース向けのジャストインタイム (JIT) 特権アクセスワークフローを管理します。ワークフローは承認ベースのアクセス制御を適用し、 必要に応じて貸出/返却、MFA認証、時間帯によるアクセス制限を設定できます。

サブコマンド

• 構成

  • 作成

  • 参照

  • 更新

  • 削除

  • 承認者の追加

  • 承認者の削除

• 承認者による操作

  • 保留中リクエスト一覧

  • 承認

  • 拒否

• リクエスト側の操作

  • リクエスト

  • 開始 (貸出)

  • 終了 (返却)

• 状態確認

  • 状態

  • 自分のアクセス状況

PAM Workflow createコマンド

PAMレコードのワークフロー設定を作成します。承認が必要な場合は、少なくとも1人の承認者を追加する必要があります。

DotNet CLI

コマンド: pam-workflow create

別名: pam-wf c

パラメーター:

パラメーター	説明
<record>	レコードのUIDまたはレコード名/タイトル。必須。
-n, --approvals-needed <int>	アクセスが許可されるまでに必要な承認数。デフォルト: 1。0以上を指定 (0の場合は承認不要)。
--checkout	フラグ。貸出/返却を必須にします (セッションを明示的に貸出し、後で返却する必要があります)。
--start-on-approval	フラグ。ユーザーが貸出を行うタイミングではなく、リクエストが承認されたタイミングでアクセスタイマーを開始します。
--require-reason	フラグ。アクセスをリクエストする際に、リクエスト者へ理由の入力を必須にします。
--require-ticket	フラグ。リクエスト者に外部チケット/参照番号の入力を必須にします。
--require-mfa	フラグ。アクセスが許可される前にMFA認証を必須にします。
-d, --duration <string>	アクセス期間。例: "2h"、"30m"、"1d"。単位のない数値は分として扱われます。デフォルト: "1d"。
--allowed-days <string>	アクセスを許可する曜日をコンマ区切りで指定します。例: "mon,tue,wed,thu,fri"。アクセス可能な曜日を制限します。
--time-range <string>	同日内で許可する時間帯をHH:MM-HH:MM形式で指定します。例: "09:00-17:00"。終了時刻は開始時刻より後である必要があります。
-u, --user <email>	承認者のメールアドレス。複数の承認者を指定する場合は複数回指定できます。
--approver <email>	承認者メールアドレス用の--userの別名 (-u/--userと同様に使用可能)。複数回指定できます。
--format <table|json>	出力形式。デフォルト: table。

例:

My Vault> pam-workflow create 0bEtV6M9nah78at9UicRzH2gSS7A --checkout --approvals-needed 1 --approver [e-mail]

Workflow created successfully

Record: Dotnet-Gateway-14thJuly - VNC Machine (0bEtV6M9nah78at9UicRzH2gSS7A )
Approvals needed: 1
Check-in/out: Yes
Duration: 1 day
Approvers: [e-mail]

DotNet SDK

関数:

    public static async Task CreateWorkflowConfigAsync(IAuthentication auth, WorkflowParameters parameters)
    {
      if (parameters == null)
      {
        throw new ArgumentNullException(nameof(parameters));
      }

      await PostToRouterAsync(auth, CreateWorkflowConfigPath, parameters);
    }

Power Commander

コマンド: New-KeeperPamWorkflow

別名: pam-workflow-new

パラメーター:

パラメーター	説明
-Record, -r	PAMリソースレコードのUIDまたはタイトル
-ApprovalsNeeded, -n	必要な承認数。承認者が不要な場合は0を指定します。デフォルトは1です。
-Checkout, -co	シングルユーザーの貸出/返却モードを有効にします。
-StartOnApproval, -sa	リソースが貸出されたタイミングではなく、承認が完了したタイミングでアクセスタイマーを開始します。
-RequireReason, -rr	リクエスト者に理由の入力を必須にします。
-RequireTicket, -rt	リクエスト者にチケット番号の入力を必須にします。
-RequireMfa, -rm	MFA認証を必須にします。
-Duration, -d	アクセス期間。例: 30m、2h、1d。デフォルトは1dです。
-AllowedDays	曜日をコンマ区切りで指定: mon,tue,wed,thu,fri,sat,sun。
-TimeRange	同日内の時間帯をHH:MM-HH:MM形式で指定。
-User, -u	承認者として追加するユーザーのメールアドレス。
-Approver	承認者メールアドレス用の互換オプション。繰り返し指定できます。
-Team, -t	承認者として追加するチームのUIDまたは一意のチーム名。
-Format	出力形式: tableまたはjson。
-Help, -h	コマンドのヘルプを表示します。

例:

PS > New-KeeperPamWorkflow `
    -Record "OZiyGTEO_KrBxG8mvMJNWw" `
    -Approver "[e-mail]" `
    -ApprovalsNeeded 1 `
    -Checkout `
    -StartOnApproval `
    -RequireReason `
    -RequireTicket `
    -RequireMfa `
    -Duration "1d" `
    -AllowedDays "mon,tue,wed,thu,fri" `
    -TimeRange "09:00-17:00"

Python CLI

コマンド: 近日公開

Python SDK

コマンド: 近日公開

PAM Workflow updateコマンド

指定した項目のみワークフロー設定を更新し、指定しなかった項目は既存の値のまま保持します。

DotNet CLI

コマンド: pam-workflow update

別名: pam-wf u

パラメーター:

パラメーター	説明
<record>	レコードのUIDまたはレコード名/タイトル。必須。対象のワークフローが既に存在している必要があります。
-n, --approvals-needed <int>	新しい必要承認数。0以上を指定してください。
--checkout <true|false>	貸出/返却の要否を有効/無効にします。
--start-on-approval <true|false>	アクセスタイマーを承認時点で開始するか、貸出時点で開始するかを切り替えます。
--require-reason <true|false>	アクセスリクエスト時の理由入力の要否を切り替えます。
--require-ticket <true|false>	アクセスリクエスト時のチケット番号入力の要否を切り替えます。
--require-mfa <true|false>	MFA認証の要否を切り替えます。
-d, --duration <string>	新しいアクセス期間。例: "2h"、"30m"、"1d"。
--allowed-days <string>	新しい許可曜日 (コンマ区切り)。
--time-range <string>	新しい許可時間帯 (HH:MM-HH:MM)。
--format <table|json>	出力形式。デフォルト: table。

例:

My Vault> pam-workflow update 0bEtV6nah65142M9t9UicRzH2gSS7A --checkout --approvals-needed 2                                            

Workflow updated successfully

Record: Dotnet-Gateway-14thJuly - VNC Machine (0bEtV6nah65142M9t9UicRzH2gSS7A )

DotNet SDK

関数:

public static async Task UpdateWorkflowConfigAsync(IAuthentication auth, WorkflowParameters parameters)
    {
      if (parameters == null)
      {
        throw new ArgumentNullException(nameof(parameters));
      }

      await PostToRouterAsync(auth, UpdateWorkflowConfigPath, parameters);
    }

Power Commander

コマンド: Update-KeeperPamWorkflow

別名: pam-workflow-edit

パラメーター:

パラメーター	説明
-Record, -r	PAMリソースレコードのUIDまたはタイトル。
-ApprovalsNeeded, -n	必要な承認数。承認者が不要な場合は0を指定します。
-Checkout, -co	貸出/返却モードを有効または無効にします。
-StartOnApproval, -sa	タイマーを承認時点で開始するかどうかを制御します。
-RequireReason, -rr	理由入力の要否を切り替えます。
-RequireTicket, -rt	チケット番号入力の要否を切り替えます。
-RequireMfa, -rm	MFA認証の要否を切り替えます。
-Duration, -d	アクセス期間。例: 30m、2h、1d。
-AllowedDays	許可曜日 (コンマ区切り)。
-TimeRange	同日内の時間帯 (HH:MM-HH:MM形式)。
-Format	出力形式: tableまたはjson。

例:

PS > Update-KeeperPamWorkflow `
    -Record "OZiyGTrf_KrBxG8mvMJNWw" `
    -ApprovalsNeeded 2 `
    -Checkout $true `
    -StartOnApproval $true `
    -RequireReason $true `
    -RequireTicket $true `
    -RequireMfa $true `
    -Duration "2h"

Python CLI

コマンド: 近日公開

Python SDK

コマンド: 近日公開

PAM Workflow readコマンド

PAMリソースレコードのワークフロー設定を参照します。

DotNet CLI

コマンド: pam-workflow read

別名: pam-wf r

パラメーター:

パラメーター	説明
<record>	レコードのUIDまたはレコード名/タイトル。必須。
--format <table|json>	出力形式。デフォルト: table。

例:

My Vault> pam-workflow read 0bEtV6M9t9nahyt6a7wUicRzH2gSS7A--format json
{
 "record_uid": "0bEtV6M9t9nahyt6a7wUicRzH2gSS7A",
 "record_name": "Dotnet-Gateway-14thJuly - VNC Machine",
 "parameters": {
   "approvals_needed": 2,
   "checkout_needed": true,
   "start_access_on_approval": false,
   "require_reason": false,
   "require_ticket": false,
   "require_mfa": false,
   "access_duration": "1 day",
   "allowed_times": null
  },
 "approvers": [
   {
    "escalation": false,
    "type": "user",
    "email": "[e-mail]"
   }
  ]
}

DotNet SDK

関数:

    public static async Task<WorkflowConfig> ReadWorkflowConfigAsync(
      IAuthentication auth,
      string recordUid,
      string recordName = null)
    {
      var refMsg = CreateRecordRef(recordUid, recordName);
      var config = await auth.ExecuteRouter<WorkflowConfig>(ReadWorkflowConfigPath, refMsg);

      if (config == null
          || (config.Parameters == null && config.Approvers.Count == 0 && config.CreatedOn == 0))
      {
        return null;
      }

      return config;
    }

Power Commander

コマンド: Get-KeeperPamWorkflow

別名: pam-workflow-read

パラメーター:

パラメーター	説明
-Record, -r	PAMリソースレコードのUIDまたはタイトル。
-Format	出力形式: tableまたはjson。

例:

PS > Get-KeeperPamWorkflow `
    -Record "OZirfTEO_KrBxG8mvMJNWw"

Python CLI

コマンド: 近日公開

Python SDK

コマンド: 近日公開

PAM Workflow deleteコマンド

PAMリソースレコードからワークフロー設定を削除します。

DotNet CLI

コマンド: pam-workflow delete

別名: pam-wf d

パラメーター:

パラメーター	説明
<record>	レコードのUIDまたはレコード名/タイトル。必須。
--format <table|json>	出力形式。デフォルト: table。

例:

My Vault> pam-wf d 0bEtV6M9nahu78791t9UicRzH2gSS7A

Workflow deleted successfully

Record: Dotnet-Gateway-14thJuly - VNC Machine (0bEtV6M9nahu78791t9UicRzH2gSS7A)

DotNet SDK

関数:

    public static async Task DeleteWorkflowConfigAsync(
      IAuthentication auth,
      string recordUid,
      string recordName = null)
    {
      var refMsg = CreateRecordRef(recordUid, recordName);
      await PostToRouterAsync(auth, DeleteWorkflowConfigPath, refMsg);
    }

Power Commander

コマンド: Remove-KeeperPamWorkflow

別名: pam-workflow-delete

パラメーター:

パラメーター	説明
-Record, -r	PAMリソースレコードのUIDまたはタイトル。
-Format	出力形式: tableまたはjson。
-Confirm	対話式の確認プロンプトを表示せずに削除を確定します。

例:

PS > Remove-KeeperPamWorkflow `
    -Record "OZfgGTEO_KrBxG8mvMJNWw" `
    -Confirm:$false

Python CLI

コマンド: 近日公開

Python SDK

コマンド: 近日公開

PAM Workflow add-approverコマンド

ユーザーまたはチームをワークフローの承認者として追加します。

DotNet CLI

コマンド: pam-workflow add-approver

別名: pam-wf aa

パラメーター:

パラメーター	説明
<record>	レコードのUIDまたはレコード名/タイトル。必須。
-u, --user <email>	承認者として追加するユーザーのメールアドレス。繰り返し指定可能。
--approver <email>	--userの別名。繰り返し指定可能。
-t, --team <name|uid>	承認者として追加するチーム名またはチームUID。繰り返し指定可能。
-e, --escalation	フラグ。追加する承認者をエスカレーション承認者として設定します (主承認フローがエスカレーションされた場合のみ呼び出されます)。
--escalation-after <string>	この承認者へのエスカレーションが発生するまでの時間。例: "30m"、"1h"。要 --escalation。
--format <table|json>	出力形式。デフォルト: table。

(--user/_--approver _または_--team`のいずれかが必須です。)

例:

{% code expandable="true" %}

My Vault> pam-wf aa 0bEtV6M9tanhqy679UicRzH2gSS7A --approver [e-mail]                                           

Approvers added successfully

Record: Dotnet-Gateway-14thJuly - VNC Machine (0bEtV6M9tanhqy679UicRzH2gSS7A )
Added 1 approver(s)c#

DotNet SDK

関数:

    public static async Task AddWorkflowApproversAsync(
      IAuthentication auth,
      string recordUid,
      string recordName,
      IEnumerable<string> users = null,
      IEnumerable<string> teamUids = null,
      bool isEscalation = false,
      long escalationAfterMs = 0)
    {
      var config = BuildApproverConfig(recordUid, recordName, users, teamUids, isEscalation, escalationAfterMs);
      if (config.Approvers.Count == 0)
      {
        return;
      }

      await PostToRouterAsync(auth, AddWorkflowApproversPath, config);
    }

Power Commander

コマンド: Add-KeeperPamWorkflowApprover

別名: pam-workflow-add-approver

パラメーター:

パラメーター	説明
-Record, -r	PAMリソースレコードのUIDまたはタイトル。
-User, -u	承認者として追加するユーザーのメールアドレス。繰り返し指定可能。
-Approver	承認者メールアドレス用の互換オプション。
-Team, -t	チームUIDまたは一意のチーム名。繰り返し指定可能。
-Escalation, -e	指定した承認者をエスカレーション承認者として設定します。
-EscalationAfter	エスカレーションまでの遅延時間。例: 30m、2h、1d。-Escalationの指定が必要です。
-Format	出力形式: tableまたはjson。

例:

PS > Add-KeeperPamWorkflowApprover `
    -Record "OZiyGTEO_KffgG8mvMJNWw" `
    -User "[e-mail]" `
    -Team "TestTeam"

Python CLI

コマンド: 近日公開

Python SDK

コマンド: 近日公開

PAM Workflow remove-approverコマンド

ワークフローの承認者リストからユーザーまたはチームを削除します。

DotNet CLI

コマンド: pam-workflow remove-approver

別名: pam-wf ra

パラメーター:

パラメーター	説明
<record>	レコードのUIDまたはレコード名/タイトル。必須。
-u, --user <email>	承認者から削除するユーザーのメールアドレス。繰り返し指定可能。
--approver <email>	--user の別名。繰り返し指定可能。
-t, --team <name|uid>	承認者から削除するチーム名またはチームUID。繰り返し指定可能。
--format <table|json>	出力形式。デフォルト: table。

(--user/_--approver _または_--team`のいずれかが必須です。)

例:

{% code expandable="true" %}

My Vault> pam-wf ra 0bEtV6M9t9Unah87icRzH2gSS7A --approver [e-mail]

Approvers removed successfully

Record: Dotnet-Gateway-14thJuly - VNC Machine (0bEtV6M9t9Unah87icRzH2gSS7A )
Removed 1 approver(s)

DotNet SDK

関数:

public static async Task DeleteWorkflowApproversAsync(
      IAuthentication auth,
      string recordUid,
      string recordName,
      IEnumerable<string> users = null,
      IEnumerable<string> teamUids = null)
    {
      var config = BuildApproverConfig(recordUid, recordName, users, teamUids);
      if (config.Approvers.Count == 0)
      {
        return; 
      }

      await PostToRouterAsync(auth, DeleteWorkflowApproversPath, config);
    }

Power Commander

コマンド: Remove-KeeperPamWorkflowApprover

別名: pam-workflow-remove-approver

パラメーター:

パラメーター	説明
-Record, -r	PAMリソースレコードのUIDまたはタイトル。
-User, -u	削除するユーザーのメールアドレス。繰り返し指定可能。
-Approver	承認者メールアドレス用の互換オプション。
-Team, -t	削除するチームUIDまたは一意のチーム名。
-Format	出力形式: tableまたはjson。

例:

PS > Remove-KeeperPamWorkflowApprover `
    -Record "OZiyGrfO_KrBxG8mvMJNWw" `
    -User "[e-mail]"

Python CLI

コマンド: 近日公開

Python SDK

コマンド: 近日公開

PAM Workflow pendingコマンド

現在のユーザーに割り当てられている、承認待ちのワークフローリクエストを一覧表示します。

DotNet CLI

コマンド: pam-workflow pending

別名: pam-wf p

パラメーター:

パラメーター	説明
--format <table|json>	出力形式。デフォルト: table。

例:

My Vault> pam-wf p  0bEtV6M9tnajaut9UicRzH2gSS7A                                            

Record Name                            Record UID              Flow UID                Requested By                            Reason  Ticket  Started  Expires  Duration
-------------------------------------  ----------------------  ----------------------  --------------------------------------  ------  ------  -------  -------  --------
Dotnet-Gateway-14thJuly - RDP Machine  0nahay67wd7s9NnujjRMyGA  v2UD_gpdAW_HJvEN57SH2g  [e-mail]                                            

DotNet SDK

関数:

    public static async Task<ApprovalRequests> GetApprovalRequestsAsync(IAuthentication auth)
    {
      return await auth.ExecuteRouter<ApprovalRequests>(GetApprovalRequestsPath);
    }

Power Commander

コマンド: Get-KeeperPamWorkflowPending

別名: pam-workflow-pending

例:

PS > Get-KeeperPamWorkflowPending
PS > pam-workflow-pending

Python CLI

コマンド: 近日公開

Python SDK

コマンド: 近日公開

PAM Workflow approveコマンド

pending コマンドで取得したフローUIDを使用して、保留中のワークフローアクセスリクエストを承認します。

DotNet CLI

コマンド: pam-workflow approve

別名: pam-wf a

パラメーター:

パラメーター	説明
<flow_uid>	保留中リクエストのフローUID (pending コマンドで取得)。必須。
--format <table|json>	出力形式。デフォルト: table。

例:

My Vault> pam-wf a v2UD_gpdAW_HJvEN5nahudyr7SH2g

Access request approved

Flow UID: v2UD_gpdAW_HJvEN5nahudyr7SH2g

DotNet SDK

関数:

   public static async Task ApproveWorkflowAccessAsync(IAuthentication auth, byte[] flowUidBytes)
    {
      await ApproveOrDenyWorkflowAccessAsync(auth, flowUidBytes, deny: false, denialReasonEncrypted: null);
    }

Power Commander

コマンド: Approve-KeeperPamWorkflowAccess

別名: pam-workflow-approve

パラメーター:

パラメーター	説明
-FlowUid <string>	保留中リクエストのフローUID (Get-KeeperPamWorkflowPending で取得)。必須、位置引数 (0)。

例:

PS > Approve-KeeperPamWorkflowAccess -FlowUid "<flow-uid>"
PS > pam-workflow-approve "<flow-uid>"

Python CLI

コマンド: 近日公開

Python SDK

コマンド: 近日公開

PAM Workflow denyコマンド

保留中のワークフローアクセスリクエストを拒否します。

DotNet CLI

コマンド: pam-workflow deny

別名: pam-wf dn

パラメーター:

パラメーター	説明
<flow_uid>	保留中リクエストのフローUID。必須。
-r, --reason <string>	拒否理由 (任意)。暗号化に成功した場合はリクエスト者に表示されます。暗号化に失敗した場合は、理由を表示せずに拒否が実行されます。
--format <table|json>	出力形式。デフォルト: table。

例:

My Vault> pam-wf dn <flow_UID>

DotNet SDK

関数:

    public static async Task DenyWorkflowAccessAsync(
      IAuthentication auth,
      byte[] flowUidBytes,
      ByteString denialReasonEncrypted = null)
    {
      await ApproveOrDenyWorkflowAccessAsync(auth, flowUidBytes, deny: true, denialReasonEncrypted);
    }

Power Commander

コマンド: Deny-KeeperPamWorkflowAccess

別名: pam-workflow-deny

パラメーター:

パラメーター	説明
-FlowUid <string>	保留中リクエストのフローUID。必須、位置引数 (0)。
-Reason <string>	リクエスト者に表示する理由 (任意)。リクエスト者向けに暗号化されます。暗号化に失敗した場合は警告が表示され、理由を表示せずに拒否が実行されます。

例:

PS > Deny-KeeperPamWorkflowAccess -FlowUid "<flow-uid>" -Reason "Not authorized"
PS > pam-workflow-deny "<flow-uid>" -r "Not authorized"

Python CLI

コマンド: 近日公開

Python SDK

コマンド: 近日公開

PAM Workflow requestコマンド

ワークフローで保護されたPAMリソースへのアクセスをリクエストします。保留中リクエストのエスカレーションや、実行中リクエストの取り消しにも対応しています。

DotNet CLI

コマンド: pam-workflow request

別名: pam-wf rq

パラメーター:

パラメーター	説明
<record>	レコードのUIDまたはレコード名/タイトル。必須。
-r, --reason <string>	アクセスリクエストの理由。--cancel とは併用できません。
--ticket <string>	リクエストに関連付ける外部チケット/参照番号。--cancel とは併用できません。
--escalate	フラグ。新しいリクエストを送信する代わりに、既存の保留中リクエストをエスカレーション承認者にエスカレーションします。--cancel とは同時に指定できません。
-c, --cancel	フラグ。リクエストを送信する代わりに、そのレコードに対する実行中/保留中のワークフローリクエストを取り消します。--escalate、--reason、--ticket とは同時に指定できません。
--format <table|json>	出力形式。デフォルト: table。

例:

My Vault> pam-workflow request 0bEtV6M9t9UnahticRzH2gSS7A

Access request sent

Record: Dotnet-Gateway-14thJuly - VNC Machine (0bEtV6M9najaytt9UicRzH2gSS7A)

Approvers have been notified.

DotNet SDK

関数:

    public static async Task RequestWorkflowAccessAsync(
      IAuthentication auth,
      string recordUid,
      string recordName,
      byte[] recordKey,
      string reason = null,
      string ticket = null)
    {
      var needsEncrypted = !string.IsNullOrEmpty(reason) || !string.IsNullOrEmpty(ticket);
      if (needsEncrypted && (recordKey == null || recordKey.Length == 0))
      {
        throw new InvalidOperationException(
          "Record key not available — cannot encrypt reason/ticket. " +
          "You do not have sufficient access to this record to send encrypted parameters.");
      }

      var accessRequest = new WorkflowAccessRequest
      {
        Resource = CreateRecordRef(recordUid, recordName),
      };
      if (!string.IsNullOrEmpty(reason))
      {
        accessRequest.Reason = ByteString.CopyFrom(
          CryptoUtils.EncryptAesV2(System.Text.Encoding.UTF8.GetBytes(reason), recordKey));
      }

      if (!string.IsNullOrEmpty(ticket))
      {
        accessRequest.Ticket = ByteString.CopyFrom(
          CryptoUtils.EncryptAesV2(System.Text.Encoding.UTF8.GetBytes(ticket), recordKey));
      }

      await PostToRouterAsync(auth, RequestWorkflowAccessPath, accessRequest);
    }

Power Commander

コマンド: Request-KeeperPamWorkflowAccess

別名: pam-workflow-request

パラメーター:

パラメーター	説明
-Record <string>	PAMリソースレコードのUIDまたはタイトル。必須、位置引数 (0)。
-Reason <string>	アクセスリクエストの理由。-Cancel とは併用できません。
-Ticket <string>	外部チケット/参照番号。-Cancel とは併用できません。
-Escalate	スイッチ。新しいリクエストを送信する代わりに、既存の保留中リクエストをエスカレーション承認者にエスカレーションします。-Cancel とは併用できません。
-Cancel	スイッチ。そのレコードに対する自分自身の保留中/実行中のワークフローリクエストを取り消します。-Escalate、-Reason、-Ticket とは併用できません。

注: レコードの所有者および承認者はワークフローの制限が適用されないため、リクエストを送信する代わりに「対象外」というメッセージが表示されます。

例:

PS > Request-KeeperPamWorkflowAccess -Record "<uid>" -Reason "Need access to investigate an incident"
PS > Request-KeeperPamWorkflowAccess -Record "<uid>" -Escalate
PS > Request-KeeperPamWorkflowAccess -Record "<uid>" -Cancel
PS > pam-workflow-request "<uid>" -re "reason text"

Python CLI

コマンド: 近日公開

Python SDK

コマンド: 近日公開

PAM Workflow startコマンド

ワークフローセッションを開始します (貸出)。貸出/返却が有効な場合、リソースに接続する前にこの操作が必要です。

DotNet CLI

コマンド: pam-workflow start

別名: pam-wf s

パラメーター:

パラメーター	説明
<record_or_flow_uid>	レコードのUID/名前。ローカルでレコードを解決できない場合はフローUID。必須。
--format <table|json>	出力形式。デフォルト: table。

例:

My Vault> pam-wf start 0bEtV6M9t9UicRzH2gSS7A

Workflow started (checked out)

Record: Dotnet-Gateway-14thJuly - VNC Machine (0bEtV6M9t9UicRzH2gSS7A)

DotNet SDK

関数:

   public static async Task StartWorkflowAsync(IAuthentication auth, WorkflowState state)
    {
      if (state == null)
      {
        throw new ArgumentNullException(nameof(state));
      }

      await PostToRouterAsync(auth, StartWorkflowPath, state);
    }

Power Commander

コマンド: Start-KeeperPamWorkflow

別名: pam-workflow-start

パラメーター:

パラメーター	説明
-Uid <string>	レコードのUID、レコードタイトル、またはフローUID。必須、位置引数 (0)。レコードとして解決できない場合はフローUIDとして扱われます。

例:

PS > Start-KeeperPamWorkflow -Uid "<record-or-flow-uid>"
PS > pam-workflow-start "<uid>"

Python CLI

コマンド: 近日公開

Python SDK

コマンド: 近日公開

PAM Workflow endコマンド

ワークフローセッションを終了します (返却)。返却後に認証情報がローテーションされる場合があります。

DotNet CLI

コマンド: pam-workflow end

別名: pam-wf e

パラメーター:

パラメーター	説明
<record_or_flow_uid>	レコードのUID/名前、またはフローUID。必須。
-f, --force	フラグ。このレコード/フローで他のユーザーが使用中のセッションを強制的に返却します (管理者による強制操作)。
--format <table|json>	出力形式。デフォルト: table。

例:

My Vault> pam-wf end 0bEtV6M9t9UicRzH2gSS7A  

DotNet SDK

関数:

   public static async Task EndWorkflowAsync(IAuthentication auth, GraphSyncRef flowOrResourceRef)
    {
      if (flowOrResourceRef == null)
      {
        throw new ArgumentNullException(nameof(flowOrResourceRef));
      }

      await PostToRouterAsync(auth, EndWorkflowPath, flowOrResourceRef);
    }

Power Commander

コマンド: Stop-KeeperPamWorkflow

別名: pam-workflow-end

パラメーター:

パラメーター	説明
-Uid <string>	レコードのUID、レコードタイトル、またはフローUID。必須、位置引数 (0)。
-Force	スイッチ。シングルユーザーの貸出が有効な場合に、他のユーザーが使用中のセッションを代わりに強制返却します (承認者または管理者権限が必要)。

例:

PS > Stop-KeeperPamWorkflow -Uid "<record-or-flow-uid>"
PS > Stop-KeeperPamWorkflow -Uid "<uid>" -Force
PS > pam-workflow-end "<uid>"

Python CLI

コマンド: 近日公開

Python SDK

コマンド: 近日公開

PAM Workflow stateコマンド

PAMリソースレコードの現在のワークフロー状態を取得します。

DotNet CLI

コマンド: pam-workflow state

別名: pam-wf st

パラメーター:

パラメーター	説明
<record>	レコードのUIDまたはレコード名/タイトル。必須。
--format <table|json>	出力形式。デフォルト: table。

例:

My Vault> pam-wf state 0bEtV6M9t9UicRzH2gSS7A 

You are exempt from workflow restrictions on this record.
As a record owner or approver, you can access this resource directly.

DotNet SDK

関数:

    public static async Task<WorkflowState> GetWorkflowStateByRecordAsync(
      IAuthentication auth,
      string recordUid,
      string recordName = null)
    {
      var request = new WorkflowState
      {
        Resource = CreateRecordRef(recordUid, recordName),
      };
      return await auth.ExecuteRouter<WorkflowState>(GetWorkflowStatePath, request);
    }

Power Commander

コマンド: Get-KeeperPamWorkflowState

別名: pam-workflow-state

パラメーター:

パラメーター	説明
-Record, -r	PAMリソースレコードのUIDまたはタイトル。
-Format	出力形式: tableまたはjson。

例:

PS > Get-KeeperPamWorkflowState `
    -Record "OZiyGTrf_KrBxG8mvMJNWw"

Python CLI

コマンド: 近日公開

Python SDK

コマンド: 近日公開

PAM Workflow my-accessコマンド

現在のユーザーが持つ、有効なワークフローアクセス状態を一覧表示します。

DotNet CLI

コマンド: pam-workflow my-access

別名: pam-wf ma

パラメーター:

パラメーター	説明
--format <table|json>	出力形式。デフォルト: table

例:

My Vault> pam-wf my-access                   

No active workflows

DotNet SDK

関数:

    public static async Task<UserAccessState> GetUserAccessStateAsync(IAuthentication auth)
    {
      return await auth.ExecuteRouter<UserAccessState>(GetUserAccessStatePath);
    }

Power Commander

コマンド: Get-KeeperPamWorkflowMyAccess

別名: pam-workflow-my-access

パラメーター:

パラメーター	説明
-Format	出力形式: tableまたはjson。

例:

PS > Get-KeeperPamWorkflowMyAccess

Python CLI

コマンド: 近日公開

Python SDK

コマンド: 近日公開