Skip to main content

Prerequisites for Installing Add-ons

Jive must be configured before installing the following add-ons: Forms and Surveys Add-on, Microsoft Teams Add-on, GDPR Add-on, or Social Group Sync Add-on. These configurations are performed by Support or the PS teams and are provided here for informational purposes only.

Configuration Steps​

Setting Up System Properties​

For Forms and Surveys Add-on:​

  1. Go to Advanced Admin Console > System > Management > System Properties.

  2. Set the following system properties to whitelist calls from Jive to the Forms and Surveys App middleware:

    • jive.apps.proxy.whitelist.cidrs = <instance URL of middleware>
    • jive.api.whitelist.cidrs = <instance URL of middleware>

  3. Define the middleware service address:

    • formsapp.jive.service.url = <instance URL of middleware>

  4. Permit impersonation calls from Forms and Surveys App to Jive:

    • jive.api.run_as.strategies = userid

For Microsoft Teams Add-on:​

  1. Go to Advanced Admin Console > System > Management > System Properties.

  2. Set the following properties to define the middleware service address:

    • On Production instances: services.chats.serviceURL = https://ps-chats-addon.aws-eu-west-1-prod.svc.jivehosted.com
    • On Preview instances: services.chats.serviceURL = https://ps-chats-addon.aws-us-east-1-prod.svc.jivehosted.com

  3. Set the following system properties to whitelist calls from Jive to the Microsoft Teams middleware or add to the existing list if present:

    • jive.api.whitelist.cidrs = <instance URL of middleware>
    • jive.apps.proxy.whitelist.cidrs = <instance URL of middleware>

    This address should also be used for the service URL in the meta.json of the extension.zip file.

  4. Permit impersonation calls for some functionalities of the Microsoft Teams Add-on to Jive from the middleware:

    • jive.api.run_as.strategies = userid

For GDPR Add-on:​

  1. Go to Advanced Admin Console > System > Management > System Properties.

  2. Set the following system properties to define the middleware service address:

    • On Production instances: services.gdpr.serviceURL = https://ps-gdpr-addon.aws-eu-west-1-prod.svc.jivehosted.com
    • On Preview instances: services.gdpr.serviceURL = https://ps-gdpr-addon.aws-us-east-1-prod.svc.jivehosted.com

For Social Group Sync Add-on:​

  1. Go to Advanced Admin Console > System > Management > System Properties.

  2. Set the following system properties:

    • services.profileSocialGroupSyncAddon.serviceURL = <value is the URL to the middleware>

      Production: services.profileSocialGroupSyncAddon.serviceURL = https://profile-social-group-sync--addon.aws-eu-west-1-prod.svc.jivehosted.com

    • jive.api.whitelist.cidrs = <value is the URL to the middleware, add URL to existing list>

      Production: jive.api.whitelist.cidrs = https://profile-social-group-sync--addon.aws-eu-west-1-prod.svc.jivehosted.com

    • jive.apps.proxy.whitelist.cidrs = <value is the URL to the middleware, add URL to existing list>

      Production: jive.apps.proxy.whitelist.cidrs = https://profile-social-group-sync--addon.aws-eu-west-1-prod.svc.jivehosted.com

    Preview:

    • services.profileSocialGroupSyncAddon.serviceURL = https://profile-social-group-sync-addon.aws-us-east-1-prod.svc.jivehosted.com
    • jive.api.whitelist.cidrs = https://profile-social-group-sync-addon.aws-us-east-1-prod.svc.jivehosted.com
    • jive.apps.proxy.whitelist.cidrs = https://profile-social-group-sync--addon.aws-eu-west-1-prod.svc.jivehosted.com

    Test/QA:

    • services.profileSocialGroupSyncAddon.serviceURL = https://ps-social-group-sync.aws-us-east-1-ms-test.svc.jivehosted.com
    • jive.api.whitelist.cidrs = https://ps-social-group-sync.aws-us-east-1-ms-test.svc.jivehosted.com
    • jive.apps.proxy.whitelist.cidrs = https://ps-social-group-sync.aws-us-east-1-ms-test.svc.jivehosted.com

Middleware URLs​

  • Forms and Surveys Add-on:

    • Preview instances: 
      https://ps-formsapp.aws-us-east-1-prod.svc.jivehosted.com
    • Production instances: 
      https://ps-formsapp.aws-eu-west-1-prod.svc.jivehosted.com
    • Test/QA instances: 
      https://ps-formsapp.aws-eu-west-1-ms-test.svc.jivehosted.com

  • Microsoft Teams Add-on:

    • Production instances: 
      https://ps-chats-addon.aws-eu-west-1-prod.svc.jivehosted.com
    • Preview instances: 
      https://ps-chats-addon.aws-us-east-1-prod.svc.jivehosted.com

  • GDPR Add-on:

    • Production instances: 
      https://ps-gdpr-addon.aws-eu-west-1-prod.svc.jivehosted.com
    • Preview instances: 
      https://ps-gdpr-addon.aws-us-east-1-prod.svc.jivehosted.com

  • Social Group Sync Add-on:

    • Production instances: 
      https://profile-social-group-sync--addon.aws-eu-west-1-prod.svc.jivehosted.com
    • Preview instances: 
      https://profile-social-group-sync-addon.aws-us-east-1-prod.svc.jivehosted.com
    • Test/QA instances: 
      https://ps-social-group-sync.aws-us-east-1-ms-test.svc.jivehosted.com
Related

Installation of Forms and Surveys Add-on Installation of Microsoft Teams Add-on Installation of GDPR Add-on Installation of Social Group Sync Add-on