Fine tune access and features with roles and groups within ServiceNow
  • 20 Feb 2025
  • 6 Minutes to read
  • Dark
    Light
  • PDF

Fine tune access and features with roles and groups within ServiceNow

  • Dark
    Light
  • PDF

Article summary

Controlling Feature Access with Roles in ScreenMeet

Summary: This article explains how to enable and configure the "Custom Permission Feature Control" option in ScreenMeet to manage feature access for agents based on assigned roles within ServiceNow. This allows administrators to granularly control which products and features agents can utilize.

Prerequisites:

  • You must have administrator access to your ServiceNow instance.
  • You must have the necessary ScreenMeet product licenses in place.
  • Familiarity with assigning roles to users and groups in ServiceNow.

Configuration Steps:

  1. Enable Custom Permission Feature Control:

    • In ServiceNow, use the global search to navigate to sys_properties.list.

image.png

* Search for the property named x_prois_sm.control_features_with_roles.

* Change the Value field from false to true.
* Click Update.

  1. Assign Roles to Users or Groups:

    • Determine the specific features you want to enable or disable for agents.
    • Identify the appropriate ScreenMeet roles (see the table below).
    • Assign the roles directly to individual users or to ServiceNow groups. It's recommended to use groups for easier management.
    • To assign roles to a user:
      • Navigate to User Administration > Users.
      • Select the user you want to modify.
      • In the Roles related list, click Edit.
      • Add the desired ScreenMeet roles to the Roles List.
      • Click Save.
    • To assign roles to a group:
      • Navigate to User Administration > Groups.
      • Select the group you want to modify.
      • In the Roles related list, click Edit.
      • Add the desired ScreenMeet roles to the Roles List.
      • Click Save.

Role Naming Convention:

ScreenMeet roles follow a specific naming convention:

  • Product Access: x_prois_sm.x_feature_[Product_Name]_enabled - Enables the entire product for the user (if licensed).
  • Feature Control: x_prois_sm.x_feature_[Product_Name]_[Feature_Name] - Enables a specific feature within the product.
  • Agent Choice (Optional): x_prois_sm.x_feature_[Product_Name]_[Feature_Name]_agent_choice - Allows the agent to decide whether to use the feature during a session. This is used when the ScreenMeet console offers options like "Never," "Always," or "Let Agent Decide." ServiceNow roles only support "Enabled" or "Disabled," so this allows for the "Let Agent Decide" functionality.

Role Table:

ProductFeatureRole NameDescription
CobrowseEnable Productx_prois_sm.x_feature_cobrowse_enabledEnables the Cobrowse product for the agent.
CobrowseConfidential Overlayx_prois_sm.x_feature_cobrowse_confidentialOverlayEnableEnables the confidential overlay feature in Cobrowse.
CobrowseForm Fillx_prois_sm.x_feature_cobrowse_formFillEnables the form fill feature in Cobrowse.
CobrowseHighlighterx_prois_sm.x_feature_cobrowse_highlighterEnables the highlighter feature in Cobrowse.
CobrowseLaser Pointerx_prois_sm.x_feature_cobrowse_laserPointerEnables the laser pointer feature in Cobrowse.
CobrowseLink Scramblingx_prois_sm.x_feature_cobrowse_linkScramblingEnables the link scrambling feature in Cobrowse.
CobrowseRecordingx_prois_sm.x_feature_cobrowse_recordingEnables recording during Cobrowse sessions.
CobrowseRecording - Agent Choicex_prois_sm.x_feature_cobrowse_recording_agent_choiceAllows the agent to decide whether to record the Cobrowse session.
CobrowseRemote Controlx_prois_sm.x_feature_cobrowse_remoteControlEnables remote control during Cobrowse sessions.
CobrowseScreenshotx_prois_sm.x_feature_cobrowse_screenshotEnables the screenshot feature in Cobrowse.
CobrowseSession Storagex_prois_sm.x_feature_cobrowse_sessionStorageEnables session storage during Cobrowse sessions.
CobrowseURL Invitex_prois_sm.x_feature_cobrowse_urlinviteEnables URL-based invitations for Cobrowse sessions.
CobrowseVideo Chatx_prois_sm.x_feature_cobrowse_videoChatEnables video chat during Cobrowse sessions.
LiveEnable Productx_prois_sm.x_feature_live_enabledEnables the Live Sessions product for the agent.
LiveAudiox_prois_sm.x_feature_live_audioEnables audio during Live sessions.
LiveAudio - Agent Choicex_prois_sm.x_feature_live_audio_agent_choiceAllows the agent to decide whether to enable audio during the Live session.
LiveBackground Blurx_prois_sm.x_feature_live_background_blurEnables background blur for video during Live sessions.
LiveBlur Defaultx_prois_sm.x_feature_live_blur_defaultEnables blur default during Live sessions.
LiveChatx_prois_sm.x_feature_live_chatEnables chat functionality during Live sessions.
LiveGuest Change Resolutionx_prois_sm.x_feature_live_guest_change_resolutionAllows the guest to change the resolution of the Live session.
LiveGuest Invitex_prois_sm.x_feature_live_guest_inviteAllows the guest to invite others to the Live session.
LiveGuest Screen Sharex_prois_sm.x_feature_live_guest_screenshareAllows the guest to share their screen during the Live session.
LiveGuest Videox_prois_sm.x_feature_live_guest_videoEnables video for the guest during Live sessions.
LiveHost Change Resolutionx_prois_sm.x_feature_live_host_change_resolutionAllows the host to change the resolution of the Live session.
LiveHost Create Child Sessionx_prois_sm.x_feature_live_host_create_child_sessionAllows the host to create a child session from the Live session.
LiveHost Invitex_prois_sm.x_feature_live_host_inviteAllows the host to invite others to the Live session.
LiveHost Screen Sharex_prois_sm.x_feature_live_host_screenshareAllows the host to share their screen during the Live session.
LiveHost Videox_prois_sm.x_feature_live_host_videoEnables video for the host during Live sessions.
LiveKnockx_prois_sm.x_feature_live_knockEnables the "Knock" feature (request to join) during Live sessions.
LiveKnock - Agent Choicex_prois_sm.x_feature_live_knock_agent_choiceAllows the agent to decide whether to allow the "Knock" feature.
LiveLaser Pointerx_prois_sm.x_feature_live_laser_pointerEnables the laser pointer feature during Live sessions.
LiveRecordx_prois_sm.x_feature_live_recordEnables recording during Live sessions.
LiveRecord - Agent Choicex_prois_sm.x_feature_live_record_agent_choiceAllows the agent to decide whether to record the Live session.
LiveRecord - Opt Inx_prois_sm.x_feature_live_record_opt_inEnables record opt in during Live sessions.
LiveScreen Annotationsx_prois_sm.x_feature_live_screen_annotationsEnables screen annotations during Live sessions.
LiveStart Audio Enabledx_prois_sm.x_feature_live_start_audio_enabledEnables start audio during Live sessions.
LiveStart Video Enabledx_prois_sm.x_feature_live_start_video_enabledEnables start video during Live sessions.
LiveZoomx_prois_sm.x_feature_live_zoomEnables the zoom feature during Live sessions.
Remote SupportEnable Productx_prois_sm.x_feature_remotesupport_enabledEnables the Remote Support product for the agent.
Remote SupportAuto Loginx_prois_sm.x_feature_remotesupport_autologinEnables Auto Login feature for the agent during the session.
Remote SupportChatx_prois_sm.x_feature_remotesupport_chatEnables chat functionality during Remote Support sessions.
Remote SupportLaser Pointerx_prois_sm.x_feature_remotesupport_laserpointerEnables the laser pointer feature during Remote Support sessions.
Remote SupportPre Request Adminx_prois_sm.x_feature_remotesupport_prerequestadminEnables Pre Request Admin feature for the agent during the session.
Remote SupportPre Request RCx_prois_sm.x_feature_remotesupport_prerequestrcEnables Pre Request RC feature for the agent during the session.
Remote SupportPrivacy Curtainx_prois_sm.x_feature_remotesupport_privacycurtainEnables the Privacy Curtain feature during Remote Support sessions.
Remote SupportRebootx_prois_sm.x_feature_remotesupport_rebootEnables the Reboot feature during Remote Support sessions.
Remote SupportRecordingx_prois_sm.x_feature_remotesupport_recordingEnables recording during Remote Support sessions.
Remote SupportRecording - Agent Choicex_prois_sm.x_feature_remotesupport_recording_agent_choiceAllows the agent to decide whether to record the Remote Support session.
Remote SupportRemote Controlx_prois_sm.x_feature_remotesupport_remotecontrolEnables remote control during Remote Support sessions.
Remote SupportRunx_prois_sm.x_feature_remotesupport_runEnables the Run feature during Remote Support sessions.
Remote SupportSafe Rebootx_prois_sm.x_feature_remotesupport_saferebootEnables the Safe Reboot feature during Remote Support sessions.
Remote SupportScreenshotx_prois_sm.x_feature_remotesupport_screenshotEnables the screenshot feature during Remote Support sessions.
Remote SupportUACx_prois_sm.x_feature_remotesupport_uacEnables the UAC (User Account Control) prompt during Remote Support sessions.
Remote SupportURL Invitex_prois_sm.x_feature_remotesupport_urlinviteEnables URL-based invitations for Remote Support sessions.
Remote SupportWhiteboardx_prois_sm.x_feature_remotesupport_whiteboardEnables the Whiteboard feature during Remote Support sessions.
Remote SupportWindows Toolsx_prois_sm.x_feature_remotesupport_windowstoolsEnables Windows Tools during Remote Support sessions.
ReplayEnable Productx_prois_sm.x_feature_replay_enabledEnables the Replay product for the agent.

Example Configuration:

Let's grant a user permissions to use the Live product and have the option to record the session.

  1. Enable Live Sessions: Assign the role x_prois_sm.x_feature_live_enabled.

  2. Enable Recording Feature: Assign the role x_prois_sm.x_feature_live_record.

  3. Enable Agent Choice for Recording: Assign the role x_prois_sm.x_feature_live_record_agent_choice.

Verification and Testing:

  1. After assigning roles, have the agent log out and log back into ServiceNow.
  2. Verify that the enabled products and features are now available (or unavailable) in the ScreenMeet interface.
  3. If the "Agent Choice" option is enabled for a feature, confirm that the agent can toggle the feature during a session.

Troubleshooting:

  • Changes Not Reflected: Even though the role changes are applied instantly in ServiceNow, agents may need to log out/log back in for the UI to reflect the new roles.
  • Feature Still Unavailable: Double-check that the correct roles are assigned to the user or group. Verify that the ServiceNow user is in the correct group if you are using group-based role assignments.

Was this article helpful?