openid / sharedsignals

OpenID Shared Signals Working Group Repository
45 stars 11 forks source link
caep risc sharedsignals ssf

SSF: Shared Signals Framework

The goal of the Shared Signals Working Group is to enable the sharing of security events, state changes, and other signals between related and/or dependent systems in order to:

Current Development Drafts

The current drafts of the specifications under development are kept here:

Specification HTML TXT
Shared Signals Framework HTML TXT
CAEP HTML TXT
RISC HTML TXT
CAEP Interoperability Profile HTML TXT

Development

To change the spec, update one of the xml files and then run make as follows:

Assume you changed the file foo.md. To generate the foo.html file, you would run make foo.html

Similarly, to update the text file, you would run make foo.txt

Pay attention to errors generating the files and warnings about the document date. You should update the date to today's date.

In order to run make you need to:

  1. install xml2rfc which can be done via pip: pip install xml2rfc
  2. install kramdown-rfc which can be done via Ruby gems: gem install kramdown-rfc

Note The HTML and TXT files will not be uploaded to the repository. Running make only ensures that changes you made are not breaking the generation of the specifications output.