Skip to main content
All CollectionsTechnical Resources
Setting Up a Vanity URL
Setting Up a Vanity URL
Paul Sullivan avatar
Written by Paul Sullivan
Updated over 3 months ago

In This Article

Overview:

A Vanity URL allows you to use a unique URL for your organization's Coconut account, instead of using the standard URL, making the URL more memorable, easier to find, and better reflect your company branding.


For example, if your organization is called ABC Bank, the standard Coconut URL is abcbank.coconutcalendar.com. However, using a Vanity URL, you can customize the URL (e.g., appointments.abcbank.com).

For further information, please contact the customer success group customer.success@coconutsoftware.com.

Setting up Impersonation Permissions:

Before configuring the Microsoft Exchange service account, you will need to download Exchange Management Shell. Exchange Management Shell is used to automate Exchange administration tasks.

Step 1 - Creating a Custom Management Scope:

Creating a scope will allow you to restrict impersonation permission to a list of users instead of allowing impersonation permission for all users within an organization.

Navigate to the location where you installed the Exchange Management Tools folder and select the Exchange Management Shell icon.

To add permissions for a user to impersonate members of a scope (group). At the Exchange Management Shell command-line, enter the command, New-ManagementScope -Name "Coconut Users" -RecipientRoot "coconutcalendar.com/Executives" -RecipientRestrictionFilter "MemberofGroup -eq 'Coconut'", followed by the Enter key.

  • -Name: Enter the name of the management scope you are creating (e.g., Coconut Users).

  • -RecipientRoot: Enter the domain name applied to the RecipientRestrictionFilter.

  • -RecipientRestrictionFilter: Enter a filter using the OPath filter syntax to specify the recipients that are included in the scope, in the above example the filter is specifying members of the group Coconut.

PowerShell 7.1.3Copyright (c) Microsoft Corporation.https://aka.ms/powershellType 'help' to get help.PS /Users/TestUser> New-ManagementScope -Name "Coconut Users"-RecipientRoot "coconutcalendar.com/Executives" -RecipientRestrictionFilter "MemberofGroup -eq 'Coconut'"

Step 2 - Setting Impersonation Permissions for a Group of Users:

To configure impersonation permissions you will need the following:

  • An Exchange Administrator account

  • Domain Administrator permissions to create and assign roles and scopes

  • Exchange management tool to run commands

Navigate to the location where you installed the Exchange Management Tools folder and select the Exchange Management Shell icon.

At the Exchange Management Shell command-line, enter the command, New-ManagementRoleAssignment -name:"Coconut Impersonation" -Role:ApplicationImpersonation -User:service_account@example.com, followed by the Enter key.

  • -Name: Enter the name of the scope (e.g., "Coconut Impersonation").

    • The name's has a maximum character length of 65 characters.

    • Use quotation marks to enclose the name if there are spaces within the name.

  • -Role: Enter the command ApplicationImpersonation to assign impersonation permissions.

  • -User: Enter your service account username.

  • -CustomRecipientWriteScope: The name of the management scope you created in the previous step.

PowerShell 7.1.3Copyright (c) Microsoft Corporation.https://aka.ms/powershellType 'help' to get help.PS /Users/TestUser> New-MangementScope -Name: "Coconut Impersonation"-Role:ApplicationImpersonation -User:service_account@example.com-customRecipientWriteScope: "Coconut Users"

The New-ManagementRoleAssignment command will grant the user (service_account@example.com) impersonation permission for all users in the role group Sales.

Staff Access:

Administrator

  • Configuring Impersonation Permission using Exchange Management Shell

Glossary:

  • Delegate Permissions :

    • Grants the Microsoft Exchange service account the permissions to Read, Create, Respond, Update, and Remove calendar events.

  • Impersonation Permissions :

    • Impersonates or mimics the permission of a user to perform system functions. Instead of using the permissions of the Microsoft Exchange service account.

  • ISO Image File:

    • An ISO Image file that contains the entire contents of a physical CD, DVD, or BD.

Did this answer your question?