Quick and Easy Load Testing for Novell Access Manager (NAM) 3.x
Written by Corbin Links, Identity Access Management (IAM) Engineer
Links Business Group LLC
How to quickly, reliably and easily conduct system load testing for Novell Access Manager 3.x (Hereafter referred to as “NAM”)
Configure and run NAM tests at LoadStorm.com
- Technical Project / Program Managers
- Quality Assurance (QA) Team Members)
- Application Systems Engineers
- Technical Marketing Personnel
This article assumes you have a basic familiarity with:
- Novell Access Manager Architecture
- Basic Single Sign On (SSO) Concepts
- Basic concepts of load testing and capacity planning
- Basic functionality of web browsers and HTTP status / exit codes
Introduction to NAM /SSO Load Testing
Disclaimer: The author is in no way affiliated with LoadStorm.com, its partners or subsidiaries. Information provided in this article is intended solely for informational and convenience purposes. Information and statements provided in this Cool Solution are those of the author and not The Washington Post Company.
Arguably, one of the most crucial tasks of implementing any form of identity access management (IAM) framework or SSO system is the ability to verify that the system can withstand large amounts of concurrent load. Authentication (authN), Authorization (authZ) and Auditing operations though lightweight and inexpensive from a transaction standpoint, can negatively impact system performance when occurring in large quantities over short periods of time. How much or how little load your NAM system can or should handle will be defined by the requirements of your application and any corresponding Service Level Agreements (SLA) you may have in place.
Unfortunately, load testing is one of the crucial elements of any Authentication Infrastructure that can be often overlooked or short changed during pre and post implementation stages. Here are just a few of the reasons:
- Comprehensive and relevant load testing can be extremely expensive, costing anywhere from thousands of dollars, well into the tens of thousands.
- SSO deployments are extremely time, resource and cost intensive. It is not uncommon to be running behind project schedule and start dropping task items considered to be "lower priority." These often mis-categorized items include documentation, load testing, and training – just to name three.
- Load testing tools can be very difficult to implement and set up and reuse. Slight changes in the testing platform or the particular version of NAM you are running may require brand new test cases for each scenario.
- Lack of meaningful internal benchmarks or external usage data which can guide system relevant testing requirements. Generally this scenario exists for one or more of the following reasons:
- NAM/SSO is new to the organization. No hard SLA requirements yet exist.
- There is little or no application analytics data to determine usage patterns, peak and valley usage, raw transaction numbers, errors, daily and per-transaction bandwidth statics and many others.
- Future growth patterns are unknown or inadequately planned
- What does your current SLA state? (If applicable.) Does your SLA state explicit uptime requirements? Specific availability requirements for certain hours of the day?
Determining Your Load Testing Requirements
Application load testing requirements vary tremendously between application designs, infrastructure environments, business requirements and usage requirements. The following list provides a high-level general set of testing guidelines. This is the list we have used for our NAM deployment and similar deployments in the past. Though far from comprehensive for all environments, the goal is to provide general guidelines to help you get started.
- Who is your user population? (These are the users that will be interacting with the application that NAM is protecting, not NAM-specific users)
- Internal users only?
- External users?
- Mix of internal and external users
- What is the application designed to do? Is it highly transactional, RESTful, general use, highly specialized? (Limited to only a few users or a specific department for example.)
- Do you have web analytics currently installed on your present Access Management system? If not, how about the underlying client application that is protected by the Access Management System?
- If no analytics exist, do you have reasonable use projections based on server logs or similar data?
- Raw daily user counts, averaged over a period of 30 days
- Time-of-day hit counts averaged over a minimum of two weeks
- Geographic load factors
- Example: 75% of your user population is located in the States, while the other 25% is distributed over smaller locations around the world (or vice versa)
- What is your expected annual growth percentage? Will the tests you build and run today still be valid three months from now? Six months? One year?
Components of NAM Load Testing
At its most basic level, your NAM load testing will stress the following components:
- The Linux Access Gateway (if applicable)
- The Identity Server
- The application server SSO agent (if applicable) and/or if not using a Linux Access Gateway
- The application or web server which hosts your application
- All hardware and network points in between the end application page or form, and the end user browser
For the remainder of this document, we will assume the following basic transaction is common to all our NAM-protected testing scenarios:
- Open the target application URL: http://www.myapplication.com
- NAM Linux Access Gateway (LAG) or a proxy agent installed on the application's web or application server will intercept the request
- The user's browser will redirect to a NAM-based login page generated from the Novell Identity Server
- The user enters credentials into the page
- The user submits the page back to the Identity Server
- User credentials are checked in accordance with the resource's access policy. Generally, this action submits the user credentials to a backend user store (LDAP-based) to verify username and password, or other types of credentials. For our load test, we are assuming basic username/password authentication single-factor authentication
- Identity Server validates or refuses the session
- The resulting page is sent back to the user's browser
- "Success" will open the application's home page
- "Fail" will open a redirected error URL containing additional information
Here are the steps from browser/UA (User Agent) standpoint:
- Open a browser
- Open http://www.myapplication.com
- Enter username and password
- Click "login" or "submit"
- Receive application homepage in the browser
- Enter logout url: http://www.myapplication.com/logout (or simulate whatever "logout" link is appropriate on the site)
Our Testing Requirements
Before we set up the testing solution, here were the basic requirements that we wanted to test against:
- Application: Internal Intranet Portal
- NAM Configuration: Linux Access Gateway (LAG) based
- Requirement: 500 concurrent users under load
- Load Peak: no peak or special time assumed. This particular test system had a base load requirement of 500 concurrent users at full peak loading. (Using a "linear" versus a "stepped" test.)
Our NAM Infrastructure Components
- NAM LAG
- NAM Identity Server
- Windows 2003 Active Directory Authenticator
- PeopleSoft HR Portal
Load Testing Solution: LoadStorm.com
LoadStorm.com is a highly scalable cloud-based load testing service. For additional information about the LoadStorm service of company information, please visit their website at http://www.loadstorm.com.
LoadStorm.com Testing Prerequisites
- A LoadStorm.com test account, which can be obtained for free (as of this writing) over at http://www.loadstorm.com
- A list of user ID's and passwords which are allowed to authenticate to NAM
- NOTE: If you are testing 500 users, you will need 500 distinct and active accounts in your authentication repository
- In most cases, all users will have the same password (set en masse)
- A test plan which can be completely run from a user browser
- I recommend having all steps, url's and screenshots in a single document, which can be referenced when building the test case within LoadStorm
- At least one test scenario (the "Scenario") contains "Steps"
- One or more test "Steps" (each "Scenario" requires a minimum of one "Step")
Creating a LoadStorm.com Account
- Visit http://www.loadstorm.com
- Click the big red "Sign Up Now!" button to create a "Free Breeze Account" (This free account lets you run any test as often as you want, using 25 or fewer users. 25 free users are included in the basic account.)
- Complete the basic sign up form:
- Receive the confirmation page after clicking the "Sign up" button:
- Look for the confirmation email in your inbox
- Confirm the confirmation email
- Log in to your account
Once logged into LoadStorm.com, you can start configuring and running test cases. Since this Cool Solution is not intended as a detailed tutorial on all the options and possibilities within LoadStorm.com, we will instead focus on the core elements of creating and running a NAM-centric test case.
If you have not previously used LoadStorm, it is a good idea to experiment and familiarize yourself with one of the existing demo cases, such as the "CIA Factbook" case. Running a demo case will give you a pretty good feel for how the tool operates and how it outputs results. Additionally, the demo cases are designed to be copied to new cases and customized to fit other use environments.
Before building and configuring your first test case in LoadStorm, here are a few points to keep in mind:
- The case testing model is: Plan ->Scenario ->Steps
- As of this writing, LoadStorm's current version requires a full successful run of each step in a test before a subsequent step can be run. If a particular step does not complete, it follows that attempts to add a dependent step will fail.
- Each step within the load scenario will complete and deliver results to the active LoadStorm scenario.
- Every time a new URL from a new domain is added, LoadStorm considers it a new server. To protect your environment from unscrupulous people using LoadStorm as DDoS method against your network, LoadStorm requires all servers to be verified. This can be done in one of two ways:
- Place a special file in the root of your application/web server and Novel l Identity Server
- Add a string of code to the root page on your site
- For NAM deployments, it's easiest to use the "touch" command in *NIX systems, or the "copy con" command in Windows-based systems to create a 0-byte file with the correct name. Then click the "Verify" button to verify server ownership and away you go!
- Results returned on completion of each step in the scenario will determine what actions are available next. For example, if your test is a simple scenario like ours (hit a website, enter credentials on the NAM-redirected form, authenticate, redirect to an application target page, logout,) then the NAM login form would not be available to populate until after the first "visit the site" step.
- NOTE: As of this writing, LoadStorm supports three possible test actions:
- Open a page
- Click a link
- Process a form
- NOTE: As of this writing, LoadStorm supports three possible test actions:
- NAM's use of iFrames can cause some additional configuration challenges, because LoadStorm must have the ability to parse the HTML of any page to load the form and parse the elements within. This is further complicated by the extensive differences in login page composition between NAM 3.0 and 3.1. In our environment, we were in the process of upgrading from 3.0 to 3.1 and had to configure separate test runs for both environments. I recommend opening your full NAM redirect link first in your test scenario step, before attempting to directly open your target page. For instance, instead of making the first LoadStorm step: "Open http://www.myapplication.com", instead "Open"
https://namids.myapplication.com/nidp/idff/sso, (or relevant link if you are remapping NAM-standard links.) This approach will make the form accessible to LoadStorm and LoadStorm can parse the NAM login form fields "Ecom_User_ID" and "Ecom_Password" and read input from a single constant, or a CSV input file.
- Collections of users for running different sizes load of load tests can be configured at the bottom of the "Build" tab.
- If you use the "Copy" action to copy existing test cases to new test cases, or existing scenarios to new scenarios, you will have to manually run the copied scenario again for LoadStorm to recognize all of the available actions within the test (for instance, if a form is available for parsing or not)
- Important Note: As of this writing, LoadStorm treats any URL delivered in over 35 seconds as a "408 timeout error" condition. When an error condition occurs, LoadStorm automatically "fails" the current virtual user and moves to the next user on the list. This is important to understand because LoadStorm makes no assumption, rightly or wrongly, as to whether or not the URL could have been loaded had it been given enough time. When we stress tested our NAM sandbox environment, we found that the bulk of our errors related to the server having to work too hard to manage authentications and return results.
Test Case List View in the LoadStorm UI
Test Case Scenario and Step View in the LoadStorm UI
These are actually three separate scenarios, rather than steps as described in the annotation red box. Steps are shown once you click on a scenario.
Now, let's set up a more useful test. Here is what we did:
Real Case: ERP Time Reporting Test with NAM 3.1 Login and Logout
A Look inside the "Process Form" Step which reads in "Ecom_User_ID" (userID) and "Ecom_Password" (password)
Running the Tests
LoadStorm runs scenario test steps dynamically as you build your test. Each preceding step must be run successfully before the next can be executed. If there are any errors such as unreachable URL's or forms that cannot be processed, LoadStorm will provide this information in the script build page. Since our internal LoadStorm NAM tests include URL's and data we don't necessarily want to share in this Cool Solution, let's run the "CIA" test case and see what displays and how it displays.
To Run a LoadStorm Test:
- From inside your LoadStorm account page, click the "Build" tab
- Underneath "Plan Name", click the "CIA Factbook" on S3 (example) link
- Click the "Run" tab
- Click the "ADD LOAD TEST" button
- Choose the Test Plan you want, and configure the load test:
- Click the "Save" button
- The "Load Test Run" screen will display, showing when the test will start and what the test parameters are:
- To view completed tests, click the "Analyze" tab
- The "Analyze" tab stores a permanent record of all tests runs and their results. Here is a sample from our account:
- Let's open the "CIA Factbook on S3 (example)" Test. Click the "DETAILS" link in the first row (pictured above)
Interpreting Test Results
Let's examine a "Response time" graph taken from a live ERP Time Reporting test we ran recently. This test was run against one of the sandbox servers and used the basic NAM login / logout test discussed previously, but with a couple of additional steps.
The dark blue line is showing the "Peak Response Time" which means that it measures the slowest responding transaction during that minute interval. This line highlights your outliers of poor performance. The light blue line is showing the "Average Response Time" and will almost always be much lower than the peak response time because your system will respond quickly to some requests. For example, your login page may be slow due to processing bottlenecks at the database, while a small static image should be much faster since it requires no extra processing for the web server to deliver. Generally, database access is one of the common performance offenders in a load test.
The graph displays a direct correlation between the Average Response Time and the Error Rate. We can see the Peak Response Times hit the 35 second threshold at about the 40 minute mark as our system starts to take longer to respond.
By clicking on the "Show requests by error code" link above, we can look at a couple of URL's that failed a large number of times: Our application login page and the Novel Identity Server redirect page:
At a high level, the graphic tells us that users trying to log in again much later in a test are waiting a very long time to receive login pages (35 seconds or more.) Either the NAM session isn't being correctly torn down, or our NAM sandbox instance is being staggered by load. We will investigate further and re-run the tests after any configuration issues are mitigated.
LoadStorm itself is a Load Tool, Not a Diagnostic Tool – But, it can definitely help with the diagnosis or find issues early before your production users do...
When analyzing LoadStorm test results (always available on LoadStorm's "Analysis" tab,) it may be tempting to view LoadStorm or any load testing platform as a diagnostic tool. LoadStorm does not directly fulfill this role, though when used correctly can provide extensive information to help diagnose and trouble various NAM and application bottlenecks. In our case, we made a number of policy tweaks and graphic size reductions based on errors we encountered during the load tests. Natively, LoadStorm provides key data such as URL's, response times and HTTP Error Codes (most often related to the 400 series of codes), and the data can be downloaded from LoadStorm.com as a CSV file. However, the data collected from LoadStorm, when used in conjunction with web/application server and Novell Identity Server Logging can help pinpoint key bottlenecks in the system and identify potential throughput problems before you flip the switch to go live in production.
This Cool Solution has just scratched the surface of what is possible with external load testing tools such as LoadStorm. When load testing a NAM environment, be sure to consider estimated and actual peak users, while simulating real-world authentication and authorization patterns. There is no need to throw 5000 concurrent users at a system just because you can, or have a handy tool supports it. Testing 5000 concurrent authentication actions for duration of 45 – 60 minutes can literally push 20,000 or more total transactions through your system within the test duration period. This level of concurrency is a very large number represents uncommon load levels for internally-facing intranet applications. However, if you do need this level of concurrency or higher, LoadStorm can "handle the load" nicely.
For additional information, please visit:
IAM Success Tips: http://www.iamsuccesstips.com