Chat now with support
Chat with Support

Defender 6.6 - Administration Guide

Getting started Managing Defender objects in Active Directory Configuring security tokens Securing VPN access Securing Web sites Securing Windows-based computers Defender Management Portal (Web interface) Securing PAM-enabled services Delegating Defender roles, tasks, and functions Automating administrative tasks Administrative templates Integration with Active Roles Push Notifications Appendices
Appendix A: Enabling diagnostic logging Appendix B: Troubleshooting common authentication issues Appendix C: Troubleshooting DIGIPASS token issues Appendix D: Defender classes and attributes in Active Directory Appendix E: Defender Event Log messages Appendix F: Defender Client SDK Appendix G: Defender Web Service API

SetPinOnUserToken method

Sets a user's PIN for an assigned token.

C# syntax
[OperationContract]
[FaultContract(typeof(FaultException))]
void SetPinOnUserToken(string userCommonName, string tokenCommonName, string tokenPin, string userSearchBase, string tokenSearchBase);

Parameters

  • userCommonName  Common name of the user to whom the PIN is to be assigned.
  • tokenCommonName  Common name of the token to which the PIN is to be assigned.
  • tokenPin  The PIN to assign.
  • userSearchBase  Optional parameter to specify base container in which to search for users.
  • tokenSearchBase  Optional parameter to specify base container in which to search for tokens.

Return value

In the case of an error a Fault is generated. The faultCode can be one of the following:

  • ArgumentOutOfRange  One of the arguments is invalid, further details are contained in the faultstring.
  • UnknownFault  Any other error, further details may be included in the faultstring.

SetTemporaryResponse method

Sets a temporary response on a user's assigned token.

C# syntax
[OperationContract]
[FaultContract(typeof(FaultException))]
TemporaryResponse SetTemporaryResponse(string userCommonName, string tokenCommonName, int expiryTimeMinutes, bool multipleUse, string userSearchBase, string tokenSearchBase);

Parameters

  • userCommonName  Common name of the user to whom the temporary response is to be assigned.
  • tokenCommonName  Common name of the token to which the temporary response is to be assigned.
  • expiryTimeMinutes  The time interval, in minutes, during which the temporary response remains valid.
  • multipleUse  If true, then the temporary response can be used multiple times.
  • userSearchBase  Optional parameter to specify base container in which to search for users.
  • tokenSearchBase  Optional parameter to specify base container in which to search for tokens.

Return value

A succesful call returns a TemporaryResponse. In the case of an error a Fault is generated.

The faultCode can be one of the following:

  • ArgumentOutOfRange  One of the arguments was invalid, further details will be contained in the faultstring.
  • UnknownFault  Any other error, further details may be included in the faultstring.

TestDefenderToken method

Tests a Defender token's response.

C# syntax
[OperationContract]
[FaultContract(typeof(FaultException))]
DefenderResult TestDefenderToken(string tokenCommonName, string response, string challenge, string tokenSearchBase);

Parameters

  • tokenCommonName  Common name of the token to test.
  • response  The token response.
  • challenge  The token challenge, not required for synchronous tokens.
  • tokenSearchBase  Optional parameter to specify the base container in which to search for tokens.

Return value

A valid call results in a DefenderResult. This class provides the following public properties:

  • System.Boolean Success  Returns whether the test was successful.
  • System.String ErrorMessage  Returns the error message associated with the test.

In the case of an error a Fault is generated.

The faultCode can be one of the following:

  • ArgumentOutOfRange  One of the arguments is invalid, further details are contained in the faultstring.
  • UnknownFault  Any other error, further details may be included in the faultstring.

API types

 

Table 55:

API types

Method

Description

AssignedSoftwareToken type

Details of an assignment of a software token to a user.

AssignedToken type

Details of an assignment of a token to a user.

ProgrammableSoftwareTokenType type

Enumeration of programmable software token types.

TokenList type

A List of UserTokenDetail.

UserTokenDetail type

Details of a token assigned to a user.

DefenderResult type

Result indicating success or otherwise of certain operations.

UserViolationCount type

Details of authentication violations and the number of times the violation count has been reset.

TemporaryResponse type

Details of a temporary response and its expiry time.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating