Intégrer l'infrastructure Azure via Terraform

Overview

Ce guide vous aidera à intégrer des abonnements ou des locataires Azure à Netskope DSPM (également connu sous le nom de Netskope One DSPM) à l'aide de Terraform. Cela permet à DSPM de découvrir, d'analyser et de classer les activités de votre magasin de données.

Prerequisites

Avant de commencer, assurez-vous que ces outils sont installés et que vous êtes connecté :

• Terraform CLI
• Azure CLI

Pour vous assurer que vous utilisez les dernières versions de ces outils, exécutez les commandes suivantes dans votre terminal :

terraform -version  
az version

Instructions pour le raccordement de l'infrastructure

Ce site workflow commence à Netskope DSPM, se poursuit par des actions dans le terminal sur votre machine locale, et se termine à DSPM pour achever l'installation.

• In the Netskope DSPM console:

  1. Va sur Administration > Infrastructure Connections.

  2. Allez sur l'onglet Azure > Cliquez sur Add Infrastructure >

     • Select Add Subscription pour embarquer un seul abonnement.
     • Select Add Tenant pour intégrer un locataire Azure entier (Root Management Group).

  3. Select Capabilities onglet > Ajustez les onglets en fonction de vos besoins en matière de découverte et de classification.

     Le tableau suivant décrit les capacités disponibles et les autorisations qu'elles incluent :

     Description de la bascule	Details
     Auto-Discover New données Stores	Permet la découverte automatique des nouveaux magasins de données créés (par exemple, SQL Servers, comptes de stockage) afin de garantir que le DSPM soit toujours conscient de vos actifs. Configure le Auto-Discovery Role.
     Autoriser l'accès aux clichés du magasin de données	Permet l'analyse par instantané des magasins de données sur les volumes de disque et la découverte des magasins de données non gérés. Configure le Data Store Snapshot Role.
     Auto-Discover New Abonnements	Permet la découverte automatique et l'intégration des nouveaux abonnements ajoutés au sein du locataire, ce qui garantit l'exactitude de votre liste de comptes.

     (Azure Tenant Onboarding) Auto-Discover New Subscriptions: Cette fonction permet la découverte automatique des abonnements New dans le locataire. Lorsque cette option est activée, Netskope One DSPM détecte et intègre automatiquement les abonnements New au fur et à mesure qu'ils sont ajoutés au locataire.

  4. Cliquez sur Next > Complétez les valeurs suivantes.

     • For Subscription: Saisissez le nom et l'identifiant de l'abonnement.
     • For Tenant: Enter the Tenant Name and ID.

     Field	Value
     Tenant Name	N'importe quelle valeur (utilisée pour identifier votre connexion d'infrastructure dans Netskope DSPM).
     Tenant ID	Obtenez-le à partir de votre console Azure :
     Rôle du compte du service DSPM de Netskope	La valeur par défaut est Netskope DSPM_Role. Notez que cette valeur doit être unique pour chaque locataire intégré.

  5. Select Terraform > Cliquez Download Template.

  6. Ne fermez pas cette fenêtre et laissez-la sur la modale Add Infrastructure pour y revenir plus tard.

• In the Terminal on your local machine:

  1. Accédez au chemin d'accès du fichier ZIP du modèle Terraform (par exemple, cd C:\Users\User\Downloads)

  2. Exécutez la commande unzip (par exemple. unzip file_name.zip)

     • Dans le dossier org extrait, vous trouverez les fichiers Terraform nécessaires.

  3. In the org folder, run terraform init to initialize.

     • Vous verrez Initializing the backend, suivi d'un message de succès.

  4. Exécutez terraform apply pour lancer le script.

     • Terraform affichera un avertissement si vous n'êtes pas connecté ou si vos informations d'identification Azure ne sont pas définies correctement.

  5. Tapez Yes lorsque vous verrez apparaître les ressources créées dans votre dossier org , y compris les valeurs Application ID, Application Secret, et Tenant ID .

     • Une fois l'opération terminée, vous verrez apparaître le message Apply complete! Resources: XX added, 0 changed, 0 destroyed.

  6. Ne fermez pas cette fenêtre et ne la laissez pas sur les valeurs de sortie pour y revenir plus tard.

• In the Netskope Console:

  1. Return to the Add Infrastructure Modal > Copy and paste the output values into the Summary Info fields.

     Champ DSPM de Netskope	Valeur alphanumérique correspondante
     ID de l'application	application_id
     Secret d'application	secret
     Tenant ID	tenant_id

     

  2. Cliquez sur Save > Cliquez sur I’ve already run the template.

Votre abonnement ou locataire Azure est maintenant connecté et Netskope DSPM peut commencer à découvrir les magasins de données.

Reference: Azure Permissions & Roles

Le modèle Terraform configure automatiquement les rôles nécessaires en fonction des capacités que vous avez sélectionnées dans l'interface utilisateur.

All permission details documented here apply equally to:

• Configuration manuelle via le portail Azure
• Déploiements Terraform
• Dépannage et débogage de toute méthode de déploiement

{
    "properties": {
        "roleName": "Netskope One DSPM Core Role",
        "description": "",
        "assignableScopes": [
            "/subscriptions/<AZURE SUBSCRIPTION ID>"
        ],
        "permissions": [
            {
                "actions": [
                    "Microsoft.Authorization/roleAssignments/read",
                    "Microsoft.Authorization/roleDefinitions/read"
                ],
                "notActions": [],
                "dataActions": [],
                "notDataActions": []
            }
        ]
    }
}

Accorder des autorisations pour la validation des rôles

Netskope DSPM a besoin de l'autorisation Application.Read.All pour valider les rôles attribués à l'App/Service Principal et pour effectuer une analyse automatique des erreurs de configuration. Terraform crée l'application, mais vous devez accorder manuellement cette autorisation dans le portail Azure.

1. Allez sur App registrations > Recherchez le Netskope DSPM app créé par le script Terraform (utilisez l'ID de l'application à partir de la sortie du terminal pour le trouver).
2. Va voir API permissions > Select Microsoft Graph.
3. Allez à Application (1) > Cochez la permission Application.Read.All > Cliquez sur Update permissions.
4. Select Grant admin consent for Default Directory pour supprimer l'avertissement.

Résolution des problèmes de permissions

Si vous rencontrez des erreurs après le déploiement, vérifiez que Terraform a bien attribué les rôles correspondant aux capacités que vous avez sélectionnées.

• “Cannot discover and scan data store snapshots due to missing permissions.”
  • Correction : Relancez l'intégration et assurez-vous que Authorize Data Store Snapshots Access est activé, ou attribuez manuellement le Netskope One DSPM Data Store Snapshot Role.
• “Netskope encountered an error while scanning data warehouse ‘XYZ’: Missing required Azure permissions…”
  • Correction : Identifiez l’autorisation manquante dans le journal des erreurs et assurez-vous que votre modèle Terraform est à jour.
• “Insufficient privileges to complete the operation…”
  • Fix: Ensure the Terraform script ran without errors regarding Azure AD Graph permissions (Application.Read.All).