Skip to content

Commit 3826c46

Browse files
Update README.md
1 parent 2e131e6 commit 3826c46

File tree

1 file changed

+13
-21
lines changed

1 file changed

+13
-21
lines changed

README.md

Lines changed: 13 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,6 @@
44
</p>
55
<p align="center">
66
<img src="https://img.shields.io/badge/python-3.6-blue.svg"/>
7-
<img src="https://img.shields.io/badge/python-3.7-blue.svg"/>
8-
<img src="https://img.shields.io/badge/python-3.8-blue.svg"/>
9-
<img src="https://img.shields.io/badge/python-3.9-blue.svg"/>
10-
<img src="https://img.shields.io/badge/python-3.10-blue.svg"/>
11-
<img src="https://img.shields.io/badge/License-GPLv3-green.svg"/>
127
</p>
138

149
enum4linux-ng.py is a rewrite of Mark Lowe's (former Portcullis Labs now Cisco CX Security Labs) enum4linux.pl, a tool for enumerating information from Windows and Samba systems, aimed for security professionals and CTF players. The tool is mainly a wrapper around the Samba tools `nmblookup`, `net`, `rpcclient` and `smbclient`.
@@ -53,7 +48,7 @@ enum4linux-ng.py -As <target> -oY out
5348
```
5449

5550
### Demo
56-
#### Windows Server 2012 R2
51+
### Windows Server 2012 R2
5752
This demonstrates a run against Windows Server 2012 R2 standard installation. The following command is being used:
5853

5954
```console
@@ -64,7 +59,7 @@ A user 'Tester' with password 'Start123!' was created. Firewall access was allow
6459

6560
![Demo](https://github.com/cddmp/misc/blob/master/screencasts/enum4linux-ng/demo1.gif)
6661

67-
#### Metasploitable 2
62+
### Metasploitable 2
6863
The second demo shows a run against Metasploitable 2. The following command is being used:
6964

7065
```console
@@ -129,23 +124,20 @@ options:
129124
## Installation
130125
There are multiple ways to install the tool. Either the tool comes as a package with your Linux distribution or you need to do a manual install.
131126

132-
### Automatic Installation
133-
I'm aware of the following Linux distributions which package the tool:
134-
135-
#### Archstrike
127+
### Archstrike
136128

137129
```console
138130
pacman -S enum4linux-ng
139131
```
140132

141-
#### NixOS
133+
### NixOS
142134
(tested on NixOS 20.9)
143135

144136
```console
145137
nix-env -iA nixos.enum4linux-ng
146138
```
147139
### Manual Installation
148-
#### Dependencies
140+
### Dependencies
149141
The tool uses the samba clients tools, namely:
150142
- nmblookup
151143
- net
@@ -164,29 +156,29 @@ For a faster processing of YAML (optional!) also install (should come as a depen
164156

165157
Some examples for specific Linux distributions installations are listed below. Alternatively, distribution-agnostic ways (python pip, python virtual env and Docker) are possible.
166158

167-
#### Linux distribution specific
159+
### Linux distribution specific
168160
For all distribution examples below, LibYAML is already a dependency of the corresponding PyYaml package and will be therefore installed automatically.
169-
##### ArchLinux
161+
### ArchLinux
170162

171163
```console
172164
pacman -S smbclient python-ldap3 python-yaml impacket
173165
```
174-
##### Fedora/CentOS/RHEL
166+
### Fedora/CentOS/RHEL
175167
(tested on Fedora Workstation 31)
176168

177169
```console
178170
dnf install samba-common-tools samba-client python3-ldap3 python3-pyyaml python3-impacket
179171
```
180172

181-
##### Kali Linux/Debian/Ubuntu/Linux Mint
173+
### Kali Linux/Debian/Ubuntu/Linux Mint
182174
(tested on Kali Linux 2020.1, recent Debian (e.g. Buster) or Ubuntu versions should work, for Ubuntu 18.04 or below use the Docker or Python virtual environment variant)
183175

184176
```console
185177
apt install smbclient python3-ldap3 python3-yaml python3-impacket
186178
```
187179

188-
#### Linux distribution-agnostic
189-
##### Python pip
180+
### Linux distribution-agnostic
181+
### Python pip
190182
Depending on the Linux distribution either `pip3` or `pip` is needed:
191183

192184
```console
@@ -201,7 +193,7 @@ pip install -r requirements.txt
201193

202194
Remember you need to still install the samba tools as mentioned above.
203195

204-
##### Python virtual environment
196+
### Python virtual environment
205197
```console
206198
git clone https://github.com/cddmp/enum4linux-ng
207199
cd enum4linux-ng
@@ -218,7 +210,7 @@ python3 enum4linux-ng.py -As <target>
218210

219211
Remember you need to still install the samba tools as mentioned above. In addition, make sure you run ```source venv/bin/activate``` everytime you spawn a new shell. Otherwise the wrong Python interpreter with the wrong libraries will be used (your system one rather than the virtual environment one).
220212

221-
##### Docker
213+
### Docker
222214
```console
223215
git clone https://github.com/cddmp/enum4linux-ng
224216
cd enum4linux-ng

0 commit comments

Comments
 (0)