nano SIEM
Search Commands

lateral

Trace where a user or host moved: logons, lateral-movement connections and remote execution, hop by hop.

Use lateral to trace where a user, host, or IP moved during your search window. nano follows authentication, connections on lateral-movement ports, and remote-execution tools to return movement edges and a graph.

Use it to answer "where did this account go?" or "what did this compromised host reach?" without pivoting by hand.

Syntax

<seed filter> | lateral [seed=auto|user|host] [entity=<field>] [maxhops=<1-10>] [methods=auth,network,process]
ArgumentDefaultDescription
seedautoWhich kind of entity to start from. auto tries users first, then hosts and IPs.
entityauto-detectedThe field that holds the seed: user.name, actor.user.name, device.hostname, src_endpoint.hostname, dst_endpoint.hostname, src_endpoint.ip or dst_endpoint.ip.
maxhops4How many hops to follow from the seed (1–10).
methodsall threeWhich evidence to follow: auth, network, process.

The trace covers the search time range. Set it with the time picker or earliest=.

Seeding the trace

Put an exact match for the seed in the base search. lateral reads the seed from it:

  • user.name="mtaylor" | lateral starts from that account.
  • device.hostname="ws-it-083.corp.local" | lateral seed=host starts from that host.
  • src_endpoint.ip="10.1.4.63" | lateral entity=src_endpoint.ip starts from that IP.

Without an exact match, lateral takes the seed from the first matching events, so a broad base search can seed on an unexpected entity. The seed it used is shown in the result header.

Evidence it follows

MethodWhat it looks forTechnique shown
authAuthentication events (class_uid=3002), events with activity_name="Logon", and events with an auth_protocolThe authentication protocol (kerberos, ntlm, negotiate), else rdp/ssh by destination port, else logon
networkConnections to dst_endpoint.port 22, 135, 139, 445, 3389, 5985 or 5986ssh, dcom, smb, rdp, winrm
processProcesses whose process.name contains psexe, wmic, winrs, powershell, pwsh, mstsc, ssh, schtasks or sc.exeThe tool, for example psexec or wmic

A host seed also matches events that name the host only by an IP it held during the window.

Output

  • Graph. The result view draws the movement graph: hosts and users as nodes, edges labeled by method with counts and first-seen times.
  • Rows. One row per movement edge, with the time, user, source and destination host, IP and port, the method and technique (see the table above), the hop number (0 is the seed's own movement), the authentication type and result, the process name for process-based edges, and the log source.
  • Header. The seed field and value, hops and methods used, total edges and unique hosts, and whether the trace stopped early at a hop because of its time budget.

Limits

Examples

Where did this account log on or connect in the last hour?

user.name="mtaylor" | lateral

Two hops from a suspected compromised workstation, logons and connections only:

device.hostname="ws-it-083.corp.local" | lateral seed=host maxhops=2 methods=auth,network

Start from an IP address:

src_endpoint.ip="10.1.4.63" | lateral entity=src_endpoint.ip maxhops=1

Only logon evidence, one hop, first 50 edges:

user.name="lallen" | lateral entity=user.name methods=auth maxhops=1 | head 50

Notes

  • Narrow the time range and lower maxhops or methods when a trace takes long; each hop and method adds work.
  • Edges for the same source, destination and method within the same minute are collapsed into one.
  • For a single host's activity and identity history, use asset.

What's next

On this page