Wenn verwaltete Geräte hinter einer Unternehmensfirewall oder einem Proxy sitzen, müssen bestimmte Endpunkte erreichbar sein, damit die Registrierung, die Bereitstellung von Richtlinien und Push-Benachrichtigungen funktionieren. Dieser Artikel listet auf, was pro Plattform erlaubt werden muss, sowie die detaillierten Routeninformationen für Teams, die eine ganze Domain nicht auf die Whitelist setzen können.
Übersicht
Der gesamte Verkehr ist ausgehendes HTTPS vom Gerät. Es sind keine eingehenden Firewall-Regeln auf der Geräteseite erforderlich.
Jedes Konto hat seinen eigenen MDM-Server:
```
[company slug].mdm.getprimo.com
```
Geräte verbinden sich mit diesem Host, um sich zu registrieren und Befehle zu empfangen. Erlauben Sie ausgehendes TCP 443 zu diesem.
Windows, Linux und Android benötigen nichts anderes. Apple benötigt mehr, da Apple-Geräte durch den eigenen Push-Dienst von Apple geweckt werden.
Die kurze Version
Endpunkt |
Port |
Benötigt für |
[company slug].mdm.getprimo.com |
443 |
Jede Plattform |
*.push.apple.com |
443, 2197 |
Apple Push-Benachrichtigungen |
albert.apple.com |
443 |
Aktivierung von Apple-Geräten |
deviceenrollment.apple.com |
443 |
Automatisierte Registrierung von Apple |
mdmenrollment.apple.com |
443 |
MDM-Registrierung von Apple |
iprofiles.apple.com |
443 |
Bereitstellung von Apple-Profilen |
So verwenden Sie — Apple
Apple MDM hängt vom Apple Push Notification-Dienst ab, um ein Gerät zu wecken, wenn ein Befehl wartet. Blockieren Sie APNs und die Geräte erfahren einfach nie von Befehlen.
Erlauben Sie die fünf Apple-Hosts in der obigen Tabelle sowie Ihren MDM-Server.
In älteren Netzwerken, die nicht-standardisierte HTTPS-Ports blockieren, erlauben Sie auch TCP 5223 ausgehend zu *.push.apple.com. Wenn Sie sich nicht sicher sind, ob dies bei Ihnen der Fall ist, erlauben Sie es.
Apple pflegt die vollständige Liste unter Verwenden Sie Apple-Produkte in Unternehmensnetzwerken.
So verwenden Sie — Windows, Linux und Android
Der Agent kommuniziert ausgehend über Port 443 mit Ihrem MDM-Server und nichts anderem. Es gibt keine zusätzlichen Endpunkte.
Route-Level-Whitelistung
Wenn Sie einen Reverse-Proxy oder eine Firewall mit Pfadregeln betreiben und nicht eine ganze Domain erlauben möchten, erlauben Sie stattdessen diese Routen.
Geräte, die außerhalb des VPN oder Intranets umherreisen, benötigen nur die osquery-Endpunkte:
```
/api/osquery/*
/api/v1/osquery/*
macOS
Route |
Zweck |
/mdm/apple/scep |
Gerät erhält ein SCEP-Zertifikat |
/mdm/apple/mdm |
Gerät spricht das MDM-Protokoll |
/api/mdm/apple/enroll |
Gerät ruft ein Registrierungsprofil ab |
/api//fleet/device/ |
Mitarbeitergerätseite: manuelle Registrierung, Schlüsselrotation |
/mdm/sso, /api//fleet/mdm/sso, /mdm/sso/callback, /api//fleet/mdm/sso/callback, /assets/* |
Anmeldung des Mitarbeitenden bei Identitätsanbietern während der Einrichtung |
/api//fleet/mdm/setup/eula/ |
Mitarbeiter akzeptiert die EULA während der Einrichtung |
/api/*/fleet/mdm/bootstrap |
Installation des Bootstrap-Pakets |
/mdm/apple/scep und /mdm/apple/mdm befinden sich außerhalb von /api, da sie die MDM-Protokolle von Apple implementieren und nicht eine REST-API.
Windows
Route |
Zweck |
/api/mdm/microsoft/management |
Gerät erhält Befehle und Profile |
/api/mdm/microsoft/discovery |
Gerät entdeckt die MDM-Serverdetails |
/api/mdm/microsoft/policy |
Registrierungsrichtlinien für die Zertifikatsausstellung |
/api/mdm/microsoft/enroll |
WS-Trust X.509v3-Token-Registrierung (MS-WSTEP) |
/api/mdm/microsoft/tos |
Nutzungsbedingungen während der automatisierten Registrierung |
/api/mdm/microsoft/auth |
Mitarbeiter-Authentifizierung während der automatisierten Registrierung |
iOS und iPadOS
Route |
Zweck |
/enroll |
Mitarbeiter erreicht die Registrierungsseite |
/api/*/fleet/enrollment_profiles/ota |
Gerät lädt ein Registrierungsprofil herunter |
/api//fleet/software/titles//inhouseapp |
In-House .ipa-Bereitstellung |
Android
Route |
Zweck |
/enroll |
Mitarbeiter erreicht die Registrierungsseite |
/api/*/fleet/androidenterprise/enrollmenttoken |
Registrierungstoken von der Android Management API |
/api/*/fleet/android_enterprise/pubsub |
Registrierungs- und Statusbenachrichtigungen |
/api/fleetd/* |
Zertifikatsbereitstellung für WLAN und VPN |
SCEP-Proxy — wenn Sie Factorial IT als SCEP-Proxy verwenden, erlauben Sie auch /mdm/scep/proxy/*.
Mutual TLS
Die /api//fleet/-Routen unterstützen mTLS mit dem Zertifikat, das ausgestellt wurde, als der Agent verpackt wurde. /mdm/apple/mdm und /api/mdm/apple/enroll unterstützen mTLS mit dem SCEP-Zertifikat, das vom Server ausgestellt wurde.
Diese Endpunkte verwenden kein mTLS:
```
/mdm/apple/scep
/api/mdm/microsoft/discovery
/api/mdm/microsoft/auth
/api/mdm/microsoft/policy
/api/mdm/microsoft/enroll
/api/mdm/microsoft/management
/api/mdm/microsoft/tos
```
Auf macOS und Windows sendet der Client sein Zertifikat in einem Anfrage-Header, und der Server überprüft es unabhängig.
Geräte, die außerhalb des VPN reisen
Wenn Ihre Flotte das Netzwerk nur über ein VPN oder ein Intranet erreicht, bleiben Laptops unterwegs still. Sie müssen nicht alles öffnen, um das zu beheben: Exponieren Sie nur die osquery-Endpunkte, und der Agent bleibt von überall aus aktiv, während der Rest der Oberfläche geschlossen bleibt.
Windows benötigt eigene Routen
Die Registrierung und Verwaltung von Windows laufen nicht über dieselben Pfade wie der Agent. Drei Routen tragen es:
Route |
Was es trägt |
|---|---|
Verwaltung |
Die Befehle und Profile, die das Gerät erhält |
Entdeckung |
Wie das Gerät den Verwaltungsserver findet |
Richtlinie |
Die Registrierungsrichtlinien, die das Identitätszertifikat ausstellen |
Fügen Sie Windows Autopilot hinzu, und Sie benötigen auch die eigenen Endpunkte von Microsoft, die auf deren Seite dokumentiert sind und sich nach deren Zeitplan ändern, nicht unserem.
Apple und Android beziehen von ihren eigenen Anbietern
Apple benötigt seine Push-, Aktivierungs- und Registrierungs-Hosts erreichbar — Push-Benachrichtigungen über 443 und 2197, Aktivierung und Geräteeintragung über 443. Blockieren Sie sie, und Geräte registrieren sich, erhalten aber nie wieder einen Befehl.
Android hat überhaupt keinen Agenten. Geräte werden über Android Enterprise verwaltet, daher benötigen sie Google: die Verwaltungs-API, Google Play und Firebase Cloud Messaging. Es gibt nichts von uns zu erlauben.
Tipps und bewährte Verfahren
- Erlauben Sie die Apple-Hosts vor Ihrer ersten Mac-Registrierung, nicht nachdem sie fehlgeschlagen ist. Blockierte APNs sehen genau wie ein defektes MDM aus, und es ist die häufigste Ursache dafür, dass "Befehle nichts tun".
- Erlauben Sie TCP 5223, wenn Sie sich über Ihr Netzwerk unsicher sind. Es kostet nichts und beseitigt eine ganze Klasse intermittierender Fehler in älteren Netzwerken.
- Bevorzugen Sie die Domain-Level-Whitelistung, wo Ihr Sicherheitsteam dies erlaubt. Die Routenliste ändert sich mit dem Produkt; eine Domainregel nicht.
- Decken Sie Geräte ab, die das Büro verlassen. Heim- und Café-Netzwerke liegen außerhalb Ihrer Firewall, daher sorgt das Exponieren der osquery-Endpunkte dafür, dass umherreisende Geräte Berichte erstatten.
Fehlerbehebung und FAQ
Fehlerbehebung
- Apple-Geräte registrieren sich, reagieren aber nie auf Befehle. APNs ist blockiert. Erlauben Sie *.push.apple.com auf 443 und 2197 und fügen Sie 5223 hinzu, wenn Ihr Netzwerk nicht-standardisierte Ports einschränkt.
- Die Registrierung schlägt bei Apple während der Geräteeinrichtung fehl. One der Registrierungs-Hosts ist nicht erreichbar. Überprüfen Sie deviceenrollment.apple.com, mdmenrollment.apple.com und iprofiles.apple.com.
- Ein Windows- oder Linux-Gerät installiert den Agenten und meldet dann nichts. Das Gerät kann Ihren MDM-Server auf 443 nicht erreichen. Dieser Host ist der einzige Endpunkt, den diese Plattformen benötigen, also fangen Sie dort an.
- Geräte berichten nur aus dem Büro. Die osquery-Endpunkte sind von außerhalb des Netzwerks nicht erreichbar. Erlauben Sie /api/osquery/ und /api/v1/osquery/.
FAQ
-
Benötigen wir eingehende Firewall-Regeln?
Nein. Jede Verbindung ist ausgehend vom Gerät.
-
Welche Plattform benötigt die meisten Endpunkte?
Apple. Windows, Linux und Android benötigen nur Ihren MDM-Server.
-
Können wir Routen anstelle ganzer Domains auf die Whitelist setzen?
Ja — die obigen Routentabellen decken das ab. Seien Sie sich nur bewusst, dass sich Routen ändern, wenn sich das Produkt ändert.
-
Benötigen wir immer noch Port 5223?
Nur in älteren Netzwerken, die nicht-standardisierte HTTPS-Ports blockieren. Es zu erlauben ist harmlos.