Skip to content

Latest commit

 

History

History
39 lines (34 loc) · 1.94 KB

File metadata and controls

39 lines (34 loc) · 1.94 KB

Service

The Service object SHALL be used to describe a specific program running on a port. There MAY only be one Service object per port in the Host object's port attribute. Service objects MAY have child objects called ServiceDescriptor(s). These objects are defined in more detail in the ServiceDescriptor.md file, but they are generally used to give program specific information. If attribute values are not known, they MUST NOT be included unless specified otherwise in the description below.

The Service object has the following attributes defined:

  • type* - MUST be the type of object. In this case, Service
  • active - MUST be the Boolean variable representing whether this service is active or not. true for active, false for inactive. If this value is not set, the service SHOULD be assumed to be be active.
  • protocol - MUST be the protocol by which this Service communicates
  • banner - MUST be the banner that identifies this Service
  • serviceDescriptors - MUST be a key-value pairing of the name of a certain ServiceDescriptor IN THE SINGULAR to a list of these objects. This allows a user to quickly access only the ServiceDescriptor desired.

* Required attributes

Example:

{"type":"Service","protocol":"http","banner":"Apache 1.0","serviceDescriptors":{"httpUrl":[{"type":"ServiceDescriptor","path":"/test","screenshot":"/root/screenshots/screenshot.jpg","code":"200","content-type":"text/html","length":"1024"}]}}

Pretty Printed:

{
    "type":"Service",
    "protocol":"http",
    "banner":"Apache 1.0",
    "serviceDescriptors":{
        "httpUrl":[
            {
                "type":"ServiceDescriptor",
                "name":"httpUrl",
                "path":"/test",
                "screenshot":"/root/screenshots/screenshot.jpg",
                "code":"200",
                "content-type":"text/html",
                "length":"1024"
            }
        ]
    }
}