Work with Portal Users & Permission Groups
Table of Contents
A Portal User refers to a Customer (or Contact associated with a Customer), who has access to the Portal. A Portal User consists of an email or username, a password, an optional MFA configuration, and a Portal Permission Group.
Create Portal Users
There are three ways to create individual Portal Users, described below. (You can also Bulk Manage Portal Users.)
As Part of Creating a New Contact
When you're manually creating a new Contact, you have the option to create a Portal User:
When you check the Enable Portal User box, Syncro displays additional fields relevant to Portal Users (highlighted above).
Note: If the Contact does not have an email and you check the Enable Portal User box, three fields appear. In Portal Login Override, enter a username. If you enter a non-email username, you can then create a Portal User Password. However, if you enter an email address in Portal Login Override, the password fields disappear and you can send or reset the password after saving.
Click Save to save the Portal User, then click Save (at the top) to save your Contact.
See also: Contact Fields Reference and and About Portal User Permission Groups.
From an Existing Customer's Details Page
For existing Customers, follow these steps to create a Portal User:
- Click the Customers tab, then click the hyperlinked Name/Business to open their Customer Details Page.
- In the Portal Users section click +New:
Syncro adds a Portal User for the Customer, with a default Login:
Tips: Click into the Customer/Contact field to select from available options. Click into the Login field to change the login to a friendly username or email address.
- Click the caret to expand the Portal Users section:
- Provide a password that meets the criteria specified. (Syncro will change each requirement icon from gray to green when the password meets that criterion.)
- Use the Portal Group dropdown menu to change the Portal User Permission Group:
Note: While you should make a selection here, you can adjust the Portal Group at any time in the Portal User Permission Group Settings. - Optionally check the "Require MFA For This User" box. Customers will be prompted to set up MFA the next time they log in to the Portal. No additional action on your end is needed.
- If desired, click Send Registration Email Invitation. Syncro sends an email about the Portal User creation to the selected Customer or Contact's email address, with you BCC'd:
Tip: You can customize the email template used for this invitation under Admin > PDF/Email Templates > Email Templates.
- You must also click Update Portal User to save your changes.
As Part of Creating a New Customer
When you're manually creating a new Customer, you have the option to create a Portal User in the Customer Settings section:
When you check the Enable Portal User box, Syncro displays the fields relevant to Portal Users (highlighted above).
When you save your new Customer, the Portal Users section displays in your Customer's Details Page as described From a Customer's Details Page. You can follow the steps described there to complete the fields.
See also: Customer Fields Reference and About Portal User Permission Groups.
Changing a Portal User Password
If your customer has forgotten the password for their Portal, they can click the “Forgot your password?” link on the login page and Syncro will email them a link to reset their password.
You can also reset a Customer/Contact's Portal User password from the Portal Users section on the Customer's Details Page:
Click the caret, provide a new Password/Password Confirmation, then click Update Portal User.
You can also change a Portal User's password whenever you edit a Customer or Contact. When the Enable Portal User box is checked, Syncro displays a Password Reset button:
Clicking this button expands the area so you can provide a new Password/Password Confirmation.
Click Save Changes (at the top) to update the password for your Customer. Alternatively click Save to update the password for your Contact.
Tips:
- You can send Contacts the same information they'd get if they clicked “Forgot your password?” on the login page by clicking Send Password Reset Link.
- You can customize the email template used for the Password Reset email under Admin > PDF/Email Templates > Email Templates.
About Portal User Permission Groups
Portal User Permission Groups allow you to specify what can be accessed and viewed within the Portal. You then give Portal Users access to their Portal based by adding them to these permission groups. (This functions much like Security Groups do for Users.)
There are initially four Portal User Permission Groups:
- Admin Portal Group: The default in new Syncro accounts; users in this permission group have access to everything in the Portal (i.e. 24 out of 24 possible permissions).
-
Non-Portal User Group: Customers without any explicitly created Portal Users automatically belong to this permission group. Unless you change the permissions, users in this group can only access the Portal and create new Tickets (i.e. 2 out of 18 possible permissions).
IMPORTANT: Since this permission group does NOT require login authentication, we strongly recommend you limit its permissions. - Limited Portal Group: Users in this permission group have limited access to the Portal and its features (i.e. 8 out of 24 possible permissions).
- No Portal Access Group: Users in this permission group have no access to the Portal or any of its features (i.e. 0 out of 24 possible permissions).
Notes:
- If a Customer has no Portal Users, Syncro account users/techs (even Global Admins) who click that customer's “Customer Online Portal” link will have the same Non-Portal User Group permissions.
- The value that appears by default in the Portal Group dropdown when creating a new portal user can be changed. See Modify Existing Portal User Permission Groups for details.
Create a Portal User Permission Group
To create a new Portal User Permission Group, follow these steps:
- Navigate to Admin > Customers - Portal User Permission Groups. Syncro displays the Portal User Permission Groups page:
- Click +New Portal User Permission Group. Syncro displays the New Portal User Permission Group page:
- Name your Portal User Permission Group so you can recognize it in the list.
- Check the boxes next to the permissions you want Portal Users in this permission group to have. See Customer Portal Settings Reference for detailed descriptions of each permission.
Tip: If you want to include most permissions, use the Check All box at the top, then check the boxes for permissions you want to exclude. - Click Create Portal Group. The new Portal User Permission Group appears in the table with the number of possible permissions shown. You can now use it when setting up Portal Users.
Modify Existing Portal User Permission Groups
You can click in the Name field to rename the Limited Portal and No Portal Access Groups:
Note: You can't rename the Admin Portal Group or the Non-Portal User Group.
You can click the More (triple-dot) icon to change the default, Edit, or Copy, or Delete Portal User Permission Groups:
Notes:
- Make Default changes the default value Syncro displays in the Portal Group dropdown whenever someone creates a new Portal User.
- Selecting Edit displays a page similar to the New Portal User Permission Group page, only with your previous choices selected. Make any changes then click Update Portal Group.
- You'll be asked to confirm a deletion. If the portal group is associated with at least one portal user, Syncro will block the deletion. Associate these portal users with an alternate portal user group before retrying.