Integration

Mail Server Configuration of the SDK Embedded Server

To configure the SMTP settings of the SDK Embedded Server of the Default Application User Interface, set the respective properties in the<APP>-embedded/conf/conf/conf.d/openejb.xml file:

mail.transport.protocol=smtp
mail.smtp.host=mailsmtp.whitestein.com
mail.smtp.port=25
mail.from=lsps@whitestein.com
mail.smtp.user=lsps_user
mail.smtp.auth=true
mail.smtp.starttls.enable=true
mail.smtp.password=<PASSWORD>
password=<PASSWORD>

Important: The SDK Embedded Server fails to communicate with an SMTP server that requires MD5Digest authentication. This causes the sendEmail() calls to fail. To force another authentication method, specify the following property in the <APP>-embedded/conf/conf/conf.d/openejb.xml file: `mail.smtp.sasl.mechanisms=PLAIN

Note: For configuration of mail sessions for the PDS Embedded Server, which is a WildFly server, use the server web console at localhost:9990/management. For configuration of other servers, refer to the section for installation of your server in the Deployment and Configuration guide.

LDAP

The default Application User Interface uses its custom person management. The related services are implemented in the pm-exec.jar in the application bundle. If you want the application to use an LDAP server for authentication and authorization, you need to provide your implementation of the person management services in a custom 'pm-ldap-exec.jar' file.

To set your LSPS application to use LDAP on your application server, do the following:

1. In your application, create the pm-ldap-exec ejb project.
2. Implement the following beans in the project:
   • PersonManagementServiceBean stateless bean that implements the following interfaces:
     • com.whitestein.lsps.os.ejb.PersonManagementServiceLocal
     • com.whitestein.lsps.os.ejb.PersonManagementServiceRemote (optional)
   • ProcessServiceBean stateless bean that implements the following interfaces:
     • com.whitestein.lsps.os.ejb.PersonServiceLocal
     • com.whitestein.lsps.os.ejb.PersonServiceRemote (optional)
   • PersonSecurityRoleChangePlugin stateless bean that implements the following interfaces:
     • com.whitestein.lsps.orgstructure.entity.SecurityRoleChangePlugin
3. In your pom.xml of your EAR project, change the dependency.

   <dependency>
       <groupId>com.whitestein.lsps.person-management</groupId>
       <artifactId>lsps-pm-ldap-exec</artifactId>
   </dependency>
   

4. Rebuild and deploy your application.