版本记录

版本号	时间
V1.0	2018.02.08

前言

NetworkExtension框架配置VPN通道，定制和扩展核心网络功能。接下来几篇我们就一起看一下这个框架。

Overview

下面先看一下该框架的基本信息。

下面我们看一下该框架的基本结构。

Network Extension框架包含API，可用于定制和扩展iOS和MacOS的核心网络功能。

Network Extension Hotspot Entitlements

除了使用NEHotspotHelper类以外，您不需要从Apple获得使用Network Extension类的权利。要申请使用Hotspot Helper的权利，请访问https://developer.apple.com/contact/network-extension。

Personal VPN

NEVPNManager API使应用程序能够在iOS和MacOS上创建和管理个人VPN配置。个人VPN配置通常用于向用户提供服务，以保护其在诸如公共Wi-Fi网络等不安全网络上的互联网浏览活动。

Network Tunneling Protocol Client

您可以使用NETunnelProvider系列API将iOS和MacOS设备连接到使用非标准网络隧道协议（例如SSL-VPN服务器）的VPN服务器。

NETunnelProvider API系列使应用程序能够实现自定义网络隧道协议（称为Tunnel Provider）的客户端。 Tunnel Provider作为应用程序扩展运行。NETunnelProvider系列的API还包含以下类，用于配置和控制Tunnel Provider：

NETunnelProviderManager
NEPacketTunnelProvider
NEAppProxyProviderManager
NEAppProxyProvider

On-Device Network Content Filter

NEFilterProvider API使应用程序能够在iOS设备上动态过滤网络内容。应用程序可以在学校环境中使用以下的类，在使用学校拥有的设备浏览互联网时保护学生：

NEFilterManager
NEFilterControlProvider
NEFilterDataProvider

Wi-Fi Hotspot Authentication and Configuration

NEHotspotHelper API使您的应用能够为Wi-Fi热点执行自定义身份验证。它为用户提供了一种无缝连接到大型Wi-Fi热点聚合网络的方法。 NEHotspotConfiguration API可让您的应用程序配置这些热点。

Topics

1. Classes

NEAppProxyFlow
- NEAppProxyFlow用于从网络套接字读取数据并将数据写入网络套接字。
NEAppProxyProvider
- 为App Proxy Provider应用程序扩展创建一个主体类。
NEAppProxyProviderManager
- 配置和控制由App Proxy Provider应用程序扩展提供的网络隧道。
NEAppProxyTCPFlow
- NEAppProxyTCPFlow用于从应用程序代理提供程序代理的TCP套接字中读取数据和将数据写入该套接字。
NEAppProxyUDPFlow
- NEAppProxyUDPFlow用于从应用程序代理提供程序代理的UDP套接字中读取数据和将数据写入该套接字。
NEAppRule
- NEAppRule包含用于匹配基于源应用程序的网络连接的规则的匹配条件。
NEDNSSettings
- NEDNSSettings包含网络隧道的DNS解析器设置。
NEEvaluateConnectionRule
- NEEvaluateConnectionRule将网络连接的属性与操作相关联。
NEFilterBrowserFlow
- NEFilterBrowserFlow包含有关从WebKit浏览器对象发起的网络数据流的详细信息。
NEFilterControlProvider
- 创建一个Filter Control Provider应用程序扩展的主体类。
NEFilterControlVerdict
- NEFilterControlVerdict包含 Filter Control Provider对网络数据流的决定。
NEFilterDataProvider
- 为Filter Data Provider应用程序扩展创建一个主体类。
NEFilterDataVerdict
- NEFilterDataVerdict包含Filter Data Provider对网络数据块做出的决定。
NEFilterFlow
- 被过滤器提供者检查的网络数据流的表示。
NEFilterManager
- 创建和管理网络内容过滤器配置并控制网络内容过滤器。
NEFilterNewFlowVerdict
- NEFilterNewFlowVerdict包含Filter Provider对Filter Provider刚刚第一次看到的网络数据流的决定。
NEFilterProvider
- 两个Filter Provider扩展主体类的基类，它们一起工作以制作完整的设备上的网络内容过滤系统。
NEFilterProviderConfiguration
- NEFilterProviderConfiguration包含 Filter Provider的配置设置
NEFilterRemediationVerdict
- NEFilterRemediationVerdict包含Filter Data Provider在用户请求访问网络数据之后对网络数据流作出的决定。
NEFilterSocketFlow
- NEFilterSocketFlow包含有关源自套接字的网络数据流的详细信息。
NEFilterVerdict
- 内容过滤器的抽象基类判定类。
NEFlowMetaData
- NEFlowMetaData包含有关流量的本地和远程网络端点之外的网络数据流的附加信息。
NEHotspotConfiguration
- Wi-Fi网络热点的配置设置。
NEHotspotConfigurationManager
- 配置管理器，应用并删除Wi-Fi网络的热点配置。
NEHotspotEAPSettings
- 用于配置WPA和WPA2企业Wi-Fi网络的可扩展身份验证协议（EAP）设置。
NEHotspotHelper
- 注册一个应用程序作为热点帮手。
NEHotspotHelperCommand
- NEHotspotHelperCommand包含一个Hotspot Helper应用程序处理的命令。
NEHotspotHelperResponse
- NEHotspotHelperResponse包含对Hotspot Helper命令的响应。
NEHotspotHS20Settings
- 用于配置Hotspot 2.0 Wi-Fi网络的设置。
NEHotspotNetwork
- NEHotspotNetwork将关于网络的信息传达给Hotspot Helper应用程序。
NEIPv4Route
- NEIPv4Route包含IPv4路由的设置。
NEIPv4Settings
- NEIPv4Settings包含IP层网络隧道的Internet协议版本4（IPv4）设置。
NEIPv6Route
- NEIPv6Route包含IPv6路由的设置。
NEIPv6Settings
- NEIPv6Settings包含IP层网络隧道的Internet协议版本6（IPv6）设置。
NEOnDemandRule
- NEOnDemandRule定义了何时自动启动VPN连接的规则。
NEOnDemandRuleConnect
- NEOnDemandRuleConnect使用NEOnDemandRuleActionConnect操作定义了一个Connect On Demand规则。
NEOnDemandRuleDisconnect
- NEOnDemandRuleDisconnect使用NEOnDemandRuleActionDisconnect操作定义了一个Connect On Demand规则。
NEOnDemandRuleEvaluateConnection
- NEOnDemandRuleEvaluateConnection使用NEOnDemandRuleActionEvaluateConnection操作定义了一个Connect On Demand规则。
NEOnDemandRuleIgnore
- NEOnDemandRuleIgnore使用NEOnDemandRuleActionIgnore操作定义了一个Connect On Demand规则。
NEPacket
NEPacketTunnelFlow
- NEPacketTunnelFlow用于读取数据包并将数据包写入TUN虚拟接口。
NEPacketTunnelNetworkSettings
- NEPacketTunnelNetworkSettings包含IP层隧道的IP网络设置。
NEPacketTunnelProvider
- 为数据包Tunnel Provider应用程序扩展创建主体类。
NEProvider
- NEProvider是所有Network Extension Provider类的基类。
NEProxyServer
- NEProxyServer包含代理服务器的设置。
NEProxySettings
- NEProxySettings包含HTTP代理设置。
NETunnelNetworkSettings
- NETunnelNetworkSettings包含网络隧道的网络设置。
NETunnelProvider
- 为实现自定义网络隧道协议的客户端的Network Extension Provider应用程序扩展创建主体类。
NETunnelProviderManager
- 配置和控制由Tunnel Provider应用程序扩展提供的VPN连接。
NETunnelProviderProtocol
- NETunnelProviderProtocol包含网络隧道的配置参数。
NETunnelProviderSession
- NETunnelProviderSession用于控制网络隧道连接，以及内部通道连接的状态。
NEVPNConnection
- NEVPNConnection用于控制VPN连接并查看VPN连接的状态。
NEVPNIKEv2SecurityAssociationParameters
- NEVPNIKEv2SecurityAssociationParameters包含IKEv2安全关联的参数。
NEVPNManager
- NEVPNManager用于创建和管理VPN配置并控制生成的VPN隧道连接。
NEVPNProtocol
- NEVPNProtocol包含VPN配置的协议特定部分
NEVPNProtocolIKEv2
- NEVPNProtocolIKEv2包含VPN配置的IKEv2特定部分。
NEVPNProtocolIPSec
- NEVPNProtocolIPSec包含VPN配置的IPSec特定部分。
NWBonjourServiceEndpoint
- NWBonjourServiceEndpoint包含使用Bonjour解析的网络端点的规范。
NWEndpoint
- NWEndpoint是表示网络端点的抽象基类，例如远程服务器上的端口。所有实例都应使用NWHostEndpoint或NWBonjourServiceEndpoint之一的子类创建。
NWHostEndpoint
- NWHostEndpoint指定使用端点的主机名或IP地址的网络端点。
NWPath
- NWPath包含网络连接在设备上的可行性状态和路径的属性。
NWTCPConnection
- NWTCPConnection用于建立到网络端点的TCP连接，并在建立的TCP连接上发送和接收数据。
NWTLSParameters
- NWTLSParameters定义了与NWTCPConnection实例一起使用的高级TLS选项。
NWUDPSession
- NWUDPSession用于建立到网络端点的UDP会话并发送和接收数据报。
NEDNSProxyManager
- 管理DNS代理的对象。
NEDNSProxyProvider
- DNS代理的主要类。
NEDNSProxyProviderProtocol
- DNS代理提供商提供的特定于网络扩展的配置设置。
NEFilterReport
- 数据提供者对流采取的行动的报告。

2. Protocols

NWTCPConnectionAuthenticationDelegate
- NWTCPConnectionAuthenticationDelegate声明了NWTCPConnection对象在其委托上调用的方法，以使它们对某些连接事件执行自定义操作。

3. Reference

NetworkExtension Enumerations
NetworkExtension Constants
NetworkExtension Data Types

后记

本篇已结束，后面更精彩~~~

NetworkExtension框架详细解析（一） —— 基本概览