Änderungen von Dokument Agentless Scanner

Zuletzt geändert von Jannis Klein am 2024/10/28 14:07

Von Version 12.1
bearbeitet von Jannis Klein
am 2024/10/23 12:56
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 16.1
bearbeitet von Jannis Klein
am 2024/10/23 14:44
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -1,156 +5,222 @@
1 -{{aagon.priorisierung}}
2 -20
3 -{{/aagon.priorisierung}}
4 -
5 5  {{aagon.floatingbox/}}
6 6  
7 -Der //Agentless Scanner// dient der Inventarisierung von Clients, ohne dass eine Software auf diesen ausgeführt oder gar installiert werden muss. Er besteht aus den zwei Teilen AD-Import und XML-Import. Im Folgenden finden Sie eine Beschreibung der unterschiedlichen Teile.
3 +Mit dem //Agentless Scanner //ist die Inventarisierung von Windows-Clients über das Active Directory (AD) möglich, ohne dass eine Software auf den Clients ausgeführt oder installiert werden muss. Darüber hinaus können Sie vom //Agentless Scanner Configuration Manager// ausgehend mithilfe des integrierten XML Importers auch Linux- und MacOS-Clients inventarisieren. 
8 8  
5 += Funktionsweise =
6 +
7 +Grundsätzlich setzt sich der Agentless Scanner aus drei Komponenten zusammen: dem AD Connector, dem AD Agent sowie dem WMI Scanner. Die Basisdaten eines Clients werden dabei aus dem AD erfasst, mit den in ACMP vorhandenen Daten verglichen und, sofern es sich um noch nicht vorhandene Daten handelt, schließlich hinterlegt. Einmal eingerichtet, werden Clients, welche neu an das AD angebunden wurden, automatisch inventarisiert. Somit entfällt das manuelle Anstoßen einer Inventarisierung.
8 +
9 9  {{aagon.infobox}}
10 -Es kann vorkommen, dass der NetBios Name beim Agentless Scan in Multidomain-Umgebungen nicht richtig aufgelöst wird. Um hier Fehler zu vermeiden wird zusätzlich versucht die Clients per FQDN zu erreichen.
10 +Der Agentless Scanner liefert weniger Daten als der ACMP Agent, da er auf Grund seiner Funktionsweise nicht alle Daten auslesen kann.  
11 11  {{/aagon.infobox}}
12 12  
13 -= AD-Import =
13 + Im Folgenden wird die Funktionsweise der einzelnen Komponenten im Detail erklärt.
14 14  
15 -Der Agentless Scanner dient der Inventarisierung von Clients, ohne dass eine Software auf diesen ausgeführt oder gar installiert werden muss. Dabei dient ein Active Directory als Datenquelle für die Basisdaten eines Clients. Die eigentliche Inventarisierung erfolgt anschließend über einen WMI Remote Scan. Dadurch können auch Clients inventarisiert werden, welche nicht per NetBIOS erreichbar sind (z.B. auf Grund bestimmter Netzwerkrichtlinien) und somit nicht in der [[Agenteninstallation>>doc:ACMP.67.ACMP-Solutions.Client-Management.Agenteninstallation.WebHome]] auftauchen. Weiterhin werden Clients, welche neu an das AD angebunden wurden, automatisch inventarisiert. Dadurch entfällt das manuelle Anstoßen einer Inventarisierung. Der Agentless Scanner liefert jedoch weniger Daten als der ACMP Agent, da er auf Grund seiner Funktionsweise (dem Auslesen der Clients per WMI) nicht alle Daten auslesen kann.
15 +|=(% scope="row" %)AD Connector|(((
16 +Der AD Connector ist für das Erfassen der Daten aus dem Active Directory verantwortlich. Grundsätzlich wird das AD dafür in festen Intervallen nach neuen Clients gescannt. Zusätzlich wird das Auslesen durch bestimmte AD-Ereignisse ausgelöst, wie z.B. durch das Hinzufügen eines neuen Rechners zum AD. Die ausgelesenen Daten werden dabei gesammelt und anschließend an den AD Agent weitergeleitet.
16 16  
17 -Der Agentless Scanner besteht aus den drei Komponenten ACMP AD Connector, ACMP AD Agent sowie dem ACMP WMI Scanner. Wenn z.B. ein neuer Rechner zum AD hinzugefügt wird, löst das hierdurch erzeugte AD-Ereignis den Import des Rechners durch den AD Connector aus. Zusätzlich scannt er den AD aber in festen Intervallen nach neuen Clients. Die gesammelten Daten werden anschließend an den ACMP AD Agent weitergereicht und von diesem mit den ACMP-Daten abgeglichen. Wurde ein neuer Client im AD gefunden, werden Basisdaten wie Name, Beschreibung, Domain und Adresse in der ACMP-Datenbank hinterlegt. Dadurch ist der Client in der Agenteninstallation auffindbar und seine Daten können normal verarbeitet werden (z.B. in Queries oder Client Commands). Damit weitere Daten des Clients inventarisiert werden können, wird vom ACMP WMI Scanner ein Scan über die WMI des Clients angestoßen. Diese Daten werden anschließend in der ACMP-Datenbank gespeichert.
18 +{{aagon.infobox}}
19 +Es kann vorkommen, dass der NetBios Name beim Auslesen durch den AD Connector in Multidomain-Umgebungen nicht richtig aufgelöst wird. Zur Vermeidung dieses Fehlers wird zusätzlich versucht, die Clients per FQDN zu erreichen.
20 +{{/aagon.infobox}}
21 +)))
22 +|=Nun können Sie bei Bedarf noch weitere Domänen mit entsprechenden Benutzerangaben hinzufügen. AD Agent |Der AD Agent ist für den Abgleich der erhaltenen Daten mit den bereits in ACMP vorhandenen Daten zuständig. Wurde ein neuer Client oder ein vorhandener Client mit neuen Daten im AD gefunden, werden die Basisdaten des Clients (Name, Beschreibung, Domain und Adresse) in der ACMP-Datenbank hinterlegt bzw. geändert. Dadurch ist der Client in der Agenteninstallation auffindbar und seine Basisdaten können normal verarbeitet werden (z.B. in Queries oder Client Commands).
23 +|=WMI Scanner |(((
24 +Der WMI Scanner wird benötigt, damit weitere Daten des Clients inventarisiert werden können, die über die Basisdaten hinaus gehen. Dabei wird ein Scan der WMI des Clients angestoßen. Diese Daten werden anschließend in der ACMP Datenbank gespeichert. So können auch Clients inventarisiert werden, welche nicht per NetBIOS erreichbar sind (z.B. auf Grund bestimmter Netzwerkrichtlinien) und somit nicht in der [[Agenteninstallation>>doc:ACMP.67.ACMP-Solutions.Client-Management.Agenteninstallation.WebHome]] auftauchen.
25 +)))
18 18  
19 -Es kann vorkommen, dass auf Windows Server 2003 keine MSI-Software ausgelesen werden kann. Dies ist der Fall, wenn die WMI Klasse WIN32_Product nicht installiert ist. Diese kann mit den folgenden Schritten nachinstalliert werden:
27 += Installationsvoraussetzungen =
20 20  
21 -1.   Systemsteuerung\Software\Windows-Komponenten hinzufügen
22 -2.   Verwaltungs- und Überwachungsprogramme auswählen
23 -3.   Details Button drücken
24 -4.   WMI-Anbieter für Windows Installer auswählen
25 -5.   Mit OK bestätigen und anschließend das System neu starten
29 +Bevor die Installation durchgeführt werden kann, prüfen Sie folgende Voraussetzungen:
26 26  
27 -= Installationsvoraussetzungen =
31 +* Die Dienste werden auf dem Server installiert, auf dem auch ACMP installiert ist.
32 +* Es ist mindestens das .Net-Framework in der Version 4.7.2 installiert.
33 +* Das Message Queuing ist installiert. 
28 28  
29 -Bevor die Installation durchgeführt werden kann, prüfen Sie folgende Voraussetzungen:
35 +{{aagon.infobox}}
36 +Falls das Message Queuing noch nicht installiert ist, kann dieses über die Systemsteuerung unter Windows-Komponenten hinzugefügt/entfernt (für Workstation-Systeme) oder über den Server-Manager unter Features (für Server-Systeme) installiert werden. 
37 +{{/aagon.infobox}}
30 30  
31 -▪   Die Dienste werden auf dem Server installiert, auf dem auch ACMP installiert ist.
32 -▪   Es ist bereits das .Net-Framework in der Version 3.5 installiert.
33 -▪   Das Message Queuing ist installiert. Falls das Message Queuing noch nicht installiert ist, kann dieses über die Systemsteuerung unter Windowskomponenten hinzufügen/entfernen (für Workstation-Systeme) oder über den Server-Manager unter Features (für Server-Systeme) installiert werden.
34 -
39 +== Installation durchführen ==
35 35  
36 -= Installation durchführen =
41 +Zur Verwendung des Agentless Scanners müssen Sie zunächst die entsprechenden Dienste installieren. Führen Sie dazu die Installationsdatei //ACMP Agentless Scanner_Installer.exe// aus, die Sie im Installationsverzeichnis des ACMP Servers im Ordner// Installers/AgentlessScan// finden. Folgen Sie den Installationsanweisungen und installieren Sie alle Komponenten.
37 37  
38 -Um den Agentless Scanner nutzen zu können, müssen zunächst die entsprechenden Dienste installiert werden. Dazu finden Sie im Installationsverzeichnis des ACMP Servers den Ordner //Installers/AgentlessScan// mit der Installationsdatei //ACMP Agentless Scanner_Installer.exe//. Folgen Sie den Installationsanweisungen und installieren Sie alle fünf Komponenten.
43 +[[Installation des Agentless Scanners >>image:Agentless Scanner_Installer.png||alt="Installation des Agentless Scanners"]]
39 39  
45 +{{aagon.infobox}}
46 +Der XML Importer wird ausschließlich für die Inventarisierung von Linux- und MacOS-Clients benötigt und kann ggf. Nachträglich auch einzeln installiert werden.
47 +{{/aagon.infobox}}
48 +
40 40  = Agentless Scanner konfigurieren =
41 41  
42 -Für die Konfiguration des Agentless Scanners rufen Sie den soeben installierten Configuration Manager auf. Dieser bietet Ihnen fünf Bereiche zur Konfiguration des Scanners.
51 +Öffnen Sie nun den// Configuration Manager//, um mit der Konfiguration des Agentless Scanners zu beginnen. Der Configuration Manager ist in sechs Bereiche unterteilt.
43 43  
44 -Über den Bereich General wird der Connectionstring zur ACMP Datenbank eingetragen. Klicken Sie dazu auf //Get database connection string from ACMP configuration//. Der Connectionstring wird automatisch aus ACMP ausgelesen und hier eingetragen. Klicken Sie nun auf //Test connection string//. Bekommen Sie die Meldung Connection successful, kann eine Verbindung zur Datenbank aufgebaut werden. Bekommen Sie diese Meldung nicht, muss der Connectionstring über //Edit connection string //angepasst und anschließend wieder getestet werden. Bei Problemen hilft Ihnen der Aagon Support weiter, alternativ finden Sie auch [[hier>>doc:ACMP.67.ACMP installieren.ACMP Server installieren.Verbindung vom ACMP Server zum SQL Server einrichten.Connectionstring anpassen.WebHome]] weitere Informationen zu den generellen Anpassungen für den Connectionstring.
53 +{{aagon.infobox}}
54 +Sie finden die Anwendung in Ihrem angegebenen Installationsverzeichnis oder über die Windows-Schnellsuche unter dem Namen //Configuration Manager//.
55 +{{/aagon.infobox}}
45 45  
46 -{{figure}}
47 -[[image:Agentless Scanner - Database Connection String.png||data-xwiki-image-style-alignment="center"]]
57 +== General ==
48 48  
49 -{{figureCaption}}
50 -Agentless Scanner: Database Connection String
51 -{{/figureCaption}}
52 -{{/figure}}
59 +Im Bereich //General //ist standardmäßig der Connection String zur ACMP Datenbank eingetragen. Sollte dieser nicht vorhanden oder ein anderer Connection String eingetragen sein, klicken Sie auf //Get database connection string from ACMP configuration//, um den Connection String zur ACMP Datenbank automatisch eintragen zu lassen.
53 53  
54 -Über den Bereich //AD Connector// geben Sie Informationen für den AD-Zugriff an. Dazu tragen Sie unter Domain Controller den Namen oder die IP-Adresse des Servers ein, auf dem das AD installiert ist. Unter //User Name// tragen Sie einen Benutzer ein, welcher Leserechte für die Domain besitzt, aus welcher die Client-Daten gelesen werden sollen. Geben Sie zusätzlich das Password des Benutzers an. Achten Sie darauf, dass es sich nicht um ein leeres Passwort handelt. Den Namen der Domain, aus welcher die Client-Daten gelesen werden, hinterlegen Sie unter NT Domain Name. Zusätzlich tragen Sie unter BaseDN den AD-Pfad ein, unter dem die Clients zu finden sind, dessen Daten gelesen werden sollen. Dies kann z.B. das Hauptverzeichnis aber auch eine bestimmte Gruppe (OU) innerhalb des AD sein. Über die Option I//gnore Objects that haven´t changed for X days// können Clients gefiltert werden, die sei X Tagen nicht im Netzwerk waren und sich nicht am Domain Controller gemeldet haben.
61 +Klicken Sie nun auf //Test connection string//, um die Verbindung zu testen. Wenn Sie die Meldung //Connection successful// erhalten, konnte die Verbindung zur Datenbank aufgebaut werden. Bekommen Sie stattdessen die Meldung //Failed to connect//, muss der Connection string angepasst werden. 
55 55  
56 -{{figure}}
57 -[[image:Agentless Scanner - Active Directory Connector.png||data-xwiki-image-style-alignment="center"]]
63 +Um den Connection string anzupassen, klicken Sie auf //Edit connection string// und geben Sie den korrekten Connection String an. Wiederholen Sie anschließend den Test-Prozess, bis die Verbindung erfolgreich aufgebaut werden konnte.
58 58  
59 -{{figureCaption}}
60 -
61 -Agentless Scanner: Active Directory Connector
62 -
63 -{{/figureCaption}}
64 -{{/figure}}
65 +Bei Problemen hilft Ihnen der Aagon Support weiter, alternativ finden Sie [[hier >>doc:ACMP.67.ACMP installieren.ACMP Server installieren.Verbindung vom ACMP Server zum SQL Server einrichten.Connectionstring anpassen.WebHome]]weitere Informationen zu den generellen Anpassungen für den Connection string.
65 65  
66 -Neben den Angaben, die Sie in der Konfigurationsoberfläche des Configuration Manager machen können, haben Sie die Möglichkeit weitere Einstellungen in der Konfigurationsdatei vorzunehmen. Speichern Sie dazu zunächst die im Configuration Manager getätigten Eingaben. Nun öffnen Sie die Konfigurationsdatei //Configuration.xml//, die sich im Installationspfad im Unterordner //Configuration //befindet. Mithilfe der 3 Tags OuAllowList, OuDenyList und OuRuleOrder ist es Ihnen möglich festzulegen, aus welchen OUs Computerobjekte importiert werden sollen. Das OuAllowList-Tag dient dazu OUs angeben, die ausgelesen werden sollen, während das OuDenyList-Tag es Ihnen ermöglicht OUs anzugeben, die nicht ausgelesen werden sollen. OUs müssen in der Distinguished Name (DN) Schreibweise angegeben werden (siehe Beispiel). Beim Bearbeiten der Configuration.xml-Datei muss beachtet werden, dass diese Groß- und Kleinschreibung beachtet. Das heißt, wird der Listeneintrag „OuAllow“ als „OUAllow“ geschrieben, wird die gesamte Konfigurationsdatei als fehlerhaft angesehen und der Dienst beendet sich direkt nach dem Starten wieder.
67 +[[Verbindung zur ACMP Datenbank herstellen>>image:Agentless Scanner_General.png||alt="Verbindung zur ACMP Datenbank herstellen"]]
67 67  
68 -Das OuRuleOrder-Tag verhält sich folgendermaßen:
69 +== AD Connector ==
69 69  
70 -|•|Der Standardwert der OuRuleOrder ist 0. Das bedeutet, dass grundsätzlich alle OUs ausgelesen werden. Alle OUs, die nicht mit einbezogen werden sollen, müssen in der OuDenyList eingetragen werden. Rekursiv darunter liegende OUs werden dann ebenfalls nicht berücksichtigt. Sollen diese berücksichtigt werden, so müssen sie in die OuAllowList eingetragen werden.
71 +Im Bereich AD Connector nnen Sie die Einstellungen für den AD-Zugriff festlegen:
71 71  
72 -|•|Wird die OuRuleOrder auf 1 geändert, so ändert sich die Reihenfolge, in der die OuDeny- und OuAllowList ausgewertet werden. Es müssen jetzt explizit alle OUs in der OuAllowList angegeben werden, die einbezogen werden sollen. Sollen bestimmte, darunter liegende OUs nicht mit einbezogen werden, so müssen diese in der OuDenyList eingetragen werden.
73 +1. Tragen Sie bei //Domain Controller// den Namen oder die IP-Adresse des Servers ein, auf dem das AD installiert ist. 
74 +1. Tragen Sie bei //User Name// einen Benutzer ein, der Leserechte für die Domain besitzt, aus welcher die Client-Daten gelesen werden sollen.
75 +1. Tragen Sie bei //Password //das Passwort für den zuvor eingetragenen Benutzer ein. 
76 +1. Tragen Sie bei //NT Domain Name// den Namen der Domain ein, aus welcher die Client-Daten gelesen werden. 
77 +1. Tragen Sie bei //BaseDN// den AD-Pfad ein, unter dem die Clients zu finden sind, dessen Daten gelesen werden sollen. Dies kann z.B. das Hauptverzeichnis sein, Sie können aber auch eine bestimmte Gruppe (OU) innerhalb des AD angeben. 
78 +1. Sofern Sie Clients filtern möchten, die seit einer bestimmten Anzahl an Tagen nicht im Netzwerk waren und sich nicht am Domain Controller gemeldet haben, vergeben Sie bei der Option //Ignore Objects that haven´t changed for X days// einen Wert für die Anzahl der Tage.
73 73  
74 -Das folgende Beispiel soll das Verhalten illustrieren:
80 +[[Active Directory Connector konfigurieren>>image:Agentless Scanner_AD Connector.png||alt="Active Directory Connector konfigurieren"]]
75 75  
76 -(% style="width:759px" %)
77 -|(% style="width:756px" %)
82 +{{aagon.infobox}}
83 +Zusätzlich zur Konfiguration über den Configuration Manager, können Sie weitere Einstellungen in der Konfigurationsdatei des AD Connectors vorzunehmen. Weitere Informationen dazu finden Sie im Abschnitt Zusätzliche Anpassungen in der Konfigurationsdatei des AD Connectors.
84 +{{/aagon.infobox}}
78 78  
79 -{{{<OuAllowList>
86 +== AD Agent ==
80 80  
81 - <OuAllow>OU=Aagon,dc=aagon,dc=local</OuAllow>
88 +Die Einstellungen im Bereich AD Agent werden für die internen Abläufe des Agentless Scanner benötigt. Dazu gehört der Pfad der Message Queue und die Anzahl der internen IP Scanner Threads. 
82 82  
83 -</OuAllowList>
90 +{{aagon.warnungsbox}}
91 +Diese Einstellungen sollten Sie nur nach Aufforderung durch den Aagon-Support ändern.  
92 +{{/aagon.warnungsbox}}
84 84  
85 -<OuDenyList>
94 +Abgesehen von den beiden genannten Einstellungen, können Sie im Eintrag Client Destaination festlegen, wie mit den gefundenen Clients und den erfassten Daten umgegangen werden soll. Sie können zwischen folgenden Optionen wählen:
86 86  
87 - <OuDeny>OU=Marketing,OU=Aagon,dc=aagon,dc=local</OuDeny>
96 +* //Inventory// – Das Inventory wird mit den Clients inklusive der erfassten Daten befüllt
97 +* //AgentDistribution// – Die erfassten Clients werden in der Agenteninstallation in ACMP eingetragen
98 +* //Inventory and AgentDistribution// – Beide Vorgänge werden ausgeführt
88 88  
89 -</OuDenyList>
100 +[[Active Directory Agent konfigurieren>>image:Agentless Scanner_AD Agent.png||alt="Active Directory Agent konfigurieren"]]
90 90  
91 -<OuRuleOrder>1</OuRuleOrder>}}}
102 +== WMI Scanner ==
92 92  
93 -(% style="width:756px" %)
94 -(((
95 -[[image:hmfile_hash_0a8ef710.png||data-xwiki-image-style-alignment="center"]]
104 +Der Bereich WMI Scanner können Sie, wie schon zuvor beim AD Agent, die Einstellungen für den Pfad der Message Queue und die Anzahl der internen IP Scanner Threads für den WMI Scanner anpassen.
96 96  
97 -
98 -)))
106 +{{aagon.warnungsbox}}
107 +Diese Einstellungen sollten Sie nur nach Aufforderung durch den Aagon-Support ändern.  
108 +{{/aagon.warnungsbox}}
99 99  
100 -Grundsätzlich sind alle OUs verboten, da die RuleOrder auf 1 gesetzt ist. Durch die Angabe einer OU in der OuAllowList wird die OU „Aagon“ und alle unter ihr liegenden OUs erlaubt. Durch Angabe der OU „Marketing“ wird diese spezielle OU wieder ausgeschlossen.
110 +[[WMI Scanner konfigurieren>>image:Agentless Scanner_WMI Scanner.png||alt="WMI Scanner konfigurieren"]]
101 101  
102 -Über den Bereich //AD Agent// kann der Pfad der Message Queue, sowie die Anzahl der internen IP Scanner Threads geändert werden. Diese Einstellungen werden für die internen Abläufe des Agentless Scanner benötigt und sollten nur nach Aufforderung durch den Aagon Support geändert werden.
112 +Abgesehen von den beiden genannten Einstellungen, können Sie im Eintrag //Database Request Frequency// festlegen, in welchem Intervall (in Stunden) die ACMP Datenbank geprüft werden soll. Bei dieser Prüfung werden alle Clients ermittelt, welche vom //AD Connector// erfasst wurden, für die aber noch keine Daten vorhanden sind. Diese Clients werden schließlich an den WMI Scanner übergeben und es wird ein Scan der WMI der Clients angestoßen, in dem die erweiterten Daten und Eigenschaften der Clients ausgelesen werden.
103 103  
104 -Sie können über das Dropdown zusätzlich bestimmen, ob die Agenteninstallation und/oder das Inventory (AD-Clients) befüllt werden soll.
114 +Unter //Domain Credentials// können Benutzerkonten hinterlegt werden, die Administratorrechte auf den zu scannenden Clients besitzen. Sie müssen hier mindestens einen Benutzer eintragen. Gehen Sie dar folgendermaßen vor:
105 105  
106 -{{figure}}
107 -[[image:Agentless Scanner - Active Directory Agent.png||data-xwiki-image-style-alignment="center"]]
116 +1. Klicken Sie auf den Plus-Button, um das Dialogfenster für die Credentials zu öffnen.
117 +1. Tragen Sie unter //Domain name (FQDN)// den „Fully Qualified Domain Name“ der Domain ein, deren Clients gescannt werden sollen. 
118 +1. Trage Sie bei //User Name// den Benutzernamen ein. Dieser muss nach dem Prinzip Benutzer@FQDN „User Principal Name“ (UPN) aufgebaut sein.{{aagon.infobox}}Der zuerst angegebene Domain name und der FQDN des Benutzers müssen nicht identisch sein. Der Domain name stellt einen Filter der übergebenen Clientdaten dar. So werden nur Clients gescannt, welche nach ACMP Datenbank zur entsprechenden Domain gehören. {{/aagon.infobox}}
119 +1. Tragen Sie bei Password das Passwort für den Benutzer ein.
120 +1. Klicken Sie auf den OK-Button, um Ihre Angaben zu bestätigen und das Dialogfenster zu schließen.
108 108  
109 -{{figureCaption}}
110 -Agentless Scanner: Active Directory Agent
111 -{{/figureCaption}}
112 -{{/figure}}
122 +[[Domain Credentials hinterlegen >>image:Agentless Scanner - Domain Credentials.png||alt="Domain Credentials hinterlegen"]]
113 113  
114 -Der Bereich //WMI Scanner// dient der weiteren Konfiguration des Scanners. Hier nnen u.a. der Message Queuing Path sowie die Anzahl der Scanner Threads geändert werden. Auch hier sollte dies nur nach Aufforderung durch den Aagon Support geschehen.
124 +Nun nnen Sie bei Bedarf noch weitere Domänen mit entsprechenden Benutzerangaben hinzugen.
115 115  
116 -{{figure}}
117 -[[image:Agentless Scanner - WMI Scanner.png||data-xwiki-image-style-alignment="center"]]
126 +== XML Importer ==
118 118  
119 -{{figureCaption}}
120 -Agentless Scanner: WMI Scanner
121 -{{/figureCaption}}
122 -{{/figure}}
128 +Während Clients mit Windows-Betriebssystem über die beschriebenen Schritte mithilfe des AD inventarisiert werden können, erfolgt die Inventarisierung von Linux- und MacOS-Clients durch den Einsatz von XML-Dateien. Dabei werden folgende Arbeitsschritte für die Inventarisierung durchgeführt:
123 123  
124 -Über die Database Request Frequency wird festgelegt, in welchem Intervall (in Stunden) die ACMP Datenbank geprüft werden soll. Bei dieser Prüfung werden alle Clients ermittelt, welche über das AD (Bereich //AD Connector//) erfasst, aber noch nicht gescannt wurden. Diese Clients werden an den WMI Scanner übergeben, der die Eigenschaften der Clients per WMI ausliest.
130 +1. Ausführung eines lokalen Python-Skripts auf allen Linux- und MacOS-Clients mithilfe des Client Commands Linux- und MacOS-Inventarisierung.
131 +1. Automatische Erzeugung von XML-Dateien (eine Datei pro Client) auf einer spezifischen Netzwerkfreigabe durch das Skript, in denen jeweils alle gesammelten Informationen des Clients gespeichert sind.
132 +1. Die erzeugten XML-Dateien werden durch den XML Importer ausgelesen, die enthaltenen Informationen werden erfasst und schließlich in der ACMP Datenbank hinzugefügt.
125 125  
126 -Unter //Domain Credentials //können Benutzerkonten hinterlegt werden, die auf den zu scannenden Clients Administratorrechte besitzen. Mindestens einen Benutzer ssen Sie hier eintragen. Über den Plus-Button nnen Sie dazu einen Dialog aufrufen.
134 +Da im Agentless Scanner selbst nur der XML-Import (Arbeitsschritt 3) durchgeführt wird, wird an dieser Stelle auch nur die Konfiguration des XML Importers beschrieben. Für weiterführende Informationen zur Ausführung des Python-Skripts und der Erzeugung der XML-Dateien (Arbeitsschritte 1 und 2), lesen Sie bitte den Abschnitt [[Linux- und MacOS-Inventarisierung. >>doc:Linux- und MacOS-Inventarisierung.WebHome]]
127 127  
128 -{{figure}}
129 -[[image:Agentless Scanner - Domain Credentials.png||data-xwiki-image-style-alignment="center"]]
136 +Im Bereich //XML Importer// müssen Sie für die Inventarisierung der Linux- und MacOS-Clients bei //Reader //die Netzwerkfreigaben angeben, auf der die zu importierenden XML-Dateien hinterlegt sind. Bei der Verwendung des XML Importers müssen Sie folgende Hinweise beachten:
130 130  
131 -{{figureCaption}}
132 -Agentless Scanner: Domain Credentials
133 -{{/figureCaption}}
134 -{{/figure}}
138 +* Sollten zwei Clients ihre Daten in derselben XML-Datei speichern, so überschreibt der zweite Client die Daten des ersten.
139 +* Nach dem Importieren werden die XML-Dateien gelöscht.
140 +* Defekte Dateien oder Dateien, die nicht für den XML Importer bestimmt sind, werden ebenfalls gelöscht. Daher dürfen in der Freigabe nur Dateien für den XML Importer hinterlegt werden.
141 +* Es ist nicht möglich die XML-Dateien in einem Unterverzeichnis der Freigabe abzulegen
142 +* Die Software-Inventarisierung mit dem Paketmanager „dpkg“ kann einige Zeit in Anspruch nehmen (15-20 min). Die Softwareinventarisierung kann jedoch unter „Options“ in der Oberfläche des ClientCommands ausgeschaltet werden.
143 +* Linux Software wird standardmäßig im Lizenzmanagement ausgeblendet, da grundsätzlich davon ausgegangen wird, dass es sich um Open Source Software handelt. Sie kann jedoch auch wieder eingeblendet werden.
135 135  
145 +Sie können zwischen drei verschiedenen Reader-Typen wählen (FTP-, SCP- und Share Reader). Die Konfiguration der verschiedenen Reader ist im Grundsatz gleich aufgebaut:
136 136  
137 -Tragen Sie unter Domain name den „Fully Qualified Domain Name“ (FQDN) der Domain ein, deren Clients gescannt werden sollen. Den Benutzernamen geben Sie nach dem Prinzip Benutzer@FQDN „User Principal Name“ (UPN) an und setzen das Passwort. Dabei müssen der zuerst angegebene Domain name und der FQDN des Benutzers nicht identisch sein. Der Domain name stellt einen Filter der übergebenen Clientdaten dar. Dadurch werden nur Clients gescannt, welche laut ACMP-Datenbank der entsprechenden Domain zugehören. Kehren Sie über den OK-Button zurück zum WMI Scanner und tragen Sie gegebenenfalls weitere Domänen mit entsprechenden Benutzerangaben ein.
147 +* Pfad des Verzeichnisses, in dem die XML-Dateien hinterlegt sind {{aagon.infobox}}Beachten Sie, dass der FTP-Reader nicht das FTP-Root unterstützt. Es ist daher notwendig, dass Sie ein Unterverzeichnis angeben. {{/aagon.infobox}}
148 +* Benutzer, der über Zugriffsrechte auf die Verzeichnisse verfügt 
149 +* Domain, in der der Benutzer angelegt ist
150 +* Passwort für das Benutzerkonto
151 +* Pfad des Verzeichnisses, in dem alle Dateien vor dem Import lokal als Sicherheitskopie zwischengespeichert werden
152 +* Maximale Anzahl von Inventardateien, die gleichzeitig aus dem Verzeichnis importiert werden
153 +* Zeitangabe in Sekunden, wie oft der Reader nach einem Scan warten soll, bis er das Verzeichnis nach neuen XML-Dateien scannt
138 138  
139 -Im Bereich Services können Sie die installierten und konfigurierten Dienste des Agentless Scanner über die jeweiligen Buttons starten und stoppen.
155 +[[Reader konfigurieren >>image:Agentless Scanner_XML Importer_Share Reader.png||alt="Reader konfigurieren"]]
140 140  
157 +Im Eintrag //Max queue length// können Sie die maximale Anzahl an gleichzeitig zu verarbeitenden XML-Dateien begrenzen. Weiterhin können Sie im Eintrag //Wait every n cycles// festlegen, dass der Verarbeitungsvorgang nach einer gewissen Anzahl n an verarbeiteten XML-Dateien unterbrochen werden soll. Die Dauer der Wartezeit können Sie im Eintrag //Wait time// einstellen. Auf diese Weise ist es möglich die Datenbank zu entlasten.
158 +
159 +== Services ==
160 +
161 +Im Bereich Services können Sie die einzelnen Dienste des Agentless Scanners starten und stoppen.
162 +
141 141  {{aagon.infobox}}
142 -Beachten Sie, dass Sie vor dem Starten oder Stoppen eines Dienstes alle Änderungen über //Save// speichern.
164 +Beachten Sie, dass Sie vor dem Starten oder Stoppen eines Dienstes alle Änderungen über Save speichern müssen, bevor ein Starten/Stoppen möglich ist.
143 143  {{/aagon.infobox}}
144 144  
167 += Zusätzliche Anpassungen in der Konfigurationsdatei des AD Connectors =
168 +
169 +Neben den Angaben, die Sie in der Konfigurationsoberfläche des Configuration Manager machen können, haben Sie die Möglichkeit, weitere Einstellungen in der Konfigurationsdatei des AD Connectors vorzunehmen. 
170 +
171 +Speichern Sie dazu zunächst die im Configuration Manager getätigten Eingaben. Öffnen Sie nun die Konfigurationsdatei Configuration.xml, die Sie im Dateiverzeichnis //Aagon/Configuratio//n finden. 
172 +
173 +Mithilfe der XML-Tags <OuAllowList>,<OuDenyList> und <OuRuleOrder> ist es Ihnen möglich festzulegen, aus welchen OUs Computerobjekte importiert werden sollen. Die verschiedenen XML-Tags haben folgende Funktionen:
174 +
175 +* <OuAllowList> - Liste mit allen OUs, die ausgelesen werden
176 +* <OuDenyList> - Liste mit allen OUs, die nicht ausgelesen werden
177 +* <OuRuleOrder> - Reihenfolge zur Auswertung der beiden Listen 
178 +** 0 (Standardwert) = Alle OUs werden ausgelesen und alle OUs, die nicht einbezogen werden sollen, müssen in der OuDenyList eingetragen werden. Rekursiv darunter liegende OUs werden dann ebenfalls nicht berücksichtigt. Sollen diese berücksichtigt werden, so müssen sie in die OuAllowList eingetragen werden
179 +** 1 = Keine OUs werden ausgelesen und es müssen explizit alle OUs in der OuAllowList angegeben werden, die einbezogen werden sollen. Sollen bestimmte, darunter liegende OUs nicht mit einbezogen werden, so müssen diese in der OuDenyList eingetragen werden.
180 +
181 +{{aagon.infobox}}
182 +OUs müssen in der Schreibweise des Distinguished Name (DN) angegeben werden (siehe Beispiel). Beachten Sie beim Bearbeiten der Configuration.xml-Datei die Groß- und Kleinschreibung, ansonsten wird die gesamte Konfigurationsdatei als fehlerhaft angesehen und der Dienst beendet sich direkt nach dem Starten wieder. 
183 +{{/aagon.infobox}}
184 +
185 +Das folgende Beispiel soll das Verhalten illustrieren:
186 +
187 +{{code}}
188 +<OuAllowList>
189 +
190 + <OuAllow>OU=Aagon,dc=aagon,dc=local</OuAllow>
191 +
192 +</OuAllowList>
193 +
194 +<OuDenyList>
195 +
196 + <OuDeny>OU=Marketing,OU=Aagon,dc=aagon,dc=local</OuDeny>
197 +
198 +</OuDenyList>
199 +
200 +<OuRuleOrder>1</OuRuleOrder>
201 +{{/code}}
202 +
203 +
204 +[[image:1729693841810-329.png]]
205 +
206 +(% class="box" %)
207 +(((
208 +**Erklärung des Beispiels:** Grundsätzlich sind alle OUs verboten, da die RuleOrder auf 1 gesetzt ist. Durch die Angabe einer OU in der OuAllowList wird die OU „Aagon“ und alle unter ihr liegenden OUs erlaubt. Durch Angabe der OU „Marketing“ wird diese spezielle OU wieder ausgeschlossen.
209 +)))
210 +
145 145  = Agentless Scanner aktualisieren =
146 146  
147 -Nach der Installation eines ACMP Updates kann es vorkommen, dass eine Aktualisierung des Agentless Scanners erforderlich ist.
213 +Nach der Installation eines ACMP Updates kann es vorkommen, dass eine Aktualisierung des Agentless Scanners erforderlich ist
148 148  
149 149  {{aagon.infobox}}
150 -Aus den [[ACMP Release Notes>>https://www.aagon.com/produkte/ueberblick/release-notes-acmp/]] entnehmen Sie, ob und welche Zusatzkomponenten von Ihnen aktualisiert werden müssen.
216 +Sie können aus den ACMP Release Notes entnehmen, ob und welche Zusatzkomponenten von Ihnen aktualisiert werden müssen.
151 151  {{/aagon.infobox}}
152 152  
153 -Sollte eine neue Version vom Agentless Scanner im ACMP Update vorhanden sein, können Sie Ihre vorhandene Installation wie folgt aktualisieren:
219 +Sollte eine neue Version vom Agentless Scanner im ACMP Update vorhanden sein, können Sie Ihre vorhandene Installation wie folgt aktualisieren:
154 154  
155 -1. Navigieren Sie zum Installationsverzeichnis des ACMP Servers zum Ordner// Installers/AgentlessScan// mit der Installationsdatei //ACMP Agentless Scanner_Installer.exe//.
156 -1. Folgen Sie den [[Installationsanweisungen>>doc:||anchor="HAgentlessScannerkonfigurieren"]] und installieren Sie alle fünf Komponenten.
221 +1. Navigieren Sie zum Installationsverzeichnis des ACMP Servers zum Ordner Installers/AgentlessScan mit der Installationsdatei ACMP Agentless Scanner_Installer.exe.
222 +1. Folgen Sie den [[Installationsanweisungen>>doc:||anchor="HAgentlessScannerkonfigurieren"]] und installieren Sie alle fünf Komponenten.
1729688483404-505.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.jklein
Größe
... ... @@ -1,0 +1,1 @@
1 +495 bytes
Inhalt
1729688644200-724.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.jklein
Größe
... ... @@ -1,0 +1,1 @@
1 +495 bytes
Inhalt
1729693841810-329.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.jklein
Größe
... ... @@ -1,0 +1,1 @@
1 +28.9 KB
Inhalt
Agentless Scanner_AD Agent.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.jklein
Größe
... ... @@ -1,0 +1,1 @@
1 +35.4 KB
Inhalt
Agentless Scanner_AD Connector.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.jklein
Größe
... ... @@ -1,0 +1,1 @@
1 +32.8 KB
Inhalt
Agentless Scanner_General.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.jklein
Größe
... ... @@ -1,0 +1,1 @@
1 +30.2 KB
Inhalt
Agentless Scanner_Installer.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.jklein
Größe
... ... @@ -1,0 +1,1 @@
1 +15.7 KB
Inhalt
Agentless Scanner_WMI Scanner.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.jklein
Größe
... ... @@ -1,0 +1,1 @@
1 +36.8 KB
Inhalt
Agentless Scanner_XML Importer_Share Reader.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.jklein
Größe
... ... @@ -1,0 +1,1 @@
1 +14.5 KB
Inhalt
© Aagon GmbH 2025
Besuchen Sie unsere neue Aagon-Community