Security settings, Logo and other customisation for mobile app

Security settings, Logo and other customisation for mobile app

Requirement: 

      Security settings for mobile app is waiting for release in 14830 build version. In addition to this, server side support for separate logo for mobile app is currently under development. Meanwhile, customers are requesting customisations for other areas in the mobile app (say, Landing page after user login needs to be customised). To support all these (irrespective of server version), we have come up with a workaround.

Workaround:

      The required settings are read from a properties file and shared to mobile app in "api/v3/app_resources/properties" (non-login call) api call. Please follow the below steps for this

1. Place the attached mobileappconfig.properties file under ServiceDesk/conf/ folder
2. Place the attached fjar under ServiceDesk/fixes/ folder (Download the fjar file according to the customer build number). If folder isn't available, create one under "ServiceDesk" folder.
3. Restart the service after placing the fjar file.
4. The configured custom properties should be available in the above api call.

Details of the properties file.
  1. #Security related properties are set here. DONOT enter any properties here as these are default properties
    security_allow_paste_option=true
    security_allow_attachment_operations=true
    security_allow_screen_captures=true

    #All custom properties should be entered below with the prefix "custom_". These properties will be returned in api/v3/app_resources/properties under "custom_props" key
    custom_landing_page=Template

    #Place the logo for Mobile under /custom/customimages/ folder with name "Custom_MobileLogo" and extension as png / jpg / jpeg / gif. Enter the extension of the logo file in the below property. If the logo file present, the relative logo url will be returned under "logo_url" key
    custom_logo_extension=png

Sample response:

  2. {
  3.   "result": {
  4.     "logo_url": "/custom/customimages/Custom_MobileLogo.png",
  5.     "security_props": {
  6.       "allow_paste_option": "true",
  7.       "allow_attachment_operations": "true",
  8.       "allow_screen_captures": "true"
  9.     },
  10.     "login_props": {.....},
  11.       "v3_header_supported": true,
  12.       "dynamic_user_addition": true,
  13.       "domain_props": {
  14.         "domain_filtering": false,
  15.         "domain_listing": true,
  16.         "domains_list": []
  17.       },
  18.       "password_encryption": {
  19.         "is_enabled": true,
  20.         "public_key": "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA4kctn+UsbRERdMtlfZ9UQ0uOoxXCc5I1zXOJOBbIAINME9QzXuY0vL+TRQBGdVDViCCHQ57LEJXWx2sXzoM2bqBt1eVhtQ6wwFfZMgADY4bffPhW4zWb1EnHMPCk0l1kh8wHN+RFf8Q7HkB4qsNA6OIRWfvt339ifIZw08iNp2/c+Pj58GsgIFmsBSPw7b2Coc/ZfsxcbH5e0U7oGLKSJXsFYKwRGWKCg/xSTnkVkbCLe0Lcj5YzI/DbBpR6lonv61Qnr00N/tMh7MP0/T817T3A2cgnjlVyebnOMYLrt2ba4HnD0JbJJlXAPLmIkAYoWDOm7D1uuURHGeeJGGCkSQIDAQAB",
  21.         "algorithm_info": {
  22.           "transformation": "fips_compatible"
  23.         }
  24.       },
  25.       "product_info": {
  26.         "release_number": "14.8",
  27.         "product_name": "AdventNet ManageEngine ServiceDesk Plus"
  28.       },
  29.       "forgot_password": {
  30.         "is_enabled": true
  31.       }
  32.     },
  33.     "custom_props": {
  34.       "landing_page": "Template"
  35.     }
  36.   },
  37.   "response_status": {
  38.     "status_code": 2000,
  39.     "status": "success"
  40.   }
  41. }

Fjar details:

Server build version
Fjar file name
14501
custom_mobile_14501.fjar