Review user mappings for an external content connector

  • Release version: Xanadu
  • Updated March 20, 2025
  • 2 minutes to read

    • View user and group access permissions retrieved by an external content connector, and see how the connector maps those principals to your ServiceNow AI Platform® instance's users.

    Before you begin

    Role required: ais_admin, plus ais_high_security_admin to view full user mapping details

    About this task

    The User mappings list for an external content connector shows user and group access permissions retrieved from the connector's data source, along with details of how those permissions are mapped to your ServiceNow AI Platform instance's users. Review this information when you want to verify user and group permission mappings for your external content connector.

    To view the user mappings list, you must elevate to the ais_high_security_admin role. If you don't elevate or don't have this role, you can see the number of user mappings created for the external content connector, but can't see details of those user mappings.
    Note:
    Some external content connectors don't retrieve user and group access permissions. You can't run user mapping crawls for these connectors.
    • Predefined web sources external content connector
    • ServiceNow documentation external content connector
    • Slack external content connector

    The Atlassian Confluence Cloud external content connector only maps permissions for Confluence Cloud users who have made their email addresses visible to all users. To allow user mapping, each Confluence Cloud user must set their own email visibility to Anyone as explained in the https://support.atlassian.com/confluence-cloud/docs/configure-user-email-visibility/ Atlassian support resource.

    Procedure

    1. Navigate to All > External Content Connectors > External Content Admin Home.
    2. In the Connectors pane, select the record for the external content connector whose user mappings you want to review.
    3. In the connector editor, select the User mappings tab.
      The User mappings page shows the total count of user mappings created by the external content connector.
    4. Optional: Elevate to the ais_high_security_admin role:
      1. Perform the appropriate action for your version of the UI:
        UI version Action

        Next Experience UI
        In the banner frame, select the icon for your account to open the user menu, then select Elevate role.
        User menu with Elevate role action highlighted in Next Experience UI.
        Core UI In the banner frame, select your name to open the user menu, then select Elevate Roles.
        User menu with Elevate Roles action highlighted in Core UI.
        A dialog box appears, displaying a checklist of your available privileged roles.
        Dialog box displaying privileged roles in Next Experience UI.
      2. In the dialog box, select the ais_high_security_admin option, then select Update (in Next Experience UI) or OK.
        The page reloads and an elevated role indicator appears next to your user name in the user menu. In Next Experience UI, this indicator displays the names of the active privileged roles. In Core UI, the indicator displays the elevated role icon .
        User menu showing elevated role indicator in Next Experience UI.
        Note:
        When the page reloads, any unsaved edits are lost.
    5. Optional: Review the entries in the User mappings list.
      Each entry shows a single ServiceNow AI Platform user along with the external user mapped to them and any external group memberships associated with that external user. You can sort and filter the list to locate entries of interest.