- Open Vulnerability and Assessment Language -
Element Dictionary

The following is a description of the elements, types, and attributes that compose the MacOS specific system characteristic items found in Open Vulnerability and Assessment Language (OVAL). Each item is an extension of the standard test element defined in the Core Definition Schema. Through extension, each test inherits a set of elements and attributes that are shared amongst all OVAL tests. Each test is described in detail and should provide the information necessary to understand what each element and attribute represents. This document is intended for developers and assumes some familiarity with XML. A high level description of the interaction between the different tests and their relationship to the Core Definition Schema is not outlined here.

The MacOS System Characteristics Schema was initially developed by The Center for Internet Security. Many thanks to their contributions to OVAL and the security community.

The OVAL Schema is maintained by The MITRE Corporation and developed by the public OVAL Community. For more information, including how to get involved in the project and how to submit change requests, please visit the OVAL website at http://oval.mitre.org.



< accountinfo_item >

This item stores sser account information (username, uid, gid, etc.).

Extends: oval-sc:ItemType

Child Elements Type MinOccurs MaxOccurs
username oval-sc:EntityItemStringType 0 1
The user associated with the information collected.
password oval-sc:EntityItemStringType 0 1
Obfuscated (*****) or encrypted password for this user.
uid oval-sc:EntityItemIntType 0 1
The numeric user id, or uid, is the third column of each user's entry in /etc/passwd. This element represents the owner of the file.
gid oval-sc:EntityItemIntType 0 1
Group ID of this account.
realname oval-sc:EntityItemStringType 0 1
User's real name, aka gecos field of /etc/passwd.
home_dir oval-sc:EntityItemStringType 0 1
The home directory for this user account.
login_shell oval-sc:EntityItemStringType 0 1
The login shell for this user account.



< diskutil_item >

The diskutil_item holds verification information about an individual disk on a Mac OS system. Each diskutil_item contains a device, filepath, and how the actual permissions differ from the expected permissions. For more information, see diskutil(8). It extends the standard ItemType as defined in the oval-system-characteristics schema and one should refer to the ItemType description for more information.

Extends: oval-sc:ItemType

Child Elements Type MinOccurs MaxOccurs
device oval-sc:EntityItemStringType 0 1
The device entity is a string that represents the disk on a Mac OS system to verify. Please see diskutil(8) for instructions on how to specify the device.
filepath oval-sc:EntityItemStringType 0 1
The filepath element specifies the absolute path for a file or directory on the specified device.
uread macos-sc:EntityItemPermissionCompareType 0 1
Has the actual user read permission changed from the expected user read permission?
uwrite macos-sc:EntityItemPermissionCompareType 0 1
Has the actual user write permission changed from the expected user write permission?
uexec macos-sc:EntityItemPermissionCompareType 0 1
Has the actual user exec permission changed from the expected user exec permission?
gread macos-sc:EntityItemPermissionCompareType 0 1
Has the actual group read permission changed from the expected group read permission?
gwrite macos-sc:EntityItemPermissionCompareType 0 1
Has the actual group write permission changed from the expected group write permission?
gexec macos-sc:EntityItemPermissionCompareType 0 1
Has the actual group exec permission changed from the expected group exec permission?
oread macos-sc:EntityItemPermissionCompareType 0 1
Has the actual others read permission changed from the expected others read permission?
owrite macos-sc:EntityItemPermissionCompareType 0 1
Has the actual others read permission changed from the expected others read permission?
oexec macos-sc:EntityItemPermissionCompareType 0 1
Has the actual others read permission changed from the expected others read permission?



< inetlisteningserver_item >

Deprecated As Of Version: 5.10
Reason: The inetlisteningserver_item has been deprecated and replaced by the inetlisteningserver510_item. The name of an application cannot be used to uniquely identify an application that is listening on the network. As a result, the inetlisteningserver510_object utilizes the protocol, local_address, and local_port entities to uniquely identify an application listening on the network. Please see the inetlisteningserver510_item for additional information.

An inet listening server item stores the results of checking for network servers currently active on a system.

Extends: oval-sc:ItemType

Child Elements Type MinOccurs MaxOccurs
program_name oval-sc:EntityItemStringType 0 1
This is the name of the communicating program.
local_address oval-sc:EntityItemIPAddressStringType 0 1
This is the IP address of the network interface on which the program listens. Note that the IP address can be IPv4 or IPv6.
local_full_address oval-sc:EntityItemStringType 0 1
This is the IP address and network port on which the program listens, equivalent to local_address:local_port. Note that the IP address can be IPv4 or IPv6.
local_port oval-sc:EntityItemIntType 0 1
This is the TCP or UDP port on which the program listens. Note that this is not a list -- if a program listens on multiple ports, or on a combination of TCP and UDP, each will have its own entry in the table data stored by this item.
foreign_address oval-sc:EntityItemIPAddressStringType 0 1
This is the IP address with which the program is communicating, or with which it will communicate, in the case of a listening server. Note that the IP address can be IPv4 or IPv6.
foreign_full_address oval-sc:EntityItemStringType 0 1
This is the IP address and network port to which the program is communicating or will accept communications from, equivalent to foreign_address:foreign_port. Note that the IP address can be IPv4 or IPv6.
foreign_port oval-sc:EntityItemStringType 0 1
This is the TCP or UDP port to which the program communicates. In the case of a listening program accepting new connections, this is usually a *.
pid oval-sc:EntityItemIntType 0 1
This is the process ID of the process. The process in question is that of the program communicating on the network.
protocol oval-sc:EntityItemStringType 0 1
This is the transport-layer protocol, in lowercase: tcp or udp.
user_id oval-sc:EntityItemStringType 0 1
The numeric user id, or uid, is the third column of each user's entry in /etc/passwd. It represents the owner, and thus privilege level, of the specified program.



< inetlisteningserver510_item >

An inet listening server item stores the results of checking for network servers currently active on a system.

Extends: oval-sc:ItemType

Child Elements Type MinOccurs MaxOccurs
protocol oval-sc:EntityItemStringType 0 1
This is the transport-layer protocol, in lowercase: tcp or udp.
local_address oval-sc:EntityItemIPAddressStringType 0 1
This is the IP address of the network interface on which the program listens. Note that the IP address can be IPv4 or IPv6.
local_port oval-sc:EntityItemIntType 0 1
This is the TCP or UDP port on which the program listens. Note that this is not a list -- if a program listens on multiple ports, or on a combination of TCP and UDP, each will have its own entry in the table data stored by this item.
local_full_address oval-sc:EntityItemStringType 0 1
This is the IP address and network port on which the program listens, equivalent to local_address:local_port. Note that the IP address can be IPv4 or IPv6.
program_name oval-sc:EntityItemStringType 0 1
This is the name of the communicating program.
foreign_address oval-sc:EntityItemIPAddressStringType 0 1
This is the IP address with which the program is communicating, or with which it will communicate, in the case of a listening server. Note that the IP address can be IPv4 or IPv6.
foreign_port oval-sc:EntityItemIntType 0 1
This is the TCP or UDP port to which the program communicates. In the case of a listening program accepting new connections, this is usually a *.
foreign_full_address oval-sc:EntityItemStringType 0 1
This is the IP address and network port to which the program is communicating or will accept communications from, equivalent to foreign_address:foreign_port. Note that the IP address can be IPv4 or IPv6.
pid oval-sc:EntityItemIntType 0 1
This is the process ID of the process. The process in question is that of the program communicating on the network.
user_id oval-sc:EntityItemIntType 0 1
The numeric user id, or uid, is the third column of each user's entry in /etc/passwd. It represents the owner, and thus privilege level, of the specified program.



< nvram_item >

Output of 'nvram -p'

Extends: oval-sc:ItemType

Child Elements Type MinOccurs MaxOccurs
nvram_var oval-sc:EntityItemStringType 0 1
A nvram variabl.
nvram_value oval-sc:EntityItemStringType 0 1
This is the value of the associated nvram variable.



< plist_item >

The plist_item holds information about an individual property list preference key found on a system. Each plist_item contains a preference key, application identifier or filepath, type, as well as the preference key's value. It extends the standard ItemType as defined in the oval-system-characteristics schema and one should refer to the ItemType description for more information.

Extends: oval-sc:ItemType

Child Elements Type MinOccurs MaxOccurs
key oval-sc:EntityItemStringType 0 1
The preference key to check.
app_id oval-sc:EntityItemStringType 0 1
The unique application identifier that specifies the application to use when looking up the preference key (e.g. com.apple.Safari).
filepath oval-sc:EntityItemStringType 0 1
The absolute path to a plist file (e.g. ~/Library/Preferences/com.apple.Safari.plist).
instance oval-sc:EntityItemIntType 0 1
The instance of the preference key found in the plist. The first instance of a matching preference key is given the instance value of 1, the second instance of a matching preference key is given the instance value of 2, and so on. Instance values must be assigned using a depth-first approach. Note that the main purpose of this entity is to provide uniqueness for the different plist_items that result from multiple instances of a given preference key in the same plist file.
type macos-sc:EntityItemPlistTypeType 0 1
The type of the preference key.
value oval-sc:EntityItemAnySimpleType 0 unbounded
The value of the preference key.



< pwpolicy_item >

Deprecated As Of Version: 5.9
Reason: Replaced by the pwpolicy59_item. The username, userpass, and directory_node entities in the pwpolicy_item were underspecified and as a result their meaning was uncertain. A new item was created to resolve this issue. See the pwpolicy59_item.
Comment: This item has been deprecated and may be removed in a future version of the language.

Output of 'pwpolicy -getpolicy'. Please see the 'pwpolicy' man page for additional information.

Extends: oval-sc:ItemType

Child Elements Type MinOccurs MaxOccurs
username oval-sc:EntityItemStringType 0 1
userpass oval-sc:EntityItemStringType 0 1
directory_node oval-sc:EntityItemStringType 0 1
maxChars oval-sc:EntityItemIntType 0 1
Maximum number of characters allowed in a password.
maxFailedLoginAttempts oval-sc:EntityItemIntType 0 1
Maximum number of failed logins before the account is locked.
minChars oval-sc:EntityItemIntType 0 1
Minimum number of characters allowed in a password.
passwordCannotBeName oval-sc:EntityItemBoolType 0 1
Defines if the password is allowed to be the same as the username or not.
requiresAlpha oval-sc:EntityItemBoolType 0 1
Defines if the password must contain an alphabetical character or not.
requiresNumeric oval-sc:EntityItemBoolType 0 1
Defines if the password must contain an numeric character or not.



< pwpolicy59_item >

The pwpolicy59_item holds the password policy information for a particular user specified by the target_user element. Please see the 'pwpolicy' man page for additional information.

Extends: oval-sc:ItemType

Child Elements Type MinOccurs MaxOccurs
target_user oval-sc:EntityItemStringType 0 1
The target_user element specifies the user whose password policy information was collected.
username oval-sc:EntityItemStringType 0 1
The username element specifies the username of the authenticator.
userpass oval-sc:EntityItemStringType 0 1
The userpass element specifies the password of the authenticator as specified by the username element.
directory_node oval-sc:EntityItemStringType 0 1
The directory_node element specifies the directory node that the password policy information was collected from.
maxChars oval-sc:EntityItemIntType 0 1
Maximum number of characters allowed in a password.
maxFailedLoginAttempts oval-sc:EntityItemIntType 0 1
Maximum number of failed logins before the account is locked.
minChars oval-sc:EntityItemIntType 0 1
Minimum number of characters allowed in a password.
passwordCannotBeName oval-sc:EntityItemBoolType 0 1
Defines if the password is allowed to be the same as the username or not.
requiresAlpha oval-sc:EntityItemBoolType 0 1
Defines if the password must contain an alphabetical character or not.
requiresNumeric oval-sc:EntityItemBoolType 0 1
Defines if the password must contain an numeric character or not.
maxMinutesUntilChangePassword oval-sc:EntityItemIntType 0 1
Maximum number of minutes until the password must be changed.
minMinutesUntilChangePassword oval-sc:EntityItemIntType 0 1
Minimum number of minutes between password changes.
requiresMixedCase oval-sc:EntityItemBoolType 0 1
Defines if the password must contain upper and lower case characters or not.
requiresSymbol oval-sc:EntityItemBoolType 0 1
Defines if the password must contain a symbol character or not.
minutesUntilFailedLoginReset oval-sc:EntityItemIntType 0 1
Number of minutes after login has been disabled due to too many failed login attempts to wait before reenabling login.
usingHistory oval-sc:EntityItemIntType 0 1
0 = user can reuse the current pass-word, 1 = user cannot reuse the current password, 2-15 = user cannot reuse the last n passwords.
canModifyPasswordforSelf oval-sc:EntityItemBoolType 0 1
If true, the user can change the password.
usingExpirationDate oval-sc:EntityItemBoolType 0 1
If true, user is required to change password on the date in expirationDateGMT
usingHardExpirationDate oval-sc:EntityItemBoolType 0 1
If true, user's account is disabled on the date in hardExpireDateGMT
expirationDateGMT oval-sc:EntityItemStringType 0 1
Date for the password to expire, format is: mm/dd/yyyy. NOTE: The pwpolicy command returns the year as a two digit value, but OVAL uses four digit years; the pwpolicy value is converted to an OVAL compatible value.
hardExpireDateGMT oval-sc:EntityItemStringType 0 1
Date for the user's account to be disabled, format is: mm/dd/yyyy. NOTE: The pwpolicy command returns the year as a two digit value, but OVAL uses four digit years; the pwpolicy value is converted to an OVAL compatible value.
maxMinutesUntilDisabled oval-sc:EntityItemIntType 0 1
User's account is disabled after this interval
maxMinutesOfNonUse oval-sc:EntityItemIntType 0 1
User's account is disabled if it is not accessed by this interval
newPasswordRequired oval-sc:EntityItemBoolType 0 1
If true, the user will be prompted for a new password at the next authentication.
notGuessablePattern oval-sc:EntityItemBoolType 0 1

== EntityItemPermissionCompareType ==

The EntityItemPermissionCompareType complex type restricts a string value to more, less, or same which specifies if an actual permission is different than the expected permission (more or less restrictive) or if the permission is the same. The empty string is also allowed to support empty elements associated with error conditions.

Restricts: oval-sc:EntityItemStringType

Value Description

more 

The actual permission is more restrictive than the expected permission.

less 

The actual permission is less restrictive than the expected permission.

same 

The actual permission is the same as the expected permission.

 

The empty string value is permitted here to allow for detailed error reporting.


== EntityItemPlistTypeType ==

The EntityItemPlistTypeType complex type restricts a string value to the seven values CFString, CFNumber, CFBoolean, CFDate, CFData, CFArray, and CFDictionary that specify the type of the value associated with a property list preference key. The empty string is also allowed to support empty elements associated with error conditions.

Restricts: oval-sc:EntityItemStringType

Value Description

CFString 

The CFString type is used to describe a preference key that has a string value. The OVAL string datatype should be used to represent CFString values.

CFNumber 

The CFNumber type is used to describe a preference key that has a integer or float value. The OVAL int and float datatypes should be used, as appropriate, to represent CFNumber values.

CFBoolean 

The CFBoolean type is used to describe a preference key that has a boolean value. The OVAL boolean datatype should be used to represent CFBoolean values.

CFDate 

The CFDate type is used to describe a preference key that has a date value. The OVAL string datatype should be used to represent CFDate values.

CFData 

The CFData type is used to describe a preference key that has a base64-encoded binary value. The OVAL string datatype should be used to represent CFData values.

CFArray 

The CFArray type is used to describe a preference key that has a collection of values. This is represented as multiple value entities.

CFDictionary 

The CFDictionary type is used to describe a preference key that has a collection of key-value pairs. Note that the collection of CFDictionary values is not supported. If an attempt is made to collect a CFDictionary value, an error should be reported.

 

The empty string value is permitted here to allow for detailed error reporting.