4.2 Deploying Actions: Entry Points, Targeting, Distribution and Approval
Key Takeaways
- An action specifies the package that performs a change, endpoint targeting criteria such as an action group, and deployment conditions such as scheduling.
- Action deployment from Question Results or from the Client Status page accepts a maximum of 100 selected rows, so larger populations should be targeted with a computer group or saved question.
- A simple action deploys to all targeted endpoints in one phase and supports Distribute Over, whereas an adaptive ring-based action deploys progressively and does not support Distribute Over.
- Two-person integrity means actions a user initiates cannot deploy until another user approves them, using roles that grant Approve Action or Bypass Action Approval on specified content sets.
- An approval remains in force only until the action's End At date-time or until another user modifies the configuration, so editing an approved action invalidates its approval.
4.2 Deploying Actions: Entry Points, Targeting, Distribution and Approval
Quick overview: An action is a configuration object you deploy to endpoints to manage a change on them. In the action configuration you specify the package that performs the change, endpoint targeting criteria such as an action group, and deployment conditions such as scheduling. Blueprint objective TA-1 — given a scenario, make changes to an endpoint — is this workflow, and the parts that go wrong in practice are targeting, distribution and approval.
1. Where an action deployment starts
Tanium gives you several entry points, and choosing the right one is often the whole answer to a scenario item.
| Entry point | Where | When to use it |
|---|---|---|
| Question Results | Ask a question, then select up to 100 rows and click Deploy Action | The population was discovered by a question and you want to act on exactly those endpoints |
| Client Status | Administration > Configuration > Client Status, select clients (up to 100) and click Deploy Action | The problem is client health itself, so the endpoints are not answering questions normally |
| Packages | Administration > Content > Packages, select a package and click Deploy Action | You already know the fix and will target it with a group rather than a question |
| Reporting or Guide | Deploy a predefined action from a report or dashboard | The report already recommends a remediation with predefined settings |
[!IMPORTANT] The 100-row limit is real and it is a design signal. If your population is larger than 100 endpoints, Tanium is telling you to express it as a computer group or a saved question rather than as a hand-selected list. Hand-selection does not scale and does not survive being repeated next month.
Simple and adaptive actions
| Type | Behaviour |
|---|---|
| Simple action | Deploys to all targeted endpoints in one phase |
| Adaptive (ring-based) action | Deploys in progressive rings, with a Deployment Details page for monitoring |
The distinction has practical consequences: Distribute Over can be set only for simple actions, not for adaptive actions, and stopping them differs — you disable or delete a simple action, whereas an adaptive action is stopped, paused or resumed from its deployment pages.
2. Action groups: the targeting boundary
Actions are targeted through action groups. An action group defines the set of computer groups an action is permitted to reach, and it exists to bound the blast radius of a deployment independently of the question or group that discovered the problem.
The mental model to carry into an exam item: the question finds the endpoints, the action group constrains where the change is allowed to land. If an operator can see an endpoint in question results but cannot deploy to it, the action group is the first thing to check after computer management group assignment.
Quick Summary: Deploying an Action is the mechanism by which a static Tanium Package is executed across a targeted set of enterprise endpoints. Operators can deploy actions interactively from question results in Interact or schedule recurring actions from the administration workspace. Critical deployment parameters include Targeting Filters (scoping who runs the action), Schedule Start Time (when execution begins), Distribute Over (randomly spreading execution over hours to eliminate network spikes), and Expiration Time (defining how long offline endpoints have to check in and execute). Understanding how these timing controls interact and tracking action execution lifecycle states is essential for enterprise operations and the TCO exam.
1. Action Deployment Workflows & Console Entry Points
Tanium provides two primary operational entry points for deploying actions:
+---------------------------------------------------------------------------------------------------+
| ACTION DEPLOYMENT ENTRY POINTS |
+---------------------------------------------------------------------------------------------------+
| |
| ENTRY POINT A: Interact Results Grid (Contextual Triage & Remediation) |
| 1. Operator asks a question in Interact: `Get Installed Applications contains "VulnerableApp"` |
| 2. Results grid displays matching rows (e.g., 250 endpoints return "VulnerableApp 1.0"). |
| 3. Operator selects the row(s) and clicks `Deploy Action`. |
| 4. Tanium automatically pre-populates the targeting filter with the exact sensor query criteria. |
| 5. Operator selects the remediation package, enters parameters, and deploys. |
| |
| ENTRY POINT B: Packages / Actions Administration (Direct & Scheduled Deployment) |
| 1. Operator navigates to `Administration > Actions > Deploy Action` (or Packages catalog). |
| 2. Operator selects the desired Package directly from the catalog. |
| 3. Operator manually defines the target Computer Group or builds a custom targeting expression. |
| 4. Operator configures one-time or recurring scheduling options and submits the action. |
| |
+---------------------------------------------------------------------------------------------------+
2. Action Targeting Architecture & Scope Safety
Targeting controls ensure that an action executes only on the specific machines intended by the operator. Tanium uses a multi-layered security model to prevent accidental mass deployments:
+---------------------------------------------------------------------------------------------------+
| ACTION TARGETING GOVERNANCE |
+---------------------------------------------------------------------------------------------------+
| |
| [ Operator User Persona Permissions ] |
| │ |
| ▼ |
| [ Action Group Scope (Computer Groups) ] |
| │ |
| ▼ |
| [ Targeting Question Filter (Sensor Expression) ] |
| │ |
| ▼ |
| [ FINAL EFFECTIVE TARGET: Matching Endpoints ] |
| |
+---------------------------------------------------------------------------------------------------+
Targeting Components
- Operator Persona Scope: An operator can never deploy an action to endpoints outside their assigned management rights computer groups (e.g., a Windows Server Admin persona cannot target macOS endpoints).
- Action Groups: An administrative configuration object that assigns specific computer groups to action execution boundaries. Scheduled and recurring actions must be assigned to an Action Group.
- Targeting Question Filters: The real-time filter expression evaluated by endpoints. For example:
Is Windows equals True and Operating System contains "Server" and Disk Free Space < 10 GB.
The Dual-Filter Evaluation Rule
When an endpoint receives an action instruction, it evaluates both its membership in the target Action Group and the specific question filter. If the endpoint does not satisfy both criteria simultaneously, it discards the action instruction without downloading payloads or executing code.
3. Action Timing Controls: Start, Distribution & Expiration
Configuring action timing is a critical operational skill tested heavily on the TCO exam. Three distinct timing controls dictate how and when an action executes:
+---------------------------------------------------------------------------------------------------+
| ACTION TIMING PARAMETERS |
+---------------------------------------------------------------------------------------------------+
| TIMING PARAMETER | DEFINITION & MECHANICS | TYPICAL VALUE & SCENARIO |
+--------------------------+----------------------------------------+-------------------------------+
| 1. Schedule Start Time | Specifies the exact date/time when | Immediate (Now) for incidents;|
| | endpoints are authorized to begin | Future Maintenance Window |
| | executing the action. | (e.g., Saturday at 02:00 UTC).|
+--------------------------+----------------------------------------+-------------------------------+
| 2. Distribute Over | Spreads the execution start time | 2 to 4 hours for large apps; |
| (Distribute Over) | randomly across endpoints over a | 0 minutes for emergency |
| | configured duration window. | incident containment. |
+--------------------------+----------------------------------------+-------------------------------+
| 3. Expiration Time | The duration during which the action | 2 hours for active incidents; |
| (Action Lifespan) | remains active on the Tanium Server | 3 to 7 days for mobile / |
| | for offline endpoints to receive. | roaming laptop workforces. |
+--------------------------+----------------------------------------+-------------------------------+
Deep-Dive: Distribute Over
If an administrator deploys a 1 GB software package to 100,000 endpoints simultaneously with Distribute Over = 0, every machine will attempt to install the software at the exact same second. This can cause:
- Thundering Herd Network Spikes: Saturated local network switches and proxy gateways.
- Storage I/O Bottlenecks: Virtual Desktop Infrastructure (VDI) SAN storage lockups ("boot storms").
- Backend Service Outages: Hundreds of thousands of endpoints simultaneously restarting a service or connecting to a database.
How Distribute Over Resolves This:
When an operator sets Distribute Over = 2 hours, each target endpoint calculates a randomized local execution delay (jitter) between 0 and 120 minutes. Endpoint A starts at minute 7, Endpoint B starts at minute 42, and Endpoint C starts at minute 108. The operational load is smoothed perfectly across the entire 2-hour window.
Deep-Dive: Expiration Time
Enterprise workforces are dynamic—laptops go to sleep, traveling employees board flights, and branch offices experience intermittent connectivity. If an action had zero lifespan, only endpoints online at the exact deployment moment would receive it.
How Expiration Time Resolves This:
When an action is configured with Expiration Time = 5 days, the Tanium Server maintains the action definition active in the linear chain broadcast state. If an offline laptop powers on 3 days after the initial deployment, the Tanium Client checks in, evaluates the active action, verifies that the current timestamp is prior to the expiration cutoff, downloads the payload, and executes the remediation.
[!TIP] Exam Rule of Thumb for Expiration Time:
- For Emergency Incident Containment (e.g., isolating a compromised ransomware host or killing a malicious process), use short expiration times (e.g., 2 to 6 hours) to prevent running obsolete remediation commands days later.
- For Fleet-Wide Software Deployment or Compliance Baselines, use long expiration times (e.g., 3 to 14 days) to achieve maximum fleet coverage across traveling and offline devices.
5. Action approval and two-person integrity
Some organisations require two-person integrity, which means that actions a user initiates cannot deploy until another user approves those actions. This is a platform capability rather than a workflow convention, and it is configured through roles.
The three permissions that matter
| Permission | Effect |
|---|---|
| Approve Action | The holder can approve pending actions associated with packages in the specified content sets. An approver role is normally configured with Approve Action and Sensor read permissions on those content sets |
| Bypass Action Approval | The holder is not subject to approval requirements when deploying actions associated with packages in the specified content sets |
| (neither) | Actions the user initiates wait for someone else's approval |
Both are configured as custom roles and can be assigned to personas, users and user groups. The global switch is Require Action Approval, set to ON or OFF, and there is an optional Bulk Approval setting that lets approvers approve multiple actions without being prompted to review each configuration — which enables a More > Bulk Approval option on the Actions I can Approve page.
One documented exception: Tanium Endpoint Configuration automatically bypasses approval when deploying actions that distribute Tanium Client configuration and manifest packages.
The approval workflow
- An operator deploys an action. If approval is required, the action does not start.
- Users with the Admin reserved role can see everything waiting on Administration > Actions > All Pending Approvals.
- An approver signs in and works from the Actions I can Approve page. They can click Preview to review the action configuration before approving, or use Bulk Approval to approve without reviewing.
- Once approved, the action proceeds. Its status is visible on the Action History page or the Deployment Details page.
How long an approval lasts
The approval remains in force until the End At date-time that is set in the action configuration, or until another user modifies the configuration.
That second clause is the one that catches people. Editing an approved action invalidates its approval, and the action must be approved again. This is deliberate — otherwise an approver would be signing off on a configuration that someone could quietly change afterwards, which would defeat the entire point of two-person integrity.
Why organisations turn it on
- Insider-threat and compromised-account mitigation. A single credential cannot unilaterally push a change to production.
- Blast-radius reduction. A second reader catches an inverted filter or a target group that is wider than intended before it reaches endpoints.
- Audit evidence. Frameworks that demand dual authorisation for production change get it natively, with the record kept in the platform.
6. A safe deployment sequence
| Step | What you do | What it protects against |
|---|---|---|
| 1 | Ask the question that identifies the problem, and reissue it | Results expire after 10 minutes; stale targeting acts on the wrong fleet |
| 2 | Check the count against expectation | A filter that is not doing what you think |
| 3 | Narrow with drill down if you are acting from question results | Acting on aggregate rows rather than identified endpoints |
| 4 | If the population exceeds 100, express it as a computer group or saved question | The 100-row selection limit, and unrepeatable hand-selection |
| 5 | Confirm the action group permits the target | Deploying into a scope the organisation did not intend |
| 6 | Set Distribute Over for anything heavy | Thundering-herd network, storage and backend spikes |
| 7 | Set a sensible End At | Actions lingering long after they are relevant |
| 8 | Submit for approval where required, and do not edit after approval | Silently invalidating the approval you just obtained |
| 9 | Watch Action History, then verify with a question | Assuming exit code 0 means the state is correct |
What is the primary operational benefit of setting a Distribute Over value of 4 hours when deploying a large software package to 50,000 endpoints?
An administrator deploys an action with an Expiration Time of 7 days to remediate a critical workstation vulnerability. What happens when an employee powers on an offline laptop 3 days after the initial deployment?
An operator has identified 240 endpoints that need a remediation package. What does Tanium's action deployment design expect them to do?
An action has been approved and is waiting for its scheduled start time when another user edits its command line. What happens to the approval?
Which permission allows a user to deploy actions without being subject to approval requirements, and how is its scope limited?