Chat now with support
Chat with Support

Defender 5.9.3 - 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 Integration with Cloud Access Manager 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

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.

AssignedSoftwareToken type

Details of an assignment of a software token to a user. If the token was already assigned to the user then the AssignedToken.TokenCommonName contains a text message indicating that it was already assigned.

C# syntax
[DataContract]
public class AssignedToken
{
   [DataMember]
   public string UserCommonName { get; set; }
   [DataMember]
   public string TokenCommonName { get; set; }
   [DataMember]
   public string ActivationCode { get; set; }
}

Properties

  • UserCommonName  Common name of the user to whom the token is assigned.
  • TokenCommonName  Common name of the assigned token.
  • ActivationCode  The activation code used to activate the token on the user's device.

AssignedToken type

Details of an assignment of a token to a user. If the token was already assigned to this user then the AssignedToken.TokenCommonName will contain a text message indicating that it was already assigned.

C# syntax
[DataContract]
public class AssignedToken
{
   [DataMember]
   public string UserCommonName { get; set; }
   [DataMember]
   public string TokenCommonName { get; set; }
}

Properties

  • UserCommonName  Common name of the user to whom the token is assigned.
  • TokenCommonName  Common name of the assigned token.
Related Documents