SDK Resources > Posture Validation (NAC) > Agent Presence Attribute

Agent Presence Attribute

Posture version 2, supported in Intel AMT Releases 4.0 and 5.0, adds the AMTAgentPresence attribute. This attribute reports on the status of software agents running on the host that are monitored by the Intel AMT Agent Presence feature. The attribute is a fixed length of 352 bytes. It can contain up to 16 entries, each containing 22 bytes:

Agent GUID: 16 bytes

State counters: 5 bytes - each time an agent enters one of the listed states, the corresponding one-byte counter is incremented. The states are:

• Not started – 1 byte

• Running – 1 byte

• Expired – 1 byte

• Stopped – 1 byte

• Suspended – 1 byte

Current state: 1 byte. The valid values are:

• 0x1 Not started

• 0x2 Stopped

• 0x4 Running

• 0x8 Expired

• 0x10 Suspended

Intel AMT adds agent presence information to the posture for a selected agent only if the agent was configured with at least one state transition configured for “EAC Action.” Once one transition is so configured, Intel AMT maintains all of the state counters for that agent. See Agent Presence for information on the Agent Presence feature and the options for actions on state transition.

The attribute can report on up to 16 agents. An unused entry will have its GUID field set to zero. The populated entries may not be adjacent: there may be “holes” of unused entries dispersed between populated entries.

Note:

Do not define an agent with a GUID of zero. It is incompatible with the posture format. See Create an Agent Watchdog.