# Impacket: read a file from an SMB share



Read a file from an SMB share.



## 1. Run the example



[Download the Impacket example](https://www.security.run/docs/examples/impacket.zip). Extract it, install `httpx`, set your API URL and token, then run `python client.py`. The client uploads the included inputs, submits the command, and saves the result under `results/RUN_ID`.



## 2. Check the result



Read download.txt for the marker fetched from the isolated authenticated share.



Read the native exit code and cleanup status printed by the client. [Read results and save reports](https://www.security.run/docs/visibility.html) explains the returned files.



## 3. Use your own inputs



Edit `example.json` to change the command arguments, requested outputs or deadline. Replace the files under `inputs/` with your own data, keeping the staged paths aligned with the command. The client creates the artifact IDs for you; illustrative IDs shown here must not be copied into a live request.



### Files used by this example



- `read_share.py`



This example selects the isolated `smb-fixture` target. To use a reachable target of your own, change the target arguments or driver and remove `target_profile`. See [Run a check against a target](https://www.security.run/docs/targets.html) for network setup.



Qualified version: `0.13.1`. Commands: `smbclient`, `smbserver`, `secretsdump`, `python`, `CheckLDAPStatus`, `DumpNTLMInfo`, `Get-GPPPassword`, `GetADComputers`, `GetADUsers`, `GetLAPSPassword`, `GetNPUsers`, `GetUserSPNs`, `addcomputer`, `atexec`, `attrib`, `badsuccessor`, `changepasswd`, `checkMSSQLStatus`, `dacledit`, `dcomexec`, `describeTicket`, `dpapi`, `dpapidump`, `esentutl`, `exchanger`, `filetime`, `findDelegation`, `getArch`, `getPac`, `getST`, `getTGT`, `goldenPac`, `karmaSMB`, `keylistattack`, `kintercept`, `lookupsid`, `machine_role`, `mimikatz`, `mqtt_check`, `mssqlclient`, `mssqlinstance`, `net`, `netview`, `ntfs-read`, `ntlmrelayx`, `owneredit`, `ping`, `ping6`, `psexec`, `raiseChild`, `rbcd`, `rdp_check`, `reg`, `registry-read`, `regsecrets`, `rpcdump`, `rpcmap`, `sambaPipe`, `samedit`, `samrdump`, `services`, `smbexec`, `sniff`, `sniffer`, `split`, `ticketConverter`, `ticketer`, `tstool`, `wmiexec`, `wmipersist`, `wmiquery`.



- Bundled console scripts and the Python API are available; network operations need a compatible target.



Inspect `GET /v1/tools/impacket` for the current installed version and readiness. The published snapshot has 2 functional case(s), plus timeout and cancellation checks. These examples demonstrate the native path; other flags and inputs are supported within the tool’s runtime limits.

## Command submitted by the example

```json
{
  "tool": "impacket",
  "timeout_seconds": 90,
  "invocation": {
    "args": [
      "read_share.py"
    ],
    "outputs": [
      "download.txt"
    ],
    "success_exit_codes": [
      0
    ],
    "executable": "python",
    "files": [
      {
        "path": "read_share.py",
        "artifact_id": "artifact_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        "executable": false
      }
    ]
  },
  "target_profile": "smb-fixture"
}
```