SMB Share Enumeration

Overview

Read-only Windows / Samba enumeration. Tries guest credentials first, falls back to anonymous; never attempts brute-force.

How it works

Built from KaliToolbox.smbmap(). avoidWhen guidance: don't run on hosts without SMB; guest/anonymous only — no brute-force.

Example

When a user asks:

Enumerate SMB shares on 192.168.1.10

the agent calls the tool:

kali_smbmap(target="192.168.1.10")

and gets back: [+] IP: 192.168.1.10 Name: SAMBA-SERVER Disk Permissions Comment --- ----------- ------ print$ NO ACCESS Printer Drivers public READ ONLY Public Files homes READ, WRITE Home Directories

Configuration

Set these before calling the tool. Values marked required must be present or the tool call will fail.

swarmai.skill.container.runtime required

Shared ContainerSkillRuntime.

Use it in a workflow

Wire this tool into a SwarmAI crew. Use the YAML DSL for declarative workflows, or the Java builder API when you want full programmatic control.

YAML DSL

# Step 3 of a reactive audit:
# 1. kali_nmap finds 192.168.1.10:445 open (microsoft-ds)
# 2. agent reasons: SMB host → enumerate shares
# 3. agent calls kali_smbmap(target='192.168.1.10')

Java

import ai.intelliswarm.swarmai.skill.runtime.KaliToolbox;
import ai.intelliswarm.swarmai.skill.runtime.ContainerSkillRuntime;

var smbmap = new KaliToolbox(new ContainerSkillRuntime()).smbmap();
String result = (String) smbmap.execute(java.util.Map.of("target", "192.168.1.10"));

What it's good for

Real scenarios where agents put this tool to work.

Triage SMB-exposing hosts during an internal network audit

Compose with kali_enum4linux for deeper Windows enumeration

Quick share-permission inventory before a configuration review

Source

Implementation lives at swarmai-core/src/main/java/ai/intelliswarm/swarmai/skill/runtime/KaliToolbox.java in the swarm-ai repository.

Open kali_smbmap on GitHub →