Notes de mise à jour
1.0.0
Added
- Initial Release.
- Ce plugin récupère les données des applications à partir de Monitor > Reports > Security > Application Discovery > All Applications et les périphériques à partir de la page Configure > Security > Endpoints de la plateforme Infoblox BloxOne. Ce plugin prend en charge l'action de mise à jour du statut de l'application sur les applications et ne prend pas en charge d'action sur les périphériques.
Ce document explique comment configurer le plugin Infoblox BloxOne v1.0.0 avec le module Risk Exchange de la plate-forme Netskope Cloud Exchange. Ce plugin récupère les données des applications depuis Monitor > Reports > Security > Application Discovery > All Applications et les périphériques depuis Configure > Security > Endpoints de la plateforme Infoblox BloxOne. Ce plugin prend en charge l'action de mise à jour du statut de l'application sur les applications et ne prend en charge aucune action sur les périphériques.
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).
- Un locataire Netskope Cloud Exchange avec le plugin Tenant et le plugin Risk Exchange déjà configurés.
- Votre URL de base Infoblox BloxOne et votre clé API.
- Connectivité à la plateforme Infoblox BloxOne.
Prise en charge du plugin Infoblox
Ce plugin récupère les données des applications à partir de Monitor > Reports > Security > Application Discovery > All Applications et les périphériques à partir de la page Configure > Security > Endpoints de la plateforme Infoblox BloxOne. Ce plugin prend en charge l'action de mise à jour du statut de l'application sur les applications et ne prend pas en charge d'action sur les périphériques.
| Type de données extraites | Actions soutenues |
|---|---|
| Applications, périphériques | Applications : – Mettre à jour le statut de l'application – Aucune action Périphériques : – Aucune action |
Mises en correspondance
Le mappage ci-dessous peut être utilisé pour récupérer les applications et les périphériques ainsi que 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 le mappage suggéré à utiliser lors de la configuration du plugin.
Cartographie d'extraction pour l'application
| Étiquette du champ du plugin | Type de données attendu | Étiquette suggérée pour le champ | Stratégie globale suggérée |
|---|---|---|---|
| Nom de l'application | String | Nom de l'application Infoblox | Unique |
| État de l'application | String | État de l'application Infoblox | Overwrite |
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 suggérée |
|---|---|---|---|
| périphérique ID | String | ID de périphérique Infoblox | Unique |
| périphérique Nom | String | Nom de périphérique Infoblox | Overwrite |
| Pays du périphérique | String | Pays du périphérique Infoblox | Overwrite |
| Région du périphérique | String | Région du périphérique Infoblox | Overwrite |
| IP publique du périphérique | String | Adresse IP publique du périphérique Infoblox | Overwrite |
| État du périphérique | String | État du périphérique Infoblox | Overwrite |
| Device Tags | List | Infoblox Device Tags | Overwrite |
| Adresse MAC du périphérique | List | Adresse MAC du périphérique Infoblox | Overwrite |
Détails de l'API
Liste des API utilisées
| Point final de l'API | Méthode | Use case |
|---|---|---|
| /api/atcfw/v1/app_approbations | OBTENIR | Recherche d'applications |
| /api/atcep/v1/roaming_périphériques | OBTENIR | Recherche d'un périphérique |
| /api/atcfw/v1/app_approbations | PATCH | Mettre à jour le statut de l'application |
Recherche d'applications
Endpoint: <Base URL>/api/atcfw/v1/app_approvals
Method: OBTENIR
Headers:
| Clé | Value |
|---|---|
| User-Agent | netskope-ce-5.1.0-cre-infoblox-bloxone-v1.0.0 |
| Authorization | Token <api_key> |
Sample API Response(Status Code 200):
{
"results": [
{
"app_name": "<Application Name>",
"status": "<APPROVED or UNAPPROVED>"
}
]
}
Recherche d'un périphérique
Endpoint: <Base URL>/api/atcep/v1/roaming_devices
Method: OBTENIR
Parameters:
| Clé | Value |
|---|---|
| _limit | 10000 |
| _offset | 0 |
Headers:
| Clé | Value |
|---|---|
| User-Agent | netskope-ce-5.1.0-cre-infoblox-bloxone-v1.0.0 |
| Authorization | Token <api_key> |
Sample API Response(Status Code 200):
{"results":[{"calculated_status":"ACTIVE","city_name":"san francisco","client_id":"b1a011e8328f75e7233db3c2a6d9c217","connected_time":"2024-09-12T05:34:19.398Z","country_name":"united states","created_time":"2024-09-12T05:34:19.398Z","device_info":"S-1-5-21-804185182-4086767973-266869295","device_region":"california","elb_ip_list":["string"],"group_id":53212,"group_name":"endpoint_group_a","is_uploading_logs":false,"log_level":"INFO","name":"endpoint_device_a","net_info":{"fqdn":"example1.corp-device.com","ipv4_addr_list":["10.5.77.12","11.2.5.39"],"mac_addr":["00:a0:c9:14:c8:29","12:cb:c0:31:ff:ee"],"state":{"protection":"UNKNOWN_SUB_STATUS","upgrade":"NO_OPERATION"}},"os_platform":"Windows 7 Enterprise","public_ip":"string","region":"ap-northeast-1","region_name":"Asia Pacific (Seoul)","serial_number":"string","tags":{},"updated_time":"2024-09-12T05:34:19.398Z","user_id":"user_a","user_id_verified":true,"version":"1.5.2"}],"total_result_count":0}
Mettre à jour le statut de l'application
Endpoint: <Base URL>/api/atcfw/v1/app_approvals
Method: PATCH
Headers:
| Clé | Value |
|---|---|
| User-Agent | netskope-ce-5.1.0-cre-infoblox-bloxone-v1.0.0 |
| Authorization | Token <api_key> |
Body:
{
"inserted_approvals": [
{
"app_name": "<Application Name>",
"status": "<APPROVED or UNAPPROVED>"
}
]
}
Sample API Response(Status Code 200):
{
"results": [
{
"app_name": "<Application Name>",
"status": "<APPROVED or UNAPPROVED>"
}
]
}
Agent utilisateur
netskope-ce-5.1.0-cre-infoblox-bloxone-v1.0.0
Workflow
- Configurer le plugin Infoblox BloxOne.
- Configurez une règle de gestion.
- Configurer les actions.
- Validez le plugin.
Configurer le plugin Infoblox BloxOne
-
Dans Cloud Exchange, allez sur Settings > Plugin Store. Recherchez et sélectionnez le plugin Infoblox BloxOne v1.0.0 (CRE).

-
Saisissez un nom de configuration du plugin et modifiez l'intervalle de synchronisation si nécessaire.

-
Cliquez sur Next et saisissez votre URL de base Infoblox BloxOne et votre clé API.

-
Cliquez sur Next et sélectionnez l'entité Applications dans le menu déroulant Entité, puis fournissez le(s) mappage(s) de champ selon vos besoins.
Le nom de l'application sera nécessaire pour récupérer les applications et pour effectuer des actions sur les applications récupérées.
Le champ ID de périphérique sera requis pour extraire les périphériques. -
Cliquez sur Save.
Configurer une règle métier de Risk Exchange pour Infoblox BloxOne
-
Dans Risk Exchange, allez dans Business Rules et cliquez sur Create New Rule dans le coin supérieur droit.
-
Saisissez un nom de règle et sélectionnez l'entité pour les champs configurés pour le plugin Infoblox BloxOne, puis configurez la requête en fonction de vos besoins. Voici un exemple qui récupère les applications contenant Akamai dans le nom de l'application.

-
Cliquez sur Save.

Configurer les actions Risk Exchange pour Infoblox BloxOne
L'InfoBlox BloxOne prend en charge les actions suivantes :
- Update Application Status: Mettre à jour le statut de l'application mettra à jour le statut de l'application.
- No Action: Aucune action ne sera effectuée pour cette action. Les utilisateurs peuvent générer des alertes dans CTO en utilisant cette action et en activant le bouton de bascule de génération d'alertes.
Mettre à jour le statut de l'application
- Dans Risk Exchange, allez à Actions et cliquez sur Add Action Configuration.
- Select la règle métier requise, votre configuration de plugin et l'action Mettre à jour le statut de l'application dans leurs menus déroulants respectifs.
- Activez le bouton de bascule Exiger une approbation si une approbation est nécessaire avant d’effectuer une action sur les applications.
- Cliquez sur Save.
No Action
- Dans Risk Exchange, allez à Actions et cliquez sur Add Action Configuration.
- Select la règle métier requise, votre configuration de plugin et l'action Aucune action dans leurs menus déroulants respectifs
- Enable the Generate Alert toggle to generate alerts in the Ticket Orchestrator module.
- Activez le bouton de bascule Require Approval si une approbation est nécessaire avant d'effectuer une action sur les périphériques.
- Cliquez sur Save.
Dépannage du plugin Infoblox BloxOne
Impossible d'extraire des données
Si vous ne parvenez pas à récupérer les périphériques et les applications du plugin CRE Infoblox BloxOne, cela peut être dû à l'une de ces raisons :
- Aucun périphérique ou application présent sur la plateforme.
- Une erreur a été reçue lors de l'extraction des périphériques et des applications de la plateforme.
- Le mappage n'est pas ajouté lors de la configuration du plugin dans la page source de l'entité.
What to do:
- Vérifiez sur la plateforme InfoBlox BloxOne si des périphériques ou des applications existent ou non.
- Réception d'une erreur 500 : Le serveur est peut-être en panne, attendez un peu et vérifiez plus tard.
- Erreur 401 reçue : la clé API fournie dans le paramètre de configuration du plugin est invalide ou expirée.
- Assurez-vous que le mappage est ajouté et que le champ ID de périphérique est mappé pour l'entité Périphérique, et que le Nom de l'application est mappé pour l'entité Application.
Impossible d'afficher les détails des périphériques ou des applications sur la page des enregistrements
Si vous ne parvenez pas à voir les détails des périphériques et des applications dans le tableau des enregistrements, cela peut être dû à l'une des raisons suivantes :
- Le mappage de tous les champs Infoblox BloxOne n'a pas été fourni lors de la configuration du plugin Infoblox BloxOne.
- Les périphériques ou applications extraits sont affichés dans une ligne avec des valeurs séparées par des virgules.
What to do:
- Assurez-vous que les mappages nécessaires ont été fournis lors de la configuration du plugin.
- Assurez-vous que les champs créés dans une entité sont conformes aux mappages recommandés.

