0xbbuddha/Ensh
GitHub: 0xbbuddha/Ensh
纯 Bash 实现的 Windows 网络协议攻击库,无需编译或外部依赖即可在 Shell 中与 SMB、NTLM、Kerberos、LDAP 等协议直接交互。
Stars: 1 | Forks: 0
# Ensh
Ensh 是一个模块化库,它为 Bash 带来了 [impacket](https://github.com/fortra/impacket) 为 Python 提供的能力:无需离开 shell 即可与 Windows 环境的各种协议(SMB, NTLM, Kerberos, LDAP, NetBIOS…)进行交互。
零编译依赖。零必需外部二进制文件。纯 Bash 实现。
## 为什么选择 Ensh?
| | impacket (Python) | Manticore (Go) | **Ensh (Bash)** |
|---|---|---|---|
| 语言 | Python 3 | Go | Bash ≥ 5.0 |
| 依赖 | pip | go modules | 无 |
| Shell 集成 | 通过 subprocess | 通过 subprocess | **原生** |
| 可移植性 | 只要安装了 Python 即可 | 需要编译 | 只要安装了 bash 即可 |
Ensh 不是 impacket 或 Manticore 的移植。这是一种专为 shell 设计的全新方法。
## 项目结构
```
ensh.sh — Chargeur principal (point d'entrée)
lib/
core/ — Fondations : import, log, bytes, hex, endianness
crypto/ — Primitives : MD4, HMAC-MD5, RC4, NT/LM hash
encoding/ — UTF-16LE, Base64, ASN.1 DER
protocol/ — Implémentations des protocoles
netbios/ — NetBIOS over TCP (NBT)
ntlm/ — Authentification NTLM (v1/v2)
smb/smb1/ — SMB 1.0
smb/smb2/ — SMB 2.x / 3.x
kerberos/ — Kerberos 5
ldap/ — LDAP / LDAPS
transport/ — Couche TCP et UDP (/dev/tcp, /dev/udp)
tools/ — Outils standalone (smbclient, secretsdump…)
tests/ — Suite de tests unitaires
examples/ — Exemples d'utilisation
docs/ — Références de protocoles et spécifications
```
## 快速使用
```
# 加载完整库
source ensh.sh
# 或仅导入所需内容
ensh::import protocol/ntlm
# 创建 Negotiate NTLM 消息
ntlm::negotiate::build my_msg
ntlm::negotiate::set_flags my_msg "$(ntlm::flags::default)"
ntlm::negotiate::encode my_msg hex_output
```
## 代码规范
- 所有函数都使用命名空间:`module::sous_module::fonction`
- 二进制数据以十六进制形式传输(`DEADBEEF`,不带 `0x`)
- 字节序是显式声明的:`core::endian::le16`, `core::endian::be32`
- 每个模块都在文件头部通过 `ensh::import` 声明其依赖项
- 测试文件共存于 `tests/` 目录中,并遵循相同的层级结构
## 前置条件
- Bash ≥ 5.0
- `printf`, `xxd`, `od`(所有 Linux/macOS 发行版均自带)
- `openssl`(可选,可加速某些加密操作)
## 许可证
MIT — 详见 [LICENSE](LICENSE)
标签:ASN1, Base64, Checkov, Conpot, CTF学习, HTTP, Impacket替代, Kerberos协议, LDAP协议, MD4, NetBIOS, NTLM认证, Offensive Security, RC4, SMB协议, TCP UDP, Web报告查看器, Windows安全, XML 请求, 内网渗透, 协议分析, 安全开发, 安全脚本, 应用安全, 攻击路径可视化, 权限提升, 纯Bash, 网络协议库, 网络安全, 隐私保护, 零依赖, 黑客工具