Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Corrected links that should have been relative instead of absolute.

This section lists the prerequisites and steps for applying and verifying this patch.

...

  • Read and Write permissions on all sub-folders and files of .../AdeptiaConnect-<Version>
  • Take backup of launcherapps.properties file from …<ConnectPoratlInstallFolder>\conf…<ConnectPortalInstallFolder>\resources_config location. This backup file will help you replicate the manual changes in case you have done earlier in the launcher.properties file before changes that you may have done in this file in the past before applying this patch. 
  • Take backup of web.xml file from …<ConnectPortal>\conf location. This backup file will help you replicate the manual changes that you may have done in this file in the past before applying this patch.  
  • Take backup of appsof securityContext.propertiesxml file from …<ConnectPortalInstallFolder>ConnectPortal\resources_config\saml location. This  This backup file will help you replicate the manual changes in case changes that you may have done earlier in the apps.properties file before in this file in the past before applying this patch.  
  • Connect Server services are running.
  • Connect Portal service is stopped.
  • Ensure that you have followed the Prerequisites' instructions given on the Upgrade page.

...

In this release, some manual changes are required in Connect Portal.

Changes in

...

  1. Go to …<ConnectPoratlInstallFolder>\conf location.
  2. Open launcher.properties file.
  3. Do the same manual changes in the file that you have done in your previous launcher.properties file (that you had saved as a backup). For example, you may need to update the JVM settings and Truststore location as they are there in the backup file.
  4. Save the file.

Changes in apps.properties file

  1. Go to …<ConnectPortalInstallFolder>\resources_config location.

  2. Open apps.properties file.
  3. Search for Below the Dropbox app Facebook section and replace the code block for the existing two properties with the updated one given below:

    Code Block
    titleDropbox
    dropbox.refreshToken=https://api.dropboxapi.com/oauth2/token
    dropbox.authorizationValueMap=response_type$code,token_access_type$offline

    Add in the file, add the following code block for Zoho CRM next to the QuickBooks section:Microsoft Azure.

    #Zoho Crm zohocrm
    Code Block
    language
    titleZoho CRM
    css
    themeMidnight
    microsoftazure.appKey=
    zohocrmmicrosoftazure.appKeySecret=
    zohocrmmicrosoftazure.oauthVersion = 2.0
    zohocrmmicrosoftazure.oauth20.accessToken refreshToken=  https://accountslogin.zohomicrosoftonline.com/oauth{domain}/oauth2/v2.0/token
    zohocrmmicrosoftazure.oauth20.authorize = https://accountslogin.zohomicrosoftonline.com/oauth{domain}/oauth2/v2.0/authauthorize
    zohocrm.refreshToken microsoftazure.oauth20.accessToken=https://accountslogin.zohomicrosoftonline.com/{domain}/oauthoauth2/v2.0/token
    microsoftazure.SecretId=
    zohocrmmicrosoftazure.authorizationValueMapscope=responseopenid offline_type$code,access_type$offline
    zohocrm.refreshTokenValueMap=N/A
    zohocrm.accessTokenValueMap=N/A
    zohocrm.scope = ZohoCRM.settings.modules.ALL,ZohoCRM.settings.ALL,ZohoCRM.modules.ALL,ZohoCRM.users.ALL
  4. Search for the Sage One app section and replace the code block for the existing three properties with the updated one given below:

    Code Block
    titleSage One
    sageone.oauth20.accessToken=https://oauth.accounting.sage.com/token
    sageone.oauth20.authorize=https://www.sageone.com/oauth2/auth/central
    sageone.refreshTokenValueMap=N/A
  5. Search for the FreshBooks app section and do the followings:

  6. Replace the code block, freshbooks.oauthVersion=1.0with the updated one given below:

    Code Block
    titleFreshBooks
    freshbooks.oauthVersion=2.0
  7. Add the following code block for the four new properties just below freshbooks.oauthVersion=2.0

    Code Block
    titleFreshBooks
    freshbooks.oauth20.requestToken=https://api.freshbooks.com/auth/oauth/token
    freshbooks.oauth20.authorize=https://my.freshbooks.com/service/auth/oauth/authorize
    freshbooks.oauth20.accessToken=https://api.freshbooks.com/auth/oauth/token
    freshbooks.refreshToken = https://api.freshbooks.com/auth/oauth/token
  8. Save the file.
  9. Restart the Connect Portal
     https://storage.azure.com/user_impersonation
    microsoftazure.enableProduction=true


  10. Save the file.
  11. Restart the Connect Portal.

Changes in Web.xml file

  1. Go to the location …<ConnectPortal>\conf.
  2. Open the web.xml file in a text editor.
  3. In the filter section, add the following code snippet just after the </init-param> tag that follows <param-value>SAMEORIGIN</param-value>

    Code Block
    languagecss
    themeMidnight
    <init-param>
    <param-name>hstsMaxAgeSeconds</param-name>
    <param-value>31536000</param-value>
    </init-param>
    <init-param>
    <param-name>hstsIncludeSubDomains</param-name>
    <param-value>true</param-value>
    </init-param>


  4. Save the file.

Changes in securityContext.xml

  1. Go to ConnectPortal\resources_config\saml location.

  2. Open securityContext.xml file.

  3. Update the xsi:schemaLocation attribute as shown in the following code snippet. 

    Code Block
    languagecss
    themeMidnight
    xsi:schemaLocation="http://www.springframework.org/schema/beans classpath:org/springframework/beans/factory/xml/spring-beans.xsd
    http://www.springframework.org/schema/security classpath:org/springframework/security/config/spring-security-5.6.xsd 
    http://www.springframework.org/schema/context classpath:org/springframework/context/config/spring-context.xsd">


  4. Save the file.

Anchor
Verifying Connect Portal patch
Verifying Connect Portal patch
Verifying Connect Portal patch

...