SingleRadiusServerAuthPerSession Property of the IFPCWebListenerProperties Interface
The SingleRadiusServerAuthPerSession property gets or sets a Boolean value that indicates whether the Forefront TMG Web proxy will validate user credentials with a RADIUS server to authenticate the user only once during a TCP connection or on each request.
C++
HRESULT put_SingleRadiusServerAuthPerSession(
[in] VARIANT_BOOL fRadiusSingleRequest
);
HRESULT get_SingleRadiusServerAuthPerSession(
[out] VARIANT_BOOL* pfRadiusSingleRequest
);
Parameters
fRadiusSingleRequest
Boolean value that indicates whether the Web proxy will validate user credentials with a RADIUS server to authenticate the user only once during a TCP connection or on each request.pfRadiusSingleRequest
Pointer to a Boolean variable that is set on return to VARIANT_TRUE if the Web proxy will validate user credentials with a RADIUS server to authenticate the user only once during a TCP connection, or to VARIANT_FALSE if the Web proxy will validate user credentials with a RADIUS server to authenticate the user on each request.
Return Value
These property methods return S_OK if the call is successful; otherwise, they return an error code.
Visual Basic
Property SingleRadiusServerAuthPerSession As Boolean
Property Value
Boolean value that indicates whether the Web proxy will validate user credentials with a RADIUS server to authenticate the user only once during a TCP connection.
Example Code
This VBScript subprocedure sets the SingleRadiusServerAuthPerSession property of the specified Web listener to True or False according to the value passed to it. It does not include error handling.
Sub SetSingleRadiusAuth(listenerName, NewValue)
' Declare the other objects needed.
Dim root ' The FPCLib.FPC root object
Dim isaArray ' An FPCArray object
Dim listener ' An FPCNetwork object
Dim currentValue ' A Boolean
' Create the root object.
Set root = CreateObject("FPC.Root")
' Get references to the array object
' and the Web listener object.
Set isaArray = root.GetContainingArray()
Set listener = isaArray.RuleElements.WebListeners.Item(listenerName)
' Change the value of the property if necessary.
currentValue = listener.Properties.SingleRadiusServerAuthPerSession
WScript.Echo "Current status: " & currentValue
If newValue <> currentValue Then
listener.Properties.SingleRadiusServerAuthPerSession = newValue
WScript.Echo "New status: " & listener.Properties.SingleRadiusServerAuthPerSession
listener.Save
WScript.Echo "Done!"
End If
End Sub
Remarks
This property is read/write. Its default value is False (VARIANT_FALSE in C++).
When this property is set to True (VARIANT_TRUE in C++), the Web proxy caches the credentials of a user after successful authentication using a RADIUS server and then uses the cached credentials for comparison with the credentials sent in subsequent requests within the same connection instead of sending them to the RADIUS server.
This property cannot be accessed through Forefront TMG Management.
Requirements
Client | Requires Windows 7 or Windows Vista. |
Server | Requires Windows Server 2008 R2 or Windows Server 2008 x64 Edition with SP2. |
Version | Requires Forefront Threat Management Gateway (TMG) 2010. |
IDL | Declared in Msfpccom.idl. |
DLL | Requires Msfpccom.dll. |
See Also
Send comments about this topic to Microsoft
Build date: 6/30/2010