156 lines
5.5 KiB
Markdown
156 lines
5.5 KiB
Markdown
# BizTalk IIS Environment Inventory
|
|
|
|
`BizTalk IIS Environment Inventory` erzeugt pro BizTalk-2020-Umgebung eine Microsoft-Word-Dokumentation (`.docx`) des lokalen IIS- und BizTalk-Servers. Das Tool ist für die BEW-Umgebungen `ACC` und `PROD` vorgesehen und funktioniert ohne PowerShell.
|
|
|
|
Es ist eine C#-Konsolenanwendung für .NET Framework 4.7.2. Auf dem Zielserver werden weder Microsoft Word/Office noch BizTalk-SDK-DLLs oder `Microsoft.Web.Administration` benötigt. Die Anwendung erzeugt das DOCX direkt als standardkonformes Office-Open-XML-Paket und liest lokale Windows-/IIS-Daten, WMI, Registry, Zertifikatsspeicher und NTFS-ACLs ausschließlich lesend.
|
|
|
|
## Erfasster Umfang
|
|
|
|
- installierte IIS-/WAS-/HTTP-/MSMQ- und .NET-Serverrollen
|
|
- `applicationHost.config`, globale IIS-Sections und Konfigurationsprovider
|
|
- Application Pools inklusive effektiver Identitäten
|
|
- Sites, Bindings, Anwendungen und virtuelle Verzeichnisse
|
|
- Webinhaltsmanifest mit Pfad, Größe und Änderungszeit; SHA-256 optional
|
|
- NTFS-Berechtigungen der Web-Stammverzeichnisse
|
|
- Zertifikate aus `LocalMachine\My`, IIS-Zuordnung, Ablauf und Enhanced Key Usage
|
|
- Private-Key-Metadaten, Exportpolicy, Provider, Container und ACL
|
|
- relevante Windows-Dienste und deren Dienstkonten
|
|
- lokale User Rights und Security-/Audit-Policy über `secedit.exe`
|
|
- BizTalk-Installation, Produkt-/Dateiversionen und zentrale WMI-Klassen
|
|
- Fehler, fehlende Rechte und unvollständige Daten als sichtbare Findings
|
|
|
|
Der in der Aufgabe genannte Scope wird standardmäßig geprüft:
|
|
|
|
- `heat_archive`
|
|
- `heat_bankdata`
|
|
- `heat_bbill`
|
|
- `heat_caccount`
|
|
- `heat_invoice`
|
|
- `heat_meterchange`
|
|
- `heat_meterlist`
|
|
- `heat_meterreading`
|
|
|
|
Fehlt eine erwartete Anwendung, erscheint ein Hinweis im Bericht. Die Liste kann in `BizTalkIisEnvironmentInventory.exe.config` über `ExpectedApplications` angepasst oder durch einen leeren Wert deaktiviert werden.
|
|
|
|
## Sicherheitsprinzip
|
|
|
|
Das Word-Dokument enthält absichtlich:
|
|
|
|
- keine Kennwörter
|
|
- keine Connection Strings oder Tokens
|
|
- keine entschlüsselbaren IIS-Konfigurationsblobs
|
|
- keine privaten Schlüssel/PFX-Dateien
|
|
|
|
Für die Migration werden stattdessen Provider, Containername, Fingerprint, Exportpolicy und ACL dokumentiert. Zertifikate und IIS-Verschlüsselungsschlüssel müssen anschließend über den freigegebenen betrieblichen Schlüsseltransfer übertragen werden. Der Report selbst ist kein Key-Backup.
|
|
|
|
## Schnellstart auf ACC und PROD
|
|
|
|
Deployment-Ordner auf den jeweiligen BizTalk-Server kopieren und eine administrative `cmd.exe` öffnen.
|
|
|
|
ACC:
|
|
|
|
```cmd
|
|
run-inventory.cmd ACC C:\IIS-Doku\ACC
|
|
```
|
|
|
|
PROD:
|
|
|
|
```cmd
|
|
run-inventory.cmd PROD C:\IIS-Doku\PROD
|
|
```
|
|
|
|
Die Ausgabe besteht pro Lauf aus:
|
|
|
|
```text
|
|
IIS-Dokumentation-ACC-SERVERNAME-20260724-143000.docx
|
|
IIS-Dokumentation-ACC-SERVERNAME-20260724-143000.log
|
|
```
|
|
|
|
Das DOCX ist vollständig offline und kann anschließend auf einem Arbeitsplatz mit Microsoft Word, LibreOffice oder einer anderen OOXML-kompatiblen Anwendung geöffnet, durchsucht, gedruckt oder als PDF gespeichert werden. Auf dem BizTalk-Server wird keine dieser Anwendungen benötigt. Während des Laufs zeigt die Konsole jeden Collector, Laufzeit, Fehler und den finalen Dateipfad.
|
|
|
|
## Voraussetzungen
|
|
|
|
Zielserver:
|
|
|
|
- Windows Server mit IIS/BizTalk Server 2020
|
|
- .NET Framework 4.7.2 oder neueres 4.x
|
|
- lokale Ausführung auf dem zu dokumentierenden Server
|
|
- administrative Eingabeaufforderung empfohlen
|
|
|
|
Build-Host:
|
|
|
|
- Visual Studio 2022 Build Tools oder Visual Studio 2022
|
|
- .NET Framework 4.7.2 Developer Pack
|
|
- MSBuild im `PATH` oder über `vswhere.exe` auffindbar
|
|
|
|
Build und Tests:
|
|
|
|
```cmd
|
|
scripts\build-release.cmd
|
|
```
|
|
|
|
Deployment-Paket:
|
|
|
|
```cmd
|
|
scripts\package-release.cmd
|
|
```
|
|
|
|
Ergebnis:
|
|
|
|
```text
|
|
artifacts\BizTalkIisEnvironmentInventory-deploy\
|
|
```
|
|
|
|
## Direkter Aufruf
|
|
|
|
```cmd
|
|
BizTalkIisEnvironmentInventory.exe --environment ACC --output C:\IIS-Doku\ACC
|
|
```
|
|
|
|
Optionen:
|
|
|
|
| Option | Bedeutung |
|
|
| --- | --- |
|
|
| `--environment NAME` | Umgebung, beispielsweise `ACC` oder `PROD`. |
|
|
| `--output PFAD` | Ausgabeordner für DOCX und Log. |
|
|
| `--include-file-hashes` | Berechnet SHA-256 für manifestierte Webdateien; erhöht Laufzeit und I/O. |
|
|
| `--skip-content-manifest` | Erfasst Pfade und ACLs, aber keine rekursive Dateiliste. |
|
|
| `--iis-config DATEI` | Liest eine alternative `applicationHost.config`, vor allem für Offline-Tests. |
|
|
| `--self-test` | Prüft Parser, Secret-Bereinigung und DOCX-Paketstruktur ohne Serverzugriffe. |
|
|
|
|
Exitcodes:
|
|
|
|
| Code | Bedeutung |
|
|
| --- | --- |
|
|
| `0` | Alle Collector-Abschnitte erfolgreich. |
|
|
| `1` | Bericht wurde erzeugt, mindestens ein Abschnitt war unvollständig. |
|
|
| `2` | Fataler Fehler; Aufruf, Ausgabeordner oder Berichtserzeugung prüfen. |
|
|
|
|
## Repository-Struktur
|
|
|
|
```text
|
|
.
|
|
├── .gitea/workflows/build.yml
|
|
├── deployment/run-inventory.cmd
|
|
├── scripts/
|
|
│ ├── build-release.cmd
|
|
│ └── package-release.cmd
|
|
├── src/BizTalkIisEnvironmentInventory/
|
|
├── tests/BizTalkIisEnvironmentInventory.Tests/
|
|
├── BizTalkIisEnvironmentInventory.sln
|
|
├── Dokumentation.md
|
|
└── Readme.md
|
|
```
|
|
|
|
Die technische Architektur, Berechtigungen, Datenquellen und Betriebsgrenzen sind in [Dokumentation.md](Dokumentation.md) beschrieben.
|
|
|
|
## Base64-Transport per certutil
|
|
|
|
Wenn das Repository als `BizTalkIisEnvironmentInventory-source.zip.txt` geliefert wird:
|
|
|
|
```cmd
|
|
certutil.exe -decode BizTalkIisEnvironmentInventory-source.zip.txt BizTalkIisEnvironmentInventory-source.zip
|
|
```
|
|
|
|
Danach die ZIP-Datei mit Windows Explorer oder `tar.exe` entpacken. Der SHA-256-Wert der ZIP-Datei wird bei der Übergabe separat genannt.
|