Plugin Jamf pour la bourse des risques

Ce document explique comment configurer le plugin Jamf v1.0.0 avec le module Risk Exchange de la plateforme Netskope Cloud Exchange. Ce plugin est utilisé pour récupérer le périphérique de la plateforme Jamf Security Cloud > périphérique > Manage page. Il permet également d'effectuer les actions Override Risk Level et Revert Risk Level sur le périphérique.

Calcul du score de normalisation de Netskope : Niveau de risque sécurisé = 875, niveau de risque faible = 875, niveau de risque moyen = 625, niveau de risque élevé = 375.

Notez que les scores sont basés sur la médiane des plages de scores de risque de Netskope, par exemple, le score faible (751-1000) a une médiane de 875.

Conditions préalables

Pour réaliser cette intégration, vous avez besoin de :

• Un locataire Netskope (ou plusieurs, par exemple des instances de production et de développement/test).
• A Netskope Cloud Exchange tenant with the Tenant plugin and Risk Exchange plugin already configured.
• Les informations d'identification de l'instance Jamf (ID de l'application, secret de l'application).
• Connexion à l'hôte suivant : https://radar.wandera.com.

Support du plugin Jamf

Ce plugin récupère les périphériques et leurs détails respectifs depuis la plateforme Jamf Security Cloud. Il permet également d'effectuer les actions Override Risk Level, Revert Risk Level et No sur le périphérique tiré.

Type de données extraites	Périphériques
Actions soutenues	Remplacer le niveau de risque Revenir au niveau de risque Aucune action

Mises en correspondance

La cartographie sera utilisée pour visualiser les périphériques tirés et leurs détails respectifs. Les champs mappés lors de la configuration du plugin seront visibles sur la page Enregistrements une fois les données extraites. Vous trouverez ci-dessous la cartographie suggérée qui doit être utilisée lors de la configuration du plugin.

Pull Mapping pour périphérique

Étiquette du champ du plugin	Type de données attendu	Étiquette suggérée pour le champ	Stratégie globale
périphérique ID	String	périphérique ID	Unique
Nom de l'utilisateur	String	Nom de l'utilisateur	Overwrite
Courriel de l'utilisateur	String	Courriel de l'utilisateur	Overwrite
périphérique Nom	String	périphérique Nom	Overwrite
périphérique System Version	String	périphérique System Version	Overwrite
Type de système d'exploitation	String	Type de système d'exploitation	Overwrite
périphérique Platform	String	périphérique Platform	Overwrite
périphérique Catégorie de risque	String	périphérique Catégorie de risque	Overwrite
Nom de l'application	String	Nom de l'application	Overwrite
Version de l'application	String	Version de l'application	Overwrite
Score normalisé de Netskope	Number	Score normalisé de Netskope	Overwrite

Permissions

Voici les autorisations nécessaires pour configurer le plugin Jamf et effectuer des actions sur le périphérique tiré.
L'utilisateur pour lequel l'identifiant et le secret de l'application sont générés doit être un administrateur global.

• Périphériques
• Paramètres

Détails de l'API

Liste des API utilisées

Point final de l'API	Méthode	Cas d'utilisation
/v1/login	PUBLIER	Pour obtenir un jeton d'authentification
/risk/v2/devices	OBTENIR	Pour récupérer le périphérique de la plateforme Jamf
/risk/v1/override	PUT	Pour remplacer le niveau de risque du périphérique recherché

Obtenir un jeton d'authentification

API Endpoint: <Base URL>/v1/login
Method: POST
Headers

Clé	Value
User-Agent	netskope-ce-5.1.0-cre-jamf-v1.0.0

Authorization
Authentification de base

Username	<Application_ID>
Mot de passe	<Application_secret>

Sample API Response

{
    "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJjdXN0b21lcl9pZCI6ImMwZmUzNmU2LWNhNDUtNGFkNS05OWM3LTBjM2NjODliZDU2NiIsImlhdCI6MTcyNTg2MDg1NSwiZXhwIjoxNzI1ODYxNzU1LCJhdWQiOiJSSVNLX0FQSSIsImNsaWVudF9pZCI6IjRhMTk3MzExLTI0ZGUtNDQxZi1iYTRkLTNjOTc4YzY4MjQ0NyIsImFub255bWl6ZWQiOmZhbHNlfQ._FRbcbpo02VFZOUc1j0kj8-geXIKI2U9un9f6i_Qrss"
}

Recherche d'un périphérique

API Endpoint: <Base URL>/risk/v2/devices
Method: GET
Headers:

Clé	Value
Authorization	Bearer <Bearer Token>
User-Agent	netskope-ce-5.1.0-cre-jamf-v1.0.0

Parameters

Clé	Value
page	0
pageSize	99

Sample API Response

{
    "customerId": "c0fe36e6-ca45-4ad5-99c7-0c3cc89bd566",
    "userDeviceList": [
        {
            "guid": "7d827d40-81a4-4016-8b40-d7048c1e2660",
            "externalId": null,
            "phoneNumber": null,
            "user": {
                "email": "sam@gmail.com",
                "name": "Gary Jenkins"
            },
            "joinDate": 1724285780379,
            "status": "ACTIVE",
            "traffic": {
                "lastTrafficRun": 0
            },
            "info": {
                "location": {
                    "isoCountry": "us"
                },
                "lastStatusUpdateTime": 1724415515771,
                "device": {
                    "deviceName": "24566f91-3313-4357-8820-c70f00faa828",
                    "deviceSystemVersion": "14",
                    "osType": "ANDROID",
                    "platform": null
                },
                "app": {
                    "name": null,
                    "version": "11.55.0.0"
                }
            },
            "hardwareSpec": {
                "platform": "Other Android",
                "version": null,
                "osType": "ANDROID"
            },
            "statusUpdate": {
                "connector": null,
                "device": {
                    "payload": {},
                    "lastStatusUpdateUtcMs": 1724415515771
                }
            },
            "connectorState": "UNMANAGED",
            "riskCategory": "SECURE",
            "group": "",
            "deploymentState": "NONE",
            "lastPrivateAccessDnsTraffic": 0,
            "lastDnsTraffic": 1724421490768
        },
        {
            "guid": "d0f8d97e-11b1-4a0b-8fa6-2d03cee50c21",
            "externalId": null,
            "phoneNumber": null,
            "user": {
                "email": "sam@gmail.com",
                "name": "Gary Jenkins"
            },
            "joinDate": 1723247393856,
            "status": "ACTIVE",
            "traffic": {
                "lastTrafficRun": 0
            },
            "info": {
                "location": {
                    "isoCountry": "US"
                },
                "lastStatusUpdateTime": 1725834090308,
                "device": {
                    "deviceName": "f2d374f2-18f6-46d3-b650-1fd1f0bc59e4",
                    "deviceSystemVersion": "16.6.1",
                    "osType": "IOS",
                    "platform": null
                },
                "app": {
                    "name": null,
                    "version": "11.37.0"
                }
            },
            "hardwareSpec": {
                "platform": "Apple iPad",
                "version": null,
                "osType": "IOS"
            },
            "statusUpdate": {
                "connector": null,
                "device": {
                    "payload": {},
                    "lastStatusUpdateUtcMs": 1725834090308
                }
            },
            "connectorState": "UNMANAGED",
            "riskCategory": "MEDIUM",
            "group": "",
            "deploymentState": "NONE",
            "lastPrivateAccessDnsTraffic": 0,
            "lastDnsTraffic": 1725859823210
        }
    ],
    "linkTemplates": {}
}

Remplacer le niveau de risque de Fetched périphérique

API Endpoint: <Base URL>/risk/v1/override
Method: PUT
Headers:

Clé	Value
Authorization	Bearer <Bearer Token>
User-Agent	netskope-ce-5.1.0-cre-jamf-v1.0.0

Body

{
    "risk": "HIGH",
    "source": "MANUAL",
    "deviceIds": []
}

Matrice de performance

Vous trouverez ci-dessous la matrice de performance réalisée sur une grande pile CE avec les spécifications mentionnées ci-dessous en tirant un périphérique de 500K.

Taille de la pile	Grandes dimensions RAM : 32 GB Cœur : 16
Temps nécessaire pour stocker les enregistrements d'hôtes tirés et mis à jour	~50 minutes

Agent utilisateur

netskope-ce-5.1.0-cre-jamf-v1.0.0

Workflow

1. Ajoutez des autorisations à l'utilisateur Global Admin.
2. Obtenez votre identifiant et votre secret de candidature.
3. Configure Netskope Tenant and Plugin.
4. Configurez le plugin Jamf.
5. Ajouter une règle de gestion.
6. Ajouter des actions.
7. Valider le plugin

Cliquer sur « play » pour regarder une vidéo.

Ajouter des autorisations à l'utilisateur Global Admin

1. Connectez-vous à la plateforme Jamf. Cliquez dans le coin supérieur droit, puis cliquez sur View all accounts.
   
2. Cliquez Administration.
   
3. Cliquez sur Actions > Edit pour l’utilisateur.
   
4. Select Devices et Settings, puis cliquez sur Save.
   

Obtenez votre identifiant et votre secret de candidature

1. Allez au menu Icon > Integrations > Risk API.
   
2. Cliquez Generate API key.
   
3. Saisissez un nom et cliquez sur Generate API Key.
   
4. Copiez l'ID de l'application et le secret de l'application pour les utiliser dans la configuration du plugin.
   

Configurer le plugin Jamf

1. Connectez-vous à Cloud Exchange et allez sur Settings > Plugins. Cherchez et sélectionnez la boîte de plugin Jamf v1.0.0 (CRE) .
   
2. Pour les informations de base, entrez un nom de configuration du plugin et modifiez l'intervalle de synchronisation si nécessaire.
   
3. Cliquez Next. Saisissez l'URL de base, l'ID de l'application et le secret de l'application.
   
4. Cliquez sur Next. Select l'entité dans la liste déroulante Entité. Les champs d'entité peuvent être créés à partir de la page de l'éditeur de schéma ou en utilisant l'option + Add Field dans la liste déroulante des champs. Fournissez la cartographie du terrain. Pour la correspondance suggérée, veuillez vous référer à la section Correspondances.
   Notez que le champ ID du périphérique sera nécessaire pour extraire le périphérique et pour effectuer des actions sur le périphérique extrait.

   

5. Cliquez Save.
   

Ajouter une règle de gestion de l'échange de risques pour Jamf

1. Dans Risk Exchange, allez à Business Rules.
2. Cliquez sur Create New Rule dans le coin supérieur droit.
3. Saisissez un nom de règle, sélectionnez l’entité pour laquelle les champs ont été configurés pour le plugin Jamf, puis configurez la requête selon vos besoins. L’exemple ci-dessous récupère périphérique contenant Gary dans le nom d’utilisateur.
   
4. Cliquez Save.
   

Ajoutez des actions d'échange de risques pour Jamf

Le plugin Jamf prend en charge ces types d'actions :

• Pas d'action : Aucune action ne sera effectuée pour cette action. Les utilisateurs peuvent générer des alertes UBA dans le CTO en utilisant cette action et en activant l'option Générer des alertes.
• Remplacer le niveau de risque : L'option Override Risk Level permet d'attribuer un niveau de risque New au périphérique sur lequel une action est effectuée.
• Rétablir le niveau de risque : Revenir au niveau de risque permet d'attribuer le niveau de risque qui était présent lors de la création du périphérique.

Notez que vous pouvez effectuer les actions sur le périphérique tiré de Jamf sur le site Netskope Tenant.

Remplacer le niveau de risque

1. Dans Risk Exchange, allez à Actions et cliquez sur Add Action Configuration.
2. Select votre règle de gestion, la configuration (plugin) dans leurs listes déroulantes respectives.
3. Pour Action, sélectionnez Override Risk Level dans la liste déroulante.
4. Activez la case à cocher Exiger une approbation si une approbation est nécessaire avant d'effectuer une action sur le périphérique.

   Notes

   • Les champs mappés avec l'ID du périphérique lors de la configuration du plugin seront nécessaires pour effectuer une action sur le périphérique.
   • Si l'option Statique est sélectionnée dans le menu déroulant, indiquez l'ID du périphérique, séparé par des virgules.

   

5. Cliquez Save.
   

Revenir au niveau de risque

1. Dans Risk Exchange, allez à Actions et cliquez sur Add Action Configuration.
2. Select votre règle de gestion, la configuration (plugin) dans leurs listes déroulantes respectives.
3. Pour Action, sélectionnez Revert Risk Level dans la liste déroulante.
4. Activez la case à cocher Exiger une approbation si une approbation est nécessaire avant d'effectuer une action sur le périphérique.

   Notes

   • Les champs mappés avec l'ID du périphérique lors de la configuration du plugin seront nécessaires pour effectuer une action sur le périphérique.
   • Si l'option Statique est sélectionnée dans le menu déroulant, indiquez l'ID du périphérique, séparé par des virgules.

   
   

5. Cliquez Save.
   

No Action

1. Dans Risk Exchange, allez à Actions et cliquez sur Add Action Configuration.
2. Select votre règle de gestion, la configuration (plugin) dans leurs listes déroulantes respectives.
3. Pour Action, sélectionnez No actions dans le menu déroulant et, si vous le souhaitez, activez le bouton bascule Générer une alerte pour générer des alertes dans le module CTO.
4. Activez la case à cocher Exiger une approbation si une approbation est nécessaire avant d'effectuer une action sur le périphérique.

   Notes

   • Les champs mappés avec l'ID du périphérique lors de la configuration du plugin seront nécessaires pour effectuer une action sur le périphérique.
   • Si l'option Statique est sélectionnée dans le menu déroulant, indiquez l'ID du périphérique, séparé par des virgules.

   

5. Cliquez Save.
   

Valider le plugin Jamf

Valider sur Cloud Exchange

Pour valider le tirage sur Cloud Exchange :

1. Dans Risk Exchange, allez sur Records. Select l’Entité sélectionnée lors de la configuration du mappage de champ pour périphérique afin de visualiser le périphérique tiré.
   
2. Rendez-vous à Logging et recherchez les journaux du plugin.
   
3. En Logging, vérifiez l’action effectuée pour un périphérique.
   

Valider sur Jamf

Les périphérique sont extraits de la page périphérique > Manage depuis la plateforme Jamf.

Si vous souhaitez valider l’action Override Risk Level, rendez-vous sur Devices > Manage pour vérifier si le niveau de risque est mis à jour ou non. Vous pouvez vérifier le niveau existant des utilisateurs, puis le niveau mis à jour après que l’action soit déclenchée.


Si vous souhaitez valider l’action Revert Risk Level, rendez-vous sur Devices > Manage pour vérifier si le niveau de risque est mis à jour ou non.

Dépannage du plugin Jamf

Impossible de configurer le plugin Jamf

Si vous ne parvenez pas à configurer le plugin Jamf, c'est peut-être parce que vous avezfourni un ID d'application et un secret d'application incorrects.

Pour résoudre ce problème, vérifiez que l'ID de l'application et le secret de l'application sont corrects.

Impossible de tirer le périphérique

Si vous ne parvenez pas à extraire le périphérique du plugin Jamf, cela peut être dû à l'une des raisons suivantes :

• Aucun périphérique n'est présent sur la plate-forme Jamf.
• Une erreur est survenue lors du retrait du périphérique de la plate-forme.
• Le mappage n'est pas ajouté lors de la configuration du plugin dans la page source de l'entité.

Pour résoudre ces problèmes, suivez les étapes suivantes :

1. Vérifiez sur la plateforme Jamf si le périphérique existe ou non. Pour vérifier si le périphérique existe ou non, suivez les étapes de la section Valider sur Jamf.
2. Réception d'une erreur 500 : Le serveur est peut-être en panne ; attendez un peu et vérifiez plus tard.
3. Réception d'une erreur 403 : Le paramètre de configuration du plugin ne dispose pas d'autorisations suffisantes ou les informations d'identification n'existent plus.
4. Assurez-vous que le mappage a été ajouté et que le champ périphérique ID a été mappé lors de la configuration du plugin.

Impossible d'effectuer une action sur Jamf

Si vous ne parvenez pas à effectuer une action sur le périphérique, cela peut être dû à l'une des raisons suivantes :

• Réception d'une erreur lors de l'exécution d'une action.
• périphérique n'est pas présent sur la plate-forme Jamf.
• La case à cocher Require Approval est activée lors de la configuration de l'action et la demande n'est pas approuvée.

Pour résoudre ces problèmes, suivez les étapes suivantes :

1. Vérifiez l'erreur présente sur la page Logging et essayez de la résoudre.
2. Accédez à la plate-forme Jamf et vérifiez si le périphérique pour lequel l'action doit être effectuée est présent ou non.
3. Allez sur Action Logs, sélectionnez les journaux pour lesquels vous souhaitez approuver les demandes et cliquez sur l'icône d'approbation. Vous pouvez également désactiver l'option Require Approval de l'action configurée et effectuer à nouveau l'action.

Impossible d'afficher les détails du périphérique sur l'enregistrement

Si vous ne parvenez pas à consulter les détails du périphérique dans le tableau des enregistrements, cela peut être dû à l'une des raisons suivantes :

• Le mappage de tous les champs Jamf n'a pas été fourni lors de la configuration du plugin Jamf.
• Les périphériques tirés sont affichés dans une ligne avec des valeurs séparées par des virgules.

Pour résoudre ces problèmes, suivez les étapes suivantes :

1. Veillez à fournir le mappage nécessaire lors de la configuration du plugin.
2. Assurez-vous que les champs créés dans une entité sont conformes aux correspondances.