The Barracuda Web Application Firewall integrates with CA/Netegrity SiteMinder to provide single sign-On and centralized management of web applications using the predefined security policies. It uniquely identifies users before they are authenticated as named users, and manages user’s privileges to ensure that they access only authorized applications or operations.
Components in SiteMinder Setup
SiteMinder contains two significant components:
- Web Agents – Integrated with a standard web server or application server that enables SiteMinder to manage web applications based on the predefined security policies.
- Policy Server – Provides policy management and AAA functions within the SiteMinder framework.
Single Sign-On (SSO) Setup
In SiteMinder single sign-on (SSO), a user successfully authenticates through one agent and does not have to re-authenticate when accessing a realm protected by a different agent. The two agents must be in the same cookie domain, for example: /abc.siteminder.com. CA SiteMinder supports both single- and multi-domain single sign-on. For more information about single sign-on functionality, refer to How to Configure Single Sign-On (SSO).
The ACCESS CONTROL > Authentication page provides two types of single sign-on:
Single Sign-On (SSO)
- Supports single and multiple domains.
- The Barracuda Web Application Firewall authenticates and authorizes users accessing the web application.
- Supports single and multiple domains.
- Authentication and authorization is performed by the SiteMinder Policy Server. By default, the Barracuda Web Application Firewall is set as an authorization agent for all authentication services. To change the Authorization Agent to SiteMinder, navigate to the ACCESS CONTROL > Authorization page and click Edit next to the service. See Configuring Authorization Policy.
How It Works
The following steps describe how the Barracuda Web Application Firewall communicates with the Policy Server before granting access to the protected resource.
- The Barracuda Web Application Firewall intercepts requests and communicates with the Policy Server to determine whether the requested resources are protected. For protected resources, users are redirected to a login page, and challenged to provide credentials. If the resource is not protected, the user is allowed to access the requested resource instantly. Note: If a customized login URL is defined in Auth Not Done URL on the ACCESS CONTROL > Authorization page, the user is redirected to that page for authentication. If not, the user is redirected to the default login page.
- User enters username and password.
- The Barracuda Web Application Firewall transmits the credentials to the SiteMinder Policy Server for validation.
- The SiteMinder Policy Server authenticates the user against the configured external user directories. The Policy Server supports LDAP, Oracle, Microsoft SQL Server, and custom user directories.
- After successful authentication, the Barracuda Web Application Firewall communicates with the Policy Server to authorize the user. During authorization, SiteMinder performs the following:
- It checks the rules and policies assigned to the users and groups.
- It generates an SSO token for the request.
- On successful authorization, SiteMinder sends the SSO token along with other information such as user details, session expiration time, and additional user attributes defined on the Policy Server, if any.
- The Barracuda Web Application Firewall uses the SSO token, appends the SMSESSION cookie to the request, and allows access to the protected resource.
- When the user attempts to access another protected resource:
- The Barracuda Web Application Firewall validates the user based on the contents of the SMSESSION cookie and communicates with the Policy Server for authorization, without challenging the user for credentials.
- If authorized, the user is allowed to access the protected resource and the information is stored in the cache.
Configuring SiteMinder SSO through the Barracuda Web Application Firewall
The Barracuda Web Application Firewall requires the following configuration settings for SiteMinder SSO:
- Before enabling SiteMinder SSO on the Barracuda Web Application Firewall, the administrator must configure the SiteMinder Policy Server as follows:
- SiteMinder Agent – Create an agent with the Agent Type as SiteMinder and Web Agent. Note: The Name field in the Agent Properties window must match the Agent Name parameter in the Barracuda Web Application Firewall configuration for SITEMINDER server.
- Agent Conf Objects – In Agent Configuration Objects Properties, do the following:
- Add a new parameter AcceptTPCookie and set Value to Yes.
- Set DefaultAgentName to Agent Name parameter defined in Step 1a.
- Host Conf Objects – In Host Configuration Object Properties, ensure the IP address and port numbers assigned to Policy Server are correct. If the Policy Server is in a cluster, specify the IP addresses of all Policy Servers in the cluster.
- Create a user directory with all user names to be authenticated by SiteMinder.
Create realms and define rules and policies for the realm. You should create realms for each URL pattern you want to protect or unprotect instead of protecting the root directory (/). For example “/images/logo.jpg”, “/images/banner.png” can be ignored from protection, and “/finance/report.html”, “/server/login.html” can be configured to be protected. Note: The SiteMinder realm is not related with the realm on the Barracuda Web Application Firewall. A realm in SiteMinder is a cluster of protected and unprotected resources. The SiteMinder realm and the corresponding policies determine the users and groups to be allowed for a protected resource. See CA SiteMinder Policy Design Guide for more information on how to configure these objects. The values configured on the Policy Server must now be specified in the SITEMINDER tab under the ACCESS CONTROL > Authentication Services page.
Note: The Barracuda Web Application Firewall uses Custom Agent capabilities of SiteMinder to provide authentication and authorization in a single sign-on environment.
Configuring SiteMinder Authentication Service
The SiteMinder Policy Server must be specified as the authentication service on the ACCESS CONTROL > Authentication Services > SITEMINDER tab. The Barracuda Web Application Firewall uses this information to communicate with the SiteMinder Policy Server to authenticate a user.
To configure SITEMINDER authentication service:
- From the ACCESS CONTROL > Authentication Services page, select the SITEMINDER tab and specify values for the following:
- Realm Name – Enter a name for the realm to identify this server in the web interface.
- Server IP – Enter the IP address of the SiteMinder Policy Server used for authenticating users.
- Port – Enter the port number associated with the IP address of the SiteMinder Policy Server.
- Admin – Enter the user name of a user with privileges to access the SiteMinder Policy Server.
- Password – Enter the password associated with the above user name (Admin).
- Agent Name – Enter the agent name of the SiteMinder Agent you configured in the SiteMinder Policy Server.
- Host Conf Object – Enter the corresponding host configuration object defined in the SiteMinder Policy Server.
- Click Add to save your settings.
Configuring Authorization Policy
By default, the Barracuda Web Application Firewall is the authorization agent for services associated with the LDAP, RADIUS, and RSA SECURID authentication services. If a service is associated with the SiteMinder authentication service, the authorization agent must be SiteMinder to authorize the users accessing SiteMinder protected resources. To change the Authorization Agent, click Edit next to the SiteMinder service on ACCESS CONTROL > Authorization and scroll down to the Advanced section. For more information on how to configure an authorization policy, see Configuring Authorization Policy.
Configuring SiteMinder Single Sign-On
Configure the following the parameters to set up single sign-on (SSO) using SiteMinder:
- From the ACCESS CONTROL > Authentication page, identify the service to which you want to enable SiteMinder SSO. Ensure the service is associated with the SiteMinder authentication service.
- Click Edit next to the service. The Edit Authentication Policy window opens.
- Scroll down to the SiteMinder SSO section and specify values for the following:
- Cookie Provider – Set to Yes to enable this service to act as a cookie provider agent to other agents that are in SiteMinder SSO setup.
- Cookie Provider URL – Specify the URL path of the cookie provider. This service acts as a cookie provider agent to other agents that are in the SiteMinder SSO setup.
- Source IP Check – Set to Yes if you want to check the source IP address in the cookie while authenticating the user.
- Session Validation Timeout – Specify the time interval in seconds for the Barracuda Web Application Firewall to re-validate a session with the Policy Server.
- Set-Cookie List – Specify the list of cookies as comma-separated regular expressions. If the regex matches the requesting URL, the corresponding cookie will be set in the redirect response to the Login page.
- Idle Timeout URL – Specify a URL to which the user will be redirected after Idle Timeout is exceeded.
- Idle Timeout Cookie – Specify a cookie name and value to be inserted in the redirect response to the client after the Idle Timeout is exceeded.
- Extended Idle Timeout – Set the maximum time (in minutes) that a user can remain idle, after which the user is redirected to the configured Extended Idle Timeout URL.
- Extended Idle Timeout URL – Specify a URL to which the user will be redirected once the Extended Idle Timeout is exceeded.
- Extended Idle Timeout Cookie – Specify a cookie name and value to be inserted in the redirect response to the client after the Extended Idle Timeout is exceeded.
- Single Session Per User – Set to Yes to allow only one active session per user.
- Enable Debug Logs – Set to Yes to enable debug logs.
- Click Save Changes to save your settings.
For more information about the SiteMinder Policy Server and web agent configuration, refer to SiteMinder Bookshelf.