Skip to content

ThreatLocker Setup ​

ThreatLocker is a zero-trust endpoint protection platform built around application allowlisting. Once connected, Junto can review pending application approval requests, permit or reject blocked applications, look up computers and their security posture, manage maintenance mode, and isolate or release endpoints across your organizations.

Prerequisites ​

  • A ThreatLocker administrator account with permission to create API Users (e.g., a Super Admin role)
  • An API key generated from the ThreatLocker Portal
  • Your ThreatLocker instance letter (used to build the API URL)

Step 1: Generate an API Key ​

  1. Log in to the ThreatLocker Portal.
  2. Navigate to the Administrators page and select the API Users tab.
  3. Click New API User.
  4. Enter a name for the token (e.g., "junto").
  5. Select an API Token Expiration. The expiration is a sliding window -- each time the token is used, the timer resets, so a 365-day token only expires after 365 days of inactivity.
  6. Under Roles/Permissions, assign the role(s) and select the organization(s) Junto should manage. Include your child organizations if Junto should handle approval requests across all your clients.
  7. Click Generate API Token and copy the key. It is shown only once -- store it securely before closing the panel.

Step 2: Find Your API URL ​

ThreatLocker hosts customers on lettered instances, and the API URL depends on which instance your organization is on.

  1. In the ThreatLocker Portal, click the Help button in the upper-right corner.
  2. Your instance letter appears in parentheses next to the ThreatLocker Access header (e.g., "G").
  3. Your API URL is https://portalapi.<instance>.threatlocker.com -- for example, instance G uses https://portalapi.g.threatlocker.com.

Step 3: Configure in Junto ​

  1. In Junto, go to Settings > Integrations > ThreatLocker.
  2. Click Add configuration and fill in:
    • API URL -- Your instance-specific URL from Step 2.
    • API Key -- The key from Step 1. This is encrypted before storage.
    • Active -- Leave on so the agent can use the connection.
  3. Save, then use Test connection to verify the credentials.

TIP

If the connection test fails with an authentication error, double-check the instance letter in your API URL. A valid key from one instance will not authenticate against another instance's URL.

Step 4: Map Companies to Organizations ​

ThreatLocker organizes endpoints into organizations, with each MSP client typically a separate child organization.

  1. After connecting, click Company mapping on the configuration card. Junto lists the organizations available to your API key.
  2. Link each Junto company to its ThreatLocker organization.
  3. Auto-map is available to match organizations by name, with both exact and close-match suggestions.
  4. Save mappings.

What the Agent Can Do ​

Reads run inside the mapped organization for the company being worked; an MSP-wide view is available only in organization-wide Explore chats. Writes always need a mapped company and run only from Explore or ticket chat, never unattended.

Read ​

ActionDescription
List / get approval requestsPending application approval requests, with the file path, hash, certificates, and the requester's reason
Matching applicationsApplications already defined that match a request
Application researchBackground on a file or publisher
List / get computersEndpoints by name, with organization, OS, agent version, and last check-in
Computer groupsThe groups used to scope policies
Maintenance mode statusWhether a computer is in installation, learning, or monitor mode
Denied actionsRecent blocks on a computer
System auditAudit log entries
Health Center findingsFindings from ThreatLocker's Health Center
Agent versionsAvailable agent releases
Scheduled actionsPending scheduled agent updates and mode changes

Read tools do not require approval and are available in automated triage.

Write -- Technician Approval ​

ActionDescription
Reject approval requestDeny a request and notify the requester with a reason
Ignore approval requestDismiss a request without action
Take ownership of requestAssign a request to yourself
Set maintenance modePut a computer in installation, learning, or monitor mode
End maintenance modeReturn a computer to its normal policy
Enable protectionReturn a computer to Secured
Restart agentRestart the ThreatLocker agent on a computer
Schedule agent updateQueue an agent upgrade
Abort scheduled actionCancel a pending scheduled action

These actions require technician approval before execution.

Write -- Internal Approvers ​

ActionDescription
Permit applicationApprove a blocked application for the single computer that generated the request, with an optional expiration
Isolate computerCut a computer off from the network
Lock down computerBlock all applications on a computer
Release computerEnd isolation or lockdown
Disable protectionSwitch to monitor or tamper-off mode for 5 to 1,440 minutes
Rescan baselineRebuild a computer's application baseline

Approval Required

These changes are routed to your designated internal approvers before execution. Read-only tools do not require approval.

Permits are deliberately scoped to the single computer that generated the request -- the agent cannot create organization-wide allow policies, and storage-approval permits are not available. Requests that have been escalated to the MSP level must be handled directly in the ThreatLocker Portal.

Troubleshooting ​

  • Connection fails with an authentication error -- Verify the API key and confirm the instance letter in your API URL matches your portal's instance (Step 2). Keys are instance-specific.
  • Connection fails with an unreachable or timeout error -- Check the API URL for typos and confirm it uses https://.
  • No organizations listed for mapping -- Confirm the API User was granted access to the expected organizations when it was created.
  • Agent can't permit a request -- The request may have been escalated to the MSP level, already actioned by another administrator, or since removed. Escalated requests must be resolved in the ThreatLocker Portal.
  • Key stopped working after a period of inactivity -- API token expiration is a sliding window based on last use. Generate a new key if yours has lapsed.