VPNUOnDemandConnectionManager
This class provides a programmatic interface for managing VPN On Demand Rules.
Discussion
Use this class to manage Service Set Identifier (SSID) lists in conjunction with VPN On Demand rules. The instance of this class must be set as onDemandConnectionManager property of VPNUConfigurator if you want to apply these rules while setting up a VPN connection.
This class automatically detects new SSIDs and sends a VPNUNewSSIDFoundNotification notification with newly detected SSID's string as a value for key kVPNUNewSSIDNotificationKey in userInfo dictionary of this notification.
You must reconfigure your current VPN connection with new settings each time you want them to take effect.
Conforms: NSCoding
Extends: NSObject
Declared in: VPNUOnDemandConnectionManager.h
Instance Methods
addSSIDsToTrusted:
- (void)addSSIDsToTrusted:(NSArray *) list;
Adds an array of the Service Set Identifier (SSID) to trusted list.
Parameters
- list
- An array that contains a list of SSIDs. Cannot be nil.
addSSIDsToUntrusted:
- (void)addSSIDsToUntrusted:(NSArray *) list;
Adds an array of the Service Set Identifier (SSID) to untrusted list.
Parameters
- list
- An array that contains a list of SSIDs. Cannot be nil.
addSSIDToTrusted:
- (void)addSSIDToTrusted:(NSString *)SSID;
Adds the Service Set Identifier (SSID) to trusted list.
Parameters
- SSID
- String which contains a SSID. Cannot be nil.
addSSIDToUntrusted:
- (void)addSSIDToUntrusted:(NSString *)SSID;
Adds the Service Set Identifier (SSID) to untrusted list.
Parameters
- SSID
- String which contains a SSID. Cannot be nil.
removeAllTrustedSSIDs
- (void)removeAllTrustedSSIDs;
Removes all the Service Set Identifiers (SSID) from trusted list.
removeAllUntrustedSSIDs
- (void)removeAllUntrustedSSIDs;
Removes all the Service Set Identifiers (SSID) from untrusted list.
removeSSID:
- (void)removeSSID:(NSString *)SSID;
Removes the Service Set Identifier (SSID) from all lists.
Parameters
- SSID
- String which contains a SSID. Cannot be nil.
removeSSIDFromTrusted:
- (void)removeSSIDFromTrusted:(NSString *)SSID;
Removes the Service Set Identifier (SSID) from trusted list.
Parameters
- SSID
- String which contains a SSID. Cannot be nil.
removeSSIDFromUntrusted:
- (void)removeSSIDFromUntrusted:(NSString *)SSID;
Removes the Service Set Identifier (SSID) from untrusted list.
Parameters
- SSID
- String which contains a SSID. Cannot be nil.
Properties
connectOnCellular
@property (nonatomic, assign) BOOL connectOnCellular;
If set to YES, VPN connection is allowed for cellular networks, disallowed otherwise. Default value is YES.
connectOnEthernet
@property (nonatomic, assign) BOOL connectOnEthernet;
If set to YES, VPN connection is allowed for wired Ethernet connections, disallowed otherwise. Default value is YES.
connectOnWireless
@property (nonatomic, assign) BOOL connectOnWireless;
If set to YES, VPN connection is allowed for wireless networks, disallowed otherwise. Default value is YES.
onDemandEnabled
@property (nonatomic, assign) BOOL onDemandEnabled;
If set to YES, VPN connection auto-established when internet connection established. Default value is NO.
SSIDList
@property (readonly, copy) NSArray *SSIDList;
Gets a list of Service Set Identifiers (SSIDs).
SSIDTrustedList
@property (readonly, copy) NSArray *SSIDTrustedList;
Gets a list of trusted Service Set Identifiers (SSIDs).
SSIDUntrustedList
@property (readonly, copy) NSArray *SSIDUntrustedList;
Gets a list of untrusted Service Set Identifiers (SSIDs).