Introducing Custom Permissions for Extensions

Introducing Custom Permissions for Extensions

Many times, it is not required for all users of a portal to be able to use your extension fully. In some cases, it is even important to provide restricted access to an extension's range of capabilities. We are now making it possible in Zoho Desk, through a new functionality called Custom Permissions. 

Custom permissions are a new type of permission that you can provide in the extensions you develop. Using custom permissions, support admins/managers can configure different levels of access to your extension's functionalities, based on the user profiles set in their Zoho Desk portal. 

Enabling Custom Permissions
  1. Open the resources.json file of your extension.
  2. Add the permissions to the json file, as shown below. 
  1. {
  2.     "permissions": [{
  3.         "apiName": "createResolution",
  4.         "displayName": "create Resolution",
  5.         "description": "Able to create the Resolution task",
  6.         "defaultState": true
  7.     }, {
  8.         "apiName": "editResolution",
  9.         "displayName": "edit Resolution",
  10.         "description": "Able to edit the Resolution task",
  11.         "defaultState": false
  12.     }, {
  13.         "apiName": "deleteResolution",
  14.         "displayName": "delete Resolution",
  15.         "description": "Able to delete the Resolution task",
  16.         "defaultState": false
  17.     }]
  18. }

Configuring Custom Permissions
After an admin installs your extension, the custom permissions available are displayed under the PERMISSIONS tab on the extension detail page.




Fetching Details of Custom Permissions
You can fetch the custom permissions configured in an extension, using the following code block. 

  1. ZOHODESK.get('extension.permissions').then(function(permissions){
  2.   console.log(permissions)
  3. }).catch(function(err){
  4.   console.log(err)
  5. });
The response would be in the following format.  
  1. {
  2.   "status": "success",
  3.   "extension.permissions": [
  4.     {
  5.       "apiName": "createResolution",
  6.       "isEnabled": true
  7.     },
  8.     {
  9.       "apiName": "editResolution",
  10.       "isEnabled": false
  11.     },
  12.     {
  13.       "apiName": "deleteResolution",
  14.       "isEnabled": false
  15.     }
  16.   ]
  17. }

For any questions or clarifications, contact support@zohodesk.com.

    Access your files securely from anywhere

        Zoho Developer Community




                                  Zoho Desk Resources

                                  • Desk Community Learning Series


                                  • Digest


                                  • Functions


                                  • Meetups


                                  • Kbase


                                  • Resources


                                  • Glossary


                                  • Desk Marketplace


                                  • MVP Corner


                                  • Word of the Day



                                      Zoho Marketing Automation


                                              Manage your brands on social media



                                                    Zoho TeamInbox Resources

                                                      Zoho DataPrep Resources



                                                        Zoho CRM Plus Resources

                                                          Zoho Books Resources


                                                            Zoho Subscriptions Resources

                                                              Zoho Projects Resources


                                                                Zoho Sprints Resources


                                                                  Qntrl Resources


                                                                    Zoho Creator Resources



                                                                        Zoho Campaigns Resources


                                                                          Zoho CRM Resources

                                                                          • CRM Community Learning Series

                                                                            CRM Community Learning Series


                                                                          • Kaizen

                                                                            Kaizen

                                                                          • Functions

                                                                            Functions

                                                                          • Meetups

                                                                            Meetups

                                                                          • Kbase

                                                                            Kbase

                                                                          • Resources

                                                                            Resources

                                                                          • Digest

                                                                            Digest

                                                                          • CRM Marketplace

                                                                            CRM Marketplace

                                                                          • MVP Corner

                                                                            MVP Corner





                                                                              Design. Discuss. Deliver.

                                                                              Create visually engaging stories with Zoho Show.

                                                                              Get Started Now