Previous Topic: Authentication Server Data

Next Topic: Event Data

Web Agent Objects in the SiteMinder MIB

The following table contains the Web Agent properties that are exposed as objects in the SiteMinder MIB, which are under iso.org…siteminder.webAgentTable.webAgentEntry.

Object Name

SNMP Type

Object Description

webAgentIndex

Integer32

A unique identifier for the current Web Agent instance.

webAgentHostID

IP address

IP address of the machine where the web agent server is installed.

webAgentType

Display string

Type of component.

webAgentStatus

Integer32

Status of the Web Agent. The status can be Active or Inactive.

webAgentPort

Integer32

Web Agent port number.

webAgentProduct

Display string

Web Agent product name.

webAgentPlatform

Display string

Operating system of the machine where the Web Agent is installed.

webAgentVersion

Display string

Version number of the Web Agent.

webAgentUpdate

Display string

Version number of the most recently applied update.

webAgentLabel

Display string

Web Agent build number.

webAgentCrypto

Integer32

Length of the encryption key used to encrypt/decrypt data sent between the Web Agent and the Policy Server.

webAgentUTC

Display string

The startup time of the Web server where the Web Agent is installed. The time is specified in Universal Coordinated Time format.

webAgentTime Zone

Integer32

Time zone for the geographical location where the Web Agent is installed.

webAgentSocketCount

Gauge32

Number of open sockets, which corresponds to the number of open connections between the Policy Server and the Web Agent.

Note: Because the Web Agent architecture has changed, SocketCount has no value.

webAgentResource-CacheCount

Integer32

Number of entries in the resource cache. The resource cache stores information about recently accessed resources to speed up subsequent requests for the same resource.

The number of entries in the resource cache can be 0 to the n, where n is the maximum cache size specified in the Web Agent's configuration.

webAgentResource-CacheHits

Integer32

Number of times that the resource cache is accessed. This number indicates how frequently SiteMinder is using cached resources.

webAgentResource-CacheMisses

Integer32

The number of times the Web Agent could not locate a resource in the resource cache. This occurs when:

  • The resource has not been accessed before.
  • The cached information has expired.

webAgentUserSession-CacheCount

Integer32

Number of entries in the user session cache. The user session cache stores information about users who have recently accessed resources. Storing user information speeds up resource requests.

The number of entries in the user session cache can be 0 to n, where n is the maximum cache size specified in the Web Agent's configuration.

Note: The user session cache count may differ based on the Web server where the session cache is located.

webAgentUserSession-CacheHits

Integer32

Number of times that Web Agent accessed the user session cache.

webAgentUserSession-CacheMisses

Integer32

The number of times the Web Agent could not locate user session information in the user session cache. This occurs when:

  • The user has not accessed a resource before.
  • The cached information has expired.

webAgentIsProtected-Count

Integer32

Number of times the Web Agent has checked the Policy Server to see if a resource is protected.

Note: If the resource cache is set to 0, two or more IsProtected calls may be recorded per login attempt. If the Web Agent is not caching information, it must check with the Policy Server to determine whether or not a resource is protected each time a request is made to the Web server.

If the resource cache is not set to 0, only one IsProtected call will be recorded. In this case, the Web Agent makes one IsProtected call to the Policy Server; subsequent requests to the Web server for the same resource are satisfied against the Web Agent's resource cache until the resource in the cache expires or the resource cache is flushed.

webAgentIsProtected-Errors

Integer32

Number of times an error has occurred when the Web Agent asks the Policy Server whether or not a resource is protected. An error indicates a communication failure between the Web Agent and the Policy Server.

webAgentIsProtected-AvgTime

Unsigned 32

The average amount of time it takes for the Web Agent to determine from the Policy Server whether or not a resource is protected.

webAgentLoginCount

Counter 32

Number of login attempts made from this Web Agent.

webAgentLoginErrors

Counter 32

Number of errors that occurred during login attempts. An error indicates a communication failure between the Web Agent and the Policy Server.

webAgentLoginFailures

Counter 32

Number of failed login attempts because users were not authenticated or authorized by the Policy Server.

webAgentLoginAvgTime

Unsigned 32

Average time it takes for a user to log into a resource.

webAgentValidation-Count

Counter 32

The number of times a specific Web Agent attempted to validate a session cookie against the Policy Server to authenticate a user, instead of matching that user's credentials to a user directory entry. (The Web Agent creates a session cookie on the user's browser when a user is successfully authenticated, and uses that cookie to authenticate the user on subsequent requests for new resources.).

webAgentValidation-Errors

Counter 32

The number of errors that have occurred when the Web Agent attempted to validate a user session. Errors indicate a communication failure between the Web Agent and the Policy Server.

webAgentValidation-Failures

Counter 32

The number of times the Web Agent has failed to validate a user session because of an invalid session cookie.

webAgentValidation-AvgTime

Unsigned 32

Average amount of time it takes to validate a cookie used to authenticate a user (in milliseconds). Cookies may be used to authenticate a user in a single sign-on environment.

webAgentAuthorize-Count

Counter 32

Number of authorization attempts made by this Agent. An authorization attempt occurs when a user supplies credentials to the Policy Server in order to access a protected resource.

webAgentAuthorize-Errors

Counter 32

Number of errors that occurred during authorization attempts made by this Web Agent. An error indicates a communication failure between the Web Agent and Policy Server during an authorization call.

webAgentAuthorize-Failures

Counter 32

Number of failed authorization attempts. An authorization attempt fails when a user enters invalid credentials.

webAgentAuthorize-AvgTime

Integer32

Indicates the average time it takes to authorize a user (in milliseconds)

webAgentCrosssite-ScriptHits

Integer32

Number of cross-site scripting hits. A cross-site scripting hit consists of malicious code embedded in pages at your site. For more information about cross-site scripting, see the SiteMinder Web Agent Configuration Guide.

webAgentBadURL-charsHits

Integer32

Number of requests that the Agent refuses because of bad URL characters. Bad URL characters are specifically blocked to prevent a Web client from evading SiteMinder rules. These characters are specified in the Web Agent's configuration.

webAgentBadCookie-HitsCount

Gauge32

Number of cookies that the Web Agent could not decrypt.

webAgentExpired-CookieHitsCount

Gauge32

Number of requests that contained an expired cookie.


Copyright © 2010 CA. All rights reserved. Email CA about this topic