Uploaded image for project: 'Technical Committee Administration'
  1. Technical Committee Administration
  2. TCADMIN-4267

Request a template / starter document for PACE Architecture Specification v1.0.0 for the Open Cybersecurity Alliance Posture Attribute Collection & Evaluation project

    Details

    • Resolution:
      Hide

      Adam is TSC chair for PACE. PGB Chairs: Jason Keirstead, Mark Mastrangeli

      Show
      Adam is TSC chair for PACE.  PGB Chairs : Jason Keirstead, Mark Mastrangeli

      Description

      Your name:
        Duncan Sparrell
      Project name:
        Open Cybersecurity Alliance Posture Attribute Collection & Evaluation
      Project email address:
        [1]oca-pace-wg@lists.oasis-open-projects.org
      Work product title and version number:
        PACE Architecture Specification v1.0.0
      Work Product Abbreviation:
        PaceArch-V1.0.0-rel-01.md
      Track
        Standards Track work product
      Abstract:
        Posture Attribute Collection & Evaluation (PACE) is a comprehensive automated strategy for understanding security posture and what to do about it. The PACE Architecture Specification defines the architecture of a PACE system. Companion standards (Security Posture Attributes, PACE Interfaces) define the data used to determine security posture, and the interfaces to allow PACE systems to interact with other systems.
      Format:
        Markdown
      Chair(s):
        Adam Montville
      Editor(s):
        Duncan Sparrell
      ----------------------------------------------------------------------------------------
      [1] oca-pace-wg@lists.oasis-open-projects.org

        Attachments

          Activity

          Hide
          paul.knight1 Paul Knight added a comment - - edited

          This is the first template for the OCA OP.

          TBD:
          [x] Define URIs

          Full initial URI list:

          This stage:
          https://docs.oasis-open-projects..org/oca/PaceArch/v1.0.0/psd01/PaceArch-v1.0.0-psd01.md (Authoritative)
          https://docs.oasis-open-projects..org/oca/PaceArch/v1.0.0/psd01/PaceArch-v1.0.0-psd01.html
          https://docs.oasis-open-projects..org/oca/PaceArch/v1.0.0/psd01/PaceArch-v1.0.0-psd01.pdf

          Previous stage:
          N/A

          Latest stage:
          https://docs.oasis-open-projects..org/oca/PaceArch/v1.0.0/PaceArch-v1.0.0.md (Authoritative)
          https://docs.oasis-open-projects..org/oca/PaceArch/v1.0.0/PaceArch-v1.0.0.html
          https://docs.oasis-open-projects..org/oca/PaceArch/v1.0.0/PaceArch-v1.0.0.pdf

          [ ] Define content for "Notices" section.

          • This depends on the copyright model
          • I'll check with Claudia, Chet, and Jamie on the wording for incorporating this into the Notices text.
            • Likely similar to the OSLC-OP notices - for doing this in markdown, it may be more useful to see the templates done for Baseline (2020).
              • Note Baseline docs list old-style URIs for OASIS resources. Also lists older logo file.

          [ ] Set up markdown template for generic OCA.

          [ ] customize for this spec.

          Show
          paul.knight1 Paul Knight added a comment - - edited This is the first template for the OCA OP. TBD: [x] Define URIs OCA has several sub-projects (PACE, Kestrel, STIX Shifter) I will assume that the sub-projects will NOT have separate directories in the OASIS OP Library, so the URIs will follow the pattern https://docs.oasis-open-projects.org/oca/workproduct/version/stage/workproduct-version-stage.(md | pdf | html) the workproduct here is "PaceArch" the Version will be "v1.0.0" the stage will be "psd01" Full initial URI list: This stage: https://docs.oasis-open-projects..org/oca/PaceArch/v1.0.0/psd01/PaceArch-v1.0.0-psd01.md (Authoritative) https://docs.oasis-open-projects..org/oca/PaceArch/v1.0.0/psd01/PaceArch-v1.0.0-psd01.html https://docs.oasis-open-projects..org/oca/PaceArch/v1.0.0/psd01/PaceArch-v1.0.0-psd01.pdf Previous stage: N/A Latest stage: https://docs.oasis-open-projects..org/oca/PaceArch/v1.0.0/PaceArch-v1.0.0.md (Authoritative) https://docs.oasis-open-projects..org/oca/PaceArch/v1.0.0/PaceArch-v1.0.0.html https://docs.oasis-open-projects..org/oca/PaceArch/v1.0.0/PaceArch-v1.0.0.pdf [ ] Define content for "Notices" section. This depends on the copyright model https://github.com/opencybersecurityalliance/oasis-open-project/blob/main/LICENSE.md I'll check with Claudia, Chet, and Jamie on the wording for incorporating this into the Notices text. Likely similar to the OSLC-OP notices - for doing this in markdown, it may be more useful to see the templates done for Baseline (2020). Note Baseline docs list old-style URIs for OASIS resources. Also lists older logo file. [ ] Set up markdown template for generic OCA. [ ] customize for this spec.
          Hide
          paul.knight1 Paul Knight added a comment - - edited

          Attaching preliminary template package: PaceArch-v1.0.0-psd01.zip

          This is not immediately being delivered to the OP, pending further internal review of two main elements:

          • Notices (Appendix F, at end) - now shows just Apache 2.0 and the OASIS CLA.
            • Also, see related text in "Status" – "approved by" - is this okay?
            • Is there an existing link for "other technical work produced by the Open Project (OP)" ??
          • URIs - docs.oasis-open.org, or docs.oasis-open-projects.org ?? (currently, the latter is used)

          (in looking at the files,, the HTML is kind of "raw" - ignore everything above the second OASIS logo)

          Show
          paul.knight1 Paul Knight added a comment - - edited Attaching preliminary template package: PaceArch-v1.0.0-psd01.zip This is not immediately being delivered to the OP, pending further internal review of two main elements: Notices (Appendix F, at end) - now shows just Apache 2.0 and the OASIS CLA. Also, see related text in "Status" – "approved by" - is this okay? Is there an existing link for "other technical work produced by the Open Project (OP)" ?? URIs - docs.oasis-open.org, or docs.oasis-open-projects.org ?? (currently, the latter is used) (in looking at the files,, the HTML is kind of "raw" - ignore everything above the second OASIS logo)
          Hide
          paul.knight1 Paul Knight added a comment - - edited

          Made a few corrections:

          • replaced "v1.0" with "v1.0.0" in the URIs.
          • replaced "part of" with "a Sub-Project of" in describing PACE-OCA relationship.
          • added affiliation info for Adam Montville (but email still needs to be added by the OP Editors).
          • listed the OCA website as the place to look for "other technical work" (in "Status").

          I think this is ready to use as the base for the other two templates being requested (TCADMIN-4268, TCADMIN-4269).

          Show
          paul.knight1 Paul Knight added a comment - - edited Made a few corrections: replaced "v1.0" with "v1.0.0" in the URIs. replaced "part of" with "a Sub-Project of" in describing PACE-OCA relationship. added affiliation info for Adam Montville (but email still needs to be added by the OP Editors). listed the OCA website as the place to look for "other technical work" (in "Status"). I think this is ready to use as the base for the other two templates being requested ( TCADMIN-4268 , TCADMIN-4269 ).
          Hide
          paul.knight1 Paul Knight added a comment -

          Just saw Chet's comment in TCADMIN-4269, so updating the "Project Chairs":
          Jason Keirstead (Jason.Keirstead@ca.ibm.com), IBM
          Mark Mastrangeli (email), Affiliation

          Show
          paul.knight1 Paul Knight added a comment - Just saw Chet's comment in TCADMIN-4269 , so updating the "Project Chairs": Jason Keirstead (Jason.Keirstead@ca.ibm.com), IBM Mark Mastrangeli (email), Affiliation
          Hide
          paul.knight1 Paul Knight added a comment -

          Attaching a new ZIP file with the updated template and support files: PaceArch-v1.0.0-psd01.zip

          Show
          paul.knight1 Paul Knight added a comment - Attaching a new ZIP file with the updated template and support files: PaceArch-v1.0.0-psd01.zip
          Hide
          paul.knight1 Paul Knight added a comment -

          Delivered three templates to Editor, and to PACE email list:

          Email:

          from: Paul Knight via lists.oasis-open-projects.org <paul.knight=oasis-open.org@lists.oasis-open-projects.org>
          to: oca-pace-wg@lists.oasis-open-projects.org
          date: Nov 9, 2022, 3:08 PM
          subject: [oca-pace-wg] Three Starter Documents for PACE specifications

          Per the submission requests [1], please find the attached starter document packages for:

          • PACE Architecture Specification Version 1.0.0
            • filename abbreviation: PaceArch
          • PACE Interface Specification Version 1.0.0
            • filename abbreviation: PaceInt
          • PACE Security Posture Attributes Specification Version 1.0.0
            • filename abbreviation: PaceAttr

          Each starter document package (.zip) contains the following files and directories:
          – a markdown file (.md) ... this is the main template or starter document, customized with titles and other elements for this Work Product
          – a directory "styles" containing an HTML style sheet (.css) (some .css files are permanently installed online - see "README" file.)
          – a directory "images" containing an example image file
          – a "README" text file with important instructions

          When the OP PGB first votes [2] to publish these Work Products in the OASIS Library, we expect them to be published at:

          The permanent "Latest stage" URIs will be:

          Please let me know if anything here fails to meet your expectations.
          *************

          When the OP PGB votes [2] to approve a working draft as a Project Specification Draft, the Chair or other designated person must submit a request online, accessible on the Project Administration Requests Page [3].

          Upon receipt of this request form, the Project Administrator will review and process the Work Product for official publication in the OASIS Library (https://docs.oasis-open.org/), including addition of the requisite cover page metadata and other boilerplate information.

          =========== References:
          [1] https://tools.oasis-open.org/issues/browse/TCADMIN-4267, .../TCADMIN-4268, .../TCADMIN-4269
          [2] Motion or ballot language templates for approval of a publication
          https://www.oasis-open.org/committees/download.php/53768
          [3] Project Administration Requests Page - see "Publish a draft work" or "Start a public review"
          https://www.oasis-open.org/project-administration-support-requests/

          Best wishes,
          Paul

          –
          Paul Knight....Document Process Analyst
          OASIS...Setting the standard for open collaboration
          ?
          PaceArch-v1.0.0-psd01.zip
          ?
          PaceAttr-v1.0.0-psd01.zip
          ?
          PaceInt-v1.0.0-psd01.zip

          Show
          paul.knight1 Paul Knight added a comment - Delivered three templates to Editor, and to PACE email list: https://lists.oasis-open-projects.org/g/oca-pace-wg/message/283 Email: from: Paul Knight via lists.oasis-open-projects.org <paul.knight=oasis-open.org@lists.oasis-open-projects.org> to: oca-pace-wg@lists.oasis-open-projects.org date: Nov 9, 2022, 3:08 PM subject: [oca-pace-wg] Three Starter Documents for PACE specifications Per the submission requests [1] , please find the attached starter document packages for: PACE Architecture Specification Version 1.0.0 filename abbreviation: PaceArch PACE Interface Specification Version 1.0.0 filename abbreviation: PaceInt PACE Security Posture Attributes Specification Version 1.0.0 filename abbreviation: PaceAttr Each starter document package (.zip) contains the following files and directories: – a markdown file (.md) ... this is the main template or starter document, customized with titles and other elements for this Work Product – a directory "styles" containing an HTML style sheet (.css) (some .css files are permanently installed online - see "README" file.) – a directory "images" containing an example image file – a "README" text file with important instructions When the OP PGB first votes [2] to publish these Work Products in the OASIS Library, we expect them to be published at: https://docs.oasis-open-projects.org/oca/PaceArch/v1.0.0/psd01/PaceArch-v1.0.0-psd01.md https://docs.oasis-open-projects.org/oca/PaceInt/v1.0.0/psd01/PaceInt-v1.0.0-psd01.md https://docs.oasis-open-projects.org/oca/PaceAttr/v1.0.0/psd01/PaceAttr-v1.0.0-psd01.md The permanent "Latest stage" URIs will be: https://docs.oasis-open-projects.org/oca/PaceArch/v1.0.0/PaceArch-v1.0.0.md https://docs.oasis-open-projects.org/oca/PaceInt/v1.0.0/PaceInt-v1.0.0.md https://docs.oasis-open-projects.org/oca/PaceAttr/v1.0.0/PaceAttr-v1.0.0.md Please let me know if anything here fails to meet your expectations. ************* When the OP PGB votes [2] to approve a working draft as a Project Specification Draft, the Chair or other designated person must submit a request online, accessible on the Project Administration Requests Page [3] . Upon receipt of this request form, the Project Administrator will review and process the Work Product for official publication in the OASIS Library ( https://docs.oasis-open.org/ ), including addition of the requisite cover page metadata and other boilerplate information. =========== References: [1] https://tools.oasis-open.org/issues/browse/TCADMIN-4267 , .../ TCADMIN-4268 , .../ TCADMIN-4269 [2] Motion or ballot language templates for approval of a publication https://www.oasis-open.org/committees/download.php/53768 [3] Project Administration Requests Page - see "Publish a draft work" or "Start a public review" https://www.oasis-open.org/project-administration-support-requests/ Best wishes, Paul – Paul Knight....Document Process Analyst OASIS...Setting the standard for open collaboration ? PaceArch-v1.0.0-psd01.zip ? PaceAttr-v1.0.0-psd01.zip ? PaceInt-v1.0.0-psd01.zip
          Hide
          paul.knight1 Paul Knight added a comment -

          Should be all done here - resolving issue.

          Show
          paul.knight1 Paul Knight added a comment - Should be all done here - resolving issue.
          Hide
          chet-oasis Chet Ensign added a comment -

          All set so we'll close the ticket. 

          Show
          chet-oasis Chet Ensign added a comment - All set so we'll close the ticket. 

            People

            • Assignee:
              paul.knight1 Paul Knight
              Reporter:
              duncan Duncan Sparrell
            • Watchers:
              2 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: