The New Page landing page for the Knowledge Base is https://product.korbyt.com/help

The new version of this specific article can be found at:  https://product.korbyt.com/help/articles/9965863-content-managers-cms-users-roles-and-abilities

Please update any of your bookmarks to the new Knowledge Base

For assistance on using the new Knowledge Base, we have a Welcome to the New Korbyt Knowledge Base guide

The new Korbyt Product Page also has sections for submitting feedback on system improvements, a view of our Roadmap of upcoming enhancements, and a change log of all updates.

The post Content Managers (CMS Users) Roles and Permissions appeared first on Korbyt Knowledge Base.

The New Page landing page for the Knowledge Base is https://product.korbyt.com/help

The new version of this specific article can be found at: https://product.korbyt.com/help/articles/3697464-managing-end-users-for-desktopinview-mobileandweb

Please update any of your bookmarks to the new Knowledge Base

For assistance on using the new Knowledge Base, we have a Welcome to the New Korbyt Knowledge Base guide

The new Korbyt Product Page also has sections for submitting feedback on system improvements, a view of our Roadmap of upcoming enhancements, and a change log of all updates.

This article reviews how to add new End Users to your your tenant. End Users are the users who will be logging into the Desktop(InView) Application to view Messages or will be Logging into the Mobile & Web Experience to view and interact with their News Feed.

Both the Desktop(InView) and Mobile & Web platforms share the same End User List. If you have an individual who uses both systems they only need to be added once as an End Users.

End Users are different than Content Management System Users (CMS Users) who log directly into the tenant to create and mange communications.  If you are trying to add new CMS Users you should check out the How to Manage CMS Users article

End User Management

To find your End Users in Korbyt

• Click on the Hamburger Menu
  
• Then from the Mega Menu (depending on your services) you can open click on Users in the Desktop Section or the Audience Section
  • If you subscribe to both the Desktop(InView) AND the Mobile, Web, & Email services you can navigate through either path to find your End Users
    
• If you already have End Users in your service they will also be listed on this screen and The Edit, Export User, Impersonate Desktop View, Send Notification and Archive Actions are available.
  
  • Users who no longer access the system are Archived, rather than deleted
    • This maintains the record of previous interactions
  • If a users was Archived and needs to be active again
  • • IF you manually add single users you can not move them back directly, you will need to follow a few steps
      • Find the Archived record, click the Pencil to edit, and change the archived records email and/or user name
        • This will free up the email address and/or user name to be used for a new active user
      • Create a New User record for the person
    • IF you manage users through CSV files, adding them back to the CSV file will create an active user for them again

There are 4 different methods to add End Users to your Korbyt tenant

• Adding a Single Users
• One Time Import Through CSV File
• Schedule Import Through CSV File
• Azure Active Directory Import

Optional First Step – Creating User Attributes

If you will be creating different Audiences in your tenant so that they can receive different messages these audiences can be managed dynamically using User Attributes. The alternative to a Dynamic Audience is one that would have to be managed manually.

If you are using Azure AD Integrations, you can create Audiences from Azure groups

The section at the end of this article reviews How to Create User Attributes

Add A Single User

To add a  single user one at a time follow the steps below:

• In the Users screen described above Click on the Add Users button and Select Single Users
  
•  Fill the required information (*)
  
• Click on the button to Select the Audience.  The Audience section is where all the available audiences can be found. NOTE: An audience must first be created to be available in the list of options.  The steps to create an audience are listed in the next section below.  In this example the audience has already been created.
  
• Click on the Done button to complete selecting the Audience(s)
• Then Click on the Save Button to complete the action of adding a User
• The employee contact is created. The Edit, Export User, Impersonate Desktop View, Send Notification and Archive Actions are available.
  
• The user(s) are then imported and listed in the End User section

Back to Agenda

One-Time Import of a List of Users

To import a list of employees through a One-Time Import follow the steps below:

• In the Users screen described above Click on the Add Users button and Select One Time Import
  

• Click Download Template to get a CSV File with the correct columns and example information
  
• Navigate to the Downloads Folder on your Computer and you will see the template file
• Populate the file with your list of employees and save
  
• Fill in the CSV File with your values
  • first_name: Must contain a value.
  • last_name: Must contain a value.
  • email: Must be a unique value. You can leave this field blank. However, we recommend that you include an email address to ensure the highest degree of reach.
  • username: Must be a unique value. You can leave this field blank
  • phone_mobile: Must be a unique value. If you are loading email address, you can leave this field blank.  If you are using username only, mobile number is required.
  • international_code: This is the country code for mobile phone numbers such as 1 for US numbers. If you load mobile number, this field is required.  Otherwise, you can leave this field blank.
• If you include any user attributes in your CSV import file that are not defined in your Korbyt Anywhere settings such as Department and Location, your file will still load but those attributes will be ignored. See the User Attributes Section of this article
• Back in Korbyt, click on Select CSV file link to select the file.
  
• Locate your completed CSV file, select the file and click Open
  
• Once the file is selected, click on the “Validate and Preview” button.
  
• The Validate and Preview will show the employees on the file.
  • You have the Option to Remove Users who are no longer on the file by checking the box in the upper right
  • This will add new users and archive anyone no longer present on the CSV File
• Review that all info is correct and click on the Import or Cancel button.
  
• The user(s) are then imported and listed in the End User section

Back to Agenda

Scheduled Import of a List of Users

• In the Users screen described above Click on the Add Users button and Select Scheduled Import
  

• Click Download Template to get a CSV File with the correct columns and example information
  
• Navigate to the Downloads Folder on your Computer and you will see the template file
• Populate the file with your list of employees and save
  
• Fill in the CSV File with your values
  • first_name: Must contain a value.
  • last_name: Must contain a value.
  • email: Must be a unique value. You can leave this field blank. However, we recommend that you include an email address to ensure the highest degree of reach.
  • username: Must be a unique value. You can leave this field blank
  • phone_mobile: Must be a unique value. If you are loading email address, you can leave this field blank.  If you are using username only, mobile number is required.
  • international_code: This is the country code for mobile phone numbers such as 1 for US numbers. If you load mobile number, this field is required.  Otherwise, you can leave this field blank.
• If you include any user attributes in your CSV import file that are not defined in your Korbyt Anywhere settings such as Department and Location, your file will still load but those attributes will be ignored. See the User Attributes Section of this article
• Back in Korbyt, click on Select CSV File link to select the file
• In this interface you will be able to select a CSV File from your Media Manager
  • You can Drag and Drop the File into this window if you have not already uploaded the file to Korbyt
• Once the file is selected, click on the “Validate and Preview” button.
  
• The Validate and Preview will show the employees on the file.
  • You have the Option to Remove Users who are no longer on the file by checking the box in the upper right
  • This will add new users and archive anyone no longer present on the CSV File
• Review that all info is correct and click on the Import or Cancel button.
  
• The user(s) are then imported and listed in the End User section
• The File will be re-checked every 24 hours

• To update the Users, Load an updated copy of the CSV File to the Media Manager
  • Make sure to use the same file name, and check the box to Overwrite media if the File already exists
    
  • Now when the schedule runs again and checks the updated file it will add and remove users as you have specified.

Back to Agenda

Creating User Attributes (Optional)

• Creating User Attributes in the settings allows you to apply those attributes to your end users when they are loaded into the system, and you can then create an audience of users based on that attribute rather than manual selection
• This step is optional, but will mean that creating different audiences will be done through manual selection of members
• If you are going to use Attributes, they should be created in the system before End Users are added
• To set User Attributes Navigate to the CMS Settings by clicking the gear icon  in the upper right, then scroll down on the General Tab or  select the Mobile & Web Tab depending on your services
  

• You can then Name your Attribute
  • For example, “Job Title” or “Role” or “Location”
  • What ever the name of the attribute is that will separate your users into groups
• Select the Type
  • This will define the space this information is entered
  • We recommend Lookup as a type with multiple predefined options, you can then define those options that will be available
    • For example, a list of Job Roles, or Locations
  • Boolean as an option when the selection either “Yes or No”
    • For example, If the Employee is a remote worker
  • Defining these attributes in settings will make them available to assign to end users both individually and through CSV file import

Back to Agenda

Importing Users from Azure Active Directory

Korbyt Anywhere provides integration with Azure AD for secure and scalable user management and single sign on, allowing a customer’s employees to login to the Korbyt Anywhere CMS, Desktop, and Mobile applications using
their Azure AD credentials.

This process will require configuring both your Korbyt Tenant as well as your Microsoft Azure services. Your IT Department, as well as Korbyt Professional Services will likely be involved in the process.

This document provides high-level insight into the process steps.

There are three main steps in the setup process:

• Granting Access: In your MS Azure service you must grant Korbyt Anywhere access to the desired Azure AD groups
  • In Azure – Registering an app on the Azure app registration portal
  • In Azure – Confirming permissions for Microsoft Graph on the app
    • Microsoft Graph API permissions are required for integration with Azure AD
    • This article lists the specific Microsoft Graph API Permissions Required by Korbyt
  • In Azure – Obtaining Administrator consent
  • In Azure – Generating a Client Secret
  • Recording the details from these steps as they will be used in Korbyt to create the connection

• Importing Users: Inside Korbyt Anywhere, setting the information so that Korbyt can automatically create a corresponding CMS
  and/or Desktop or Mobile user for each employee it detects in the customer’s designated Azure groups
  • In Korbyt – Enter User Import Parameters
    • Open the Mega Menu, in the  Advanced section select Azure AD
    • Click the pink +Add New Azure Users button and enter the details you established in the first steps
      
    • Click Save
  • In Korbyt – Map Azure Fields to Employee Metadata
    • This will allow you to select the Azure AD Fields you would like to make part of the employee record in Korbyt
      
  • In Korbyt – Filter By Group
    • If specified, the import process will only add users that are members of selected groups. This can be helpful if you have a large number of users and you only wan to import a subset of those uses
    • In the Azure Menu, use the Action to select Filter By Group
      
  • Now Established the Azure AD and Korbyt will communicate periodically to match the users that should be in Korbyt based on the information in your Azure AD.

• Employee Login: Once the import is processed and complete, an employee will be able
  to log in to Korbyt Anywhere using their Azure credentials

Back to Agenda

The post How to Manage End Users of Desktop(InView) or Mobile, Web, & Email appeared first on Korbyt Knowledge Base.

The New Page landing page for the Knowledge Base is https://product.korbyt.com/help

The new version of this specific article can be found at: https://product.korbyt.com/help/articles/0988967-how-to-manage-cms-users-and-user-groups

Please update any of your bookmarks to the new Knowledge Base

For assistance on using the new Knowledge Base, we have a Welcome to the New Korbyt Knowledge Base guide

The new Korbyt Product Page also has sections for submitting feedback on system improvements, a view of our Roadmap of upcoming enhancements, and a change log of all updates.

This article describes the steps to Add, and Manage Individual CMS Users and CMS User Groups (Users who can log into the Content Management System directly).

If you are trying to add Users who only use the Desktop(InView) application, or Users who login to and use the Mobile, & Web Experience please view Managing Users

To access CMS Users Management you need to have Tenant Administrator or Administrator permission in your tenant

Contents of this Article

• Accessing CMS Users
• Adding New CMS Users
• Managing Existing CMS Users
• CMS User Groups
• Azure AD Integration

Accessing CMS Users

• Login to the tenant
• Hover your mouse over the User Profile Outline (or your Profile Picture) in the Upper Right Corner
  
• From the menu that appear, select “Manage Users”.
  
• On the Manage Users window there are two buttons “Add User” or “Manage User groups” or you can search for an existing user.
  
  • Add User = Create a New CMS Users
  • Search = Find and existing CSM users
  • Manage User Groups = A different screen for CMS Users Groups (used to control access)

The Sections below review through the Steps on how to Add Users, Manage an Existing CMS Users, and Manage CMS User Groups

To Add a New Users

• Click on the “Add User” button to add a new user.
• The Add New User window will appear.  On this window the user information has to be entered and the permissions for Signage, Mobile & Web and Desktop can be selected.
  
• Enter the CMS Users information (First Name, Last Name, and Email are required)
• Select the Users Role Type. This determines what role and permissions the new user will have within the tenant.
  
• The User Role Type controls the user’s access to different functions. The general permission for each level is listed here
  • Tenant Administrator = Full access to System and Settings. Can create new CMS Users of any level and can Manage CMS User Groups
  • Administrator =  High Level Access to System and Settings. Can create new CMS Users that are below Administrator Level. Can’t Manage CMS User Groups
  • Approver = No Access to Change System Settings or Players, but can view them. Can Create and Publish content , Can Edit Playlists
  • Content Author = No Access to Change System Settings, Players, or Playlist but can view them.  Can Create content, but have to submit for approval to make it seen
  • Read Only = Can Only view content in system, no edit rights
  • Launchpad(Signage Only) = Can create and publish, but only through approved launchpad templates. Has no access to other sections of the system
  • Please Note: Mobile & Web and Desktop tabs will only be available if your tenant is subscribed to these two features.
  • For CMS Users who should have access to more than one system you have to select their Role in each system separately.
    For a Detailed Description of the Roles see: Content Manager Roles (User Roles)
• Chose between Sending Activation Link or Create Password for Users
• Click Save
• At this point the user is created.

Back to Contents

To Manage an Existing CMS User

• Find the user in the list of current CMS users (you can use the search to find them)
• Once found you can view information about the user (Name, Email, Roles, User Groups, Last Login, Last Update)
• Clicking the Pencil Icon will allow you to Edit the User’s information and role, Clicking the Trashcan will delete
• After Clicking the Pencil you can edit Name, Contact Information, Role
• You can also change the users password, or send the Password reset email to the user

Back to Contents

To Manage CMS User Groups

User Groups are used in the CMS to be able to control access to Folders, and Player Groups based on group membership.
An example use might be limiting a group of of Content Authors for a specific location to only be able to access Layouts that are within a specific folder for that location.  These steps describe how to create and edit group memberships.

• From the CMS Users Screen, Click on the “Manage User Groups” to navigate to the User Groups screen
• Click on the “Add Group” button to add a new group.  This will open a window to Name the Group, provide an optional Description, and select Group Members
  • the Group Name can not contain the words “read only” as this will cause the group to be hidden
    
• After naming your group and selecting members, click Create
• To edit and Existing Group click the Pencil next to it
• This will let you edit the group details (Name, Description) and Add or Remove members
  
  • To add a New Member, check their name on the left
  • To remove a member, click the trash can next to the name on the right
• When done click Save

With CMS User Groups in Place you can now

• Manage Folder Permissions to set which Media Manager folders are accessible to which User Groups
• Manage Media Player Permissions to set which User Groups can see and access different Player Groups

Back to Contents

Azure AD Integration to Import CMS Users

Korbyt Anywhere provides integration with Azure AD for secure and scalable user management and single sign-on, allowing a customer’s employees to login to the Korbyt Anywhere CMS, their Azure AD credentials.

This process will require configuring both your Korbyt Tenant as well as your Microsoft Azure services. Your IT Department, as well as Korbyt Professional Services will likely be involved in the process.

This document provides high-level insight into the process steps.

There are three main steps in the setup process:

• Granting Access: In your MS Azure service you must grant Korbyt Anywhere access to the desired Azure AD groups
  • In Azure – Registering an app on the Azure app registration portal
  • In Azure – Confirming permissions for Microsoft Graph on the app
    • Microsoft Graph API permissions are required for integration with Azure AD
    • This article lists the specific Microsoft Graph API Permissions Required by Korbyt
  • In Azure – Obtaining Administrator consent
  • In Azure – Generating a Client Secret
  • Recording the details from these steps as they will be used in Korbyt to create the connection

• Importing Users: Inside Korbyt Anywhere, setting the information so that Korbyt can automatically create a corresponding CMS  user for each employee it detects in the customer’s designated Azure groups
  • In Korbyt – Enter User Import Parameters
    • Open the Mega Menu, in the  Advanced section, select Azure AD
    • Click the pink +Add New Azure Users button and enter the details you established in the first steps
      
    • Click Save
  • In Korbyt – Filter By Group
    • If specified, the import process will only add users that are members of selected groups. This can be helpful if you have a large number of users and you only wan to import a subset of those uses
    • In the Azure Menu, use the Action to select Filter By Group
      
  • Now Established the Azure AD and Korbyt will communicate periodically to match the users that should be in Korbyt based on the information in your Azure AD.

• Employee Login: Once the import is processed and complete, an employee will be able
  to log in to Korbyt Anywhere using their Azure credentials

Back to Contents

The post How to Manage CMS Users and User Groups appeared first on Korbyt Knowledge Base.