The sample-applicationContext-externalAuth-db-mt.xml file contains the beans needed to enable and perform authentication against an external database. This section summarizes the most important beans in this file, including the beans you need to configure in order for the samples to work with your deployment.
| • | proxyAuthenticationProcessingFilter: Filter bean which enables external authentication of web application requests. When proxyAuthenticationProcessingFilter is present in the application context, that is, when it appears in an applicationContext-<customName>.xml file in the <js‑webapp>/WEB-INF directory, the Spring Security filter chain processes the authentication via the proxy definitions instead of the default internal filter found in applicationContext-security-web.xml. You do not need to configure this bean. |
| • | dbAuthenticationManager: Lists the available authentication providers. The providers in the list are invoked in the order they appear in the configuration file until one of them authenticates the user. When one of the providers successfully authenticates the user, the rest of the providers are skipped. The final provider in the list, ${bean.daoAuthenticationProvider} authenticates against the jasperserver internal database. You can customize authentication by adding more providers to this bean. |
| • | externalDaoAuthenticationProvider – Custom authentication provider for external database authentication. |
| • | passwordValidator: Bean for encoding user passwords. Configure this bean with the secret key and encryption algorithm used to encrypt user passwords in the external database, as described in Setting the Password Encryption . |
| • | externalDataSynchronizer – Bean whose class creates a mirror image of the external user in the internal jasperserver database. The sample includes the following processors: |
| • | externalTenantSetupProcessor – Bean which sets up external organizations in the jasperserver database. For multi-organization JasperReports Server deployments, configure this bean to specify the mapping between fields and field values retrieved from the database and JasperReports Server organizations, as described in Setting the User Organization. |
| • | mtExternalUserSetupProcessor – Bean which creates and configures the internal user corresponding to a successfully authenticated external user. Configure this bean to specify the default internal role given to the external users in JasperReports Server and to map external user roles to internal JasperReports Server roles if desired, as described in Mapping User Roles. You can also optionally assign administrative roles to specific users. |
| • | externalUserFolderProcessor – Bean that creates a user folder as an example of additional post-authentication processing. Post-authentication processing is described in Authentication Based on Request. |
| • | externalAuthProperties – This bean stores properties necessary to configure JasperReports Server for external authentication. For multi-organization deployments of JasperReports Server, configure this bean to require an organization ID on the login form, as described in Configuring the Login Page for a Single-Organization Deployment |
Recommended Comments
There are no comments to display.