view Side-By-Side changes
Extended Incident Handling WG R. Danyliw Internet-Draft CERT/CC Expires: February 9, 2006 J. MeijerDraft-ietf-inch-iodef-03.txtSURFnet bvExpires: May 10, 2005 R. Danyliw CERT Coordination CenterY. DemchenkoNLnet Labs November 9, 2004University of Amsterdam August 8, 2005 The Incident Object Description Exchange Format Data Model and XML Implementationdraft-ietf-inch-iodef-03.txtdraft-ietf-inch-iodef-04.txt Status of this Memo By submitting this Internet-Draft,I certifyeach author represents that any applicable patent or other IPR claims of whichI amhe or she is aware have beendisclosed,or will be disclosed, and any of whichI becomehe or she becomes aware will be disclosed, in accordance withRFC 3668. This document is an Internet-Draft and is in full conformance with all provisions ofSection106 ofRFC2026.BCP 79. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF), its areas, and its working groups. Note that other groups may also distribute working documents asInternet-Drafts.Internet- Drafts. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress." The list of current Internet-Drafts can be accessed at http://www.ietf.org/ietf/1id-abstracts.txt. The list of Internet-Draft Shadow Directories can be accessed at http://www.ietf.org/shadow.html. This Internet-Draft will expire onMay 10, 2005.February 3, 2006. Copyright Notice Copyright (C) The Internet Society (2005). Abstract The purpose of the Incident Object Description Exchange Format (IODEF) is to define a data representation that provides a framework for sharing information commonly exchanged by Computer Security Incident Response Teams (CSIRTs) about computer security incidents. Danyliw, et al. Expires February 3, 2006 [Page 1] Internet-Draft IODEF Data Model August 2005 The IODEF satisfies the requirements specified in RFCXXX [1] This Internet-Draft describes a data model for representing incidentMeijer, et al. Expires May 10, 2005 [Page 1] Internet-Draft IODEF Data Model and Implementation November 2004information exported from incident handling systems managed by CSIRTs. An implementation of the data model in the Extensible Markup Language (XML) is presented, an XML Document Type Definition is developed, and examples are provided. Table of Contents 1. Introduction . . . . . . . . . . . . . . . . . . . . . . . .45 1.1 Terminology . . . . . . . . . . . . . . . . . . . . . . .45 1.2 Overview . . . . . . . . . . . . . . . . . . . . . . . . .45 1.3 About the IODEF Data Model . . . . . . . . . . . . . . . .45 1.4 About the IODEF Implementation . . . . . . . . . . . . . .56 1.5 About the Transport Protocol . . . . . . . . . . . . . . .67 1.6 Related Work . . . . . . . . . . . . . . . . . . . . . . .67 2. Formatting Issues . . . . . . . . . . . . . . . . . . . . .89 2.1 IODEF XML Documents . . . . . . . . . . . . . . . . . . .89 2.1.1 The Document Prolog . . . . . . . . . . . . . . . . .8 2.1.2 White Space Processing . . . . . . . . . . . . . . . .92.1.32.1.2 Languages in the IODEF . . . . . . . . . . . . . . . .910 2.2 IODEF Data Types . . . . . . . . . . . . . . . . . . . . .910 2.2.1 Integers . . . . . . . . . . . . . . . . . . . . . . . 10 2.2.2 Real Numbers . . . . . . . . . . . . . . . . . . . . . 10 2.2.3 Characters and Strings . . . . . . . . . . . . . . . .1011 2.2.4 Multilingual Strings . . . . . . . . . . . . . . . . . 11 2.2.5 Bytes . . . . . . . . . . . . . . . . . . . . . . . .10 2.2.511 2.2.6 Hexadecimal Bytes . . . . . . . . . . . . . . . . . . 11 2.2.7 Enumerated Types . . . . . . . . . . . . . . . . . . .10 2.2.611 2.2.8 Date-Time Strings . . . . . . . . . . . . . . . . . . 112.2.72.2.9 Port Lists . . . . . . . . . . . . . . . . . . . . . .11 2.2.812 2.2.10 Postal Address . . . . . . . . . . . . . . . . . . .. 11 2.2.912 2.2.11 Person or Organization . . . . . . . . . . . . . . .. 11 2.2.1012 2.2.12 Telephone and Fax Numbers . . . . . . . . . . . . .11 2.2.1112 2.2.13 Email string . . . . . . . . . . . . . . . . . . . .11 2.2.1212 2.2.14 Uniform Resource Identifier strings . . . . . . . .11 2.2.1312 2.2.15 Timezone string . . . . . . . . . . . . . . . . . . 122.2.142.2.16 Unique Identifiers . . . . . . . . . . . . . . . . . 12 3. The IODEF Data Model . . . . . . . . . . . . . . . . . . . . 13 3.1 IODEF-Document class . . . . . . . . . . . . . . . . . . . 13 3.2 Incident class . . . . . . . . . . . . . . . . . . . . . . 13 3.3 IncidentID class . . . . . . . . . . . . . . . . . . . . . 16 3.4 AlternativeID class . . . . . . . . . . . . . . . . . . . 17 3.5 RelatedActivity class . . . . . . . . . . . . . . . . . . 18 3.6 AdditionalData . . . . . . . . . . . . . . . . . . . . . . 18 3.7 Contact class . . . . . . . . . . . . . . . . . . . . . . 20 3.7.1 RegistryHandle class . . . . . . . . . . . . . . . . . 22 3.8 Time classes . . . . . . . . . . . . . . . . . . . . . . . 23 Danyliw, et al. Expires February 3, 2006 [Page 2] Internet-Draft IODEF Data Model August 2005 3.8.1 StartTime . . . . . . . . . . . . . . . . . . . . . . 23 3.8.2 EndTime . . . . . . . . . . . . . . . . . . . . . . . 23 3.8.3 DetectTime . . . . . . . . . . . . . . . . . . . . . . 23 3.8.4 ReportTime . . . . . . . . . . . . . . . . . . . . . . 23Meijer, et al. Expires May 10, 2005 [Page 2] Internet-Draft IODEF Data Model and Implementation November 20043.8.5 DateTime . . . . . . . . . . . . . . . . . . . . . . .2324 3.9 Expectation class . . . . . . . . . . . . . . . . . . . .2324 3.10 Method class . . . . . . . . . . . . . . . . . . . . . . 25 3.10.1 Classification class . . . . . . . . . . . . . . . . 26 3.11 Assessment class . . . . . . . . . . . . . . . . . . . . 27 3.11.1 Impact class . . . . . . . . . . . . . . . . . . . . 28 3.11.2 TimeImpact class . . . . . . . . . . . . . . . . . . 28 3.11.3 MonetaryImpact class . . . . . . . . . . . . . . . . 29 3.11.4 Confidence class . . . . . . . . . . . . . . . . . . 30 3.12 History class . . . . . . . . . . . . . . . . . . . . .3031 3.12.1 HistoryItem class . . . . . . . . . . . . . . . . . 31 3.13 EventData class . . . . . . . . . . . . . . . . . . . . 33 3.13.1 Relating the Incident and EventData classes . . . . 34 3.13.2 Cardinality of EventData . . . . . . . . . . . . . . 35 3.14 Flow class . . . . . . . . . . . . . . . . . . . . . . . 36 3.15 System class . . . . . . . . . . . . . . . . . . . . . . 36 3.16 Node class . . . . . . . . . . . . . . . . . . . . . . . 38 3.16.1 Counter class . . . . . . . . . . . . . . . . . . .4039 3.16.2 Address . . . . . . . . . . . . . . . . . . . . . .4039 3.16.3 NodeRole class . . . . . . . . . . . . . . . . . . .4241 3.17ProcessService class . . . . . . . . . . . . . . . . . . . . .43 3.18 Service42 3.17.1 Application class . . . . . . . . . . . . . . . . .. . . .433.19 Record3.18 OperatingSystem class . . . . . . . . . . . . . . . . . 44 3.19 Record class . . . . .44 3.19.1 RecordData class .. . . . . . . . . . . . . . . . . 453.19.2 Analyzer3.19.1 RecordData class . . . . . . . . . . . . . . . . . ..463.19.33.19.2 RecordItem class . . . . . . . . . . . . . . . . . .4647 4. Extending the IODEF . . . . . . . . . . . . . . . . . . . .4849 4.1 Extending the data model . . . . . . . . . . . . . . . . .4849 4.2 Extending the XMLDTD .Schema . . . . . . . . . . . . . . . . .4849 5. Processing Considerations . . . . . . . . . . . . . . . . .5153 6. Internationalization issues . . . . . . . . . . . . . . . .5254 7. Examples . . . . . . . . . . . . . . . . . . . . . . . . . .5355 7.1 Code Red detection notification . . . . . . . . . . . . .5355 7.2 IODEF-Document with XML signature . . . . . . . . . . . .5557 7.3 IODEF-Document encrypted using XML encryption . . . . . .5557 7.4 IODEF-Document encrypted and signed using XML signature & encryption . . . . . . . . . . . . . . . . . . . . . . .5557 8. The IODEF DocumentType DefinitionSchema . . . . . . . . . . . . . .56. . . 58 9. Security considerations . . . . . . . . . . . . . . . . . .6778 10. IANA considerations . . . . . . . . . . . . . . . . . . . .6879 11. Acknowledgments . . . . . . . . . . . . . . . . . . . . . .6980 12. References . . . . . . . . . . . . . . . . . . . . . . . . .7081 12.1 Normative References . . . . . . . . . . . . . . . . . .. 7081 12.2 Informative References . . . . . . . . . . . . . . . . .. 7182 Danyliw, et al. Expires February 3, 2006 [Page 3] Internet-Draft IODEF Data Model August 2005 Authors' Addresses . . . . . . . . . . . . . . . . . . . . .7182 Intellectual Property and Copyright Statements . . . . . . .72 Meijer,84 Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page3]4] Internet-Draft IODEF Data Modeland Implementation November 2004August 2005 1. Introduction 1.1 Terminology The key words "MUST," "MUST NOT," "REQUIRED," "SHALL," "SHALL NOT," "SHOULD," "SHOULD NOT," "RECOMMENDED," "MAY," and "OPTIONAL" in this document are to be interpreted as described in RFC2119 [5]. Definitions for some of the common computer security-related terminology used in this document can be found in Section 2 of [1]. 1.2 Overview The Incident Object Description Exchange Format (IODEF) is a format for representing computer security information exchanged between Computer Security Incident Response Teams (CSIRTs). It provides a transport representation conforming to the requirements specified in [1], the Requirements for Format for Incident Report Exchange. The overriding purpose of the IODEF is to expand and enhance the operational capabilities of CSIRTs. Community adoption of the IODEF provides an improved ability to resolve incidents by simplifying collaboration and data sharing. This structured format provided by the IODEF allows for: o increased automation in processing of incidentdata,data since the resources of security analysts to parse free-form textual documents will be reduced; o decreased effort in normalizing similar data (even when highly structured) from different sources; and o a common format on which to build interoperable tools for incidenthandling, such as correlation systems that processhandling and subsequent analysis specifically when data comes fromdifferent sites.multiple constituencies. Terminology, notation, and conventions of the data model and XMLDTDSchema are presented in Sections 2. The data model is described in Section 3, and the implementation considerations are covered in Sections 4 through 6. Section 7 provides several examples of IODEF documents. Section 8 formally specifies the XMLDTDSchema implementation of the data model. Sections 9 and 10 address the security and IANA considerations, respectively. 1.3 About the IODEF Data Model The IODEF data model is a data representation that provides a framework for sharing information commonly exchanged by CSIRTs aboutMeijer,Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page4]5] Internet-Draft IODEF Data Modeland Implementation November 2004August 2005 computer security incidents. A number of considerations were made in the design of the data model. o The intent of the data model is to support the automated processing of incident data. Hence, little consideration was made to ensure human-readability. Despite the still prevalent practice of manual incident report generation, this model is sufficiently complex that it will be unwieldy to create and process without software. o The data model serves as a transport format. Therefore, its specific representation is not the optimal representation foron-diskon- disk storage, long-term archiving, or in-memory processing. o Since there is no precise, widely agreed upon definition for an incident, the data model does not attempt to dictate one through its implementation. Rather, a broad understanding is assumed that is flexible enough to encompass most of the CSIRT community. o Describing an incident for all definitions would require an incredibly complex data model. Therefore, the IODEF data model only intends to be a framework to convey commonly exchanged incident information. However, it ensures that there are ample mechanisms for extensibility to support organization-specific information, and techniques to reference information kept outside of the explicit data model. o Incidents have a life-cycle that dictates the exact type, quantity, and detail of the data that will be present at a given time (e.g., newly reported incidents may only contain the most rudimentary details, but closed incidents may contain a detailed analysis). The data model deals with this situation. o Communication and coordination are central to the role of a CSIRT. Hence, tracking the source of all data is central to handling the incident. Therefore, the data model provides ways to explicitly bind information to a source, and accommodates differences in the types of parties involved in the incident (e.g., varying levels of confidence in information, different data sharing arrangements). 1.4 About the IODEF Implementation The IODEF implementation uses the Extensible Markup Language (XML) [2], specifies an XMLDocument Type Definition (DTD),Schema, and registers an application-specific namespace [3]. For clarity in this document, the terms "XML" and "XML documents"Meijer,Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page5]6] Internet-Draft IODEF Data Modeland Implementation November 2004August 2005 will be used when referring to the Extensible Markup Language (XML). The terms "IODEF description", "IODEF markup" and "IODEF document" will be used to refer to specific elements (tags) and attributes of the IODEFDTD.Schema. Finally, the terms "class" and "subclass" will be used as synonyms for an XML element. The choice to implement the IODEF in XML was made because it provides: o all the necessary features to define and extend a specific markup language for describing security incidents; o a well understood technique for supporting internationalization and localization; o a base of related technologies such as XSL [4], XPATH, and XML-SIG that the aid in the manipulation and use of the incident data; and o a broad community of developers who already understand how to build systems around data exchanged in this format. While XML provides a useful implementation language for IODEF, this implementation also dictates several limitations. o XML is a text representation making it inherently inefficient either when binary data must beembedded,embedded or very large volumes of data must be exchanged. o The data model is designed as a transport representation, and the use of XML further reinforces the inefficiency of using the IODEF for other purposes. Due to the overhead of the parser, XML is not an optimal in-memory representation. Furthermore, storing, searching, and retrieving native XML documents is problematic on a large scale dictating that this format is also a poor choice as a storage and archive format. 1.5 About the Transport Protocol Currently, there is no transport protocol specified for exchanging IODEF documents. The working group has realized that this omission is aninpedimentimpediment to interoperability, and is working on identifying candidate protocols. It is likely that SOAP will be used as the messaging envelope, and HTTP will be the underlying transport. 1.6 Related Work The IODEF is only one of several security relevant dataMeijer,Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page6]7] Internet-Draft IODEF Data Modeland Implementation November 2004August 2005 representations being standardized. Specifically, the complementary nature of the Intrusion Detection Message Exchange Format [7] bears mention given that many incidents represented in the IODEF may have first been discovered through the use of intrusion detection system output formatted according to the IDMEF. Given this relationship, the IODEF data model makes use of certain classes defined in the IDMEF data model.Meijer,Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page7]8] Internet-Draft IODEF Data Modeland Implementation November 2004August 2005 2. Formatting Issues 2.1 IODEF XML Documents This document uses three notations: the Unified Modeling Language (UML) to describe the data model, an XMLDocument Type Definition (DTD)Schema to define the IODEF syntax, and IODEF XML markup conforming to the specifiedDTDSchema to represent the incident data. This section describes the XML notations and conventions used in this document and explains particular issues related to using them to describe the IODEF data model and syntax. For readers unfamiliar with these notations [17] and [7] will provide a comprehensive reference. 2.1.1 The Document Prolog The "prolog" of an XML document, that part that precedes anything else, consists of the XML declaration and the document type declaration. 2.1.1.1 XML Declaration Every IODEF document MUST begin with an XML declaration, and MUST specify the XML version used. If UTF-8 encoded is not used, the character encoding MUST also be explicitly specified. The XML declaration with no character encoding will read as follows: <?xml version="1.0" ?> When a character encoding is specified, the XML declaration will read like the following: <?xml version="1.0" encoding="charset" ?> where "charset" is the name of the character encoding as registered with the Internet Assigned Numbers Authority (IANA), see [9]. Consistent with the XML standard, if no encoding is specified for an IODEF document, UTF-8 is assumed. IODEF documents encoded in UTF-16 MUST begin with the Byte Order Mark described by ISO/IEC 10646 Annex E and Unicode Appendix B (the "ZERO WIDTH NO-BREAK SPACE" character, #xFEFF). 2.1.1.2 IODEFDTD Formal Public Identifier The formal public identifier (FPI) forNamespace Each IODEF document must use the IODEFDocument Type Meijer,namespace "iodef" as follows: Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page8]9] Internet-Draft IODEF Data Modeland Implementation November 2004 Definition describedAugust 2005 <IODEF-Document version="1.0" xmlns:iodef="http://iana.org/iodef" xsi:schemaLocation="http://iana.org/iodef/ietf-inch-iodef-1.0.xsd" where the string "http://iana.org/iodef/ietf-inch-iodef-1.0.xsd" is the URI to the schema. 2.1.2 Languages inthis document is: "-//IETF//DTD RFCxxxxthe IODEFv0.0//EN" NOTE: The "RFCxxxx" textIODEF messages SHOULD specify the language in which their contents are encoded. In general, theFPI value willlanguage can bereplacedspecified with theactual RFC number when this document is published as an RFC. This FPI MUST be used in the documentattribute "language" that has reserved typedeclaration within an XML document referencing the IODEF DTD as shown"xs:language" inSection 2.1.1.3. 2.1.1.3 IODEF DTD Document Type Declarationthe top- level element and letting all other elements "inherit" that definition. Thedocument type declarationvalid language codes foran XML document referencingtheIODEF DTD MUST"xs:language" are described in RFC 3066 [6]. If no language is specified, English "en-US" SHOULD bespecified either by referencingassumed. For theFPI (see Section 2.1.1.2) as follows: <!DOCTYPE IODEF-Document PUBLIC "-//IETF//DTD RFCxxxxIODEFv0.0//EN"> or by providing a URIclasses thatreferences a copy of the DTD as follows: <!DOCTYPE IODEF-Document SYSTEM "/path/to/IODEF-Document.dtd"> 2.1.2 White Space Processing All IODEF elementssupportthe "xml:space" attribute. If "xml:space" is set to "preserve," the IODEF processing application MUST treat all white space in the element's content as significant. If "xml:space" is set to "default," the application is free to decide on the handling of the whitepace. 2.1.3 Languagesfree-form text inthe IODEF For the IODEF elementsa language thatsupport free-form text, the "xml:lang" attribute can be used to identifydiffer from thelanguagerest ofits contents. The valid language codes for the "xml:lang" attribute are described in RFC 3066 [6]. IODEF messages SHOULD specify the language in which their contents are encoded. In general,the document, this language can be specifiedwith the "xml:lang"by local attributein the top-level element and letting all other elements "inherit" that definition. If no language is specified, English SHOULD be assumed."xs:language". 2.2 IODEF Data Types The IODEF data model defines a number of data types.Meijer, et al. Expires May 10, 2005 [Page 9] Internet-Draft IODEF Data Model and Implementation November 20042.2.1 Integers Integer attributes are represented by the INTEGER data type. Integer data MUST be encoded in Base 10 or Base 16. Base 10 integer encoding uses the digits '0' through '9' and an optional sign ('+' or '-'). For example, "123", "-456". Base 16 integer encoding uses the digits '0' through '9' and 'a' through 'f' (or their upper case equivalents), and is preceded by the characters "0x". For example, "0x1a2b". 2.2.2 Real Numbers Real (floating-point) attributes are represented by the REAL data type. Real data MUST be encoded in Base 10. Real encoding is that of the POSIX "strtod" library function: an optional sign ('+' or '-') followed by a non-empty string of decimal digits, optionally containing a radix character, then an optional exponent part. An exponent part consists of an 'e' or 'E', followed by an optional sign, followed by one or more decimal digits. For Danyliw, et al. Expires February 3, 2006 [Page 10] Internet-Draft IODEF Data Model August 2005 example, "123.45e02", "-567,89e-03". IODEF-compliant applications MUST support both the '.' and ',' radix characters. 2.2.3 Characters and Strings Single-character attributes are represented by the CHARACTER data type. Multi-character attributes of known length are represented by the STRING data type. Character and string data have no special formatting requirements, other than the need to occasionally use character references to represent special characters. 2.2.4 Multilingual Strings STRING data that represents multi-character attributes in a language different than the default encoding of the document are of the ML_STRING data type. 2.2.5 Bytes Binarydataoctets encoded using character code references (see ) is represented by the BYTE (and BYTE[]) data type. 2.2.6 Hexadecimal Bytes Binarydata MUST beoctets encodedin its entiretyusing a notation where each octet is encoded as a charactercode references (see ). 2.2.5tuple consisting of two hexadecimal digits is represented by the HEXBIN (and HEXBIN[]) data type. 2.2.7 Enumerated Types Enumerated types are represented by the ENUM data type, and consist of an ordered list of acceptable values. Each value has aMeijer, et al. Expires May 10, 2005 [Page 10] Internet-Draft IODEF Data Model and Implementation November 2004representative keyword. Within an IODEFDTD,Schema, the enumerated type keywords are used as attribute values.2.2.62.2.8 Date-Time Strings Date-time strings are represented by the DATETIME data type. Each date-time string identifies a particular instant in time; ranges are not supported. Date-time strings are formatted according to a subset of ISO8601:20008601: 2000 [13] documented in RFC 3339 [12].2.2.7Danyliw, et al. Expires February 3, 2006 [Page 11] Internet-Draft IODEF Data Model August 2005 2.2.9 Port Lists A list of network ports are represented by the PORTLIST data type, and consist of a comma-separated list of numbers (individual integers) and ranges (N-M means ports N through M, inclusive). Any combination of numbers and ranges may be used in a single list. For example, "5-25,37,42,43,53,69-119,123-514".2.2.82.2.10 Postal Address A postal address is represented by the POSTAL data type. The format of this address data is documented in Sections 5.17 - 5.19 of RFC 2256 [10].2.2.92.2.11 Person or Organization The name of an individual or organization is represented by the NAME data type. The format of the NAME data type is documented in Section 5.4 of RFC 2256 [10].2.2.102.2.12 Telephone and Fax Numbers A telephone number is represented by the PHONE data type. The format of the PHONE data type is documented in Section 5.21 of RFC 2256 [10].2.2.112.2.13 Email string An email address is represented by the EMAIL data type. The format of the EMAIL data type is documented in Section 3.4.1 RFC 2822 [11]2.2.122.2.14 Uniform Resource Identifier strings A uniform resource identifier (URI) is represented by the URI data type. The format of the URI data type is documented in RFC 2396 [8].Meijer, et al. Expires May 10, 2005 [Page 11] Internet-Draft IODEF Data Model and Implementation November 2004 2.2.132.2.15 Timezone string A timezone offset from UTC is represented by the TIMEZONE data type.Its formatIt isyetformatted according tobe specified. 2.2.14the following regular expression: [+-][0-9][0-9][0-9][0-9]. 2.2.16 Unique Identifiers A unique identifier in the context of particular creator of IODEF documents (e.g., a CSIRT) is represented by the UID data type. A globally unique identifier is represented by the GUID data type. The UID and GUID data types are constructed from alphanumeric strings.Meijer,Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page 12] Internet-Draft IODEF Data Modeland Implementation November 2004August 2005 3. The IODEF Data Model In this section, the individual components of the IODEF data model will be discussed in detail. For each class, the semantics will be documented and the relationship with other classes with be depicted with UML. 3.1 IODEF-Document class The IODEF-Document class is the top level class in the IODEF data model. All IODEF documents are an instance of this class. +-----------------+ | IODEF-Document | +-----------------+ | STRING version |<>--{1..*}--[ Incident ] | | +-----------------+ Figure 1: IODEF-Document class The aggregate class that constitutes IODEF-Document is: Incident One or more. The information related to a single incident. The IODEF-Document class has one attribute: version Required. STRING. The IODEF specification version number to which the IODEF document conforms. The value of this attribute MUST be 1.0 3.2 Incident class Every incident is represented by an instance of the Incident class. This class provides a standardized representation for commonly exchanged incident data and associates a CSIRT assigned unique identifier with the described activity.Meijer,Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page 13] Internet-Draft IODEF Data Modeland Implementation November 2004August 2005 +-------------------+ | Incident | +-------------------+ | ENUM purpose |<>----------[ IncidentID ] | ENUM restriction |<>--{0..1}--[ AlternativeID ] | |<>--{0..1}--[ RelatedActivity ] | |<>--{0..*}--[ Description ] | |<>--{1..*}--[ Assessment ] | |<>--{0..*}--[ Method ] | |<>--{0..1}--[ DetectTime ] | |<>--{0..1}--[ StartTime ] | |<>--{0..1}--[ EndTime ] | |<>----------[ ReportTime ] | |<>--{1..*}--[ Contact ] | |<>--{0..*}--[ Expectation ] | |<>--{0..1}--[ History ] | |<>--{0..*}--[ EventData ] | |<>--{0..*}--[ AdditionalData ] +-------------------+ Figure 2: the Incident class The aggregate classes that constitute Incident are: IncidentID One. An incident tracking number assigned to this incident by the CSIRT that generated the IODEF document. AlternativeID Zero or one. A list of incident tracking numbers used by other CSIRTs to refer to the incident described in the document. RelatedActivity Zero or one. A list of incident tracking numbers of related incidents. Description Zero or more.STRING.ML_STRING. A free-form textual description of the incident. Assessment One or more. A characterization of the impact of the incident. Method Zero or more. The techniques used by the intruder in the incident.Meijer,Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page 14] Internet-Draft IODEF Data Modeland Implementation November 2004August 2005 DetectTime Zero or one. The time the incident was first detected. StartTime Zero or one. The time the incident started. EndTime Zero or one. The time the incident ended. ReportTime One. The time the incident was reported. Contact One or more. Contact information for the parties involved in the incident. Expectation Zero or more. Expected action to be performed by the recipient of the document. History Zero or one. A log of significant events or actions that occurred during the course of handling the incident. EventData Zero or more. Description of the events comprising the incident, AdditionalData Zero or more. Mechanism by which to extend the data model. The Incident class has two attributes: purpose Required. ENUM. The purpose attribute represents the reason why the IODEF document was created. It is closely related to the Expectation class (Section 3.9). This attribute is defined as an enumerated list: 1.handling.traceback. The document was sent forincident-handlingtrace-back purposes; 2.statistics.mitigation. The document was sent tobe includedrequest aid ina data-repository for statistical purposes;mitigating the described activity; 3.warning.reporting. The document was sentas a warning;to comply with reporting requirements; 4. other. The document was sent for purposes specified in the Expectationelement. Meijer,class. Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page 15] Internet-Draft IODEF Data Modeland Implementation November 2004August 2005 restriction Optional. ENUM. This attribute indicates the disclosure guidelines to which the sender expects the recipient of theIODEF-DocumentIODEF- Document to adhere. Naturally, this provides no real security since it is the choice of the recipient of the document to honor this guideline. The value of this attribute is logically inherited by the children of this class. That is to say, the disclosure rules applied to this class, also apply to its children. It is possible to set a granular disclosure policy, since all of the high-level classes (i.e., children of the Incident class) have a restriction attribute. Therefore, a child can override the guidelines of a parent class, be it to restrict or relax the disclosure rules (i.e., a child has a weaker policy than an ancestor; or an ancestor has a weak policy, and the children selectively apply more rigid controls). The implicit value of the restriction attribute for a class that did not specify one can be found in the closest ancestor that did specify a value. This attribute is defined as an enumerated value with a default value of "private". Note that the default value of the restriction attribute is only defined in the context of the Incident class. In other classes where this attribute is used, no default is specified. 1. public. There are no restrictions placed in the information; 2. need-to-know. The information may be shared with other parties that are involved in the incident (e.g., multiple victim sites can be informed of each other); 3. private. The information may not be shared. 4. default. The information can be shared according to an information disclosure policy pre-arranged by the communicating parties. 3.3 IncidentID class The IncidentID class represents an incident tracking number (UID) that is unique in the context of the CSIRT and identifies the activity characterized in an IODEF-Document.Meijer,Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page 16] Internet-Draft IODEF Data Modeland Implementation November 2004August 2005 +------------------+ | IncidentID | +------------------+ | UID | | | | GUID name | +------------------+ Figure 3: the IncidentID class The IncidentID class has one attribute: name Required. GUID. An identifier for the CSIRT that created the IODEF-Document. 3.4 AlternativeID class The AlternativeID class lists the incident tracking numbers used by other CSIRTs to refer to activity described in this IODEF document. Thus, a tracking number listed as an AlternativeID references the same incident detected by another CSIRT. The incident tracking numbers of the CSIRT that generated the IODEF document should never be considered an AlternativeID. +------------------+ | AlternativeID | +------------------+ | ENUM restriction |<>--{1..*}--[ IncidentID ] | | +------------------+ Figure 4: the AlternativeID class The aggregate class that constitutes AlternativeID is: IncidentID One or more. The incident tracking number of another CSIRT. The AlternativeID class has one attribute: restriction Optional. ENUM. This attribute has been defined in Section 3.2.Meijer,Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page 17] Internet-Draft IODEF Data Modeland Implementation November 2004August 2005 3.5 RelatedActivity class The RelatedActivity class lists the incident tracking numbers of incidents that are related to the one described in the IODEF document. These references may be to local incident tracking numbers, as well as, to those of other CSIRTs. The specifics of how a CSIRT came to believe that two incidents are related is considered out of scope. +------------------+ | RelatedActivity | +------------------+ | ENUM restriction |<>--{1..*}--[ IncidentID ] | | +------------------+ Figure 5: RelatedActivity class The aggregate class that constitutes RelatedActivity is: IncidentID One or more. The incident tracking number of a related incident. The RelatedActivity class has one attribute: restriction Optional. ENUM. This attribute has been defined in Section 3.2. 3.6 AdditionalData The AdditionalData class serves as an extension mechanism for information not otherwise represented in the data model. For relatively simple information, atomic data types (e.g., integers, strings) are provided with a mechanism to annotate their meaning. The class can also be used to extend the data modeland(and theDTDassociated Schema) to support proprietary extensions by encapsulating entire XML documents conforming to anotherDTDSchema (e.g., IDMEF). A detailed discussion for extending the data model and theDTDSchema can be found in Section 4. Unlike XML, which is self-describing, atomic data must be documented to convey its meaning. This information is described in the 'meaning' attribute. Since these description are outside the scope Danyliw, et al. Expires February 3, 2006 [Page 18] Internet-Draft IODEF Data Model August 2005 of the specification, some additional coordination may be required to ensure that a recipient of a document using the AdditionalData classes can make sense of the custom extensions.Meijer, et al. Expires May 10, 2005 [Page 18] Internet-Draft IODEF Data Model and Implementation November 2004+------------------+ | AdditionalData | +------------------+ | ANY | | | | ENUM restriction | | ENUM type | | STRING meaning | +------------------+ Figure 6: the AdditionalData class The AdditionalData class has three attributes: restriction Optional. ENUM. This attribute has been defined in Section 3.2. type Required. ENUM. The data type of the element content. The permitted values for this attribute are shown below. The default value is "string". 1. boolean. The element contains a boolean value, i.e., the strings "true" or "false" 2. byte. The element content is a single 8-bit byte (see Section2.2.4);2.2.5); 3. character. The element content is a single character (see Section 2.2.3); 4. date-time. The element content is a date-time string (see Section2.2.6);2.2.8); 5. integer. The element content is an integer (see Section 2.2.1); 6. portlist. The element content is a port list (see Section2.2.7);2.2.9); 7. real. The element content is a real number (see Section 2.2.2); Danyliw, et al. Expires February 3, 2006 [Page 19] Internet-Draft IODEF Data Model August 2005 8. string. The element content is a string (see Section 2.2.3); 9. xml. The element content is XML-tagged data (see Section 4).Meijer, et al. Expires May 10, 2005 [Page 19] Internet-Draft IODEF Data Model and Implementation November 2004meaning Optional. STRING. A description of the semantics of the custom data in this class. 3.7 Contact class The Contact class describes contactinforma tioninformation for organizations and personnel involved in the incident. This class allows for the naming of the involved party, specifying contact information for them, and identifying their role in the incident. People and organizations are treated interchangeably as contacts; one can be associated with the other using the recursive definition of the class (the Contact class is aggregated into the Contact class). The 'type' attribute disambiguates the type of contact information being provided. This recursive definition provides a way to relate information without requiring the explicit use of identifiers in the classes. For example,seperateseparate contact information for two individuals from the same organization would not require duplicating the organization information. +------------------+ | Contact | +------------------+ | ENUM restriction |<>--{0..1}--[ name ] | ENUM role |<>--{0..*}--[ Description ] | ENUM type |<>--{0..*}--[ RegistryHandle ] | |<>--{0..1}--[ PostalAddress ] | |<>--{0..*}--[ Email ] | |<>--{0..*}--[ Telephone ] | |<>--{0..1}--[ Fax ] | |<>--{0..1}--[ Timezone ] | |<>--{0..*}--[ Contact ] +------------------+ Figure 7: the Contact class The aggregate classes that constitute the Contact class are: Danyliw, et al. Expires February 3, 2006 [Page 20] Internet-Draft IODEF Data Model August 2005 name Zero or one. NAME. The name of the contact. The contact may either be an organization or a person. The type attribute disambiguates the semantics.Meijer, et al. Expires May 10, 2005 [Page 20] Internet-Draft IODEF Data Model and Implementation November 2004Description Zero or one.STRING. Free-formML_STRING. A free-form description ofthethis contact. In the case of a person, this is often the organizational title of the individual. RegistryHandle Zero or many. A handle name in a registry. PostalAddress Zero or one. POSTAL. The postal address of the contact formatted according to Section2.2.8.2.2.10. Email Zero or many. EMAIL. The email address of the contact formatted according to Section2.2.11.2.2.13. Telephone Zero or many. PHONE. The telephone number of the contact formatted according to Section2.2.10.2.2.12. Fax Zero or one. PHONE. The facsimile telephone number of the contact formatted according to Section2.2.10.2.2.12. Timezone Zero or one. TIMEZONE. The timezone in which the contact resides formatted according to Section2.2.13.2.2.15. Contact Zero or many. Recursive definition of Contact allowing for the grouping of information. The Contact class has three attributes: restriction Optional. ENUM. This attribute is defined in Section 3.2. role Required. ENUM. Indicates the role the contact fulfills. This attribute is defined as an enumerated list: 1. creator. The entity that generate the IODEF document. Danyliw, et al. Expires February 3, 2006 [Page 21] Internet-Draft IODEF Data Model August 2005 2. admin. An administrative contact for a host or network. 3. tech. A technical contact for a host or network. 4. irt. The CSIRT involved in handling the incident.Meijer, et al. Expires May 10, 2005 [Page 21] Internet-Draft IODEF Data Model and Implementation November 20045. cc. An entity that is to be kept informed about the handling of the incident. type Required. ENUM. Indicates the type of contact being described. This attribute is defined as an enumerated list: 1. person. 2. organization. 3.7.1 RegistryHandle class The RegistryHandle class represents a handle to an Internet registry or community-specific database. A handle consists of a name specified in the element content, and the database to which it belongs specified in the type attribute. +------------------+ | RegistryHandle | +------------------+ | STRING | | | | ENUM type | +------------------+ Figure 8: The RegistryHandle class The RegistryHandle class has one attribute: type Required. ENUM. The database to which the handle belongs. The default value is 'local'. The possible values are: 1. internic. Internet Network Information Center 2. apnic. Asia Pacific Network Information Center Danyliw, et al. Expires February 3, 2006 [Page 22] Internet-Draft IODEF Data Model August 2005 3. arin. American Registry for Internet Numbers 4. lacnic. Regional Latin-American and Caribbean IP Address Registry 5. ripe. Reseaux IP Europeens 6. local. A database local to the CSIRT.Meijer, et al. Expires May 10, 2005 [Page 22] Internet-Draft IODEF Data Model and Implementation November 20043.8 Time classes The data model uses five different classes to represent a timestamp. Their definition is identical, but each has a distinct name to convey a difference in semantics. The element content of each class is a timestamp formated according to the DATETIME data type (see Section2.2.6).2.2.8). +----------------------------------+ | {Start| End| Report| Detect}Time | +----------------------------------+ | DATETIME | +----------------------------------+ Figure 9: the Time classes 3.8.1 StartTime The StartTime class represents the time the incident began. 3.8.2 EndTime The EndTime class represents the time the incident ended. 3.8.3 DetectTime The DetectTime class represents the time the first activity of the incident was detected. 3.8.4 ReportTime The ReportTime class represents the time the incident was reported. This timestamp SHOULD coincide to the time at which the IODEF document is generated. Danyliw, et al. Expires February 3, 2006 [Page 23] Internet-Draft IODEF Data Model August 2005 3.8.5 DateTime The DateTime class is a generic representation of a timestamp. Its semantics should be inferred from the parent class into which it is aggregated. 3.9 Expectation class The Expectation class conveys to the recipient of the IODEF document the actions the sender is requesting.Meijer, et al. Expires May 10, 2005 [Page 23] Internet-Draft IODEF Data Model and Implementation November 2004+------------------+ | Expectation | +------------------+ | ENUM restriction |<>--{1..*}--[ Description ] | ENUM priority |<>--{0..1}--[ StartTime ] | ENUM category |<>--{0..1}--[ EndTime ] | |<>--{0..1}--[ Contact ] +------------------+ Figure 10: the Expectation class The aggregate classes that constitute Expectation are: Description One or many.STRING.ML_STRING. A free-form description of the desired action(s). StartTime Zero or one. The time at which the action should be performed. A timestamp that is earlier than the ReportTime specified in the Incident class denotes that the expectation should be fulfilled as soon as possible. The absence of this element leaves the execution of the expectation to the discretion of the recipient. EndTime Zero or one. The time by which the action should be completed. If the action is not carried out by this time, it should no longer be performed. Contact Zero or one. The expected actor for the action. The Expectations class has three attributes: Danyliw, et al. Expires February 3, 2006 [Page 24] Internet-Draft IODEF Data Model August 2005 restriction Optional. ENUM. This attribute is defined in Section 3.2. priority Optional. ENUM. Indicates the desired priority of the action. This attribute is an enumerated list with no default value. 1. low. Low priority 2. medium. Medium priority 3. high. High priorityMeijer, et al. Expires May 10, 2005 [Page 24] Internet-Draft IODEF Data Model and Implementation November 2004category Optional. ENUM. Classifies the type of action requested. This attribute is an enumerated list with no default value. 1. nothing. No action is requested. Do nothing with the information. 2. contact-site. Contact the listed site in the recipient's constituency. 3. contact-me. Contact the originator of the document. 4. investigate. Investigate the machine(s) listed in the document. 5. block. Block traffic from the machine(s) listed in the document. 6. other. Perform some custom action described in the Description class. 3.10 Method class The Method class describes the methodology used by the intruder to perpetrate the events of the incident. This class can reference well-known vulnerability or exploit databases; the intruder tools used in the attack; and provide a free-form description of the activity. Danyliw, et al. Expires February 3, 2006 [Page 25] Internet-Draft IODEF Data Model August 2005 +------------------+ | Method | +------------------+ | ENUM restriction |<>--{0..*}--[ Classification ] | | | |<>--{0..*}--[ Description ] +------------------+ Figure 11: The Method class The Method class is composed of two aggregate classes. Classification Zero or many. A reference to a well-known vulnerability or exploit databases.Meijer, et al. Expires May 10, 2005 [Page 25] Internet-Draft IODEF Data Model and Implementation November 2004Description Zero or many.STRING.ML_STRING. A free-form text description of the methodology used by the intruder. The Method class has one attribute: restriction Optional. ENUM. This attribute is defined in Section 3.2. 3.10.1 Classification class The Classification class is a reference to an external database of computer vulnerabilities, exposures, or viruses. A reference consists of the database name, the entry name in the database, and the URI to this entry. +------------------+ | Classification | +------------------+ | ENUM restriction |<>----------[ name ] | ENUM origin |<>--{0..1}--[ url ] +------------------+ Figure 12: The Classification class The aggregate classes that constitute Classification: name One. STRING. The key into the database specified in the origin attribute. Danyliw, et al. Expires February 3, 2006 [Page 26] Internet-Draft IODEF Data Model August 2005 url Zero or One. URI. A URL to additional information about the vulnerability or exposure referenced by the name. The Classification class has two attribute: restriction Optional. ENUM. This attribute is defined in Section 3.2. origin Required. ENUM. The name of the database to which the reference is being made. The permitted values are shown below. 1. bugtraqid. Bugtraq 2. cve. Mitre Common Vulnerabilities or ExposuresMeijer, et al. Expires May 10, 2005 [Page 26] Internet-Draft IODEF Data Model and Implementation November 20043. certcc. CERT Coordination Center Vulnerability Catalog 4. vendor. A product vendor whose name should be specified in the name class 5. local. A local database. 6. other. A custom database whose URL is specified in the url class, and the name of the entry is specified in the name class. 3.11 Assessment class The Assessment class describes the technical and non-technical repercussions of the incident on the CSIRT's constituency. Note: The IODEF definition of the Assessment class reuses the IDMEF definition (see Section 4.2.4.5 of [7]), but also extends it. +------------------+ | Assessment | +------------------+ | ENUM restriction |<>--{0..*}--[ Impact ] | |<>--{0..*}--[ TimeImpact ] | |<>--{0..*}--[ MonetaryImpact ] | |<>--{0..1}--[ Confidence ] +------------------+ Figure 13: Assessment class Danyliw, et al. Expires February 3, 2006 [Page 27] Internet-Draft IODEF Data Model August 2005 The aggregate classes that constitute Assessment are: Impact Zero or many. Technical impact of the incident on a network. TimeImpact Zero or many. Impact of the activity measured with respect to time. MonetaryImpact Zero or many. Impact of the activity measured with respect to financial loss. Confidence Zero or one. An estimate of confidence in the assessment.Meijer, et al. Expires May 10, 2005 [Page 27] Internet-Draft IODEF Data Model and Implementation November 2004The Assessment class has one attribute: restriction Optional. ENUM. This attribute is defined in Section 3.2. 3.11.1 Impact class The Impact class allows for categorizing and describing the technical impact of the incident on the network of an organization. Note: The IODEF definition of the Impact class reuses the IDMEF definition (see Section 4.2.6.1 of [7]). 3.11.2 TimeImpact class The TimeImpact class describes the impact of the incident on an organization as a function of time. It provides a way to convey down time and recovery time. +------------------+ | TimeImpact | +------------------+ | REAL | | | | ENUM severity | | ENUM metric | | ENUM units | +------------------+ Figure 14: TimeImpact class Danyliw, et al. Expires February 3, 2006 [Page 28] Internet-Draft IODEF Data Model August 2005 The element content will be a numeric value (REAL) specifying a unit of time. The unit and metric attributes will imply the semantics of the element content. The TimeImpact class has three attributes: severity Optional. ENUM. An estimate of the relative severity of the activity. The permitted values are shown below. There is no default value. 1. low. Low severity 2. medium. Medium severityMeijer, et al. Expires May 10, 2005 [Page 28] Internet-Draft IODEF Data Model and Implementation November 20043. high. High severity metric Required. ENUM. Defines the metric in which the time is expressed. The permitted values are shown below. There is no default value. 1. labor. Total staff-time to recovery from the activity (e.g., 2 employees working 4 hours each would be 8 hours) 2. elapsed. Elapsed time from the beginning of the recovery to its completion. 3. downtime. Duration of time for which some provided service(s) was not available. units Required. ENUM. Defines the units in which the element content is expressed. The permitted values are shown below. The default value is "hours". 1. seconds. Seconds. 2. minutes. Minutes. 3. hours. Hours. 4. days. Days. 3.11.3 MonetaryImpact class The MonetaryImpact class describes the financial impact of the Danyliw, et al. Expires February 3, 2006 [Page 29] Internet-Draft IODEF Data Model August 2005 activity on an organization. For example, this impact may consider losses due to the cost of the investigation or recovery, diminished productivity of the staff, or a tarnished reputation that will affect future opportunities.Meijer, et al. Expires May 10, 2005 [Page 29] Internet-Draft IODEF Data Model and Implementation November 2004+------------------+ | MonetaryImpact | +------------------+ | REAL | | | | ENUM severity | | STRING currency | +------------------+ Figure 15: MonetaryImpact class The element content will be a numeric value (REAL) specifying a unit of currency described in the currency attribute. The MonetaryImpact class has two attributes: severity Optional. ENUM. An estimate of the relative severity of the activity. The permitted values are shown below. There is no default value. 1. low. Low severity 2. medium. Medium severity 3. high. High severity currency Required. ENUM. Defines the currency in which the monetary impact is expressed. The permitted values are defined in ISO 4217:2001, Codes for the representation of currencies and funds [16]. There is no default value. 3.11.4 Confidence class The Confidence class represents a best estimate of the validity and accuracy of the described impact (see Section 3.11) of the incident activity. This estimate can be expressed as a category, or a numeric calculation. Note: The IODEF definition of the Confidence class reuses the IDMEF Danyliw, et al. Expires February 3, 2006 [Page 30] Internet-Draft IODEF Data Model August 2005 definition (see Section 4.2.6.3 of [7]). 3.12 History class The History class is a log of the significant events or actions performed by the involved parties during the course of handling theMeijer, et al. Expires May 10, 2005 [Page 30] Internet-Draft IODEF Data Model and Implementation November 2004incident. The level of detail maintained in this log is left up to the discretion of those handling the incident. +------------------+ | History | +------------------+ | ENUM restriction |<>--{1..*}--[ HistoryItem ] | | +------------------+ Figure 16: The History class The class that constitutes History is: HistoryItem One or many. Entry in the history log of significant events or actions performed by the involved parties. The History class has one attribute: restriction Optional. ENUM. This attribute is defined in Section 3.2. 3.12.1 HistoryItem class The HistoryItem class is an entry in the History (Section 3.12) log that documents a particular action or event that occurred in the course of handling the incident. The details of the entry are a free-form description, but each can be categorized with the type attribute.Meijer,Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page 31] Internet-Draft IODEF Data Modeland Implementation November 2004August 2005 +------------------+ | HistoryItem | +------------------+ | ENUM restriction |<>--{0..1}--[ IncidentID ] | ENUM type |<>----------[ DateTime ] | |<>--{1..*}--[ Description ] +------------------+ Figure 17: HistoryItem class The aggregate classes that constitute HistoryItem are: IncidentID Zero or One. In a history log created by multiple parties, the IncidentID provides a mechanism to specify which CSIRT created a particular entry and references this organization's incident tracking number. When a single organization is maintaining the log, this class can be ignored. DateTime One. Timestamp of the this entry in the history log (e.g., when the action described in the Description was taken). Description One or many. STRING. A free-form textual description of the action or event. The HistoryItem class has two attributes: restriction Optional. ENUM. This attribute has been defined in Section 3.2. type Optional. ENUM. Classifies the type of activity or event documented in this history log entry. The possible values are an enumerated list whose default value is "other": 1. triaged. The incident data was received and processed by an IHS. 2. notification. Notification to an involved party in the incident was sent (e.g., a CSIRT sending a message to the attacking site). 3. shared-info. Information about this incident was shared with party not directly involved.4. received-info. Additional information about the incident was Meijer,Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page 32] Internet-Draft IODEF Data Modeland Implementation November 2004August 2005 4. received-info. Additional information about the incident was received. 5. remediation. The incident has been resolved; a short description may be included. 6. other. A custom entry. 3.13 EventData class The EventData class describes the events of the incident surrounding a particular set of hosts or networks. This description includes the systems from which the activity originated and those targeted, an assessment of the techniques used by the intruder, the impact of the activity on the organization, and any forensic evidence discovered. +------------------+ | EventData | +------------------+ | ENUM restriction |<>--{0..*}--[ Description ] | |<>--{0..1}--[ DetectTime ] | |<>--{0..1}--[ StartTime ] | |<>--{0..1}--[ EndTime ] | |<>--{0..*}--[ Contact ] | |<>--{0..1}--[ Assessment ] | |<>--{0..*}--[ Method ] | |<>--{0..*}--[ Flow ] | |<>--{0..1}--[ Record ] | |<>--{0..*}--[ EventData ] | |<>--{0..*}--[ AdditionalData ] +------------------+ Figure 18: The EventData class The aggregate classes that constitute EventData are: Description Zero or more.STRING.ML_STRING. A free-form textual description of the event. DetectTime Zero or one. The time the event was detected.StartTime Zero or one. The time the event started. Meijer,Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page 33] Internet-Draft IODEF Data Modeland Implementation November 2004August 2005 StartTime Zero or one. The time the event started. EndTime Zero or one. The time the event ended. Contact Zero or more. The different parties involved in the incident Assessment Zero or one. The impact of the incident on the target and the actions taken. Method Zero or more. The methodology used by the intruders. Flow Zero or more. A description of the systems or networks involved. Record Zero or one. Support data (e.g., log files) that provides additional information about the event. EventData Zero or more. Recursive definition of EventData allowing for the grouping of data AdditionalData Zero or one. An extension mechanism for data not explicitly represented in the data model. The EventData class has one attribute: restriction Optional. ENUM. This attribute is defined in Section 3.2. 3.13.1 Relating the Incident and EventData classes There is substantial overlap in the Incident and EventData classes. Nevertheless, the semantics of these classes are quite different. The Incident class provides summary information about the entire incident, while the EventData class provides information about the individual events comprising the incident. In the most common case, the EventData class will provide more specific information for the general description provided in the Incident class. However, it may also be possible that the overall summarized information about the incident conflicts with some individual information in an EventDataclass when there is a substantial composition of various events in the an incident. Meijer,Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page 34] Internet-Draft IODEF Data Modeland Implementation November 2004August 2005 class when there is a substantial composition of various events in the an incident. 3.13.2 Cardinality of EventData The EventData class can be thought of as a container for the properties of an event in an incident. These properties include: the hosts involved, impact of the incident activity on the hosts, forensic logs, etc. With an instance of the EventData class, hosts hosts (i.e., System class) are grouped around these common properties. The recursive definition of the EventData class (the EventData class is aggregated into the EventData class) provides a way to related information without requiring the explicit use of unique attribute identifiers in the classes or duplicating information. Instead, the relative depth (nesting) of a class is used to group (relate) information. Nested EventData classes imply that while the child classes share the properties of the parent, there is some properties for which they do not agree. Therefore, in order express these distinct properties, the nesting approach was used. In such a scheme, a parent EventData class MUST always have more than one EventData child. For example, an EventData class might be used to describe two machines involved in an incident. This description can be achieved using multiple instances of the System class. It happens that there is a common technical contact (i.e., Contact class) for these two machines, but the impact (i.e., Assessment class) on them is different. A depiction of the representation for this situation can be found in Figure 19. +------------------+ | EventData | +------------------+ | |<>----[ Contact ] | | | |<>----[ EventData ]<>----[ System ] | | [ ]<>----[ Assessment ] | | | |<>----[ EventData ]<>----[ System ] | | [ ]<>----[ Assessment ] +------------------+ Figure 19: Recursion in the EventData classMeijer,Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page 35] Internet-Draft IODEF Data Modeland Implementation November 2004August 2005 3.14 Flow class The Flow class groups the source and target hosts or networks in an event. +------------------+ | Flow | +------------------+ | |<>--{1..*}--[ System ] +------------------+ Figure 20: the Flow class The aggregate class that constitutes Flow is: System One or More. A host or network involved in the incident activity. The Flow System class has no attributes. 3.15 System class The System class represents a computer or network involved in the incident. The systems represented by this class are categorized according to the role they played in the incident through the category attribute. The value of this category attribute dictates the semantics of the aggregated classes in the System class. If the category attribute has a value of 'source', then the aggregated classes denote the machine and service from which the activity is originating. With a category attribute value of 'target' or 'intermediary', then the machine or service is the one targeted in the activity.Meijer, et al. Expires May 10, 2005 [Page 36] Internet-Draft IODEF Data Model and Implementation November 2004+------------------+ | System | +------------------+ | ENUM restriction |<>----------[ Node ] | ENUM category |<>--{0..*}--[ Service ] | STRING interface |<>--{0..*}--[CounterOperatingSystem ] | ENUM spoofed||<>--{0..*}--[ Counter ] +------------------+ Figure 21: the System class The aggregate classes that constitute System are: Danyliw, et al. Expires February 3, 2006 [Page 36] Internet-Draft IODEF Data Model August 2005 Node One. A host or network involved in the incident. Service Zero or more. A network service running on the system. OperatingSystem Zero or one. The operating system running on the system. Counter Zero or more. A counter with which tosummarizessummarize properties of this host or network. The System class has four attribute: restriction Optional. ENUM. This attribute is defined in Section 3.2. category Required. ENUM. Classifies the role the host or network played in the incident. The possible values are: 1. source. The System was the source of the attack. 2. target. The System was the target of the attack. 3. intermediate. The System was an intermediary in the attack. interface Optional. STRING. Specifies the interface on which the event(s) on this System originated. If the Node class specifies a network rather than a host, this attribute has no meaning. spoofed Optional. ENUM. An indication of confidenceas toin whether this System was the true target or attacking host. The permitted values for this attribute are shown below. The default value is "unknown".Meijer, et al. Expires May 10, 2005 [Page 37] Internet-Draft IODEF Data Model and Implementation November 20041. unknown. The accuracy of the category attribute value is unknown 2. yes. The category attribute value is probably incorrect. In the case of a source, the System is likely a decoy; with a target, the System was likely not the intended victim. 3. no. The category attribute value is believed to be correct. Danyliw, et al. Expires February 3, 2006 [Page 37] Internet-Draft IODEF Data Model August 2005 3.16 Node class The Node class identifies a host, network device, or network. The base definition of the class is reused from the IDMEF specification, see Section 4.2.7.1 of [7]. However, the class has been extended by adding the NodeRole and DateTime classes. +---------------+ | Node | +---------------+ |ENUM category|<>--{0..1}--[ Location ] | |<>--{0..1}--[ name ] | |<>--{0..*}--[ Address ] | |<>--{0..1}--[ DateTime ] | |<>--{0..*}--[ NodeRole ] | |<>--{0..*}--[ Counter ] +---------------+ Figure 22: The Node class The aggregate classes that constitute Node are: Location Zero or one. STRING. A free-from description of the physical location of the equipment. name Zero or one. STRING. The name of the equipment (e.g., fully qualified domain name). This information MUST be provided if no Address information is given. Address Zero or more. The hardware, network, or application address of the Node. Unless a name is provided, at least one address must be specified.Meijer, et al. Expires May 10, 2005 [Page 38] Internet-Draft IODEF Data Model and Implementation November 2004DateTime Zero or one. A timestamp of when the resolution between the name and address was performed. This information SHOULD be provided if both an Address and name are given. NodeRole Zero or more. The intended purpose of the equipment. Danyliw, et al. Expires February 3, 2006 [Page 38] Internet-Draft IODEF Data Model August 2005 Counter Zero or more. A counter with which to summarizes properties of this host or network.The Node class has one attribute: category Optional. ENUM. The context in which the Address and name classes should be considered, if relevant. The permitted values for this attribute are shown below. The default value is "unknown". 1. unknown. Domain unknown or not relevant 2. ads. Windows 2000 Advanced Directory Services 3. afs. Andrew File System (Transarc) 4. coda. Coda Distributed File System 5. dfs. Distributed File System (IBM) 6. dns. Domain Name System 7. hosts. Local hosts file 8. kerberos. Kerberos realm 9. nds. Novell Directory Services 10. nis. Network Information Services (Sun) 11. nisplus. Network Information Services Plus (Sun) 12. nt. Windows NT domain 13. wfw. Windows for Workgroups Meijer, et al. Expires May 10, 2005 [Page 39] Internet-Draft IODEF Data Model and Implementation November 20043.16.1 Counter class The Counter class summarize multiple occurrences of some event, or conveys counts on various features (e.g., packets, sessions, events). The value of the counter is the element content, with its units represented in the type attribute. The complete semantics are entirely context dependant based on the class in which the Counter is aggregated. +------------------+ | Counter | +------------------+ | INTEGER | | | | ENUM type | | STRING meaning | +------------------+ Figure 23: the Counter class The Counter class has two attribute: type Optional. ENUM. Specifies the units of the element contents. 1. packet. Count of packets. 2. session. Count of sessions 3. event. Count of events 4. other. User defined count meaning Optional. STRING. Describes the semantics of the element content if the type attribute is set to other. 3.16.2 Address The Address class represents a hardware (layer-2), network (layer-3), Danyliw, et al. Expires February 3, 2006 [Page 39] Internet-Draft IODEF Data Model August 2005 or application (layer-7) address. This class was originally derived from the IDMEF specification [7].Meijer, et al. Expires May 10, 2005 [Page 40] Internet-Draft IODEF Data Model and Implementation November 2004+------------------+ | Address | +------------------+ | ENUM category | | STRING vlan-name | | INTEGER vlan-num | +------------------+ Figure 24: the Address class The Address class has four attributes: category Required. ENUM. The type of address represented. The permitted values for this attribute are shown below. The default value is "ipv4-addr". 1. asn. Autonomous System Number 2. atm. Asynchronous Transfer Mode (ATM)2. mac. Media Access Control (MAC)address 3.sna. IBM Shared Network Architecture (SNA) addresse-mail. Electronic mail address (RFC 822) 4. ipv4-addr. IPv4 host address in dotted-decimal notation (a.b.c.d) 5. ipv4-net. IPv4 network address in dotted-decimal notation, slash, significant bits (a.b.c.d/nn) 6. ipv4-net-mask. IPv4 network address in dotted-decimal notation, slash, network mask in dotted-decimal notation (a.b.c.d/w.x.y.z) 7. ipv6-addr. IPv6 host address 8. ipv6-net. IPv6 network address, slash, significant bits 9. ipv6-net-mask. IPv6 network address, slash, network mask 10.vm. IBM VM ("PROFS") email address 11. e-mail. Electronic mail address (RFC 822) 12. lotus-notes. Lotus Notes e-mailmac. Media Access Control (MAC) addressMeijer,Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page41]40] Internet-Draft IODEF Data Modeland Implementation November 2004August 2005 vlan-name Optional. STRING. The name of the Virtual LAN to which the address belongs. vlan-num Optional. STRING. The number of the Virtual LAN to which the address belongs. 3.16.3 NodeRole class The NodeRole class describes (based on a pre-defined list) the function performed by a particular host. +---------------+ | NodeRole | +---------------+ | STRING | | | | ENUM category | +---------------+ Figure 25: The NodeRole class The element content should be empty in all cases other than when the category attribute is set to "other". The NodeRole class has one attributes: category Required. Functionality provided by a node. If a value of "other" is specified, a description SHOULD be provided in the element content. The default value is "other". 1. client. Client computer 2. server-internal. Server with internal services 3. server-public. Server with public services 4. www. WWW server 5. mail. Mail server 6. messaging. Messaging server (e.g. NNTP, IRC, IM)7. streaming. Streaming-media server Meijer,Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page42]41] Internet-Draft IODEF Data Modeland Implementation November 2004August 2005 7. streaming. Streaming-media server 8. voice. Voice server (e.g. SIP, H.323) 9. file. File server (e.g. SMB, CVS, AFS) 10. ftp. FTP server 11. p2p. Peer-to-peer node 12. name. Name server (e.g. DNS, WINS) 13. directory. Directory server (e.g. LDAP, finger, whois) 14. credential. Credential server (e.g. domain controller, Kerberos) 15. print. Print server 16. application. Application server 17. database. Database server 18. infra. Infrastructure server (e.g. router, firewall, DHCP) 19. log. Logserver 20. other. other role not in this list 3.17Process class The Process class describes a running program on a given host involved in an incident. This class is reused outright from the IDMEF specification, see Section 4.2.7.3 of [7]. 3.18Service class The Service class describes a network service of a host or network. The service is identified by specific port or list of ports, along with the application listening on that port. When Service occurs as an aggregate class of a System that is a source, then that the service is the one from which activity of interest is originating. Conversely, when Service occurs as an aggregate class of a System that is a target, then that service is the one to which activity of interest is being directed. This class was originally derived from the IDMEF specification, see Section 4.2.7.4 of [7].Meijer,Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page43]42] Internet-Draft IODEF Data Modeland Implementation November 2004August 2005 +--------------------+ | Service | +--------------------+ | STRING ip_version |<>--{0..1}--[ port ] | STRING ip_protocol |<>--{0..1}--[ portlist ] | |<>--{0..1}--[ Application ] +--------------------+ Figure 26: The Service class The aggregate classes that constitute Service are: port Zero or one. INTEGER. A port number. portlist Zero or one. PORTLIST. A list of port numbers formatted according to Section2.2.7.2.2.9. Application Zero or more. The application bound to the specified port or portlist. The Service class must specify either a port or portlist. The Service class has two attributes: ip_version Required. INTEGER. The IP version number. ip_protocol Required. INTEGER. The IANA protocol number.3.19 Record3.17.1 Application class TheRecord class is a containerApplication classfor log and audit data that provides supportive information about the incident. The source of this data will often be the output of monitoring tools (e.g., IDMEF messages generated bydescribes anIDS, connection logs fromapplication running on aweb server) that were used to uncover the malicious activity. These logs should provide evidence as to whySystem providing aCSIRT believes an incident has occurred. Meijer,Service. Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page44]43] Internet-Draft IODEFDa taData Modeland Implementation November 2004 +------------------+August 2005 +--------------------+ |RecordApplication |+------------------++--------------------+ |ENUM restriction |<>--{1..*}--[ RecordDataSTRING appid |<>--{0..1}--[ name ]+------------------+| STRING configid |<>--{0..1}--[ url ] | STRING vendor | | STRING version | +--------------------+ Figure 27:RecordThe Application class The aggregateclassclasses thatconstitutes Record is: RecordData One or more. Logconstitute Application are: name Zero oraudit data generated by a particular type of sensor. Seperate instancesone. STRING. The name of theRecordData class SHOULD be used for each sensor type.application. url Zero or one. URI. A uri describing the application. TheRecordApplication class hasonefour attributes: appid Optional. STRING. . configid Optional. STRING. . vendor Optional. STRING. . version Optional. STRING. . 3.18 OperatingSystem class The OperatingSystem class describes the operating system running on a System. Danyliw, et al. Expires February 3, 2006 [Page 44] Internet-Draft IODEF Data Model August 2005 +--------------------+ | OperatingSystem | +--------------------+ | STRING | | | | STRING vendor | | STRING version | | STRING patch | +--------------------+ Figure 28: The OperatingSystem class The operating system name listed in the body of the element is further annotated by three attributes: vendor Optional. STRING. Name of the OS vendor. version Optional. STRING. Version number of the OS. patch Optional. STRING. Patch level of the OS. 3.19 Record class The Record class is a container class for log and audit data that provides supportive information about the incident. The source of this data will often be the output of monitoring tools (e.g., IDMEF messages generated by an IDS, connection logs from a web server) that were used to uncover the malicious activity. These logs should provide evidence as to why a CSIRT believes an incident has occurred. +------------------+ | Record | +------------------+ | ENUM restriction |<>--{1..*}--[ RecordData ] +------------------+ Figure 29: Record class The aggregate class that constitutes Record is: Danyliw, et al. Expires February 3, 2006 [Page 45] Internet-Draft IODEF Data Model August 2005 RecordData One or more. Log or audit data generated by a particular type of sensor. Seperate instances of the RecordData class SHOULD be used for each sensor type. The Record class has one attributes: restriction Optional. ENUM. This attribute has been defined in Section 3.2. 3.19.1 RecordData class The RecordData class groups log or audit data from a given sensor (e.g., IDS, firewall log) and provides a way to annotate the output. +------------------+ | RecordData | +------------------+ | ENUM restriction |<>--{0..1}--[ DateTime ] | |<>--{0..*}--[ Description ] | |<>--{0..1}--[AnalyzerApplication ] | |<>--{1..*}--[ RecordItem ] +------------------+ Figure28:30: The RecordData class The aggregate classes that constitutes RecordData is: DateTime Zero or one. Timestamp of the RecordItem data. Description Zero or more.STRING.ML_STRING. Free-form textual description of the provided RecordItem data. At minimum, this description should convey the significance of the provided RecordItem data.Meijer, et al. Expires May 10, 2005 [Page 45] Internet-Draft IODEF Data Model and Implementation November 2004 AnalyzerApplication Zero or one. Information about the sensor used to generate the RecordItem data. RecordItem One or more. Log, audit, or forensic data. The RecordData class has one attributes: Danyliw, et al. Expires February 3, 2006 [Page 46] Internet-Draft IODEF Data Model August 2005 restriction Optional. ENUM. This attribute has been defined in Section 3.2. 3.19.2Analyzer class The Analyzer class identifies the sensor (e.g., IDS, firewall, web server) used to generate particular log or audit data. The definition of the class is reused from the IDMEF specification, see Section 4.2.7.3 of [7]. However, in this context, the definition of an analyzer is expanded beyond merely an IDS. 3.19.3RecordItem class The RecordItem class provides a way to incorporate relevant logs, audit trails, or forensic data to support the conclusions made during the course of analyzing the incident. The class supports both the direct encapsulation of the data, as well as, provides primitives to reference data stored elsewhere. The dtype attribute will dictate the type of log data that will be found in this class. This class is very similar to the AdditionalData class (Section 3.6) in that it is an extension mechanism that can support proprietary representations of security event data, not all of which is necessarily in XML.Meijer, et al. Expires May 10, 2005 [Page 46] Internet-Draft IODEF Data Model and Implementation November 2004+------------------+ | RecordItem | +------------------+ | ANY | | | | ENUM type | | STRING formatid | +------------------+ Figure29:31: The RecordItem class The Recorditem class hasone attribute:two attributes: type Required. The type of data included in the element content. The permitted values for this attribute are shown below. The default value is "string". 1. boolean. The element contains a boolean value, i.e., the strings "true" or "false" 2. byte. The element content is a single 8-bit byte (see Section2.2.4);2.2.5); 3. character. The element content is a single character (see Section 2.2.3); Danyliw, et al. Expires February 3, 2006 [Page 47] Internet-Draft IODEF Data Model August 2005 4. date-time. The element content is a date-time string (see Section2.2.6);2.2.8); 5. integer. The element content is an integer (see Section 2.2.1); 6. portlist. The element content is a port list (see Section2.2.7);2.2.9); 7. real. The element content is a real number (see Section 2.2.2); 8. string. The element content is a string (see Section 2.2.3); 9. file. The element content is a base64 encoded binary file; 10. frame. The element content is a hexbin-encoded layer-2 frame (see Section 2.2.6) 11. packet. The element content is a hexbin-encoded layer-3 packet (see Section 2.2.6) 12. ipv4-packet. The element content is an IPv4 hexbin-encoded packet (see Section 2.2.6) 13. ipv6-packet. The element content is an IPv6 hexbin-encoded packet (see Section 2.2.6) 14. path. The element content is a filesystem path;11.15. url. The element content is a URL (see Section2.2.12;) 12.2.2.14;) 16. xml. The element content is XML-tagged data (see Section 4).Meijer,formatid Optional. An identifier referencing the format and semantics of the encapsulated data. Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page47]48] Internet-Draft IODEF Data Modeland Implementation November 2004August 2005 4. Extending the IODEF In order to support the changing activity of CSIRTS, the IODEF data modeland DTDwill need to evolve along with them. To allow new features to be added, both the data model and theDTDSchema can be extended as described in this section. As these extensions mature, they can be incorporated into future versions of the specification or published separately. 4.1 Extending the data model There are two mechanisms for extending the IODEF data model: inheritance and aggregation. o By using inheritance, new subclasses may be derived and given additional attributes or operations not found in the superclass. o Aggregation allows for entirely new, self-contained classes to be created and associated with a parent class. Of the two extension mechanisms, inheritance is preferred, because it preserves the existing data model and the operations (methods) executed on the classes of the model. There are explicit guidelines for extending the XMLDTDSchema (see Section 4.2) which set limits on where extensions to the data model may be made. 4.2 Extending the XMLDTD There are two ways to extend the IODEFSchema XMLDTD: 1. The AdditionalData (see Section 3.6) and RecordItem (see Section 3.19.3) classes allow implementers to include arbitrary "atomic" data. (e.g., integers, strings). This approach SHOULD be used whenever possible. 2. The AdditionalData and RecordItem classes also allow implementers to extendSchema provides a flexible way of extending the IODEFXML DTD with additional DTDs that describe arbitrarily complexdatatypes and relationships.model by defining extension schemas in a separate namespace. The following guidelines MUST be followed when extending the IODEFDTDSchema with anotherDTD in the extension classes:schema: 1. The IODEFdescriptionextension Schema MUST include an extension namespace definition and provide adocument type declaration (see Section 2.1.1.3);reference to this schema's location per the XML Schema specification: <xs:schema targetNamespace="http://iana.org/iodef-ext1" xmlns:iodef-ext1="http://iana.org/iodef-ext1" xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified"> 2. Thedocument type declaration MUST define a parameter entity that containsimport of thelocationbase namespace and declaration of the base IODEF schema can be added to the extensionDTD, and then reference Meijer,Schema Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page48]49] Internet-Draft IODEF Data Modeland Implementation November 2004 that entity: <!DOCTYPE IODEF-Document SYSTEM "/path/to/IODEF-Document.dtd" [ <!ENTITY % x-extension SYSTEM "/path/to/extension.dtd"> % x-extension; ]> In this example, the "x-extension" parameter entity is defined and then referenced, causing the DTD for the extension to be read by the XML parser.August 2005 <xs:schema targetNamespace="http://iana.org/iodef-ext1" xmlns:iodef-ext1="http://iana.org/iodef-ext1" xmlns:iodef="http://iana.org/iodef" xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" attributeFormDefault="unqualified" > <xs:import namespace="http://iana.org/iodef" schemaLocation="http://iana.org/iodef/ietf-inch-iodef-1.0.xsd"> 3. Thenamelocation of theparameter entity defined for this purpose MUSTextension schema should bea string beginning with "x-"; there are no other restrictions onreferenced in thename (other than those imposed onXML document that uses it. <IODEF-Document xmlns:iodef-ext1="http://iana.org/iodef-ext1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://iana.org/iodef-ext1 http://iana.org/iodef-ext1/ietf-inch-iodef-ext1.xsd"> 4. It is RECOMMENDED that allentity names by XML). Multipleextensions starts with "iodef-" prefix and add specific extension abbreviation such as "ext1". 5. It may beincluded by defining multiple entities and referencing them. For example: <!DOCTYPE IODEF-Document SYSTEM "/path/to/IODEF-Document.dtd" [ <!ENTITY % x-extension SYSTEM "/path/to/extension.dtd"> <!ENTITY % x-another SYSTEM "/path/to/another.dtd"> %x-extension; %x-another; ]> 3. Extension DTDs MUST declare all of their elementsconvenient to add a reference to the extension schema andattribute simport this extension namespace to the base IODEF schema. Elements defined in the extension schema can be used ina separate XML namespace. Extension DTDs MUST NOT declareanyelements or attributesplace in final IODEF document. In the"IODEF" or default namespaces. For example,example below, the"test""iodef-xws" extensionmight be declared as follows: <!ELEMENT test:test ( test:a, test:b, test:c )> <!ATTLIST test:test xmlns CDATA #IMPLIED xmlns:test CDATA #IMPLIED > <!ELEMENT test:a (#PCDATA)> <!ATTLIST test:a test:attr CDATA #IMPLIED > <!ELEMENT test:b (#PCDATA)> <!ELEMENT test:c (#PCDATA)> 4. Extensions MUST only be included inis defined by theAdditionalData or RecordItem classes whose "type" attributeschema that contains one element "iodef- xws:Principal". This element is"xml". For example: Meijer,composed of the NameIdentifier element of XML type NCName and imports "iodef:Description" element from the master IODEF schema. Danyliw, et al. ExpiresMay 10,February 3, 2006 [Page 50] Internet-Draft IODEF Data Model August 2005 <xs:schema targetNamespace="http://iana.org/iodef-xws" elementFormDefault="qualified" attributeFormDefault="unqualified" xmlns:iodef-xws="http://iana.org/iodef-xws" xmlns:iodef="http://iana.org/iodef" xmlns:xs="http://www.w3.org/2001/XMLSchema"> <xs:import namespace="http://iana.org/iodef" schemaLocation="http://iana.org/iodef/ietf-inch-iodef-1.0.xsd"> <xs:element name="Principal" type="iodef-xws:PrincipalType"/> <xs:complexType name="PrincipalType"> <xs:sequence> <xs:element ref="iodef-xws:NameIdentifier"/> <xs:element ref="iodef:Description" minOccurs="0"/> </xs:sequence> <xs:attribute name="principalcat" type="xs:string"/> </xs:complexType> <xs:element name="NameIdentifier" type="iodef-xws:NameIdentifierType"/> <xs:complexType name="NameIdentifierType" type="xs:NCName"> </schema> In the example below, the above defined extension is used in the iodef:System element. Danyliw, et al. Expires February 3, 2006 [Page49]51] Internet-Draft IODEF Data Modeland Implementation November 2004August 2005 <IODEF-Documentversion="0.0">xmlns:iodef="http://iana.org/iodef" xmlns:iodef-xws="http://iana.org/iodef-xws" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://iana.org/iodef http://iana.org/iodef-xws/draft-ietf-inch-iodef-1.0.xsd" xsi:schemaLocation="http://iana.org/iodef-xws http://iana.org/iodef-xws/draft-ietf-inch-iodef-xws.xsd" version="1.0"> <Incidentident="..."> ... <AdditionalData type="xml"> <test:test xmlns:test="http://www.ietf.org/iodef/test.html" xmlns="http://www.ietf.org/iodef/test.html"> <test:a test:attr="...">...</test:a> <test:b>...</test:b> <test:c>...</test:c> </test:test> </AdditionalData> </Incident> </IODEF-Document> Meijer,restriction="private" purpose="traceback"> <IncidentID Issuer="String" restriction="default">Text</IncidentID> [.....] <iodef:System restriction="default" interface="VLAN" systemcat="source" spoofed="unknown"> [.....] <iodef-xws:Principal iodef-xws:principalcat="other"> <NameIdentifier>CN=Yuri Demchenko, OU=AIRG, O=UvA, S=NH, L=Holland, C=NL</NameIdentifier> </iodef-xws:Principal> </iodef:System> Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page50]52] Internet-Draft IODEF Data Modeland Implementation November 2004August 2005 5. Processing Considerations The IODEF documents MUST be well-formed, and when practical, SHOULD also be valid.It is expected that IODEF-compliant applications will normally not include the IODEF DTD in their communications. Instead, the DTD will be referenced in the document type declaration section of the IODEF document (see Section 2.1.1.3).On occasion, an IODEF-compliant application may receive a well- formed, or well-formed and valid IODEF document containing tags or content in the tags that are not expected. These spurious conditions might include: o Unrecognized tags used in one of the extension classes (i.e., AdditionalData or RecordItem); o Unrecognized tags outside of the extension classes; or o Well-formed and validate document where element or attribute values to not conform to the expected values identified by an enumerated list; IODEF-compliant applications MUST continue to process IODEF documents that contain unknown tags, provided that these documents arewell-formed.well- formed. It is up to the individual application to decide how to process any content from the unknown tag.Meijer,Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page51]53] Internet-Draft IODEF Data Modeland Implementation November 2004August 2005 6. Internationalization issues Internationalization and localization is of specific concern to the IODEF, since it is only through collaboration, often across language barriers, that certain incidents be resolved. The IODEF supports this goal by depending on XML constructs, and through explicit design choices in the data model. The IODEF leverages that XML natively supports different characterencodings. This flexibility allowsencodings that is specified for whole document. The default encoding is UTF-8 whereby allowing information encoded in an IODEF document to be inmost languages.all languages that are supported by UCS/Unicode. In order to disambiguate the explicit languageusedon a per-element basis,XML provides the xml:lang attribute. Usingthexml:langxs: language attributeallowsis used. For theIODEF to make use of multiplelanguagesinthat do not use UTF-8 encoding (e.g., Chinese Big5 or Japanese ISO-2022-JP), thesame document.IODEF schema uses the MultilingTextType type that allows a binary transformation of non-UTF-8 encoded text. The intent of the data model was to provide internationalization and localization, but not to the detriment of inter-operability. While IODEF does support different languages, the data model also relies heavily on standardized enumerated attributes that can crudely approximate the contents of the document. With this approach, a CSIRT should be able to make some sense of an IODEF document it might receive that uses a language unfamiliar to its analysts. Likewise, the data model was designed so that classes where free-text might be used for descriptive purposes always have a one-to-many cardinality with its parent (i.e., Description class). The primary intent of this design was to allow the same description to be repeated in another instance of the class but in a different language. This approach allows recipients speaking different languages to receive the identical document, but allows the IODEF parser to select the appropriate language.Meijer,Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page52]54] Internet-Draft IODEF Data Modeland Implementation November 2004August 2005 7. Examples This section provides representative examples of incident data converted to an IODEF document. 7.1 Code Red detection notification The following email message is a typical example of an incident report where one host is infected with a worm. The original report sent by email is presented in Figure34,37, and the corresponding equivalent as an IODEF document is shown below. From e-citizen@domain.com Date: 13 Sep 2001 23:19:24 -0000 To: cert-domain@domain.com Subject: 10.1.1.2 - Code Red Virus detected Automated message, you don't have to reply to this email. Your system with the IP number 10.1.1.2 seems to be infected with the Code Red virus. For more information see http://www.domain.org/react/code_redII.html Please fix the problem or inform a person who is responsible for that machine to do so. >From our web server logs (Port 80): 10.1.1.2 - - [13/Sep/2001:18:11:21 +0200] "GET /default.ida?XXXXXXXXXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX Figure34:37: Code Red detection notification: initial report <IODEF-Document version="1.0"> <Incident restriction="need-to-know" purpose="handling"> <IncidentID name="CERT-DOMAIN.COM">CERT-DOMAIN.COM#189</IncidentID> <Description>Host sending out Code Red probes</Description> <Assessment> <Impact severity="low" completion="failed" type="none"></Impact> </Assessment> <ReportTime>2001-09-13T23:19:24+00:00</ReportTime> <Contact role="creator" role="irt" type="organization">Meijer,Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page53]55] Internet-Draft IODEF Data Modeland Implementation November 2004August 2005 <name>CERT-FOR-OUR-DOMAIN.PL</name> <Email>cert-for-our-domain.pl@ourdomain.pl</Email> </Contact> <Contact role="tech" type="organization"> <name>Constituency-contact for 10.1.1.2</name> <Email>Constituency-contact@10.1.1.2.pl</Email> </Contact> <Expectation category="investigate"> <Description>Track and clean host</Description> </Expectation> <EventData> <Flow> <System category="source"> <Node> <Address category="ipv4-addr">10.1.1.2</Address> </Node> </System> <System category="target"> <Service ip_version=4" ip_protocol="6"> <port>80</port> </Service> </System> </Flow> <Record> <RecordData> <DateTime>2001-09-13T18:11:21+02:00</DateTime> <Description>Web-server logs</Description> <RecordItem> 10.1.1.2 - - [13/Sep/2001:18:11:21 +0200] "GET /default.ida?XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX </RecordItem> </RecordData> </Record> </EventData> <History> <HistoryItem type="notification"> <Description>Notification sent to Constituency-contact@10.1.1.2 </Description> <DateTime>2001-09-14T08:19:01+00:00</DateTime> </HistoryItem> </History> </Incident> </IODEF-Document>Meijer,Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page54]56] Internet-Draft IODEF Data Modeland Implementation November 2004August 2005 Figure35:38: Code Red detection notification: CSIRT response 7.2 IODEF-Document with XML signature 7.3 IODEF-Document encrypted using XML encryption 7.4 IODEF-Document encrypted and signed using XML signature & encryptionMeijer,Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page55]57] Internet-Draft IODEF DataModel and Implementation November 2004Model August 2005 8. The IODEF DocumentType DefinitionSchema <?xml version="1.0" encoding="UTF-8"?> <xs:schema targetNamespace="draft-ietf-inch-iodef-043.xsd" elementFormDefault="qualified" attributeFormDefault="unqualified" xmlns:iodef="draft-ietf-inch-iodef-043.xsd" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:ds="http://www.w3.org/2000/09/xmldsig#"> <xs:import namespace="http://www.w3.org/2000/09/xmldsig#" schemaLocation="http://www.w3.org/TR/xmldsig-core/xmldsig-core-schema.xsd"/> <!-- ******************************************************************** ******************************************************************** *** Incident Object Description and Exchange FormatDTDXML Schema *** *** Version01, November 200404, August 2005 *** *** draft-ietf-inch-iodef-04 *** ******************************************************************** ******************************************************************** --><!ENTITY % attlist.iodef " version CDATA #FIXED '0.30' "><!-- ==================================================================== == Element definitions == ==================================================================== --> <!--========================================================================================================================================= == IODEF-Document class == ==================================================================== --><!ELEMENT IODEF-Document (Incident+)> <!ATTLIST IODEF-Document %attlist.iodef; xmlns:iodef CDATA #FIXED "urn:iana:xml:ns:iodef" ><xs:annotation> <xs:documentation>Root Element IODEF-Document</xs:documentation> </xs:annotation> <xs:element name="IODEF-Document"> <xs:complexType> <xs:sequence> <xs:element ref="iodef:Incident"/> <xs:element ref="ds:Signature" minOccurs="0" maxOccurs="unbounded"/> </xs:sequence> <xs:attribute name="version" type="xs:string" fixed="0.40"/> </xs:complexType> Danyliw, et al. Expires February 3, 2006 [Page 58] Internet-Draft IODEF Data Model August 2005 </xs:element> <!-- ========================================================================= Incident class===== ==================================================================== --><!ELEMENT Incident (IncidentID, AlternativeID?, RelatedActivity?, Description*, Contact+, ReportTime, DetectTime?, StartTime?, EndTime?, Expectation*, Method*, Assessment+, EventData*, History?, AdditionalData*)> <!ATTLIST Incident restriction %attvals.restriction; "private" purpose %attvals.purpose; #REQUIRED ><xs:element name="Incident"> <xs:complexType> <xs:sequence> <xs:element ref="iodef:IncidentID"/> <xs:element ref="iodef:AlternativeID" minOccurs="0"/> <xs:element ref="iodef:RelatedActivity" minOccurs="0"/> <xs:element ref="iodef:Description" minOccurs="0" maxOccurs="unbounded"/> <xs:element ref="iodef:Contact" maxOccurs="unbounded"/> <xs:element ref="iodef:ReportTime"/> <xs:element ref="iodef:DetectTime" minOccurs="0"/> <xs:element ref="iodef:StartTime" minOccurs="0"/> <xs:element ref="iodef:EndTime" minOccurs="0"/> <xs:element ref="iodef:Expectation" minOccurs="0" maxOccurs="unbounded"/> <xs:element ref="iodef:Method" minOccurs="0" maxOccurs="unbounded"/> <xs:element ref="iodef:Assessment" maxOccurs="unbounded"/> <xs:element ref="iodef:EventData" minOccurs="0" maxOccurs="unbounded"/> <xs:element ref="iodef:History" minOccurs="0"/> <xs:element ref="iodef:AdditionalData" minOccurs="0" maxOccurs="unbounded"/> </xs:sequence> <xs:attribute ref="iodef:restriction" default="private"/> <xs:attribute ref="iodef:purpose" use="required"/> </xs:complexType> </xs:element> <!-- ==================================================================== == IncidentID class == ==================================================================== --><!ELEMENT IncidentID (#PCDATA)> <!ATTLIST IncidentID name CDATA #IMPLIED Meijer, et al. Expires May 10, 2005 [Page 56] Internet-Draft IODEF Data Model and Implementation November 2004 restriction %attvals.restriction; #IMPLIED ><xs:element name="IncidentID" type="iodef:IncidentIDType"/> <xs:complexType name="IncidentIDType" mixed="true"> <xs:attribute name="Issuer" type="xs:string" use="required"/> <xs:attribute ref="iodef:restriction"/> </xs:complexType> <!-- ==================================================================== == AlternativeID class == ==================================================================== --><!ELEMENT AlternativeID (IncidentID+)> <!ATTLIST AlternativeID restriction %attvals.restriction; #IMPLIED ><xs:element name="AlternativeID"> <xs:complexType> Danyliw, et al. Expires February 3, 2006 [Page 59] Internet-Draft IODEF Data Model August 2005 <xs:sequence> <xs:element ref="iodef:IncidentID" maxOccurs="unbounded"/> </xs:sequence> <xs:attribute ref="iodef:restriction"/> </xs:complexType> </xs:element> <!-- ==================================================================== == RelatedActivity class == ==================================================================== --><!ELEMENT RelatedActivity (IncidentID+)> <!ATTLIST RelatedActivity restriction %attvals.restriction; #IMPLIED ><xs:element name="RelatedActivity"> <xs:complexType> <xs:sequence> <xs:element ref="iodef:IncidentID" maxOccurs="unbounded"/> </xs:sequence> <xs:attribute ref="iodef:restriction"/> </xs:complexType> </xs:element> <!-- ==================================================================== === AdditionalData class === ==================================================================== --><!ELEMENT AdditionalData ANY> <!ATTLIST AdditionalData restriction %attvals.restriction; #IMPLIED type %attvals.dtype; #REQUIRED meaning CDATA #IMPLIED ><xs:element name="AdditionalData" type="iodef:AdditionalDataType"/> <xs:complexType name="AdditionalDataType"> <xs:sequence> <xs:any namespace="##any" processContents="lax" minOccurs="0" maxOccurs="unbounded"/> <!-- (0,unbounded) elements from any (target and external) namespace --> </xs:sequence> <xs:attribute ref="iodef:dtype" use="required"/> <xs:attribute name="meaning" type="xs:string"/> </xs:complexType> <!-- ==================================================================== === Contact class === === - Name === - RegistryHandle === - PostalAddress === - Email === - Telephone === - Fax === -TimezoneTimeZone === - Contact (recursive) ==================================================================== --><!ELEMENT Contact (Name?, Description*, RegistryHandle*, PostalAddress?, Email*, Telephone*, Fax?, Timezone, Contact*)> <!ATTLIST Contact contactrole (creator | admin | tech | irt | cc) #REQUIRED contacttype (person | organization) #REQUIRED Meijer,<xs:element name="Contact"> <xs:complexType> Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page57]60] Internet-Draft IODEF Data Modeland Implementation November 2004 restriction %attvals.restriction; #IMPLIED > <!ELEMENT RegistryHandle (#PCDATA)> <!ATTLIST RegistryHandle type %attvals.registrytype; "local" > <!ELEMENT PostalAddress (#PCDATA)> <!ATTLIST PostalAddress lang NMTOKEN #IMPLIED > <!ELEMENT Email (#PCDATA)> <!ELEMENT Telephone (#PCDATA)> <!ELEMENT Fax (#PCDATA)>August 2005 <xs:sequence> <!-- <xs:element ref="iodef:NameIdentifier" minOccurs="0"/> --> <xs:element ref="iodef:name" minOccurs="0"/> <xs:element ref="iodef:Description" minOccurs="0" maxOccurs="unbounded"/> <xs:element ref="iodef:RegistryHandle" minOccurs="0" maxOccurs="unbounded"/> <xs:element ref="iodef:PostalAddress" minOccurs="0"/> <xs:element ref="iodef:Email" minOccurs="0" maxOccurs="unbounded"/> <xs:element ref="iodef:Telephone" minOccurs="0" maxOccurs="unbounded"/> <xs:element ref="iodef:Fax" minOccurs="0"/> <xs:element ref="iodef:TimeZone" minOccurs="0"/> <xs:element ref="iodef:Contact" minOccurs="0" maxOccurs="unbounded"/> </xs:sequence> <xs:attribute ref="iodef:contactrole" use="required"/> <xs:attribute ref="iodef:contacttype" use="required"/> <xs:attribute ref="iodef:restriction"/> </xs:complexType> </xs:element> <!--<xs:attribute ref="iodef:format"/> --> <xs:element name="RegistryHandle"> <xs:complexType mixed="true"> <xs:attribute ref="iodef:registrytype" use="required"/> </xs:complexType> </xs:element> <xs:element name="PostalAddress"> <xs:complexType mixed="true"> <xs:attribute name="lang" type="xs:language"/> </xs:complexType> </xs:element> <xs:element name="Email" type="xs:string"/> <xs:element name="Telephone" type="xs:string"/> <xs:element name="Fax" type="xs:string"/> <!-- ==================================================================== === Time-based classes ====== - DateTime === - ReportTime === - DetectTime === - StartTime === - EndTime==================================================================== --><!ELEMENT DateTime (#PCDATA)> <!ELEMENT ReportTime (#PCDATA)> <!ELEMENT DetectTime (#PCDATA)> <!ATTLIST DetectTime <!ELEMENT StartTime (#PCDATA)> <!ELEMENT EndTime (#PCDATA)><xs:element name="DateTime" type="xs:dateTime"/> <xs:element name="ReportTime" type="xs:dateTime"/> <xs:element name="DetectTime" type="xs:dateTime"/> <xs:element name="StartTime" type="xs:dateTime"/> <xs:element name="EndTime" type="xs:dateTime"/> <xs:element name="TimeZone" type="iodef:TimeZoneType"/> <xs:simpleType name="TimeZoneType"> <xs:restriction base="xs:string"> <xs:pattern value="[+-][0-9][0-9][0-9][0-9]"/> </xs:restriction> </xs:simpleType> <!-- Danyliw, et al. Expires February 3, 2006 [Page 61] Internet-Draft IODEF Data Model August 2005 ==================================================================== === History class === === - HistoryItem ==================================================================== --><!ELEMENT History (HistoryItem+)> <!ATTLIST History restriction %attvals.restriction; #IMPLIED > <!ELEMENT HistoryItem (DateTime, IncidentID?, Description+)> <!ATTLIST HistoryItem type %attvals.historycat; #IMPLIED restriction %attvals.restriction; #IMPLIED ><xs:element name="History"> <xs:complexType> <xs:sequence> <xs:element ref="iodef:HistoryItem" maxOccurs="unbounded"/> </xs:sequence> <xs:attribute ref="iodef:restriction" default="default"/> </xs:complexType> </xs:element> <xs:element name="HistoryItem"> <xs:complexType> <xs:sequence> <xs:element ref="iodef:DateTime"/> <xs:element ref="iodef:IncidentID" minOccurs="0"/> <xs:element ref="iodef:Description" maxOccurs="unbounded"/> </xs:sequence> <xs:attribute ref="iodef:restriction"/> <xs:attribute ref="iodef:historycat" default="other"/> </xs:complexType> </xs:element> <!-- ==================================================================== === Expectation class ===Meijer, et al. Expires May 10, 2005 [Page 58] Internet-Draft IODEF Data Model and Implementation November 2004==================================================================== --><!ELEMENT Expectation (Description+, Contact?, StartTime?, EndTime?)> <!ATTLIST Expectation priority %attvals.priority; #IMPLIED restriction %attvals.restriction; #IMPLIED category %attvals.expectcat; #IMPLIED ><xs:element name="Expectation"> <xs:complexType> <xs:sequence> <xs:element ref="iodef:Description" maxOccurs="unbounded"/> <xs:element ref="iodef:Contact" minOccurs="0"/> <xs:element ref="iodef:StartTime" minOccurs="0"/> <xs:element ref="iodef:EndTime" minOccurs="0"/> </xs:sequence> <xs:attribute ref="iodef:restriction" default="default"/> <xs:attribute ref="iodef:priority"/> <xs:attribute ref="iodef:expectcat"/> </xs:complexType> </xs:element> <!-- ==================================================================== === Method class === === - Classification ==================================================================== --><!ELEMENT Method (Classification*, Description*)> <!ATTLIST Method restriction %attvals.restriction; #IMPLIED > <!ELEMENT Classification (name, url?)> <!ATTLIST Classification restriction %attvals.restriction; #IMPLIED origin %attvals.origin; "other" >Danyliw, et al. Expires February 3, 2006 [Page 62] Internet-Draft IODEF Data Model August 2005 <xs:element name="Method"> <xs:complexType> <xs:sequence> <xs:element ref="iodef:Classification" minOccurs="0" maxOccurs="unbounded"/> <xs:element ref="iodef:Description" maxOccurs="unbounded"/> </xs:sequence> <xs:attribute ref="iodef:restriction"/> </xs:complexType> </xs:element> <xs:element name="Classification"> <xs:complexType> <xs:sequence> <xs:element ref="iodef:name"/> <xs:element ref="iodef:url"/> </xs:sequence> <xs:attribute ref="iodef:origin" use="required"/> </xs:complexType> </xs:element> <!-- ==================================================================== === Assessment class === === - Impact === - TimeImpact === - MonetaryImpact === -LifeImpact === -Confidence ==================================================================== --><!ELEMENT Assessment (Impact*, TimeImpact*, MonetaryImpact*, LifeImpact*, Confidence?)> <!ATTLIST Assessment restriction %attvals.restriction; #IMPLIED > <!ELEMENT Impact (#PCDATA)> <!ATTLIST Impact severity %attvals.severity; #IMPLIED completion %attvals.completion; #IMPLIED type %attvals.impacttype; "unknown" lang NMTOKEN #IMPLIED > <!ELEMENT TimeImpact (#PCDATA)> <!ATTLIST TimeImpact severity %attvals.severity; #IMPLIED unit (labor | elapsed | downtime) #REQUIRED Meijer,<xs:element name="Assessment"> <xs:complexType> <xs:sequence> <xs:element ref="iodef:Impact" minOccurs="0" maxOccurs="unbounded"/> <xs:element ref="iodef:TimeImpact" minOccurs="0" maxOccurs="unbounded"/> <xs:element ref="iodef:MonetaryImpact" minOccurs="0" maxOccurs="unbounded"/> <xs:element ref="iodef:Confidence" minOccurs="0"/> </xs:sequence> <xs:attribute ref="iodef:restriction"/> </xs:complexType> </xs:element> <xs:element name="Impact"> <xs:complexType> <xs:attribute ref="iodef:severity"/> <xs:attribute ref="iodef:completion"/> <xs:attribute ref="iodef:impacttype" use="optional" default="unknown"/> <xs:attribute name="lang" type="xs:language"/> </xs:complexType> </xs:element> <xs:element name="TimeImpact"> <xs:complexType mixed="true"> Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page59]63] Internet-Draft IODEFData Model and Implementation November 2004 metric (days | hours | minutes | seconds) "hours" > <!ELEMENT MonetaryImpact (#PCDATA)> <!ATTLIST MonetaryImpact severity %attvals.severity; #IMPLIED currency CDATA #REQUIRED > <!ELEMENT LifeImpact (#PCDATA)> <!ATTLIST LifeImpact severity %attvals.severity; #IMPLIED metric (deaths | injuries) #REQUIRED > <!ELEMENT Confidence EMPTY> <!ATTLIST Confidence rating %attvals.rating; #REQUIRED >Data Model August 2005 <xs:attribute ref="iodef:severity"/> <xs:attribute name="unit" use="required"> <xs:simpleType> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="labor"/> <xs:enumeration value="elapsed"/> <xs:enumeration value="downtime"/> </xs:restriction> </xs:simpleType> </xs:attribute> <xs:attribute name="metric" use="required"> <xs:simpleType> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="days"/> <xs:enumeration value="hours"/> <xs:enumeration value="minutes"/> <xs:enumeration value="seconds"/> </xs:restriction> </xs:simpleType> </xs:attribute> </xs:complexType> </xs:element> <xs:element name="MonetaryImpact"> <xs:complexType mixed="true"> <xs:attribute ref="iodef:severity"/> <xs:attribute name="currency" type="xs:string"/> </xs:complexType> </xs:element> <xs:element name="Confidence"> <xs:complexType> <xs:attribute ref="iodef:rating" use="required"/> </xs:complexType> </xs:element> <!-- ==================================================================== === EventData class === ==================================================================== --><!ELEMENT EventData (Description*, DetectTime?, StartTime?, EndTime?, Contact*, Assessment?, Method*, Flow*, EventData*, Record?, AdditionalData*)> <!ATTLIST EventData restriction %attvals.restriction; #IMPLIED ><xs:element name="EventData"> <xs:complexType> <xs:sequence> <xs:element ref="iodef:Description" minOccurs="0" maxOccurs="unbounded"/> <xs:element ref="iodef:Contact" minOccurs="0" maxOccurs="unbounded"/> <xs:element ref="iodef:DetectTime" minOccurs="0"/> <xs:element ref="iodef:StartTime" minOccurs="0"/> <xs:element ref="iodef:EndTime" minOccurs="0"/> <xs:element ref="iodef:Flow" minOccurs="0" maxOccurs="unbounded"/> <xs:element ref="iodef:System" minOccurs="0" maxOccurs="unbounded"/> Danyliw, et al. Expires February 3, 2006 [Page 64] Internet-Draft IODEF Data Model August 2005 <xs:element ref="iodef:Method" minOccurs="0" maxOccurs="unbounded"/> <xs:element ref="iodef:Assessment" minOccurs="0"/> <xs:element ref="iodef:EventData" minOccurs="0" maxOccurs="unbounded"/> <xs:element ref="iodef:Record" minOccurs="0"/> <xs:element ref="iodef:AdditionalData" minOccurs="0" maxOccurs="unbounded"/> </xs:sequence> <xs:attribute ref="iodef:restriction" default="default"/> </xs:complexType> </xs:element> <!-- ==================================================================== === Flowand Systemclass === ==================================================================== --> <xs:element name="Flow"> <xs:complexType> <xs:sequence> <xs:element ref="iodef:System" maxOccurs="unbounded"/> </xs:sequence> </xs:complexType> </xs:element> <!-- ==================================================================== ===Note. Represents merged Source and Target classes of IDMEFSystem class ===(sections 4.2.4.3, 4.2.4.4)==================================================================== --><!ELEMENT Flow (System+)> <!ELEMENT System (Node, Service*, Counter*)> <!ATTLIST System category %attvals.systemcat; #IMPLIED spoofed %attvals.spoofed; "unknown" interface CDATA #IMPLIED restriction %attvals.restriction; #IMPLIED ><xs:element name="System"> <xs:complexType> <xs:sequence> <xs:element ref="iodef:Node"/> <xs:element ref="iodef:Service" minOccurs="0" maxOccurs="unbounded"/> <xs:element ref="iodef:OperatingSystem" minOccurs="0"/> <xs:element ref="iodef:Counter" minOccurs="0" maxOccurs="unbounded"/> </xs:sequence> <xs:attribute ref="iodef:restriction"/> <xs:attribute name="interface" type="xs:string"/> <xs:attribute ref="iodef:systemcat"/> <xs:attribute ref="iodef:spoofed" default="unknown"/> </xs:complexType> </xs:element> <!-- ============================================================================= Node class === ==================================================================== --> <xs:element name="Node"> <xs:complexType> Danyliw, et al. Expires February 3, 2006 [Page 65] Internet-Draft IODEF Data Model August 2005 <xs:sequence> <xs:element ref="iodef:DateTime" minOccurs="0"/> <xs:element ref="iodef:name" minOccurs="0"/> <xs:element ref="iodef:Address" minOccurs="0" maxOccurs="unbounded"/> <xs:element ref="iodef:Location" minOccurs="0"/> <xs:element ref="iodef:NodeRole" minOccurs="0" maxOccurs="unbounded"/> <xs:element ref="iodef:Counter" minOccurs="0" maxOccurs="unbounded"/> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="Address"> <xs:complexType> <xs:attribute ref="iodef:addrcat" use="required"/> <xs:attribute name="vlan-name" type="xs:string"/> <xs:attribute name="vlan-num" type="xs:string"/> </xs:complexType> </xs:element> <xs:element name="Location" type="xs:string"/> <xs:element name="NodeRole"> <xs:complexType mixed="true"> <xs:attribute ref="iodef:noderolecat" use="required"/> <xs:attribute name="lang" type="xs:language"/> </xs:complexType> </xs:element> <!-- ==================================================================== ===- AddressService Class ===- NodeRole==================================================================== --> <xs:element name="Service"> <xs:complexType> <xs:sequence> <xs:choice> <xs:element ref="iodef:port"/> <xs:element ref="iodef:portlist"/> </xs:choice> <xs:element ref="iodef:Application" minOccurs="0"/> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="port" type="xs:string"/> <xs:element name="portlist" type="xs:string"/> <!-- ==================================================================== ===- Location Meijer,Application class === ==================================================================== Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page60]66] Internet-Draft IODEF Data Modeland Implementation November 2004 === - nameAugust 2005 --> <xs:element name="Application"> <xs:complexType> <xs:sequence> <xs:element ref="iodef:url" minOccurs="0"/> <xs:element ref="iodef:name" minOccurs="0"/> </xs:sequence> <xs:attribute name="appid" type="xs:string" default="0"/> <xs:attribute name="configid" type="xs:string" default="0"/> <xs:attribute name="vendor" type="xs:string"/> <xs:attribute name="version" type="xs:string"/> </xs:complexType> </xs:element> <!-- ==================================================================== ===Note. IODEF Node class is extended IDMEF NodeOperatingSystem class(4.2.7.1):===<!ELEMENT Node ( location?, (name | Address), Address* )>==================================================================== --><!ELEMENT Node (name?, Address*, DateTime?, Location?, NodeRole*, Counter*)> <!ATTLIST Node category %attvals.nodecat; "unknown" > <!ELEMENT Address (#PCDATA)> <!ATTLIST Address category %attvals.addrcat; "ipv4-addr" vlan-name CDATA #IMPLIED vlan-num CDATA #IMPLIED > <!ELEMENT Location (#PCDATA)> <!ATTLIST Location lang NMTOKEN #IMPLIED > <!ELEMENT NodeRole (#PCDATA)> <!ATTLIST NodeRole category %attvals.noderolecat; "other" lang NMTOKEN #IMPLIED ><xs:element name="OperatingSystem"> <xs:complexType> <xs:attribute name="vendor" type="xs:string"/> <xs:attribute name="version" type="xs:string"/> <xs:attribute name="patch" type="xs:string"/> </xs:complexType> </xs:element> <!-- ==================================================================== === Counter class === ==================================================================== --><!ELEMENT Counter (#PCDATA)> <!ATTLIST Counter type (packet | session | event | other ) "other" meaning CDATA #IMPLIED ><xs:element name="Counter"> <xs:complexType> <xs:attribute ref="iodef:countertype" default="other"/> <xs:attribute name="meaning" type="xs:string" use="optional"/> </xs:complexType> </xs:element> <!-- ==================================================================== ===Service Class === === - port === - portlistRecord class ===IDMEF (4.2.7.4)==================================================================== --><!ELEMENT Service ((port | portlist), Application?)> <!ATTLIST Service ip_version CDATA "4" ip_protocol CDATA #REQUIRED Meijer,<xs:element name="Record"> <xs:complexType> <xs:sequence> <xs:element ref="iodef:RecordData" maxOccurs="unbounded"/> </xs:sequence> <xs:attribute ref="iodef:restriction"/> Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page61]67] Internet-Draft IODEF Data Modeland Implementation November 2004 > <!ELEMENT port (#PCDATA)> <!ELEMENT portlist (#PCDATA)> <!ELEMENT Application (name, url?)> <!ATTLIST Application appid CDATA "0" configid CDATA "0" vendor_name CDATA #IMPLIED version CDATA #IMPLIED > <!-- ==================================================================== === Record class === === - RecordData === - Analyzer === - RecordItem ====================================================================August 2005 </xs:complexType> </xs:element> <xs:element name="RecordData"> <xs:complexType> <xs:sequence> <xs:element ref="iodef:DateTime" minOccurs="0"/> <xs:element ref="iodef:Description" minOccurs="0" maxOccurs="unbounded"/> <xs:element ref="iodef:Application" minOccurs="0"/> <xs:element ref="iodef:RecordItem" maxOccurs="unbounded"/> </xs:sequence> <xs:attribute ref="iodef:restriction"/> </xs:complexType> </xs:element> <xs:element name="RecordSource" type="iodef:RecordSourceType"/> <xs:complexType name="RecordSourceType" mixed="true"> <xs:attribute name="recsourcetype" type="xs:string" use="optional"/> </xs:complexType> <xs:element name="Pattern" type="xs:string"/> <xs:element name="PatternLocation" type="iodef:PatternLocationType"/> <xs:complexType name="PatternLocationType" mixed="true"> <xs:attribute name="recdtype" type="xs:string" use="optional"/> </xs:complexType> <!-- <xs:element name="Count" type="xs:integer"/> --><!ELEMENT Record (RecordData+)> <!ATTLIST Record restriction %attvals.restriction; #IMPLIED > <!ELEMENT RecordData (Description*, DateTime?, Analyzer?, RecordItem+)> <!ATTLIST RecordData ident CDATA "0" restriction %attvals.restriction; #IMPLIED ><!--Element Analyzer of IODEF is re-used from IDMEF (4.2.4.1) --><!ELEMENT Analyzer (Node?, Process?)> <!ATTLIST Analyzer analyzerid CDATA "0" manufacturer CDATA #IMPLIED model CDATA #IMPLIED version CDATA #IMPLIED class CDATA #IMPLIED ostype CDATA #IMPLIED osversion CDATA #IMPLIED > <!--Element Process<xs:element name="Sensor"> <xs:complexType> <xs:sequence> <xs:element ref="iodef:Node" minOccurs="0"/> <!-- removed in expectation ofIODEF is re-used from IDMEF (4.2.7.3)Analyser simplification --><!ELEMENT Process (name, pid?, path?, arg*, env*)> <!ATTLIST Process ident CDATA "0" > <!ELEMENT env (#PCDATA)> <!ELEMENT pid (#PCDATA)> Meijer,<!-- <xs:element ref="iodef:Process" minOccurs="0"/> --> <xs:element ref="iodef:Process" minOccurs="0"/> </xs:sequence> <xs:attribute name="analyzerid" type="xs:string" default="0"/> <xs:attribute name="manufacturer" type="xs:string"/> <xs:attribute name="model" type="xs:string"/> <xs:attribute name="version" type="xs:string"/> <xs:attribute name="class" type="xs:string"/> <xs:attribute name="ostype" type="xs:string"/> <xs:attribute name="osversion" type="xs:string"/> </xs:complexType> </xs:element> <xs:element name="Process"> <xs:complexType> <xs:sequence> <xs:element ref="iodef:name" minOccurs="0"/> <xs:element name="arg" type="xs:string" minOccurs="0"/> <xs:element name="env" type="xs:string" minOccurs="0" maxOccurs="unbounded"/> </xs:sequence> Danyliw, et al. ExpiresMay 10,February 3, 2006 [Page 68] Internet-Draft IODEF Data Model August 2005 </xs:complexType> </xs:element> <xs:element name="RecordItem" type="iodef:AdditionalDataType"/> <!-- ==================================================================== === Description class === === (contains attribute "transform" to preserve non-UTF-8 text encoding) ==================================================================== --> <xs:element name="Description" type="iodef:MultilingTextType"/> <xs:complexType name="MultilingTextType" mixed="true"> <xs:complexContent mixed="true"> <xs:extension base="iodef:TextAbstractType"> <xs:attribute ref="iodef:preserve"/> <xs:attribute ref="iodef:transform"/> </xs:extension> </xs:complexContent> </xs:complexType> <!-- <xs:element name="Text" type="iodef:TextAbstractType"/> --> <xs:complexType name="TextAbstractType" mixed="true"> <xs:annotation> <xs:documentation xml:lang="en">Textual description, may use local languages. For particular use may be extended with optional attributes "preserve"={0,1} and "transformation" </xs:documentation> </xs:annotation> <xs:complexContent mixed="true"> <xs:restriction base="xs:anyType"> <xs:sequence> <xs:any processContents="lax" minOccurs="0" maxOccurs="unbounded"/> </xs:sequence> <xs:attribute name="lang" type="xs:language"/> </xs:restriction> </xs:complexContent> </xs:complexType> <!-- | Values for the Description.preserve attributes --> <xs:attribute name="preserve"> <xs:simpleType> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="no"/> <xs:enumeration value="yes"/> </xs:restriction> </xs:simpleType> </xs:attribute> <xs:attribute name="transform"> <xs:simpleType> <xs:restriction base="xs:NMTOKEN"> Danyliw, et al. Expires February 3, 2006 [Page62]69] Internet-Draft IODEF Data Modeland Implementation November 2004 <!ELEMENT path (#PCDATA)> <!ELEMENT RecordItem ANY> <!ATTLIST RecordItem dtype %attvals.dtype; #REQUIRED > <!-- ==================================================================== === Simple classes containing multilingual content === === - Description === - Contact.Name ==================================================================== --> <!ELEMENT Description ANY> <!ATTLIST Description preserve %attvals.preserve; #IMPLIED transform %attvals.transform; #IMPLIED lang NMTOKEN #IMPLIED > <!ELEMENT Name ANY> <!ATTLIST Name preserve %attvals.preserve; #IMPLIED transform %attvals.transform; #IMPLIED lang NMTOKEN #IMPLIED >August 2005 <xs:enumeration value="none"/> <xs:enumeration value="Base64"/> <xs:enumeration value="QP"/> <xs:enumeration value="stringprep"/> <xs:enumeration value="zip"/> <xs:enumeration value="URI"/> </xs:restriction> </xs:simpleType> </xs:attribute> <!-- ==================================================================== === Miscellaneous simple classes === === -urlname === -name ==================================================================== --> <!ELEMENT name (#PCDATA)> <!ATTLIST name lang NMTOKEN #IMPLIED > <!ELEMENTurl(#PCDATA)><xs:element name="name" type="iodef:MultilingTextType"/> <xs:element name="name" type="xs:string"/> <xs:element name="name" type="NameidType"/> <xs:complexType name="NameidType"> <xs:complexContent> <xs:extension base="iodef:MultilingTextType"/> </xs:complexContent> </xs:complexType> ==================================================================== --> <xs:element name="name" type="iodef:MultilingTextType"/> <xs:element name="number" type="xs:string"/> <xs:element name="url" type="xs:string"/> <!-- ==================================================================== === Attribute list declarations. === ==================================================================== --> <!-- | Attributes of the IODEF element. In general, the fixed value | of this attribute will change each time a new version of | the DTD is released. --> <!--Meij er,| Values for the Address.category attribute. --> <xs:attribute name="addrcat"> <xs:simpleType> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="asn"/> <xs:enumeration value="atm"/> <xs:enumeration value="e-mail"/> <xs:enumeration value="mac"/> Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page63]70] Internet-Draft IODEF Data Modeland Implementation November 2004 ==================================================================== === SECTION 2. Attribute value declarations. Enumerated values === === for the many element-specific attribute lists. === ==================================================================== -->August 2005 <xs:enumeration value="ipv4-addr"/> <xs:enumeration value="ipv4-net"/> <xs:enumeration value="ipv4-net-mask"/> <xs:enumeration value="ipv6-addr"/> <xs:enumeration value="ipv6-net"/> <xs:enumeration value="ipv6-net-mask"/> </xs:restriction> </xs:simpleType> </xs:attribute> <!-- |Defines purpose ofValues for theIncident --> <!ENTITY % attvals.purpose " ( handling | statistics | warning | other ) "> <!-- | Defines restriction on access to an element's contentImpact.completion attribute. --><!ENTITY % attvals.restriction " ( default | public | need-to-know | private ) "><xs:attribute name="completion"> <xs:simpleType> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="failed"/> <xs:enumeration value="succeeded"/> </xs:restriction> </xs:simpleType> </xs:attribute> <!-- | Values for theExpectation.expectcat attributesContact.role attribute. --><!ENTITY % attvals.expectcat " ( nothing | contact-site | contact-me | investigate | block | other ) "><xs:attribute name="contactrole"> <xs:simpleType> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="creator"/> <xs:enumeration value="admin"/> <xs:enumeration value="tech"/> <xs:enumeration value="irt"/> <xs:enumeration value="cc"/> </xs:restriction> </xs:simpleType> </xs:attribute> <!-- | Values for theAdditionalData.typeContact.type attribute. --><!ENTITY % attvals.adtype " ( boolean | byte | character | date-time | integer | ntpstamp | portlist | real | string | xml ) "><xs:attribute name="contacttype"> <xs:simpleType> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="person"/> <xs:enumeration value="organisation"/> </xs:restriction> </xs:simpleType> </xs:attribute> <!-- | Values for theRecordItem.type attributeCounter.type attribute. Danyliw, et al. Expires February 3, 2006 [Page 71] Internet-Draft IODEF Data Model August 2005 --><!ENTITY % attvals.dtype " ( boolean | byte | character | date-time | integer | ntpstamp | portlist | real | string | file | path | url | xml ) "><xs:attribute name="countertype"> <xs:simpleType> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="packet"/> <xs:enumeration value="session"/> <xs:enumeration value="event"/> <xs:enumeration value="other"/> </xs:restriction> </xs:simpleType> </xs:attribute> <!-- | Values for theHistory.type attribute.RecordItem.type attribute --><!ENTITY % attvals.historycat " ( triaged | notification | shared-info | received-info | remediation | other ) "><xs:attribute name="dtype"> <xs:simpleType> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="boolean"/> <xs:enumeration value="byte"/> <xs:enumeration value="character"/> <xs:enumeration value="date-time"/> <xs:enumeration value="integer"/> <xs:enumeration value="ntpstamp"/> <xs:enumeration value="portlist"/> <xs:enumeration value="real"/> <xs:enumeration value="string"/> <xs:enumeration value="file"/> <xs:enumeration value="path"/> <xs:enumeration value="frame"/> <xs:enumeration value="packet"/> <xs:enumeration value="ipv4-packet"/> <xs:enumeration value="ipv6-packet"/> <xs:enumeration value="url"/> <xs:enumeration value="xml"/> </xs:restriction> </xs:simpleType> </xs:attribute> <!-- | Values for theAddress.category attribute.Expectation.expectcat attributes -->Meijer,<xs:attribute name="expectcat"> <xs:simpleType> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="nothing"/> <xs:enumeration value="contact-site"/> <xs:enumeration value="contact-me"/> <xs:enumeration value="block"/> <xs:enumeration value="investigate"/> Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page64]72] Internet-Draft IODEF Data Modeland Implementation November 2004 <!ENTITY % attvals.addrcat " ( atm | mac | sna | ipv4-addr | ipv4-net | ipv4-net-mask | ipv6-addr | ipv6-net | ipv6-net-mask | asn | vm | e-mail | lotus-notes ) ">August 2005 <xs:enumeration value="other"/> </xs:restriction> </xs:simpleType> </xs:attribute> <!-- | Values for theId.typeFile.category attribute. --><!ENTITY % attvals.idtype " ( current-user | original-user | target-user | user-privs | current-group | group-privs ) "><xs:attribute name="filecat"> <xs:simpleType> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="current"/> <xs:enumeration value="original"/> </xs:restriction> </xs:simpleType> </xs:attribute> <!-- | Values for theImpact.completionNameIdentifier.format attribute. --><!ENTITY % attvals.completion " ( failed | succeeded ) "><xs:attribute name="format"> <xs:simpleType> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="emailAddress"/> <xs:enumeration value="x509NameQualifier"/> <xs:enumeration value="urn"/> <xs:enumeration value="local"/> <xs:enumeration value="other"/> </xs:restriction> </xs:simpleType> </xs:attribute> <!-- | Values for theImpact.typeHistory.type attribute. --><!ENTITY % attvals.impacttype " ( none | admin | dos | file | recon | user | unknown | other ) "><xs:attribute name="historycat"> <xs:simpleType> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="triaged"/> <xs:enumeration value="notification"/> <xs:enumeration value="shared-info"/> <xs:enumeration value="received-info"/> <xs:enumeration value="remediation"/> <xs:enumeration value="other"/> </xs:restriction> </xs:simpleType> </xs:attribute> <!-- | Values for theRegistryHandle.typeImpact.type attribute. --><!ENTITY % attvals.registrytype " ( internic | apnic | arin | lacnic | ripencc | local ) "><xs:attribute name="impacttype"> Danyliw, et al. Expires February 3, 2006 [Page 73] Internet-Draft IODEF Data Model August 2005 <xs:simpleType> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="none"/> <xs:enumeration value="admin"/> <xs:enumeration value="dos"/> <xs:enumeration value="file"/> <xs:enumeration value="recon"/> <xs:enumeration value="user"/> <xs:enumeration value="unknown"/> <xs:enumeration value="other"/> </xs:restriction> </xs:simpleType> </xs:attribute> <!-- | Values for theConfidence.ratingNodeRole.category attribute. --><!ENTITY % attvals.rating " ( low | medium | high | numeric | unknown ) "><xs:attribute name="noderolecat"> <xs:simpleType> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="client"/> <xs:enumeration value="server-internal"/> <xs:enumeration value="server-public"/> <xs:enumeration value="www"/> <xs:enumeration value="mail"/> <xs:enumeration value="messaging"/> <xs:enumeration value="streaming"/> <xs:enumeration value="voice"/> <xs:enumeration value="file"/> <xs:enumeration value="ftp"/> <xs:enumeration value="p2p"/> <xs:enumeration value="name"/> <xs:enumeration value="directory"/> <xs:enumeration value="credential"/> <xs:enumeration value="print"/> <xs:enumeration value="application"/> <xs:enumeration value="database"/> <xs:enumeration value="infra"/> <xs:enumeration value="log"/> <xs:enumeration value="other"/> </xs:restriction> </xs:simpleType> </xs:attribute> <!-- | Values for theImpact.severityClassification.origin attribute. --><!ENTITY % attvals.severity " ( low | medium | high ) "> <!ENTITY % attvals.priority " ( low | medium | high ) "> Meijer,<xs:attribute name="origin"> <xs:simpleType> <xs:restriction base="xs:NMTOKEN"> Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page65]74] Internet-Draft IODEF Data Modeland Implementation November 2004August 2005 <xs:enumeration value="bugtraqid"/> <xs:enumeration value="cve"/> <xs:enumeration value="certcc"/> <xs:enumeration value="vendor"/> <xs:enumeration value="local"/> <xs:enumeration value="other"/> </xs:restriction> </xs:simpleType> </xs:attribute> <!-- | Values for theNode.category attribute.Expectation.priority attributes --><!ENTITY % attvals.nodecat " ( unknown | ads | afs | coda | dfs | dns | hosts | kerberos | nds | nis | nisplus | nt<xs:attribute name="priority"> <xs:simpleType> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="low"/> <xs:enumeration value="medium"/> <xs:enumeration value="high"/> </xs:restriction> </xs:simpleType> </xs:attribute> <!-- |wfw ) ">Defines purpose of the Incident --> <xs:attribute name="purpose"> <xs:simpleType> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="traceback"/> <xs:enumeration value="mitigation"/> <xs:enumeration value="reporting"/> <xs:enumeration value="other"/> </xs:restriction> </xs:simpleType> </xs:attribute> <!-- | Values for theNodeRole.categoryConfidence.rating attribute. --><!ENTITY % attvals.noderolecat " ( client | server-internal | server-public | www | mail | messaging | streaming | voice | file | ftp | p2p | name | directory | credential | print | application | database | infra | log | other ) "><xs:attribute name="rating"> <xs:simpleType> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="low"/> <xs:enumeration value="medium"/> <xs:enumeration value="high"/> <xs:enumeration value="numeric"/> <xs:enumeration value="unknown"/> </xs:restriction> </xs:simpleType> </xs:attribute> Danyliw, et al. Expires February 3, 2006 [Page 75] Internet-Draft IODEF Data Model August 2005 <!-- | Values for theClassification.originRegistryHandle.type attribute. --><!ENTITY % attvals.origin " ( bugtraqid | cve | certcc | vendor | local<xs:attribute name="registrytype"> <xs:simpleType> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="internic"/> <xs:enumeration value="apnic"/> <xs:enumeration value="arin"/> <xs:enumeration value="lacnic"/> <xs:enumeration value="ripencc"/> <xs:enumeration value="ti"/> <xs:enumeration value="local"/> </xs:restriction> </xs:simpleType> </xs:attribute> <!-- |other) ">Defines restriction on access to an element's content --> <xs:attribute name="restriction"> <xs:simpleType> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="default"/> <xs:enumeration value="public"/> <xs:enumeration value="need-to-know"/> <xs:enumeration value="private"/> </xs:restriction> </xs:simpleType> </xs:attribute> <!-- | Values for theSystem.spoofed attributeImpact.severity attribute. --><!ENTITY % attvals.spoofed " ( unknown | yes | no ) "><xs:attribute name="severity"> <xs:simpleType> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="low"/> <xs:enumeration value="medium"/> <xs:enumeration value="high"/> </xs:restriction> </xs:simpleType> </xs:attribute> <!-- | Values for theSystem.category attributeSystem.spoofed attributes --><!ENTITY % attvals.systemcat " ( source | target | intermediate ) "><xs:attribute name="spoofed"> <xs:simpleType> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="unknown"/> Danyliw, et al. Expires February 3, 2006 [Page 76] Internet-Draft IODEF Data Model August 2005 <xs:enumeration value="yes"/> <xs:enumeration value="no"/> </xs:restriction> </xs:simpleType> </xs:attribute> <!-- | Values for theMultilingText.preserve and MultilingText.transformSystem.category attribute --><!ENTITY % attvals.preserve " ( yes | no ) "> <!ENTITY % attvals.transform " ( none | Base64 | QP | stringprep | zip | URI ) "> Meijer,<xs:attribute name="systemcat"> <xs:simpleType> <xs:restriction base="xs:NMTOKEN"> <xs:enumeration value="source"/> <xs:enumeration value="target"/> <xs:enumeration value="intermediate"/> </xs:restriction> </xs:simpleType> </xs:attribute> </xs:schema> Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page66]77] Internet-Draft IODEF Data Modeland Implementation November 2004August 2005 9. Security considerations Due to the sensitive nature of some of the data that might be represented in the IODEF, the integrity, confidentiality, andnon-repudiationnon- repudiation of these documents in transit SHOULD be ensured. Although this protection can be provided by the transport mechanism, applying this security to the IODEF document itself is RECOMMENDED. When used, the applied protective measures MUST use cryptographic techniques. XML Digital Signatures [14]SHOULDMUST be used for ensuring integrity and non-repudiation, while XML Encryption [15]SHOULDMUST be used to ensure the confidentiality of an IODEF document. Examples using signatures and encryption on an IODEF document can be found in Section 7: o IODEF-Document with XML signature (Section 7.2) o IODEF-Document encrypted using XML encryption (Section 7.3) o IODEF-Document encrypted and signed using XML signature & encryption (Section 7.4) Additional information on applying XML Digital Signatures and XML Encryption to an IODEF document can be found in the IODEF Implementation Guide [18].Meijer,Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page67]78] Internet-Draft IODEF Data Modeland Implementation November 2004August 2005 10. IANA considerationsMeijer,Must be written Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page68]79] Internet-Draft IODEF Data Modeland Implementation November 2004August 2005 11. Acknowledgments The following groups contributed substantially to this document and should be recognized for their efforts. o the Incident Object Description and Exchange Format Working-Group of the TERENA task-force (TF-CSIRT) o the eCSIRT.net projectMeijer,Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page69]80] Internet-Draft IODEF Data Modeland Implementation November 2004August 2005 12. References 12.1 Normative References [1] Demchenko, Y., Hiroyuki,H.H., and G. Keeni, "Requirements for Format for Incident Report Exchange", RFC XXX, November 2004. [2] World Wide Web Consortium, "Extensible Markup Language (XML) 1.0 (Second Edition)", W3C Recommendation , October 2000, <http://www.w3.org/TR/2000/REC-xml-20001006>. [3] World Wide Web Consortium, "Namespaces in XML", W3C Recommendation , January 1999, <http://www.w3.org/TR/REC-xml-names/>. [4] World Wide Web Consortium, "Extensible Stylesheet Language (XSL) Version 1.0", W3C Recommendation , October 2001, <http://www.w3.org/TR/xsl/>. [5] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", RFC 2119, March 1997. [6] Alvestrand, H., "Tags for the Identification of Languages", RFC 3066, January 2001. [7] Curry, D. and H. Debar, "IntrusionDetecti onDetection Message Exchange Format", RFC XXX, July 2004. [8] Berners-Lee, T., Fielding,R.R., and L. Masinter, "Uniform Resource Identifiers (URI): Generic Syntax", RFC 2396, August 1998. [9] Freed, N., "IANA Charset Registration Procedures", BCP 2278, January 1998. [10] Wahl, M., "A Summary of the X.500(96) User Schema for use with LDAPv3", RFC 2256, December 1997. [11] Resnick, P., "Internet Message Format", RFC 2822, April 2001. [12] Klyne, G. and C. Newman, "Date and Time on the Internet: Timestamps", RFC 3339, July 2002. [13] International Organization for Standardization, "International Standard: Data elements and interchange formats - Information interchange - Representation of dates and times", ISO 8601, Second Edition, December 2000. Danyliw, et al. Expires February 3, 2006 [Page 81] Internet-Draft IODEF Data Model August 2005 [14] Eastlake 3rd, D., Reagle,J.J., and D. Solo, "(Extensible MarkupMeijer, et al. Expires May 10, 2005 [Page 70] Internet-Draft IODEF Data Model and Implementation November 2004Language) XML-Signature Syntax and Processing", RFC 3275, March 2002. [15] Imamura, T., Dillaway,B.B., and E. Simon, "XML Encryption Syntax and Processing, W3C Recommendation", December 2002, <http://www.w3.org/TR/2002/REC-xmlenc-core-20021210/>. [16] International Organization for Standardization, "International Standard: Codes for the representation of currencies and funds, ISO 4217:2001", ISO 4217:2001, August 2001. 12.2 Informative References [17] Rumbaugh, J., Jacobson,I.I., and G. Booch, "The Unified Modeling Language Reference Model, ISBN 020130998X, Addison-Wesley", 1998. [18] Danyliw, R., "The IODEF Implementation Guide", RFC XXX, 2003. Authors' AddressesJan Meijer SURFnet bv P.O. Box 19035 Utrecht NL-3501 DA Netherlands Phone: +31 302 305 305 EMail: jan.meijer@surfnet.nlRoman Danyliw CERT Coordination Center 4500 Fifth Ave. Pittsburgh, PA 15213 USA Phone: +1 412 268 7090EMail:Email: rdd@cert.org Jan Meijer SURFnet bv P.O. Box 19035 Utrecht NL-3501 DA Netherlands Phone: +31 302 305 305 Email: jan.meijer@surfnet.nl Danyliw, et al. Expires February 3, 2006 [Page 82] Internet-Draft IODEF Data Model August 2005 Yuri DemchenkoNLnet LabsUniversity of Amsterdam NetherlandsEMail:Email: demch@chello.nlMeijer,Danyliw, et al. ExpiresMay 10, 2005February 3, 2006 [Page71]83] Internet-Draft IODEF Data Modeland Implementation November 2004 Full CopyrightAugust 2005 Intellectual Property StatementCopyright (C)TheInternet Society (2004). ThisIETF takes no position regarding the validity or scope of any Intellectual Property Rights or other rights that might be claimed to pertain to the implementation or use of the technology described in this documentis subjector the extent to which any license under such rights might or might not be available; nor does it represent that it has made any independent effort to identify any such rights. Information on therights, licenses and restrictions containedprocedures with respect to rights in RFC documents can be found in BCP78,78 andexcept as set forth therein,BCP 79. Copies of IPR disclosures made to theauthors retainIETF Secretariat and any assurances of licenses to be made available, or the result of an attempt made to obtain a general license or permission for the use of such proprietary rights by implementers or users of this specification can be obtained from the IETF on-line IPR repository at http://www.ietf.org/ipr. The IETF invites any interested party to bring to its attention any copyrights, patents or patent applications, or other proprietary rights that may cover technology that may be required to implement this standard. Please address the information to the IETF at ietf-ipr@ietf.org. The IETF has been notified of intellectual property rights claimed in regard to some or alltheirof the specification contained in this document. For more information consult the online list of claimed rights. Disclaimer of Validity This document and the information contained herein are provided on an "AS IS" basis and THE CONTRIBUTOR, THE ORGANIZATIONHEHE/SHE REPRESENTS OR IS SPONSORED BY (IF ANY), THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.Meijer,Copyright Statement Copyright (C) The Internet Society (2005). This document is subject to the rights, licenses and restrictions contained in BCP 78, and except as set forth therein, the authors retain all their rights. Danyliw, et al. ExpiresMay 10,February 3, 2006 [Page 84] Internet-Draft IODEF Data Model August 2005 Acknowledgment Funding for the RFC Editor function is currently provided by the Internet Society. Danyliw, et al. Expires February 3, 2006 [Page72]85] ----