Supported Intel AMT Features > System Defense > Using the System Defense API
CollapseAll image

Using the System Defense API

The HLAPI implements the System Defense feature in the System Defense API.

The available methods are described in these interfaces:

•   IPolicyStore – Used to manage policies on the Intel AMT device

•   ISystemDefense – Used to get System Defense related information from the Intel AMT device

 Note:

•   To create a System Defense policy and apply it to an Intel AMT device, see Creating and Applying System Defense Policies.

•   When using the HLAPI, the name of a System Defense policy is a key and must be unique. However, the Intel AMT device can also include System Defense policies created by third-party applications. This means that two policies can exist in the Intel AMT device with the same name. If this occurs, HLAPI methods that include the duplicate policy name as a parameter will throw an exception. (The exception to this rule is the DeletePolicy method (see Deleting System Defense Policies.)

 

Examples

These C# examples show how to use the System Defense API (after connecting to the Intel AMT device).

Get the Active Policy on an Intel AMT device interface

EnablingSource source;

amt.SystemDefense.PolicyStore.GetActivePolicy(NetworkInterface.Wired, out source);

Because only one of the enabled policies can be active, the source of the GetActivePolicy method is an out parameter.

Get the filter statistics from the Intel AMT device

Dictionary<Filter, PolicyStatistics> filtersStatistics = amt.SystemDefense.PolicyStore.GetStatistics(NetworkInterface.Wired);

 

// Go over the filters and display the statistics parameters for each filter

Console.WriteLine("\nWired statistics:");

Console.WriteLine("-------------------");

IEnumerator enumerator = filtersStatistics.GetEnumerator();

while (enumerator.MoveNext())

{

     KeyValuePair<Filter, PolicyStatistics> statistics = (KeyValuePair<Filter, PolicyStatistics>)enumerator.Current;

 

     Console.WriteLine("Filter {0}:", ((Filter)statistics.Key).Name);

     Console.WriteLine("\tActivation time: {0} ", ((PolicyStatistics)statistics.Value).ActivationTime);

     Console.WriteLine("\tFilter matched: {0} ", ((PolicyStatistics)statistics.Value).FilterMatched);

     Console.WriteLine("\tLast reset time: {0} ", ((PolicyStatistics)statistics.Value).LastResetTime);

     Console.WriteLine("\tRead count: {0} ", ((PolicyStatistics)statistics.Value).ReadCount);

}

 

See Also:

•   Connecting to an Intel AMT Device

•   Exception Handling

 

Copyright © 2006-2022, Intel Corporation. All rights reserved.