Class

NEFilterProvider

An abstract base class shared by NEFilterDataProvider and NEFilterControlProvider.

Declaration

@interface NEFilterProvider : NEProvider

Overview

A Network Content Filter is made up of two Filter Provider extensions:

The Filter Data Provider extension examines network content as it passes through the network stack on the device and decides if the network content should be blocked or allowed to pass on to its final destination.

Because the Filter Data Provider extension has access to all of the network content flowing through the device, it runs in a very restrictive sandbox. The sandbox prevents the Filter Data Provider extension from moving network content outside of its address space by blocking all network access, IPC, and disk write operations.

The Filter Data Provider extension is implemented by creating a custom subclass of the NEFilterDataProvider class.

The Filter Control Provider extension is responsible for feeding information to the Filter Data Provider extension so that the Filter Data Provider extension can do its job.

For example, the Filter Control Provider extension can be notified by the Filter Data Provider extension that it does not have enough information to make a decision about a particular flow of network content. The Filter Control Provider extension can then download more filtering rules from a server and write the rules to a location where the Filter Data Provider can access them.

The Filter Control Provider extension is implemented by creating a custom subclass of the NEFilterControlProvider class.

Subclassing Notes

NEFilterProvider should not be subclassed directly. Instead, you should create subclasses of NEFilterProvider’s subclasses and override the following methods:

Methods to Override

Topics

Managing the Filter Life Cycle

Getting the Filter Configuration

filterConfiguration

An NEFilterProviderConfiguration object containing the current filter configuration.

Instance Methods

Relationships

Inherits From

See Also

Data and Control Providers

NEFilterDataProvider

The principal class for a filter data provider app extension.

NEFilterControlProvider

The principal class for a filter control provider app extension.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software