ACMP Intune Connector

160

Microsoft Intune ist eine cloudbasierte Lösung, mit der Sie Ihre mobilen Endgeräte verwalten können. Dadurch ist es für Sie möglich, auch die Endgeräte aus der Ferne zu verwalten, Zugänge zu sichern oder auch sperren zu können. Mithilfe des ACMP Intune Connectors können Sie die Geräte aus dem Intune im ACMP inventarisieren und die wichtigsten Aktionen aus dem ACMP heraus an die Geräte schicken.

8

9

= Voraussetzungen für die Nutzung des ACMP Intune Connectors =

10

11

Um den ACMP Intune Connector nutzen zu können, müssen folgende Voraussetzungen gegeben sein:

12

13

* Sie benötigen ein Benutzerkonto mit den entsprechenden Berechtigungen für Microsoft Azure Active Directory

14

* Es muss eine Verbindung zwischen AESB und ACMP bestehen. Hierfür muss AESB vorhanden sein, sowie die nötigen Angaben der [[SICS-Verbindungen>>doc:||anchor="H1.ACMPConsole:SICS-VerbindunginACMPFCberprFCfen"]] in ACMP hinterlegt werden

15

* AESB muss mindestens die Versionsnummer 1.8 haben

16

* Sie benötigen eine funktionierende Internetverbindung, da Intune eine Cloudlösung ist und für die Arbeiten eine Netzwerkverbindung erforderlich sind

17

* Eine funktionierende Intune Instanz

18

19

= Vorbereitungen im Azure Active Directory =

20

21

Damit der ACMP Intune Connector auf die Intune API zugreifen darf, müssen Sie als erstes in der Azure Active Directory eine Unternehmensanwendung registrieren und innerhalb dieser Anwendungen die notwendigen Berechtigungen erteilen.

22

23

== Unternehmensanwendung registrieren ==

24

25

Melden Sie sich zunächst in der [[Azure AD (Active Directory)>>https://aad.portal.azure.com/]] an und navigieren Sie in der Übersicht zum Azure Active Directory. Klicken Sie dort auf den Reiter //Verwalten //> //App-Registrierungen //und legen Sie dort eine neue App Registrierung an.

26

27

28

[[image:65_Intune_App-Registrierung in der Azure AD.png||data-xwiki-image-style-alignment="center"]]

29

30

31

App-Registrierungen in der Azure AD

Geben Sie dort alle notwendigen Informationen an: Vergeben Sie einen Namen für die App und wählen Sie die zu unterstützenden Konten aus. Schließen Sie den Vorgang ab, indem Sie auf //Registrieren //klicken.

36

37

38

[[image:65_Intune_Anwendung registrieren.png||data-xwiki-image-style-alignment="center"]]

39

40

41

Anwendung registrieren

Wenn Sie nun die erstellte Anwendung öffnen, erhalten Sie eine Zusammenfassung der hinzugefügten Informationen. Dazu gehören u.a. der Anzeigename, die verschiedenen IDs (Anwendungs-, Objekt- und Verzeichnis-ID) und die Angaben zu den unterstützten Kontotypen.

46

47

48

[[image:65_Intune_Zusammenfassung der Anwendungsinformationen.png||alt="65_Intune_Anwendung registrieren.png" data-xwiki-image-style-alignment="center"]]

49

50

51

Zusammenfassung der Anwendungsinformationen

== Berechtigungen verteilen ==

56

57

Vergeben Sie als nächstes der Unternehmensanwendung die notwendigen Berechtigungen, damit auf die Graph API zugegriffen werden kann. Wechseln Sie dafür innerhalb der registrierten App in den Bereich Berechtigungen (//Verwalten //> API-//Berechtigungen//).

58

59

60

[[image:65_Intune_API Berechtigungen.png||data-xwiki-image-style-alignment="center"]]

API-Berechtigungen

Klicken Sie dort auf //Berechtigung hinzufügen//. Es öffnet sich eine Seite, wo Sie die API-Berechtigungen anfordern können. In diesem Schritt müssen Sie den //Microsoft Graph// auswählen.

68

69

70

[[image:65_Intune_Microsoft Graph anfordern.png||data-xwiki-image-style-alignment="center"]]

71

72

73

API-Berechtigungen: Microsoft Graph anfordern

Unterschieden wird zwischen „Delegierten Berechtigungen“ und „Anwendungsberechtigungen“. Fügen Sie unter „Delegierte Berechtigungen“ die folgenden Werte einzeln ein und wiederholen Sie die Vorgehensweise nach einander, indem Sie jeden der nachfolgenden Listeneinträge eingeben:

78

79

* DeviceManagementManagedDevices.Read.All

80

* DeviceManagementManagedDevices.ReadWrite.All

* User.Read

[[image:65_Intune_Delegierte Berechtigungen verteilen.png||data-xwiki-image-style-alignment="center"]]

85

86

87

Delegierte Berechtigungen verteilen

Haken Sie die jeweiligen Einträge an und scrollen Sie wieder nach ganz oben und klicken Sie auf das Feld der //Anwendungsberechtigungen// und fügen Sie die folgenden Berechtigungen hinzu:

92

93

* DeviceManagementApps.Read.All

94

* DeviceManagementConfiguration.Read.All

95

* DeviceManagementManagedDevices.PrivilegedOperations.All

96

* DeviceManagementManagedDevices.Read.All

97

* DeviceManagementManagedDevices.ReadWrite.All

98

* DeviceManagementServiceConfig.Read.All

99

* User.Read.All

100

101

Sobald Sie alle Berechtigungen selektiert haben, klicken Sie auf //Berechtigungen hinzufügen//. Die Einträge können Sie der Übersicht entnehmen.

102

103

104

[[image:65_Intune_Verteilte Berechtigungen (ohne Einwilligung).png||data-xwiki-image-style-alignment="center"]]

105

106

107

Verteilte Berechtigungen (ohne Einwilligung)

Sie müssen unter Umständen den Berechtigungen Ihre Einwilligung erteilen, sollte dies im Vorfeld noch nicht bereits passiert sein. Klicken Sie dafür auf das Feld //Administratorzustimmung für „%Ihr Unternehmen%“ erteilen//. Hierdurch verändert sich der Status und es wird die Benutzereinwilligung verteilt.

112

113

114

[[image:65_Intune_Bewilligte Berechtigungen.png||data-xwiki-image-style-alignment="center"]]

115

116

117

Bewilligte Berechtigungen

== //Geheimer Clientschlüssel oder Zertifikate hochladen// ==

122

123

Es ist im späteren Verlauf der Ersteinrichtung vom ACMP Intune Connector erforderlich, dass Sie in der AESB Console einen Authentifizierungstypen angeben. Sie können sich dabei zwischen zwei Methoden entscheiden, die vom Microsoft Client Credentials Provider unterstützt werden: //Zertifikat //oder //Geheimer Clientschlüssel//.

124

125

126

Je nach gewähltem Authentifizierungstyp ist die Vorgehensweise eine andere. Lesen Sie nachfolgend, was Sie bei der jeweiligen Methode zu beachten haben.

127

128

129

=== Zertifikat hochladen ===

130

131

132

Aufgrund der höheren Sicherheitsstufe wird von Microsoft empfohlen, ein Zertifikat als Anmeldeinformation zu verwenden.

133

134

135

Zertifikate können als Authentifizierungsmethode genutzt werden, mit der Sie sich in der AESB Console am Azure Active Directory anmelden können. Ein Zertifikat besteht dabei immer aus einem öffentlichen und privaten Teil, wobei der öffentliche Schlüssel direkt in die Azure AD geladen wird. Der private Teil wird in der AESB Console verwendet. Dieses Zertifikatspaar muss im Vorfeld bereits erzeugt werden. Lesen Sie hier nach, wie Sie über [[Microsoft>>url:https://learn.microsoft.com/en-us/azure/app-service/configure-ssl-certificate?tabs=apex%2Cportal]] oder über [[Open SSL>>url:https://stackoverflow.com/questions/6307886/how-to-create-pfx-file-from-certificate-and-private-key]] ein Zertifikat erstellen können.

136

137

Navigieren Sie innerhalb der zuvor registrierten Anwendung zu dem Punkt //Zertifikate & Geheimnisse//. Klicken Sie dort in den Details auf den Reiter //Zertifikate //und laden Sie das zuvor erstellte Zertifikat hoch.

138

139

140

[[image:65_Intune_Zertifikat hochladen.png||data-xwiki-image-style-alignment="center"]]

Zertifikat hochladen

Auf der rechten Seite öffnet sich ein Feld, in dem Sie das Zertifikat hochladen können. Durchsuchen Sie den entsprechenden Ordner und laden Sie die Datei hoch und geben Sie eine optionale Beschreibung für das Zertifikat ein. Klicken Sie dann auf //Hinzufügen// und das Zertifikat wird für die Anwendung hinterlegt.

148

149

150

Beachten Sie, dass beim Hochladen eines Zertifikats nur die Dateitypen .cer, .pem und .crt unterstützt werden.

[[image:65_Intune_Hochgeladenes Zertifikat in der Azure Active Directory.png||data-xwiki-image-style-alignment="center"]]

155

156

157

Hochgeladenes Zertifikat in der Azure Active Directory

=== Geheimen Clientschlüssel hinzufügen ===

162

163

Der geheime Clientschlüssel ist eine Zeichenfolge, die bei der Unternehmensanwendung beim Anfordern des Tokens als Authentifizierungsschlüssel bzw. Identitätsnachweis verwendet wird. Wechseln Sie dafür innerhalb der registrierten App in den Bereich Berechtigungen (//Sicherheit //> //Berechtigungen//) und klicken Sie anschließend auf den Link „Anwendungsregistrierung“. Navigieren Sie zu dem Punkt //Zertifikate & Geheimnisse//. Klicken Sie in den Details auf den Reiter //Geheime Clientschlüssel //und legen Sie einen neuen Schlüssel an.

164

165

166

[[image:65_Intune_Neuen Clientschlüssel hinterlegen.png||data-xwiki-image-style-alignment="center"]]

167

168

169

Neuen Clientschlüssel hinterlegen

Beim Erstellen eines neuen geheimen Clientschlüssels haben Sie die Möglichkeit, die Gültigkeitsdauer zu konfigurieren. Beachten Sie hierbei, dass nach Ablauf der Gültigkeit ein Schlüssel neu erstellt und dieser im AESB hinterlegt werden muss.

174

175

176

[[image:65_Intune_Geheimen Clientschlüssel hinterlegen.png||data-xwiki-image-style-alignment="center"]]

177

178

179

Geheimen Clientschlüssel hinzufügen

Sie benötigen den erstellten geheimen Clientschlüssel bei der Einrichtung des AESB. Speichern Sie sich diesen zwischen, damit Sie später drauf zugreifen können.

185

186

187

= Konfigurationen in AESB und ACMP =

188

189

Bevor Sie Intune in ACMP nutzen können, müssen gewisse Vorarbeiten in den ACMP und AESB Consolen erfolgen.

190

191

== 1. ACMP Console: SICS-Verbindung in ACMP überprüfen ==

192

193

Es ist erforderlich, dass Sie eine funktionierende SICS-Verbindung in ACMP haben. Navigieren Sie dazu zu //System// > //Einstellungen// > //ACMP Server// > //SICS-Verbindung//. Setzen Sie zunächst einen Haken in der Checkbox, um die Verbindung zu aktivieren. Tragen Sie anschließend den Host und den Port ein, ebenso wie den Benutzernamen und das Passwort für den Operator. Den entsprechenden Operator haben Sie während der Installation des AESB angegeben, den Sie hier ebenfalls benennen müssen. Legen Sie fest, ob versucht werden soll, eine unverschlüsselte Verbindung aufzubauen, sollte SSL/TLS fehlschlagen. Testen Sie anschließend die Verbindung.

194

195

Setzen Sie zusätzlich unter den Public API Zugriffsberechtigungen einen Haken, um den Zugriff zu gewähren. Sie können nun Ihre Angaben speichern. ACMP und SICS haben nun eine Verbindung zueinander.

196

197

198

[[image:65_Intune_SICS-Verbindung_575.png||alt="65_ACMP_Einstellungen_SICS Verbindung.png" data-xwiki-image-style-alignment="center"]]

199

200

201

SICS-Verbindung in ACMP einrichten

== 2. AESB Console: Intune Connector installieren und konfigurieren ==

206

207

Wechseln Sie nun in die AESB Console. Navigieren Sie vom Dashboard zu dem Menüpunkt //Produkte//. Innerhalb der Übersicht finden Sie eine Liste all der Pakete, die Ihnen zur Installation oder für Aktualisierungen bereitstehen. Wählen Sie den Eintrag //ACMP Intune Adapter// aus und klicken Sie entweder in der Schnellwahlleiste oder direkt im Feld auf //Installieren//. Es öffnet sich ein neues Fenster, mit dem die Installation beginnt.

208

209

210

[[image:65_AESB_Übersicht des ACMP Intune Adapters in der AESB Console.png||data-xwiki-image-style-alignment="center"]]

211

212

213

Übersicht des ACMP Intune Adapters in der AESB Console

Im ersten Schritt werden Sie darüber informiert, welche Vorbereitung Sie für die erfolgreiche Installation des Intune Adapters bereits geleistet haben müssen: Sie benötigen eine konfigurierte und funktionsfähige Microsoft Intune Instanz sowie eine funktionierende ACMP SICS-Verbindung. Beim zweiten Schritt des Installationswizards haben Sie die Möglichkeit oben auf der Seite einen Vorlagenamen zu vergeben.

218

219

Unter dem Punkt //Intune Connector Konfiguration //können Sie Grundeinstellungen für den Intune Connector vornehmen. Unter der ACMP Server-ID müssen Sie angeben, an welchen Server die Änderungen geschickt werden sollen. Durch die Eingabe des Stern-Zeichens werden die Änderungen an alle ACMP Server geschickt, die eine SICS-Verbindung aufgebaut haben und dessen Verbindungsinformationen identisch sind, wie Sie sie unter //[[1. ACMP Console: SICS-Verbindung in ACMP überprüfen>>doc:||anchor="H1.ACMPConsole:SICS-VerbindunginACMPFCberprFCfen"]] //angegeben haben. Zusätzlich dazu können Sie bestimmen, unter welchem Workflow-Instanz Namen die Einstellungen verschickt werden sollen. Diese Angabe können Sie unter //Ondemand-Definition Name //treffen.

220

221

Unterhalb des Menüpunktes //Intune Konfiguration// können Sie nun eine der zwei Anmeldemethoden verwenden: den geheimen Clientschlüssel oder ein Zertifikat.

222

223

=== Variante 1: Authentifizierungstyp //Zertifikat//: ===

224

225

226

Microsoft empfiehlt die Authentifizierungsmethode des Zertifikats.

227

228

229

Die Intune Konfiguration mit einem Zertifikat unterscheidet sich im Gegensatz zur Authentifizierungsmethode //geheimer Clientschlüssel //nur minimal. Hier müssen Sie lediglich das Zertifikat hochladen und das dazugehörige Passwort eingeben.

230

231

Wählen Sie als Authentifizierungstypen das //Zertifikat// aus. Fügen Sie unter dem gleichnamigen Feld das Zertifikat ein, welches hier verwendet werden soll. Es können nur Dateien des Typen .pfx hineingeladen werden. Geben Sie danach das Zertifikatskennwort ein, sofern eins vorhanden ist. Tragen Sie zusätzlich die Anwendungs-ID (Client) (mit der ID wird der Benutzer gegenüber Intune ausgewiesen), sowie die Verzeichnis-ID (Mandant) (unter dem Mandanten wird es ausgeführt) in die vorgegebenen Felder ein. Beide Zeichenketten können Sie aus den allgemeinen Informationen der zuvor registrierten Unternehmensanwendung der Azure AD Seite entnehmen.

232

233

234

[[image:65_Eingabe der Anwendungs- und Verzeichnis-ID.png||data-xwiki-image-style-alignment="center"]]

235

236

237

Eingabe der Anwendungs- und Verzeichnis-ID

[[image:65_AESB_Hochladen des Zertifikats.png||data-xwiki-image-style-alignment="center"]]

243

244

245

Hochladen des Zertifikats

=== Variante 2: Authentifizierungstyp //Geheimer Clientschlüssel//: ===

250

251

Wählen Sie als Authentifizierungstypen den //geheimen Clientschlüssel// aus. Fügen Sie unter den //geheimen Clientschlüssel //den Wert ein, den Sie auf der [[Azure Active Directory Seite>>doc:||anchor="HGeheimerClientschlFCsseloderZertifikatehochladen"]] als geheimen Schlüssel generiert haben.

252

253

254

Beachten Sie, dass der Wert verkürzt dargestellt wird. Dies bedeutet, dass nach Eingabe in die AESB Console eine andere Zeichenlänge auftritt.

[[image:65_Eingabe des geheimen Clientschlüssels.png||data-xwiki-image-style-alignment="center" height="234" width="1000"]]

259

260

261

Eingabe des geheimen Clientschlüssels

Tragen Sie zusätzlich die Anwendungs-ID (Client) (mit der ID wird der Benutzer gegenüber Intune ausgewiesen), sowie die Verzeichnis-ID (Mandant) (unter dem Mandanten wird es ausgeführt) in die vorgegebenen Felder ein. Beide Zeichenketten finden Sie in der allgemeinen Information der zuvor registrierten Unternehmensanwendung (Azure AD).

266

267

268

[[image:65_Eingabe der Anwendungs- und Verzeichnis-ID.png||data-xwiki-image-style-alignment="center"]]

269

270

271

Eingabe der Anwendungs- und Verzeichnis-ID

[[image:65_AESB_Eingabe der Informationen zum geheimen Clientschlüssel.png||data-xwiki-image-style-alignment="center"]]

277

278

279

Eingabe der Informationen zum geheimen Clientschlüssel

Klicken Sie auf //Verbindung prüfen//. Wenn die Verbindung erfolgreich war, wechseln Sie in die //Scanner-Konfiguration//, dort können Sie optional Zeitintervalle des Scanners einstellen. Sollten Sie keine Änderungen vornehmen wollen, klicken Sie auf //Weiter//.

284

285

Im Hintergrund beginnt die Installation des Intune Adapters. Sobald die Installation durchgelaufen ist und alle Einträge erfolgreich installiert wurden, können Sie auf //Beenden //klicken. Sie werden zurück zur Übersichtsseite der AESB Console geleitet. Innerhalb der AESB Console können Sie an verschiedenen Stellen überprüfen, ob die Installation erfolgreich war und ob alle nötigen Applikationen aufrufbar sind:

286

287

|**Navigationspunkt**|**Beschreibung**

288

|Microservices|Unterhalb des Supervisoren & der Microservice-Instanzen sehen Sie die Einträge //IntuneConnector_1 //und //IntuneWorkflowEngine_1//.

289

|Workflows|Innerhalb des Abschnittes Workflow-Engines & -Instanzen müssen die Einträge //IntuneWorkflowEngine_1 //sowie //IntuneMobileDevices_1 //gelistet sein.

290

291

292

Sie können den Intune Connector auch mehrfach installieren. Dadurch ist es möglich, dass Sie sowohl den geheimen Clientschlüssel als auch das Zertifikat als Authentifizierungstyp nutzen können. Eine doppelte Installation ist beispielsweise dann sinnvoll, wenn Sie mehrere ACMP Server verwenden und auf denen die Daten einfließen sollen. Bei mehrfacher Installation werden die Microservices und Workflow-Einträge hochgezählt. In diesem Fall hätten Sie dann z.B. //IntuneWorkflowEngine_1//, //IntuneWorkflowEngine_2// und //IntuneMobileDevices_1// und //IntuneMobileDevices_2// gelistet.

293

294

295

= Anwendungsmöglichkeiten von Intune in ACMP =

296

297

Sobald Sie den ACMP Intune Connector eingerichtet haben, werden die Geräte aus Intune in ACMP importiert. Diese Daten können Sie beispielsweise in Abfragen und Reports verwenden. Weiterhin haben Sie die Möglichkeit einige Aktionen über ACMP an die Geräte zu schicken.

298

299

== Abfrageaktionen ==

300

301

Navigieren Sie zu //Client Management //> //Abfrageverwaltung//. Öffnen Sie dort eine Abfrage, in der die benötigten Clients auftauchen.

302

In der Abfrageergebnismenge können Sie die inventarisierten Clienttypen sehen (z.B. Clients der Typen Android, iOS oder Windows). Markieren Sie nun die Clients, auf denen Sie eine Intune-relevante Aktion ausführen möchten.

303

304

305

[[image:65_Abfrageaktionen_Intune relevante Abfrageaktionen.png||data-xwiki-image-style-alignment="center"]]

306

307

308

Intune-relevante Abfrageaktionen

Sie können dabei zwischen den folgenden Aktionen auswählen:

313

314

315

Beachten Sie, dass für alle nachfolgenden Aktionen (Nachrichten senden, Geräte stilllegen etc.), die Sie über Intune an das Endgerät schicken oder ausführen wollen, unter Umständen zeitverzögert ankommen. Der Status des Jobs wird innerhalb des Job Monitors als //Abgeschlossen// angezeigt, da die Aktion seitens ACMP ausgeführt wurde und erfolgreich an Intune übergeben wurde.

316

317

318

|(% style="width:223px" %)**Abfrageaktion**|(% style="width:1141px" %)**Beschreibung**

319

|(% style="width:223px" %)Intune-Benachrichtigung senden|(% style="width:1141px" %)Über diese Aktion können Sie eine Intune-Benachrichtigung an die [[//Unternehmensportal-//App>>https://apps.microsoft.com/store/detail/unternehmensportal/9WZDNCRFJ3PZ?hl=de-de&gl=de]] auf den ausgewählten Geräten verschicken. Hierbei ist es möglich, dass die Nachrichten auch auf Sperrbildschirmen oder in den Android-Apps sichtbar sind. Vergewissern Sie sich, dass Sie nur Informationen teilen, die nicht zu vertraulich sind, sollten Sie darüber eine Benachrichtung verschicken wollen.

320

Geben Sie sowohl einen Titel als auch einen Textinhalt ein und klicken Sie anschließend auf //Ausführen//.

321

|(% style="width:223px" %)Intune-Geräte stilllegen|(% style="width:1141px" %)Mit dieser Aktion löschen Sie die Intune-spezifischen Einstellungen auf den jeweils ausgewählten Geräten. Hierdurch wird auch die //Unternehmensportal//-App entfernt und löscht die ausgewählten Geräte aus der Intune-Verwaltung.

322

|(% style="width:223px" %)Intune-Geräte zurücksetzen|(% style="width:1141px" %)Sollten Sie ein Intune-Gerät auf die Werkseinstellungen setzen wollen, wählen Sie diese Aktion aus. Hierdurch wird das entsprechende Gerät auch aus der Intune-Verwaltung gelöscht. Sie müssen für diesen Schritt einen Haken setzen und die Sicherheitsabfrage bestätigen, ehe Sie die Aktion ausführen können.

323

|(% style="width:223px" %)Intune-Geräte aus der Ferne sperren|(% style="width:1141px" %)Möchten Sie aus der Ferne Intune-Geräte sperren, können Sie das über die Aktion ausführen. Hierdurch muss der Benutzer auf dem Endgerät seinen selbst ausgewählten Sicherheitsmechanismus (PIN, Kennwort, Gesichtserkennung o.ä.) korrekt eingeben, damit das Gerät wieder entsperrt werden kann.

324

|(% style="width:223px" %)Intune-Geräte synchronisieren|(% style="width:1141px" %)Diese Aktion veranlasst ausgewählte Intune-Geräte, Ihre Inventardaten an Intune zu senden. Hierdurch lassen sich die Geräte mit den Informationen immer auf den neusten Stand bringen.

== Client Details ==

Möchten Sie sich Informationen über ein Intune-Gerät anzeigen lassen, so können Sie alle relevanten Daten aus den Client Details entnehmen. Navigieren Sie dazu innerhalb einer Abfrage auf den gewünschten Client und öffnen Sie die Details per Doppelklick.

329

Unter dem Menüpunkt //Mobile Device Management //> //Mobile device// finden Sie alle Informationen zum hinterlegten Mobilgerät. Sollten Sie eine Intune relevante Aktion für den ausgewählten Client ausführen wollen, so können Sie die Optionen innerhalb der [[Schnellwahlleiste>>doc:||anchor="HAbfrageaktionen"]] nutzen.

330

331

332

Zu allen hier hinterlegten Informationen gibt es Felder, die Sie beispielsweise innerhalb von Abfragen, Filtern und Reports verwenden können.

[[image:65_Abfrageaktion_Ansicht der Intune Client Details.png||data-xwiki-image-style-alignment="center"]]

337

338

339

Ansicht der Intune Client Details

340

341

Wiki-Quellcode von ACMP Intune Connector