Netskope LogoNetskope Logo
  • Security Services
  • AI Services
  • Networking Services
  • Analytics Services
  • Integrations
  • getting-started.svgGetting Started
    • Support
    • Community
    • Netskope.com
    © 2026 All Rights Reserved. Netskope Inc.
    Home
    Active Directory with Netskope Adapters
    Install and Configure the Netskope Adapters

    Install and Configure the Netskope Adapters

    This document describes the steps to install Netskope Adapters.

    Install Netskope Adapter From Version 216.0.20263.22

    Prerequisite

    Register Directory Importer: If you plan to install or upgrade Directory Importer, register it in your tenant first. Registration gives you the Client ID and Client Secret that the installer asks for. You don’t need to register AD Connector.

    Register Directory Importer

    To register Directory Importer:

    1. Log in to your Netskope tenant as an admin.

    2. Go to Settings > Tools > Directory Tools > On-Prem Integration.

    3. Click Create Directory Importer Credential to register a new Directory Importer instance. 

    4. Enter a name and a description. 

    5. Copy the Client ID and the Client Secret, and store them securely. 

    – Your tenant shows the Client Secret only once. Copy it before you leave the page. If you lose it, generate a new secret from the Directory Importer inventory.
    – Keep your tenant URL, Client ID, and Client Secret ready for the installation.
    – Registration also creates a service account with the predefined Identity Sync Admin role. You don’t create this account yourself. 

    Install Netskope Adapters

    Download the Netskope Adapter file (NSAdapters.msi). To download, log into your Netskope tenant, go to Settings > Tools > Directory Tools > On-Prem Integration and click Download Tools.

    If you are running this installer to upgrade an existing AD Importer installation rather than installing for the first time, back up your configuration and data files first. To learn more, Upgrade the Netskope Adapters. The installation steps provided in the following section is the same for both a fresh install and an upgrade.

    If you upgrade Directory Importer to the new version, register Directory Importer before you upgrade. During the upgrade, the installer lets you reuse existing credentials or enter new ones.

    The new version of Directory Importer supports only OAuth2 authentication. It has no fallback to the legacy connection. To roll back, reinstall the previous version of Directory Importer.

    Refer to the following steps for installation:

    1. Open the NSAdapters.msi file to install Netskope Adapters.

    2. Click Run.

    3. Click Next.

    4. During installation, the system prompts you to enter the username for the installation process. In the Netskope Adapters Setup window enter the User Name and Password.

      Enter the username in the following format <domain-name>\<username>.

    5. When finished, click Next.

    6. Select one or more features to install on your local hard drive. By default, the system selects Directory Importer.

    7. If you want to select AD Connector, follow the instructions:

      1. Click AD Connector.

      2. Toggle the arrow for features and choose Will be installed on local hard drive.

      3. Once your selections are complete, click Install.

    8. If you select Directory Importer, the installer displays a page for your credentials. Enter your Tenant URL, Client ID, and Client Secret.

      If you are upgrading and want to keep your existing credentials, select Reuse existing credentials. This option appears only during an upgrade.

    9. Continue the installation. The installer validates your credentials.

    10. If validation fails, the installer displays a message.

      If a proxy blocks the connection to your tenant, perform one of the following:

      • Select Ignore error and continue, configure the credential later and click OK. You configure the credential later in the Netskope Adaptors Configuration Utility.

      • Click Cancel to stop the installation. The installer applies no changes. 

    11. Click Install.

    The installation process uses the entered username to install the Services. 

    If you encounter the following message, correct the username format in the dialog to <domain-name>\<username>.
    ErrorMessage.png
    You must configure the features at least once before you can start the services.

    Netskope Adapter Prior to Version 216.0.20263.22

    Prerequisite

    Download the Netskope Adapter file (NSAdapters.msi). To download, log into your Netskope tenant, go to Settings > Tools > Directory Tools and click Download Tools.

    If you are running this installer to upgrade an existing AD Importer or AD Connector installation rather than installing for the first time, back up your configuration and data files first. To learn more, Upgrade the Netskope Adapters. The installation steps provided in Install Netskope Adapters are the same for both a fresh install and an upgrade.

    Install Netskope Adapters

    Refer to the following steps for installation:

    1. Open the NSAdapters.msi file to install Netskope Adapters.

    2. Click Run.

    3. Click Next.

    4. During installation, the system prompts you to enter the username for the installation process. In the Netskope Adapters Setup window enter the User Name and Password.

      Enter the username in the following format <domain-name>\<username>.

    5. When finished, click Next.

    6. Select one or more features to install on your local hard drive. By default, the system selects Directory Importer. If you want to select AD Connector, follow the instructions:

      1. Click AD Connector.

      2. Toggle the arrow for features and choose Will be installed on local hard drive.

      3. Once your selections are complete, click Install.

    The installation process uses the entered username to install the Services. 

    If you encounter the following message, correct the username format in the dialog to <domain-name>\<username>.
    ErrorMessage.png
    You must configure the features at least once before you can start the services.
    • Configure Directory Importer
    • Configure AD Connector
    In this Topic
    • Install and Configure the Netskope Adapters