Get User and Group Information Using Directory Sync

Use the Directory Sync service to retrieve user and group information for Prisma Access.
Prisma Access retrieves user and group information from your organization’s Active Directory (AD) to enforce user- and group-based policy. You can simplify the retrieval of user and group information by using Palo Alto Networks’ Directory Sync service.
In addition to simplifying user and group information retrieval, integrating Directory Sync with Prisma Access can free up the bandwidth and load on your AD. Without Directory Sync integration, all the remote networks and mobile users’ nodes individually communicate with your AD using the service connection.
You can use Directory Sync to retrieve user and group information for Prisma Access for mobile users, remote networks, or both, by completing the following steps.
The Directory Sync integration with Prisma Access has the following implementation restrictions:
  • Azure AD Directory Sync integration is not supported with Prisma Access.
  • Make sure that the groups you use with Directory Sync do not have any of the following special characters, because Prisma Access does not support the use of following special characters in groups and commit operations will fail:
    • " (Double quotes)
    • ' (Apostrophe)
    • < (less than sign)
    • > (greater than sign)
    • & (ampersand)
  • If you associate Directory Sync with Prisma Access, your user and group names must use the NetBIOS format that includes the domain.
    • The username format must use either the email format (
      username
      @
      domain
      ) or be in
      NetBIOS\sAMAccountName
      format.
    • Group names must be in the
      distinguishedName
      format (for example,
      CN=Users,CN=Builtin,DC=Example,DC=com
      ).
  • Directory Sync does not apply any settings you specify in the group include list (
    Device
    User Identification
    Group Mapping Settings
    Group Include List
    ); instead, it retrieves user and group information from your entire configuration, including groups used in all device groups and templates.
  1. Create a Directory Sync instance for Prisma Access, and make a note of the instance name.
    When you activate Directory Sync, it creates an instance. You use the instance name when you associate Directory Sync with Prisma Access in a later step. Optionally, if you need to create a separate instance for Prisma Access, create it and make a note of the instance name.
  2. Set up Directory Sync on your AD.
    This process includes installing and configuring a Directory Sync Agent to communicate with your on-premises Active Directory and configuring mutual authentication between the Directory Sync service and the agent.
    dir-sync-create-directory-sync-instance.png
  3. Associate the Panorama that manages Prisma Access with Directory Sync in the hub.
    Directory Sync integration with Prisma Access is not supported in a multi-tenant environment.
    1. Find the serial number of the Panorama that manages Prisma Access by selecting the
      Dashboard
      and noting the
      Serial #
      that displays.
      dir-sync-panorama-serial-number.png
    2. Log in to the Palo Alto Networks hub and select
      Panorama
      .
      dir-sync-hub-select-prisma-access-dir-sync.png
    3. Find the serial number of the Panorama that manages Prisma Access, select it, then select
      Add Directory Sync
      .
      dir-sync-hub-panorama-sn-add-dir-sync.png
    4. Enter the
      Directory Sync
      instance you retrieved in Step 1.
      You do not need to select the
      Region
      ; Directory Sync uses the same region that Prisma Access uses for Cortex Data Lake.
      dir-sync-initial-mapping-info.png
    5. Click
      OK
      when complete.
    6. (
      Optional
      ) If you need to edit an existing Directory Sync instance after you create it, select
      Prisma Access - DirSync Mapping
      , select the Panorama’s serial number, select
      Edit
      , and enter the following information in the window that displays:
      • Enter a
        Name
        for the Directory Sync - Prisma Access mapping.
      • Optionally, enter a
        Description
        for the mapping.
      • Select the
        Directory Sync
        instance name that you noted in Step 1.
      The
      Region
      and
      Serial Number
      fields populate automatically.
      dir-sync-hub-edit-by-sn.png
      dir-sync-hub-configure-edit-dir-sync-instance-complete.png
  4. Enable Directory Sync on Prisma Access.
    1. On the Panorama that manages Prisma Access, select one of the following tabs:.
      • To configure Directory Sync for Prisma Access for mobile users, select
        Panorama
        Cloud Services
        Configuration
        Mobile Users
        , select the gear icon to edit the settings, then select
        Group Mapping Settings
        .
        dir-sync-mobile-user-group-mapping-settings.png
      • To configure Directory Sync for Prisma Access for remote networks, select
        Panorama
        Cloud Services
        Configuration
        Remote Networks
        , select the gear icon to edit the settings, then select
        Group Mapping Settings
        .
        dir-sync-remote-networks-group-mapping-settings.png
    2. Select
      Enable Directory Sync Integration
      to enable Directory Sync with Prisma Access.
    3. Enter the following information:
      • Enter the
        Primary Username
        (the logon name attribute for the user, such as
        userPrincipalName
        or
        sAMAccountName
        ). This field is required.
      • (
        Optional
        ) Enter the
        E-Mail
        attribute (such as
        mail
        ).
      • (
        Optional
        ) If you use alternate name attributes for the user, enter them. You can enter up to three alternate user names (
        Alternate User Name 1
        ,
        Alternate User Name 2
        , and
        Alternate User Name 3
        ).
    4. Click
      OK
      when complete.
  5. Commit and push (
    Commit
    Commit and Push
    ) your changes.
    dir-sync-commit-and-push.png

Recommended For You