WithSecure Elements
Collectez l'inventaire des endpoints et les détections de menaces depuis WithSecure Elements
Le connecteur WithSecure Elements permet de centraliser votre inventaire d'endpoints protégés et les détections de menaces identifiées par votre plateforme WithSecure.
Objectif
Le connecteur WithSecure Elements permet de récupérer les informations suivantes :
- Inventaire des endpoints protégés
- Détections de menaces et alertes
- Statut de protection des endpoints
Prérequis
- Accès à WithSecure Elements avec droits API
- Génération des identifiants d'authentification API (Client ID, Client Secret)
Informations à fournir dans OverView
| Champ | Description |
|---|---|
| URL de l'API | URL de l'API WithSecure Elements (ex: https://api.connect.withsecure.com) |
| Identifiant client | ID client pour l'authentification API |
| Secret client | Secret client pour l'authentification API |
Procédure
Générer les identifiants API
- Connectez-vous à la console WithSecure Elements.
- Allez à Management > Organization Settings > API client.
- Cliquez sur Create API client.
- Nommez le client
OverViewavec la description appropriée. - Sélectionnez le scope :
- Read-only : Cochez pour activer l'accès en lecture seule (recommandé pour la surveillance)
- Cliquez sur Create.
- Copiez le Client ID et le Client Secret (le secret ne s'affichera qu'une fois).
Configurer le connecteur dans OverView
- Dans OverView, accédez à Data Sources Settings > Sources.
- Sélectionnez WithSecure Elements et cliquez sur Configure.
- Renseignez les champs requis :
- API URL : https://api.connect.withsecure.com
- Client ID : Client ID généré
- Client Secret : Client Secret généré
- Cliquez sur Test Connection pour vérifier l'authentification.
- Cliquez sur Save Configuration.
Consulter la documentation WithSecure Elements
Permissions requises
Le client API doit utiliser le modèle de permissions basé sur les scopes :
- connect.api.read : Accès en lecture seule à l'API (permet l'accès aux endpoints, détections et statut de protection)
Alternative : import par fichiers via DropPoint
L'accès API décrit plus haut est la méthode recommandée pour ce connecteur. Lorsqu'il n'est pas disponible (réseau cloisonné, version ou licence sans API, export déjà produit par ailleurs), OverView accepte des exports de fichiers, à déposer dans le bucket dédié à WithSecure Elements.
Bucket : s3://withsecure/
Exemple : s3://withsecure/export.csv
La procédure est décrite dans le guide OverView DropPoint : génération des credentials, configuration du client, puis envoi des fichiers depuis l'interface web OverView, l'AWS CLI ou un SDK. Les exemples y sont préremplis avec ce bucket lorsque vous suivez ce lien.