ACMP Intune Connector

1

2

Intune-relevante Abfrageaktionen

Eingabe des geheimen Clientschlüssels

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.

16

17

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

18

19

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

20

21

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

22

* 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

23

* AESB muss mindestens die Versionsnummer 1.8 haben

24

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

25

* Eine funktionierende Intune Instanz

26

27

= Vorbereitungen im Azure Active Directory =

28

29

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.

30

31

== Unternehmensanwendung registrieren ==

32

33

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.

34

35

36

(% style="text-align:center" %)

37

[[image:65_Intune_App-Registrierung in der Azure AD.png]]

38

39

40

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.

45

46

47

(% style="text-align:center" %)

48

[[image:65_Intune_Anwendung registrieren.png]]

49

50

51

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.

56

57

58

(% style="text-align:center" %)

59

[[image:65_Intune_Zusammenfassung der Anwendungsinformationen.png||alt="65_Intune_Anwendung registrieren.png"]]

60

61

62

Zusammenfassung der Anwendungsinformationen

== Berechtigungen verteilen ==

67

68

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//).

69

70

71

(% style="text-align:center" %)

72

[[image:65_Intune_API Berechtigungen.png]]

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.

80

81

82

(% style="text-align:center" %)

83

[[image:65_Intune_Microsoft Graph anfordern.png]]

84

85

86

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:

91

92

* DeviceManagementManagedDevices.Read.All

93

* DeviceManagementManagedDevices.ReadWrite.All

* User.Read

(% style="text-align:center" %)

98

[[image:65_Intune_Delegierte Berechtigungen verteilen.png]]

99

100

101

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:

106

107

* DeviceManagementApps.Read.All

108

* DeviceManagementConfiguration.Read.All

109

* DeviceManagementManagedDevices.PrivilegedOperations.All

110

* DeviceManagementManagedDevices.Read.All

111

* DeviceManagementManagedDevices.ReadWrite.All

112

* DeviceManagementServiceConfig.Read.All

113

* User.Read.All

114

115

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

116

117

118

(% style="text-align:center" %)

119

[[image:65_Intune_Verteilte Berechtigungen (ohne Einwilligung).png]]

120

121

122

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.

127

128

129

(% style="text-align:center" %)

130

[[image:65_Intune_Bewilligte Berechtigungen.png]]

131

132

133

Bewilligte Berechtigungen

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

138

139

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//.

140

141

142

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

143

144

145

=== Zertifikat hochladen ===

146

147

148

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

149

150

151

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.

152

153

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.

154

155

156

(% style="text-align:center" %)

157

[[image:65_Intune_Zertifikat hochladen.png]]

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.

165

166

167

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

(% style="text-align:center" %)

172

[[image:65_Intune_Hochgeladenes Zertifikat in der Azure Active Directory.png]]

173

174

175

Hochgeladenes Zertifikat in der Azure Active Directory

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

180

181

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.

182

183

184

(% style="text-align:center" %)

185

[[image:65_Intune_Neuen Clientschlüssel hinterlegen.png]]

186

187

188

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.

193

194

195

(% style="text-align:center" %)

196

[[image:65_Intune_Geheimen Clientschlüssel hinterlegen.png]]

197

198

199

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.

205

206

207

= Konfigurationen in AESB und ACMP =

208

209

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

210

211

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

212

213

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.

214

215

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.

216

217

218

(% style="text-align:center" %)

219

[[image:65_Intune_SICS-Verbindung_575.png||alt="65_ACMP_Einstellungen_SICS Verbindung.png"]]

220

221

222

SICS-Verbindung in ACMP einrichten

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

227

228

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.

229

230

231

(% style="text-align:center" %)

232

[[image:65_AESB_Übersicht des ACMP Intune Adapters in der AESB Console.png]]

233

234

235

Ü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.

240

241

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.

242

243

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

244

245

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

246

247

248

Microsoft empfiehlt die Authentifizierungsmethode des Zertifikats.

249

250

251

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.

252

253

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.

254

255

256

(% style="text-align:center" %)

257

[[image:65_Eingabe der Anwendungs- und Verzeichnis-ID.png]]

258

259

260

Eingabe der Anwendungs- und Verzeichnis-ID

(% style="text-align:center" %)

266

[[image:65_AESB_Hochladen des Zertifikats.png]]

267

268

269

Hochladen des Zertifikats

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

274

275

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.

276

277

278

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

(% style="text-align:center" %)

283

[[image:65_Eingabe des geheimen Clientschlüssels.png||height="234" width="1000"]]

284

285

286

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).

291

292

293

(% style="text-align:center" %)

294

[[image:65_Eingabe der Anwendungs- und Verzeichnis-ID.png]]

295

296

297

Eingabe der Anwendungs- und Verzeichnis-ID

(% style="text-align:center" %)

303

[[image:65_AESB_Eingabe der Informationen zum geheimen Clientschlüssel.png]]

304

305

306

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//.

311

312

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:

313

314

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

315

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

316

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

317

318

319

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.

320

321

322

= Anwendungsmöglichkeiten von Intune in ACMP =

323

324

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.

325

326

== Abfrageaktionen ==

327

328

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

329

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.

330

331

332

(% style="text-align:center" %)

333

[[image:65_Abfrageaktionen_Intune relevante Abfrageaktionen.png]]

334

335

336

Intune-relevante Abfrageaktionen

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

341

342

343

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.

344

345

346

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

347

|(% 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.

348

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

349

|(% 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.

350

|(% 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.

351

|(% 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.

352

|(% 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.

357

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.

358

359

360

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

(% style="text-align:center" %)

365

[[image:65_Abfrageaktion_Ansicht der Intune Client Details.png]]

366