Lorsque les appareils gérés se trouvent derrière un pare-feu ou un proxy d'entreprise, certains points de terminaison doivent rester accessibles, sinon l'inscription, la distribution des politiques et les notifications push cessent de fonctionner. Cet article liste ce qu'il faut autoriser, par plateforme, ainsi que le détail des routes pour les équipes qui ne peuvent pas autoriser un domaine entier.
Vue d'ensemble
Tout le trafic est du HTTPS sortant depuis l'appareil. Aucune règle de pare-feu entrant n'est nécessaire côté appareil.
Chaque compte dispose de son propre serveur MDM :
[company slug].mdm.getprimo.com
Les appareils se connectent à cet hôte pour s'inscrire et recevoir des commandes. Autorise le TCP 443 sortant vers cet hôte.
Windows, Linux et Android n'ont besoin de rien d'autre. Apple en demande davantage, car les appareils Apple sont réveillés par le service push d'Apple.
En bref
Point de terminaison |
Port |
Nécessaire pour |
[company slug].mdm.getprimo.com |
443 |
Toutes les plateformes |
*.push.apple.com |
443, 2197 |
Notifications push Apple |
albert.apple.com |
443 |
Activation des appareils Apple |
deviceenrollment.apple.com |
443 |
Inscription automatisée Apple |
mdmenrollment.apple.com |
443 |
Inscription MDM Apple |
iprofiles.apple.com |
443 |
Distribution des profils Apple |
Étapes : Apple
Le MDM Apple s'appuie sur le service de notification push d'Apple pour réveiller un appareil lorsqu'une commande est en attente. Si tu bloques APNs, les appareils ne sont tout simplement jamais informés des commandes.
Autorise les cinq hôtes Apple du tableau ci-dessus, ainsi que ton serveur MDM.
Sur les réseaux plus anciens qui bloquent les ports HTTPS non standards, autorise également le TCP 5223 sortant vers *.push.apple.com. Si tu as un doute, autorise-le.
Apple tient la liste complète à jour dans l'article Utiliser les produits Apple sur des réseaux d'entreprise.
Étapes : Windows, Linux et Android
L'agent communique uniquement en sortie, sur le port 443, avec ton serveur MDM. Il n'y a aucun autre point de terminaison.
Autorisation au niveau des routes
Si tu utilises un proxy inverse ou un pare-feu avec des règles de chemin et que tu préfères ne pas autoriser un domaine entier, autorise plutôt les routes suivantes.
Les appareils qui se déplacent en dehors du VPN ou de l'intranet n'ont besoin que des points de terminaison osquery :
/api/osquery/*
/api/v1/osquery/*
macOS
Route |
Rôle |
/mdm/apple/scep |
L'appareil obtient un certificat SCEP |
/mdm/apple/mdm |
L'appareil utilise le protocole MDM |
/api/mdm/apple/enroll |
L'appareil récupère un profil d'inscription |
/api/*/fleet/device/* |
Page de l'appareil du ou de la collaborateur·rice : inscription manuelle, rotation de clé |
/mdm/sso, /api/*/fleet/mdm/sso, /mdm/sso/callback, /api/*/fleet/mdm/sso/callback, /assets/* |
Connexion du ou de la collaborateur·rice au fournisseur d'identité lors de la configuration |
/api/*/fleet/mdm/setup/eula/* |
Le ou la collaborateur·rice accepte le contrat de licence utilisateur final (CLUF) lors de la configuration |
/api/*/fleet/mdm/bootstrap |
Installation du package d'amorçage |
/mdm/apple/scep et /mdm/apple/mdm se trouvent en dehors de /api, car ils mettent en œuvre les protocoles MDM d'Apple et non une API REST.
Windows
Route |
Rôle |
/api/mdm/microsoft/management |
L'appareil reçoit des commandes et des profils |
/api/mdm/microsoft/discovery |
L'appareil découvre les informations du serveur MDM |
/api/mdm/microsoft/policy |
Politiques d'inscription pour l'émission de certificats |
/api/mdm/microsoft/enroll |
Inscription par jeton WS-Trust X.509v3 (MS-WSTEP) |
/api/mdm/microsoft/tos |
Conditions d'utilisation lors de l'inscription automatisée |
/api/mdm/microsoft/auth |
Authentification du ou de la collaborateur·rice lors de l'inscription automatisée |
iOS et iPadOS
Route |
Rôle |
/enroll |
Le ou la collaborateur·rice accède à la page d'inscription |
/api/*/fleet/enrollment_profiles/ota |
L'appareil télécharge un profil d'inscription |
/api/*/fleet/software/titles/*/inhouseapp |
Déploiement d'une application interne .ipa |
Android
Route |
Rôle |
/enroll |
Le ou la collaborateur·rice accède à la page d'inscription |
/api/*/fleet/androidenterprise/enrollmenttoken |
Jeton d'inscription de l'API Android Management |
/api/*/fleet/android_enterprise/pubsub |
Notifications d'inscription et d'état |
/api/fleetd/* |
Déploiement de certificats pour le Wi-Fi et le VPN |
Proxy SCEP : si tu utilises Factorial IT comme proxy SCEP, autorise également /mdm/scep/proxy/*.
TLS mutuel (mTLS)
Les routes /api/*/fleet/* prennent en charge le mTLS grâce au certificat émis lors de la création du package de l'agent. Les routes /mdm/apple/mdm et /api/mdm/apple/enroll prennent en charge le mTLS grâce au certificat SCEP émis par le serveur.
Ces points de terminaison n'utilisent pas le 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
Sur macOS et Windows, le client envoie son certificat dans un en-tête de requête, et le serveur le vérifie de manière indépendante.
Appareils en déplacement hors du VPN
Si ton parc n'accède au réseau que par un VPN ou un intranet, les ordinateurs portables en déplacement restent muets. Il n'est pas nécessaire de tout ouvrir pour résoudre ce problème : expose uniquement les points de terminaison osquery, et l'agent continue de remonter ses informations de n'importe où, tandis que le reste de la surface reste fermé.
Windows a besoin de ses propres routes
L'inscription et la gestion de Windows n'empruntent pas les mêmes chemins que l'agent. Trois routes les acheminent :
Route |
Ce qu'elle transporte |
|---|---|
Gestion |
Les commandes et les profils que l'appareil reçoit |
Découverte |
La façon dont l'appareil trouve le serveur de gestion |
Politique |
Les politiques d'inscription qui émettent le certificat d'identité |
Si tu utilises Windows Autopilot, tu as aussi besoin des points de terminaison de Microsoft, qui sont documentés par Microsoft et changent selon son propre calendrier, pas le nôtre.
Apple et Android dépendent de leurs propres fournisseurs
Apple a besoin que ses hôtes de push, d'activation et d'inscription soient accessibles : notifications push sur les ports 443 et 2197, activation et inscription des appareils sur le port 443. Si tu les bloques, les appareils s'inscrivent mais ne reçoivent plus jamais de commande.
Android n'utilise aucun agent. Les appareils sont gérés via Android Enterprise, ils ont donc besoin de Google : l'API de gestion, Google Play et Firebase Cloud Messaging. Il n'y a rien à autoriser de notre côté.
Conseils et bonnes pratiques
- Autorise les hôtes Apple avant la première inscription d'un Mac, et pas après un échec. Des APNs bloqués ressemblent exactement à un MDM défaillant : c'est la cause la plus fréquente de « les commandes ne font rien ».
- Autorise le TCP 5223 si tu as un doute sur ton réseau. Cela ne coûte rien et élimine toute une catégorie de pannes intermittentes sur les réseaux plus anciens.
- Privilégie l'autorisation au niveau du domaine lorsque ton équipe sécurité l'accepte. La liste des routes évolue avec le produit ; une règle de domaine, non.
- Pense aux appareils qui quittent le bureau. Les réseaux domestiques et ceux des cafés sont en dehors de ton pare-feu : exposer les points de terminaison osquery permet aux appareils itinérants de continuer à remonter leurs informations.
Résolution des problèmes et FAQ
Résolution des problèmes
- Les appareils Apple s'inscrivent mais n'exécutent jamais les commandes. Les APNs sont bloqués. Autorise *.push.apple.com sur les ports 443 et 2197, et ajoute le 5223 si ton réseau restreint les ports non standards.
- L'inscription échoue sur Apple lors de la configuration de l'appareil. L'un des hôtes d'inscription est injoignable. Vérifie deviceenrollment.apple.com, mdmenrollment.apple.com et iprofiles.apple.com.
- Un appareil Windows ou Linux installe l'agent, puis ne remonte rien. L'appareil ne peut pas joindre ton serveur MDM sur le port 443. Cet hôte est le seul point de terminaison dont ces plateformes ont besoin : commence donc par là.
- Les appareils ne remontent leurs informations que depuis le bureau. Les points de terminaison osquery ne sont pas accessibles depuis l'extérieur du réseau. Autorise /api/osquery/* et /api/v1/osquery/*.
FAQ
-
Avons-nous besoin de règles de pare-feu entrant ?
Non. Toutes les connexions sont sortantes, depuis l'appareil.
-
Quelle plateforme a besoin du plus grand nombre de points de terminaison ?
Apple. Windows, Linux et Android n'ont besoin que de ton serveur MDM.
-
Pouvons-nous autoriser des routes plutôt que des domaines entiers ?
Oui, les tableaux de routes ci-dessus les détaillent. Garde simplement à l'esprit que les routes évoluent avec le produit.
-
Avons-nous toujours besoin du port 5223 ?
Uniquement sur les réseaux plus anciens qui bloquent les ports HTTPS non standards. L'autoriser est sans risque.