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
addSSIDToTrusted:
- (void)addSSIDToTrusted:(NSString *)SSID;
Adds the Service Set Identifier (SSID) to trusted list.
Parameters
- SSID
- String which contains a SSID. Cannot be nil.
Availability
Available in Mac OS X v10.8. Available in iOS v8.0.
addSSIDToUntrusted:
- (void)addSSIDToUntrusted:(NSString *)SSID;
Adds the Service Set Identifier (SSID) to untrusted list.
Parameters
- SSID
- String which contains a SSID. Cannot be nil.
Availability
Available in Mac OS X v10.8. Available in iOS v8.0.
removeSSID:
- (void)removeSSID:(NSString *)SSID;
Removes the Service Set Identifier (SSID) from all lists.
Parameters
- SSID
- String which contains a SSID. Cannot be nil.
Availability
Available in Mac OS X v10.8. Available in iOS v8.0.
removeSSIDFromTrusted:
- (void)removeSSIDFromTrusted:(NSString *)SSID;
Removes the Service Set Identifier (SSID) from trusted list.
Parameters
- SSID
- String which contains a SSID. Cannot be nil.
Availability
Available in Mac OS X v10.8. Available in iOS v8.0.
removeSSIDFromUntrusted:
- (void)removeSSIDFromUntrusted:(NSString *)SSID;
Removes the Service Set Identifier (SSID) from untrusted list.
Parameters
- SSID
- String which contains a SSID. Cannot be nil.
Availability
Available in Mac OS X v10.8. Available in iOS v8.0.
Properties
connectOnCellular
@property (nonatomic, assign) BOOL connectOnCellular;
If set to YES, VPN connection is allowed for cellular networks, disallowed otherwise. Default value is YES.
Availability
Available in Mac OS X v10.8. Available in iOS v8.0.
connectOnEthernet
@property (nonatomic, assign) BOOL connectOnEthernet;
If set to YES, VPN connection is allowed for wired Ethernet connections, disallowed otherwise. Default value is YES.
Availability
Available in Mac OS X v10.8. Available in iOS v8.0.
connectOnWireless
@property (nonatomic, assign) BOOL connectOnWireless;
If set to YES, VPN connection is allowed for wireless networks, disallowed otherwise. Default value is YES.
Availability
Available in Mac OS X v10.8. Available in iOS v8.0.
onDemandEnabled
@property (nonatomic, assign) BOOL onDemandEnabled;
If set to YES, VPN connection auto-established when internet connection established. Default value is NO.
Availability
Available in Mac OS X v10.8. Available in iOS v8.0.
SSIDList
@property (readonly, copy) NSArray *SSIDList;
Gets a list of Service Set Identifiers (SSIDs).
Availability
Available in Mac OS X v10.8. Available in iOS v8.0.
SSIDTrustedList
@property (readonly, copy) NSArray *SSIDTrustedList;
Gets a list of trusted Service Set Identifiers (SSIDs).
Availability
Available in Mac OS X v10.8. Available in iOS v8.0.
SSIDUntrustedList
@property (readonly, copy) NSArray *SSIDUntrustedList;
Gets a list of untrusted Service Set Identifiers (SSIDs).
Availability
Available in Mac OS X v10.8. Available in iOS v8.0.