Superschema + some post-alpha schema changes

[FrederikP]

This introduces a new versioning mechanism. Old versions and the current development preview are always part of the "superschema". This makes it simpler for parser software to be able to parse multiple versions of XARF.

Summary:

• schemas/ now contains one subfolder per version including the latest development preview in development
• samples/ now contains a positive and negative subfolder and each of them contains one sample folder per version
• top level property Version has to be set in all new versions, it is not required for alpha
• version alpha contains all work so far and the version that currently some organizations are already using. no incompatible changes have been performed
• version development should not be used in production. It is unstable and always contains the changes that will be introduced in the next version
• schema changes:
  • InfringingUrl from trademark and copyright. SourceUrl should be used from now on
  • Renamed mail sender and recipient: ToAddress -> SmtpRcptToAddress, FromAddress -> SmtpMailFromAddress
• added open service type
• test coverage has been increased
• negative test samples have been added
• a release script has been added to simplify releasing a new version
• added a changelog

[Maximilian-Staab]

Just minor things. One copy-paste error and some suggestions to the new OpenService type.

[Maximilian-Staab]

I would have expected an approach more to eg. WithTrafficStats or WithDestination.

[Maximilian-Staab]

I started implementing the Service shared type and would like to propose that. Do you know of a way to add a MR to a MR xD?

[Maximilian-Staab]

Example

xarf_shared

"Service": {
    "type": "object",
    "description": "Specify a service to report",
    "required": ["ServiceName"],
    "properties": {
        "ServiceName": {
            "type": "string"
         },
         "ServiceVersion": {
             "type": "string",
             "description": "Affected service version or version range"
         }
    }
},
"TransportProtocol": {
    "type": "object",
    "description": "Transport protocol used by the reportee",
    "properties": {
        "TransportProtocol": {
            "type": "string",
            "enum": ["tcp", "udp"]
        }
    }
}

Usage

{
    "$ref": "xarf_shared.schema.json#/TransportProtocol"
},
{
    "$ref": "xarf_shared.schema.json#/Service"
}

Outdated