Configuring custom login properties

A System Administrator can configure the custom login properties for a sponsor such that the sponsors and partners can access the IBM PEM application by using different URLs and different domains for email correspondence.

All the activities must be executed or closed before you enable or disable configuration options for a sponsor. When the dual URL option is enabled, predefined activities that use the sponsor context must be updated to support the dual URL extension.
The current configuration options are:
  1. URL access – this configuration provides access to the application using different URLs for sponsors and partners. URL access for sponsors users can use public and private domains with the sponsor extension. Partner users can access the application by using the URL in a public domain that contains the partner extension. As a sponsor, if you want to restrict your users to access IBM PEM only from your organization network, you must contact IBM for additional network configuration.
  2. Domains for email correspondence – this configuration sets different domain names in the URLs embedded in outgoing email correspondence for partner and sponsors. This changes the content of email messages, but does not change how mail is sent. When sending to a partner user, PEM constructs the URL based on the external domain name property. When sending to a sponsor user, PEM constructs the URL based on the internal domain name property.
  3. Domains for file upload - this configuration checks domain names as target URLs while uploading files for partner and sponsors. When uploading file by a partner user, PEM looks for the external domain name property and compares it with source URL. When uploading file by a sponsor user, PEM looks for the internal domain name property and compare it with source URL.
  1. Sign in to the PEM Portal as a System Administrator.
  2. Select Directory > Sponsors.

    A list of sponsors is displayed.

  3. For a sponsor, under the Actions column, click View > Configure Properties.
  4. In the Configure Properties window, click Edit for the Custom Login Properties.
  5. Change the values for the following properties to configure dual URL access:
    Property Name Property Value
    DUAL_URL_ENABLED Set this property to TRUE or FALSE based on your requirement to use different URLs for sponsor and partner users login.
    • When this property is set to TRUE, sponsor users can access the IBM PEM application by using the URL in the sponsor IP network or in the public domain that contains the sponsor extension. Partner users can access the IBM PEM application by using the URL in a public IP domain that contains the partner extension.
      • Sponsor URL to access the application
        https://<ip:port>/<sponsorContext>/sponsor/login
      • Sponsor URL to access REST APIs
        • https://<ip:port>/mdrws/sponsors/<sponsorContext>/sponsor/<entityName>
        • https://<ip:port>/pemws/sponsors/<sponsorContext>/sponsor/<entityName>
      • Sponsor URL to access JAX-RS APIs
        https://<ip:port>/mrmws/sponsors/<sponsorContext>/sponsor/<entityName>
      • Partner URL to access the application
        https://<ip:port>/<sponsorContext>/partner/login
    • When this property is set to FALSE, the following URLs are used:
      • Sponsor or Partner URL to access the application
        https://<ip:port>/<sponsorContext>/login
      • Sponsor URL to access REST APIs
        • https://<ip:port>/mdrws/sponsors/<sponsorContext>/<entityName>
        • https://<ip:port>/pemws/sponsors/<sponsorContext>/<entityName>
      • Sponsor URL to access JAX-RS APIs
        https://<ip:port>/mrmws/sponsors/<sponsorContext>/<entityName>
  6. Change the values for the following properties to configure outgoing email domains and file upload domains:
    Property Name Property Value
    INTERNAL_DOMAIN_NAME A fully qualified domain name (host and port) that PEM uses for all correspondence to sponsor members, which is currently email communications and file upload scenarios only.
    EXTERNAL_DOMAIN_NAME A fully qualified domain name (host and port) that PEM uses for all correspondence to partners, which is currently email communications and file upload scenarios only.
  7. Click Save.