AnyConnect Secure Mobility Client 4.3.00748
|
#include <ClientIfc.h>
Public Member Functions | |
bool | attach (bool SBL=false, bool isGUI=true, bool requestFullCapabilities=true, bool suppressAutoConnect=true) |
void | detach () |
virtual void | ProcessEvents () |
bool | hasFullCapabilities () |
bool | isConnected () |
bool | isAvailable () |
bool | isVPNServiceAvailable () |
bool | isOperatingMode (OperatingMode opMode) |
std::list< tstring > | getHostNames () |
tstring | getDefaultHostName () |
bool | connect (tstring host) |
virtual bool | setNewTunnelGroup (const tstring &group) |
void | disconnect () |
void | cancel () |
void | getState () |
void | getStats () |
void | resetStats () |
void | startStats () |
void | stopStats () |
void | exportStats (const tstring &tstrFilePath) |
void | setBannerResponse (bool bAccepted) |
void | setCertBlockedResponse (bool bUnblock) |
void | setCertWarningResponse (bool bConnect, bool bImportCert) |
void | UserSubmit () |
PreferenceInfo & | getPreferences () |
bool | savePreferences () |
tstring | getConnectHost () |
bool | requestImportPKCS12 (const std::vector< unsigned char > &der) |
bool | requestImportLocalization (const tstring tstrLocale, const std::vector< unsigned char > &MoFileData) |
This is the main interface class for applications that implement the Cisco AnyConnect Secure Mobility VPN API. A program wishing to use the API must create a class that extends the ClientIfc class. This new class is required to provide implementations for the pure virtual methods found in the protected section (for example, StatsCB).
Finally, the public section contains methods that are available for managing the API. These include methods like attach and connect.
A client must implement the CB (abstract) methods found in the protected section of this interface.
bool ClientIfc::attach | ( | bool | SBL = false , |
bool | isGUI = true , |
||
bool | requestFullCapabilities = true , |
||
bool | suppressAutoConnect = true |
||
) | [virtual] |
After the ClientIfc class has been created, the client implementation must invoke this method prior to attempting connections, retrieving statistics, etc. If successful, this method returns true. If not successful, it returns false and returns a notice error message to the user.
A single call to this method is all that is necessary. If the attach fails, a message indicating the VPN service is not available is returned. If the call succeeds, the ServiceReadyCB is called and true is returned.
SBL | Start Before Logon is a mode of operation where a GUI can be launched prior to the normal windows logon sequence. This allows a VPN tunnel to be activated and used as part of the windows logon sequence. The SBL attribute should be set to true only when it has been passed as an argument to the program by the VPN agent. |
isGUI | indicates that the started program is a UI application. With this attribute set to true, the application will now receive WMHints. |
requestFullCapabilities | indicates that the client program is requesting full API capabilities. Full capabilities allows the client program to connect, disconnect, receive statistics, etc. When full capabilities are not requested or not available, the client program will not be able to establish new VPN connections. Only a client program with full capabilites can do this. In addition, only the first program requesting full capabilities will be granted this level of access. The attach method can succeed even if full capabilities is requested but not granted. To test for this state, use the method ::hasFullCapabilities. |
suppressAutoConnect | indicates that the client wishes to override automatically initiating a connection to the last connected secure gateway at startup. Normally, this is determined by the value of the AutoConnectOnStart preference. If this flag is true then an automatic connection will never be initiated, even if AutoConnectOnStart is enabled. |
Reimplemented from ClientIfcBase.
void ClientIfc::cancel | ( | ) | [virtual] |
Use this method to cancel the user authentication. VPN tunnel is not connected at the moment. This function is used to cancel SSO authentication.
An indication of VPN disconnect is received via the #StateCB method.
Reimplemented from ClientIfcBase.
bool ClientIfc::connect | ( | tstring | host | ) | [virtual] |
This method initiates a connection to the specified host. The connection results in the presentation of authentication credentials, as appropriate. Any credentials returned by the secure gateway are delivered via the #UserPromptCB method.
See ConnectPromptInfo for more details on possible authentication credentials.
If the connection request is accepted, true is returned. This does not mean the connection succeeded. If the connection succeeds, a state of connect will be received via the #StateCB method.
Reimplemented from ClientIfcBase.
Reimplemented in GUIClientImpl.
void ClientIfc::detach | ( | ) | [virtual] |
After the client program is done, call the detach method to do a graceful cleanup. This method stops the flow of events and does general cleanup.
Reimplemented from ClientIfcBase.
void ClientIfc::disconnect | ( | ) | [virtual] |
Use this method to initiate a disconnect of the active VPN connection.
An indication of VPN disconnect is received via the #StateCB method.
Reimplemented from ClientIfcBase.
Reimplemented in CLIClientImpl.
void ClientIfc::exportStats | ( | const tstring & | tstrFilePath | ) |
This method directs where and how to export the statistics
Reimplemented from ClientIfcBase.
tstring ClientIfc::getConnectHost | ( | ) |
This is called from the credential dialog in the GUI to get the correct friendly name for the dialog title.
Reimplemented from ClientIfcBase.
tstring ClientIfc::getDefaultHostName | ( | ) | [virtual] |
This method returns any default Host name from User Preferences.
A host can be returned here even if there are no profiles on the system. The host last connected to (via the connect method) is returned by this method.
If there is no previously connected-to host, the first host found in an AnyConnect profile (if any) is returned.
Reimplemented from ClientIfcBase.
std::list<tstring> ClientIfc::getHostNames | ( | ) | [virtual] |
This method returns a list of secure gateway host names found in an AnyConnect profile. If no profile is available, an empty list is returned.
Reimplemented from ClientIfcBase.
PreferenceInfo& ClientIfc::getPreferences | ( | ) |
Method for retrieving the currently available user preferences. This method returns an instance of the class PreferenceInfo. The instance contains a variable number of Preference object pointers. Each preference contains data identifying the specific preference, its current value, etc. For a list of all possible preferences see the PreferenceId enum in api.h. Note that some of these preferences are not available to the user.
Reimplemented from ClientIfcBase.
void ClientIfc::getState | ( | ) | [virtual] |
This method triggers the retrieval of the current VPN state. After the client is conected to the VPN service via the attach method, both the current state and any changes in state are automatically delivered to the client. In general, this method should not be needed.
VPNState is delivered via #StateCB method.
Reimplemented from ClientIfcBase.
void ClientIfc::getStats | ( | ) |
This method triggers the retrieval of the current VPN statistics. This allows an UI to notify the API that it is ready to receive statistics.
VPNState is delivered via #StatsCB method.
Reimplemented from ClientIfcBase.
Reimplemented in CLIClientImpl.
bool ClientIfc::hasFullCapabilities | ( | ) | [virtual] |
Use this method to determine whether this application has full capabilities. Only one application (the first one started) can have full capabilities. If this is the first application started, this method returns true. When an application does not have full capabilities, it cannot initiate connections.
Reimplemented from ClientIfcBase.
bool ClientIfc::isAvailable | ( | ) | [virtual] |
This method returns true if the client VPN is available for use. If false is returned this means that VPN has been intentionally disabled. This would indicate a situation where other AnyConnect services were in use but not VPN.
Reimplemented from ClientIfcBase.
bool ClientIfc::isConnected | ( | ) | [virtual] |
This method returns true if the client has an active VPN connection with a secure gateway.
Reimplemented from ClientIfcBase.
bool ClientIfc::isOperatingMode | ( | OperatingMode | opMode | ) |
This method returns true if the mode in which the client is currently operating is enabled. For a list of all possible modes of operation see the OperatingMode enum in api.h.
Reimplemented from ClientIfcBase.
bool ClientIfc::isVPNServiceAvailable | ( | ) |
This method returns true if the VPN service is available for establishing VPN connections.
virtual void ClientIfc::ProcessEvents | ( | ) | [virtual] |
When the method ClientIfc::EventAvailable has been overriden in the client application, this method must be called to receive events.
It is expected that GUI programs will use EventAvailable as a signal, allowing them to set an event using their native event handler. When that event fires, the application can call ProcessEvents, which causes the API to deliver events in the client's main thread.
Reimplemented from ClientIfcBase.
bool ClientIfc::requestImportLocalization | ( | const tstring | tstrLocale, |
const std::vector< unsigned char > & | MoFileData | ||
) |
This method is used to import a gettext localization file from a byte array, for the specified locale. Returns true if the locale file was successfully imported, false otherwise. Note: successful import does not guarantee that the specified locale will be used.
Reimplemented from ClientIfcBase.
bool ClientIfc::requestImportPKCS12 | ( | const std::vector< unsigned char > & | der | ) |
This method is used to import a PKCS12 file from a byte array. May incite UserPromptCB() to prompt for the p12 password. Will invoke ImportPKCS12ResultCB() to indicate the result. Returns true if the request was acknowledged, false otherwise.
Reimplemented from ClientIfcBase.
void ClientIfc::resetStats | ( | ) | [virtual] |
This method resets current VPN statistics counters.
Reimplemented from ClientIfcBase.
bool ClientIfc::savePreferences | ( | ) |
This method stores the current set values of the preferences to the preferences file(s). This method is a counterpart to the getPreferences() method.
Reimplemented from ClientIfcBase.
void ClientIfc::setBannerResponse | ( | bool | bAccepted | ) |
Call this method after a #BannerCB has been received to indicate that the user response to the banner can now be read.
bAccepted | indicates if the user accepted or declined the banner. |
Reimplemented from ClientIfcBase.
virtual bool ClientIfc::setNewTunnelGroup | ( | const tstring & | group | ) | [virtual] |
Use this method to change selected group after initial connection request has been made and credentials were delivered.
Depending on secure gateway configuratiion, call to this method may result in a new connection request and will update credentials required for the selected group. New credentials returned by the secure gateway are delivered via the #UserPromptCB method.
Reimplemented from ClientIfcBase.
void ClientIfc::startStats | ( | ) | [virtual] |
This method activates the retrieval of VPN statistics and other related data. By default, VPNStats are automatically delivered via the method #StatsCB.
If the stopStats method is called to stop the delivery of statistics, this method can be called to resume delivery.
Reimplemented from ClientIfcBase.
void ClientIfc::stopStats | ( | ) | [virtual] |
This method stops the delivery of VPN statistics and other related data. By default, VPNStats are automatically delivered. This method disables delivery.
The method startStats can be called to resume the delivery of statistics.
Reimplemented from ClientIfcBase.
void ClientIfc::UserSubmit | ( | ) | [virtual] |
Call this method to indicate that authentication credential requests values solicited by the #UserPromptCB method can now be read from the ConnectPromptInfo instance.
Reimplemented from ClientIfcBase.