Skip to content

Commit 3783ec9

Browse files
committed
Move ZH and FR READMEs into docs/ and fix all cross-links
1 parent e8ded69 commit 3783ec9

5 files changed

Lines changed: 13 additions & 13 deletions

File tree

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# SharpADIDNS
22

3-
**Language**: **English** | [中文](README.zh-CN.md) | [Français](README.fr.md)
3+
**Language**: **English** | [中文](docs/README.zh-CN.md) | [Français](docs/README.fr.md)
44

55
<img align="right" src="assets/SharpADIDNS-Logo.png" alt="SharpADIDNS Logo" width="280">
66

README.fr.md renamed to docs/README.fr.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
# SharpADIDNS
22

3-
**Langues** : [English](README.md) | [中文](README.zh-CN.md) | **Français**
3+
**Langues** : [English](../README.md) | [中文](README.zh-CN.md) | **Français**
44

5-
<img align="right" src="assets/SharpADIDNS-Logo.png" alt="SharpADIDNS Logo" width="280">
5+
<img align="right" src="../assets/SharpADIDNS-Logo.png" alt="SharpADIDNS Logo" width="280">
66

77
<p>
88
Outil CLI en C# pour lire et modifier les enregistrements DNS intégrés à AD via LDAP, destiné aux travaux d'administration et de recherche autour d'AD-DNS ; un certain nombre d'adaptations d'ingénierie ont été faites pour les scénarios de chargement .NET à distance (par exemple via Sliver <code>execute-assembly</code>).
@@ -24,7 +24,7 @@ Construit sur <code>System.DirectoryServices</code>, cible .NET Framework 4.x, p
2424

2525
<br clear="right">
2626

27-
<img align="right" src="assets/SharpADIDNS-SS-Alpha.png" alt="SharpADIDNS ScreenShot" width="100%">
27+
<img align="right" src="../assets/SharpADIDNS-SS-Alpha.png" alt="SharpADIDNS ScreenShot" width="100%">
2828

2929
<br clear="right">
3030

@@ -59,7 +59,7 @@ Aucune dépendance tierce.
5959

6060
**Binaire pré-compilé** : téléchargez `SharpADIDNS.exe` depuis la [page Releases](https://github.com/RedteamNotes/SharpADIDNS/releases/latest) (la CI attache un build frais à chaque release taguée). Pour compiler depuis les sources, suivez la commande `csc` ci-dessus. Le dossier `release/` n'est pas versionné.
6161

62-
**Scénarios de bout en bout** : voir [`docs/RECIPES.fr.md`](docs/RECIPES.fr.md) pour des recettes (reconnaissance DNS, ajout d'enregistrement unique avec rollback, écriture à faible empreinte avec `--mimic-aging` + `--set-owner`, écriture wildcard, ajout SRV, opérations batch, nettoyage de fin de mission, vérification DACL préalable). Le README (ce document) couvre les flags ; les recettes couvrent les *flux*.
62+
**Scénarios de bout en bout** : voir [`RECIPES.fr.md`](RECIPES.fr.md) pour des recettes (reconnaissance DNS, ajout d'enregistrement unique avec rollback, écriture à faible empreinte avec `--mimic-aging` + `--set-owner`, écriture wildcard, ajout SRV, opérations batch, nettoyage de fin de mission, vérification DACL préalable). Le README (ce document) couvre les flags ; les recettes couvrent les *flux*.
6363

6464
### Tests
6565

README.zh-CN.md renamed to docs/README.zh-CN.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
# SharpADIDNS
22

3-
**语言**: [English](README.md) | **中文** | [Français](README.fr.md)
3+
**语言**: [English](../README.md) | **中文** | [Français](README.fr.md)
44

5-
<img align="right" src="assets/SharpADIDNS-Logo.png" alt="SharpADIDNS Logo" width="280">
5+
<img align="right" src="../assets/SharpADIDNS-Logo.png" alt="SharpADIDNS Logo" width="280">
66

77
<p>
88
一款用于通过 LDAP 读取和修改微软活动目录集成DNS(ADIDNS)记录的 C# 命令行工具,面向严肃的红队行动构建,并内置一系列专为 Sliver C2 <code>execute-assembly</code> 执行场景定制的技战术功能。
@@ -28,7 +28,7 @@
2828

2929
<br clear="right">
3030

31-
<img align="right" src="assets/SharpADIDNS-SS-Alpha.png" alt="SharpADIDNS ScreenShot" width="100%">
31+
<img align="right" src="../assets/SharpADIDNS-SS-Alpha.png" alt="SharpADIDNS ScreenShot" width="100%">
3232

3333
<br clear="right">
3434

@@ -63,7 +63,7 @@ C:\Windows\Microsoft.NET\Framework64\v4.0.30319\csc.exe
6363

6464
**预编译二进制**:可从 [Releases 页面](https://github.com/RedteamNotes/SharpADIDNS/releases/latest) 下载 `SharpADIDNS.exe`(CI 在每次打 tag 时自动构建并 attach 新版本)。源码编译参见上方 `csc` 命令。`release/` 目录不纳入版本控制。
6565

66-
**端到端场景**:详见 [`docs/RECIPES.zh-CN.md`](docs/RECIPES.zh-CN.md)(环境侦察、单记录写入与回滚、`--mimic-aging` + `--set-owner` 的低噪写入、通配符写入、SRV 追加、批处理、环境收尾、DACL 预检)。本 README 是参考手册(讲"每个 flag 干嘛"),recipes 讲"某种场景的完整流程"。
66+
**端到端场景**:详见 [`RECIPES.zh-CN.md`](RECIPES.zh-CN.md)(环境侦察、单记录写入与回滚、`--mimic-aging` + `--set-owner` 的低噪写入、通配符写入、SRV 追加、批处理、环境收尾、DACL 预检)。本 README 是参考手册(讲"每个 flag 干嘛"),recipes 讲"某种场景的完整流程"。
6767

6868
### 测试
6969

docs/RECIPES.fr.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ Scénarios de laboratoire autour de SharpADIDNS. Chaque recette est décrite sou
77
- **Perspective opérationnelle / laboratoire** — comment reproduire un comportement d'écriture ou de lecture ADIDNS dans un environnement contrôlé ;
88
- **Perspective défensive** — ce que l'équipe bleue / le SOC peut observer, les alertes, signatures de logs et angles morts de monitoring correspondants.
99

10-
Chaque recette est autonome — vous pouvez sauter directement à celle dont vous avez besoin. Par défaut on utilise le [mode `--c2`](../README.fr.md#utilisation-via-sliver-execute-assembly) comme forme d'invocation, car l'un des principaux chemins de déploiement est Sliver `execute-assembly`. Pour exécuter en shell local, retirez `--c2` et remplacez `--password-base64` par `--password` (en acceptant l'avertissement cleartext).
10+
Chaque recette est autonome — vous pouvez sauter directement à celle dont vous avez besoin. Par défaut on utilise le [mode `--c2`](README.fr.md#utilisation-via-sliver-execute-assembly) comme forme d'invocation, car l'un des principaux chemins de déploiement est Sliver `execute-assembly`. Pour exécuter en shell local, retirez `--c2` et remplacez `--password-base64` par `--password` (en acceptant l'avertissement cleartext).
1111

1212
## Variables utilisées dans toutes les recettes
1313

@@ -399,4 +399,4 @@ Ceux-ci s'appliquent à toutes les recettes, pas seulement une :
399399
- **Le champ `reverse` est un best-effort une-ligne**. Pour replace / append / disable / remove, `reverse` vaut `null` et vous devez reconstruire depuis `previous_state.records_base64`. Ne comptez pas que sur `reverse` — gardez le reçu complet.
400400
- **Le baseline défensif** : les sections « Perspective défensive » ne sont pas exhaustives — un SOC déployé en vrai dispose en plus d'EDR endpoint, de DPI réseau, de logs de requêtes DNS, de métadonnées de réplication AD, etc. Toute opération ADIDNS doit présumer **qu'au moins une source de données la voit**.
401401

402-
Pour le modèle de visibilité d'audit plus large, voir [`Visibilité d'audit`](../README.fr.md#visibilité-daudit) dans le README principal.
402+
Pour le modèle de visibilité d'audit plus large, voir [`Visibilité d'audit`](README.fr.md#visibilité-daudit) dans le README principal.

docs/RECIPES.zh-CN.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@
1111
- **运维 / 实验视角** — 在受控的实验环境中如何复现某种 ADIDNS 写入或读取行为;
1212
- **防御视角** — 蓝队 / SOC 侧能观察到什么,对应的告警、日志特征与监控盲点。
1313

14-
每个 recipe 自成一体 — 不用看其他几个就能直接跳到所需的那一个。默认使用 [`--c2` 模式](../README.zh-CN.md#通过-sliver-execute-assembly-使用) 作为调用形态,因为主部署路径之一是 Sliver `execute-assembly`。如要改在本地 shell 跑,去掉 `--c2`,把 `--password-base64` 换成 `--password`(并接受 cleartext 告警)。
14+
每个 recipe 自成一体 — 不用看其他几个就能直接跳到所需的那一个。默认使用 [`--c2` 模式](README.zh-CN.md#通过-sliver-execute-assembly-使用) 作为调用形态,因为主部署路径之一是 Sliver `execute-assembly`。如要改在本地 shell 跑,去掉 `--c2`,把 `--password-base64` 换成 `--password`(并接受 cleartext 告警)。
1515

1616
## 全部 recipe 共用的变量
1717

@@ -403,4 +403,4 @@ sliver > execute-assembly SharpADIDNS.exe -p dllhost.exe -- \
403403
- **`reverse` 字段是 best-effort 单行式**。replace / append / disable / remove 场景下 `reverse``null`,你必须从 `previous_state.records_base64` 重建。别只靠 `reverse` — 保留完整 receipt。
404404
- **防御视角的可见性是底线**:本文档的 "防御视角" 段落不是穷举 — 真实 SOC 部署里还有 endpoint EDR、network DPI、DNS query log、AD replication metadata 等多种数据源;任何 ADIDNS 操作都应假定**至少有一种数据源能看到**
405405

406-
完整的审计可见性模型参见主 README 的 [`审计可见性`](../README.zh-CN.md#审计可见性) 章节。
406+
完整的审计可见性模型参见主 README 的 [`审计可见性`](README.zh-CN.md#审计可见性) 章节。

0 commit comments

Comments
 (0)