Plugin Kolide By 1Password pour Risk Exchange

Ce document explique comment configurer le plugin Kolide v1.0.0 avec le module Risk Exchange sur la plate-forme Netskope Cloud Exchange. Ce plugin est utilisé pour récupérer les utilisateurs provisionnés et déprovisionnés. Les utilisateurs provisionnés sont récupérés à partir de la page People et les périphériques sont récupérés à partir de la page Devices de Kolide.

Ce plugin prend également en charge l'enrichissement des enregistrements de périphériques avec les comptes de problèmes ouverts et l'état de conformité des périphériques (via le flux Kolide Shared Signals Framework). Ce plugin prend en charge l'action Manage Device Group pour ajouter des périphériques à un groupe de périphériques Kolide ou en supprimer. Ce plugin ne prend en charge l'exécution d'aucune action sur l'entité des utilisateurs.

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.
• Connectivité à une instance Kolide By 1Password.

Prise en charge du plugin Kolide By 1Password

Ce plugin est utilisé pour récupérer les utilisateurs approvisionnés et déapprovisionnés. Les utilisateurs approvisionnés sont récupérés depuis la page « People » et les périphériques sont récupérés depuis la page « Devices » dans Kolide. Il permet également d'enrichir les enregistrements de périphériques avec le nombre de problèmes ouverts et l'état de conformité des périphériques (via le flux du Kolide Shared Signals Framework). Ce plugin prend en charge l'action « Manage Device Group » pour ajouter des périphériques à un groupe de périphériques Kolide ou en supprimer. Ce plugin ne prend en charge aucune action sur l'entité de l'utilisateur.

Mises en correspondance

Les mappages sont utilisés pour afficher les utilisateurs et les périphériques extraits ainsi que leurs détails respectifs. Les champs mappés lors de la configuration du plugin seront visibles sur la page Records une fois les données extraites. Voici les mappages suggérés à utiliser lors de la configuration du plugin.

Pull Mapping pour périphérique

Cartographie en mode "pull" pour les utilisateurs

Permissions

La clé d'API doit disposer des autorisations répertoriées ci-dessous :

• Gérer les groupes de périphériques
• Gérer les flux du Shared Signals Framework

{
    "organization_id": 6064,
    "organization_name": "Netskope Sandbox"
}

{
    "data": [
        {
            "id": "500001",
            "name": "Alex Carter",
            "email": "alex.carter@netskope.com",
            "created_at": "2026-07-01T06:41:15.653Z",
            "last_authenticated_at": null,
            "has_registered_device": true,
            "usernames": [
                "alex.carter@netskope.com"
            ]
        },
        {
            "id": "500002",
            "name": "Jordan Reyes",
            "email": "jordan.reyes@netskope.com",
            "created_at": "2026-07-14T09:07:15.804Z",
            "last_authenticated_at": null,
            "has_registered_device": false,
            "usernames": [
                "jordan.reyes@netskope.com"
            ]
        }
    ],
    "pagination": {
        "next": "",
        "next_cursor": "",
        "current_cursor": "",
        "count": 2
    }
}

{
    "data": [
        {
            "id": "500101",
            "name": "Morgan Lee",
            "email": "morgan.lee@netskope.com",
            "created_at": "2026-04-16T18:14:42.954Z",
            "last_authenticated_at": null,
            "has_registered_device": false,
            "api_url": "https://api.kolide.com/people/500101"
        },
        {
            "id": "500102",
            "name": "Taylor Kim",
            "email": "taylor.kim@netskope.com",
            "created_at": "2026-04-30T13:13:56.248Z",
            "last_authenticated_at": null,
            "has_registered_device": false,
            "api_url": "https://api.kolide.com/people/500102"
        }
    ],
    "pagination": {
        "next": "",
        "next_cursor": "",
        "current_cursor": "",
        "count": 2
    }
}

{
    "data": [
        {
            "id": "700001",
            "name": "WKS-LNX-01",
            "registered_at": null,
            "last_authenticated_at": null,
            "last_seen_at": "2026-07-15T07:18:14.000Z",
            "registered_owner_info": {
                "identifier": "",
                "link": null
            },
            "operating_system": "Ubuntu 20.04.6 LTS (Focal Fossa)",
            "hardware_model": "Generic Desktop",
            "serial": "SN-7F3A9C21B6D4",
            "hardware_uuid": "3F2A9B10-55C4-4E7A-9D21-8B6C4F0A1234",
            "note": null,
            "auth_state": "Good",
            "will_block_at": null,
            "product_image_url": "https://assets1.kolide.com/assets/inventory/devices/generic-desktop.png",
            "auth_configuration": null,
            "device_type": "Linux",
            "form_factor": "computer"
        },
        {
            "id": "700002",
            "name": "WKS-WIN-02",
            "registered_at": "2026-07-17T12:26:12.469Z",
            "last_authenticated_at": null,
            "last_seen_at": "2026-07-20T04:29:58.000Z",
            "registered_owner_info": {
                "identifier": "500001",
                "link": "https://api.kolide.com/people/500001"
            },
            "operating_system": "Microsoft Windows 11 Enterprise",
            "hardware_model": "Generic Laptop",
            "serial": "SN-4B2E7A88F310",
            "hardware_uuid": "9C1D4E20-77A5-4B3E-8F12-1A2B3C4D5E6F",
            "note": null,
            "auth_state": "Good",
            "will_block_at": null,
            "product_image_url": "https://assets1.kolide.com/assets/inventory/devices/generic-laptop.png",
            "auth_configuration": {
                "device_id": "700002",
                "authentication_mode": "anyone",
                "person_groups": []
            },
            "device_type": "Windows",
            "form_factor": "computer"
        }
    ],
    "pagination": {
        "next": "",
        "next_cursor": "",
        "current_cursor": "",
        "count": 2
    }
}

{
    "data": [
        {
            "id": "460604372",
            "issue_key": null,
            "issue_value": null,
            "title": "Primary Disk Is Low on Free Space",
            "value": {
                "path": "/",
                "device": "/dev/mapper/ubuntu--vg-ubuntu--lv",
                "available_gb": "18.541535232",
                "current_os_version": "20.04.6 LTS (Focal Fossa)",
                "KOLIDE_CHECK_STATUS": "FAIL",
                "available_percentage": "32.5980107815046"
            },
            "exempted": false,
            "resolved_at": null,
            "detected_at": "2026-07-03T11:51:49.799Z",
            "blocks_device_at": null,
            "device_information": {
                "identifier": "700001",
                "link": "https://api.kolide.com/devices/700001"
            },
            "check_information": {
                "identifier": "15806",
                "link": "https://api.kolide.com/checks/15806"
            },
            "last_rechecked_at": "2026-07-15T07:03:31.000Z"
        }
    ],
    "pagination": {
        "next": "https://api.kolide.com/issues?per_page=2&cursor=NDY0MzQ2Mzc4LDQ2NDM0NjM3OA==",
        "next_cursor": "NDY0MzQ2Mzc4LDQ2NDM0NjM3OA==",
        "current_cursor": "NDU5ODk4MzUwLDQ1OTg5ODM1MA==",
        "count": 1
    }
}

{
    "data": [
        {
            "id": "1389",
            "created_at": "2026-07-02T06:55:55.272Z",
            "name": "CRE Netskope",
            "description": "",
            "members_count": 1
        },
        {
            "id": "1403",
            "created_at": "2026-07-19T17:48:10.668Z",
            "name": "Non-Compliant Devices",
            "description": "Kolide Non-Compliant Devices",
            "members_count": 1
        }
    ],
    "pagination": {
        "next": "",
        "next_cursor": "",
        "current_cursor": "",
        "count": 2
    }
}

{
    "device_ids": ["700001", "700002"]
}

[
    {
        "device_id": 700001,
        "group_id": 1389
    },
    {
        "device_id": 700002,
        "group_id": 1389
    }
]

{
    "device_id": 700001,
    "group_id": 1389
}

{
    "name": "Netskope CE Kolide Plugin (<plugin configuration name>)",
    "delivery": {
        "method": "urn:ietf:rfc:8936"
    },
    "events_requested": [
        "https://schemas.openid.net/secevent/caep/event-type/device-compliance-change"
    ]
}

{
    "id": "1",
    "iss": "https://api.kolide.com",
    "stream_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "name": "Netskope CE Kolide Plugin (<plugin configuration name>)",
    "delivery_type": "poll",
    "spec_version": "draft",
    "enabled": true,
    "poll_bearer_token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "events_supported": [
        "https://schemas.openid.net/secevent/caep/event-type/device-compliance-change"
    ],
    "events_requested": [
        "https://schemas.openid.net/secevent/caep/event-type/device-compliance-change"
    ],
    "events_delivered": [
        "https://schemas.openid.net/secevent/caep/event-type/device-compliance-change"
    ],
    "created_at": "2026-01-23T21:45:43.998Z",
    "updated_at": "2026-01-23T21:45:43.998Z",
    "delivery": {
        "method": "urn:ietf:rfc:8936"
    }
}

{
    "sets": {
        "abc123-uuid": "eyJhbGciOiJSUzI1NiIsInR5cCI6InNlY2V2ZW50K2p3dCJ9..."
    }
}

{
    "ack": ["abc123-uuid"]
}

202 Accepted

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 récupérant 500k périphériques et utilisateurs.

Agent utilisateur

netskope-ce-6.1.0-cre-kolide-v1.0.0

Workflow

1. Obtenez votre jeton secret sur Kolide By 1Password.
2. Configurer le plugin Kolide.
3. Configurer une règle de gestion Risk Exchange.
4. Configurer les actions Risk Exchange.
5. Validez le plugin.

Regardez une vidéo

Cliquez sur "play" pour regarder une vidéo :

Obtenez votre jeton secret sur Kolide by 1Password

1. Connectez-vous à votre instance Kolide By 1Password et accédez à Account > Settings.

   

2. Click Developers and open the API Keys page.

   

3. Cliquez sur Create New Key.

   

4. Saisissez le nom de la clé et le contact principal selon vos besoins, et accordez ces autorisations :

   • Gérer les groupes de périphériques
   • Gérer les flux du Shared Signals Framework

   

5. Cliquez sur Save, puis copiez le jeton secret, car il sera utilisé comme clé API lors de la configuration du plugin.

Configurer le plugin Kolide

1. Dans Cloud Exchange, allez sur Settings > Plugin Store. Recherchez et sélectionnez le plugin Kolide v1.0.0 (CRE).

   

2. Saisir un nom de configuration de plugin et modifier l’intervalle de synchronisation si nécessaire.

   

3. Cliquez sur Next et entrez les paramètres de configuration : 

   • API Token: Jeton secret Kolide utilisé pour authentifier toutes les requêtes d'API. Le jeton doit être au format k2sk_v1_<secret>. Utilisez le jeton secret que vous avez obtenu précédemment.
   • Fetch Deprovisioned People: Lorsqu'il est défini sur Yes, les utilisateurs désaffectés (supprimés/désactivés) sont récupérés avec les utilisateurs actifs et marqués avec l'attribut Is Deleted défini sur true; les utilisateurs actifs sont marqués Is Deleted false. Lorsqu'il est défini sur No, seuls les utilisateurs actifs sont récupérés.
   • Fetch Open Issues: Lorsqu'il est défini sur Yes, tous les problèmes de conformité ouverts sont récupérés à partir de Kolide et renseignent les champs Open Issues Count et Issue Title sur les enregistrements de périphériques. Lorsqu'il est défini sur No, les problèmes ouverts ne sont pas récupérés.
   • Fetch Compliance Status: Lorsqu'il est défini sur Yes, l'état de conformité du périphérique est récupéré à partir du flux SSF (Shared Signals Framework) de Kolide et remplit le champ Compliance Status sur les enregistrements de périphériques ; un flux SSF est créé automatiquement lors de la première utilisation. Lorsqu'il est défini sur No, l'état de conformité n'est pas récupéré.

   

4. Cliquez sur Next et sélectionnez l'entité requise dans le menu déroulant Entity. Fournissez les correspondances de champs selon vos besoins. Vous pouvez créer une nouvelle entité en cliquant sur Add New Entity.

   

   Pour créer un champ New, cliquez sur Add Field.

   

   Fournissez l'étiquette de champ, le type de données, la normalisation et la stratégie d'agrégation selon vos besoins, puis cliquez sur Save.

   

   Map the created fields:

   

   

   

   Reportez-vous à la section Mappings avant de configurer le plugin.

5. Cliquez sur Save.

   

Configurer une règle de gestion de Risk Exchange pour le plugin Kolide

1. Allez à Risk Exchange > Business Rules et cliquez sur Create New Rule.

2. Saisissez un nom de règle. Select l'entité pour les champs configurés dans le plugin Kolide, et configurez la requête en fonction de vos exigences. Cet exemple filtre les données récupérées à partir du plugin.

   

3. Cliquez sur Save.

   

Configurer les actions Risk Exchange pour le plugin Kolide

Le plugin Kolide prend en charge les types d'action suivants :

• Manage Device Groups: ajouter ou supprimer des périphériques du groupe sur Kolide par 1Password.
• No ActionAucune action ne sera effectuée pour cette action. Vous pouvez générer des alertes UBA dans Ticket Orchestrator en utilisant cette action et en activant l'option « Générer des alertes » .

Gérer les groupes de périphériques

1. Allez à Risk Exchange > Actions et cliquez sur Add Action Configuration.
2. Select la règle métier, la configuration du plugin cible et l'action requises dans leurs listes déroulantes respectives.
3. Activez le bouton de bascule Require Approval si une approbation est nécessaire avant d'effectuer une action sur les enregistrements extraits. Notez que si Require Approval est activé, vous devez approuver manuellement l'exécution de chaque action depuis la page Risk Exchange > Action Logs dans Cloud Exchange.
4. Définissez les paramètres d'action suivants :
   • Action Type: Indique si des périphériques doivent être ajoutés au groupe ou en être supprimés.
   • Device Group Name: Select le groupe de périphériques Kolide à gérer. Notez que seul le mappage statique est pris en charge pour ce champ.
   • Device IDs: Identifiants de périphérique à ajouter ou à retirer du groupe. Select le champ source de l'identifiant de périphérique Kolide ou fournissez des identifiants de périphérique séparés par des virgules.
5. Cliquez sur Save.

No Action

1. Allez à Risk Exchange > Actions et cliquez sur Add Action Configuration.
2. Select la règle de gestion, la configuration et l'action requises dans leur liste déroulante respective.
3. Activez le bouton de bascule Require Approval si une approbation est nécessaire avant d'effectuer une action sur les enregistrements extraits. Notez que si Require Approval est activé, vous devez approuver manuellement l'exécution de chaque action depuis la page Risk Exchange > Action Logs dans Cloud Exchange.
4. Cliquez sur Save.

Valider le plugin Kolide

Valider dans Cloud Exchange

Aller à Risk Exchange > Records. Select l'entité sélectionnée lors de la configuration du mappage de champs pour afficher les enregistrements récupérés.

Pour vérifier les journaux relatifs aux enregistrements tirés, allez sur Logging et appliquez le filtre avec le nom du plugin ou le nom de la configuration du plugin.

Journaux pour l'action de gestion des groupes de périphériques effectuée :

Lorsqu’un enregistrement extrait correspond à l’une des règles de gestion configurées, l’action configurée est exécutée sur l’enregistrement. Cela peut être consulté à l’adresse Risk Exchange > Action Logs.

Valider dans Kolide

Pour valider les périphériques et les utilisateurs disponibles sur Kolide par 1Password :

Dans votre périphérique Kolide By 1Password, accédez à Devices pour afficher les périphériques enregistrés et non enregistrés.

Cliquez sur l'un des périphériques pour afficher ses détails.

De même, pour afficher les utilisateurs provisionnés, accédez à People.

Valider l'action Gérer les groupes de périphériques

Pour valider l'action Gérer les groupes de périphériques, accédez à Devices et filtrez les périphériques avec le nom de groupe utilisé lors de la configuration de l'action.

Dépannage du plugin Kolide

Impossible de configurer le plugin Kolide

Ce problème peut être dû à un jeton API non valide ou à un jeton API doté de permissions insuffisantes.

What to doVérifiez que le jeton API fourni est correct et qu'il dispose de toutes les autorisations nécessaires. Reportez-vous à la section Générer la clé API.

L’état de conformité ou l’e-mail d’utilisateur sur les périphériques cesse de se mettre à jour

Si l'état de conformité ou l'e-mail de l'utilisateur cesse de se mettre à jour sur les périphériques, cela peut être dû à l'une des raisons suivantes :

• Le flux SSF Kolide a été supprimé ou a expiré du côté de Kolide.
• Aucun événement de modification de la conformité n’a été transmis pour le périphérique pendant le cycle d’interrogation ; dans ce cas, le champ demeure inchangé et n’est pas effacé.

What to do:

1. Vérifiez les journaux du plugin pour trouver un message de recréation de flux ; le plugin crée automatiquement un flux de remplacement en cas d'échec de l'interrogation et réessaie une fois.
2. Veuillez noter que les modifications de conformité survenant pendant l'intervalle entre l'échec de l'ancien flux et la création du New flux ne sont pas rétrospectives : déclenchez une nouvelle modification de conformité dans Kolide pour confirmer que la mise à jour s'effectue à nouveau.

La configuration du plugin ne s'enregistre pas lorsque l'option Fetch Compliance Status est activée

Si la configuration du plugin ne s'enregistre pas lorsque Fetch Compliance Status est défini sur Yes, cela peut être dû à l'une de ces raisons :

• Le jeton d’API n’a pas l’autorisation de gérer les flux SSF dans Kolide.
• Kolide a rejeté la demande de création de flux SSF.

What to do:

1. Confirmez que la clé d'API a été créée avec un accès aux points de terminaison de gestion des flux SSF. Reportez-vous à la section Générer la clé d'API.
2. Réessayez d’enregistrer la configuration ; si l’échec persiste, définissez Fetch Compliance Status sur No et réactivez-la une fois l’accès à la gestion des flux confirmé.

Comportements connus

• La désactivation d'une configuration de plugin conserve son flux Kolide SSF et ses identifiants stockés ; le flux est supprimé de Kolide uniquement lorsque la configuration du plugin elle-même est supprimée.
• Si le flux Kolide SSF est supprimé manuellement de l'interface utilisateur de Kolide, lors du prochain intervalle de synchronisation, le plugin créera un New flux Kolide SSF, mais avec ce nouveau flux, il ne récupérera pas les anciennes données. Il s'agit d'un comportement de la plateforme.