Review and cleanup Module Descriptors for mod-reporting

CSP Request Details

None

CSP Rejection Details

None

CSP Approved

None

Description

To support automatic capabilities creation and keep FOLIO permission usage consistent, it is suggested that all module descriptors be reviewed and inconsistencies in permission namings and usage be fixed.

https://github.com/folio-org/folio-module-descriptor-validator can help teams with finding such problems in the module descriptor.

If the module is not a java based - https://github.com/folio-org/folio-module-descriptor-validator/blob/master/scripts/module-descriptor-batch-validator/README.md

Permission naming convention for renaming - https://folio-org.atlassian.net/wiki/spaces/FOLIJET/pages/156368925/Permissions+naming+convention

How to rename a permission:

Rules for Module Descriptor:

  • Permission name according to the convention

  • One permission can be used to protect only one endpoint

  • Endpoint should be protected by 0-1 permissions

  • Permission with sub permissions(Permission set) can’t be used for endpoint protection

Scope:

  • Add plugin to the modules pom file and run build

  • Fix problems in module descriptor according to the Permission naming convention or rules

  • If module is not a java based - run local scripts and fix module descriptor

Environment

None

Potential Workaround

None

Checklist

hide

Activity

Show:

Mike Taylor October 15, 2024 at 1:38 PM

Done. Each endpoint is now governed my its own permission instead of ldp.read governing logs/tables/columns/query/reports. For backwards-compatibility, ldp.read is retained as an umbrella that contains all five new fine-grained permissions, which means we only need a new minor version (not major) for the ldp-query interface provided by the module.

Mike Taylor October 15, 2024 at 10:57 AM

It turns out that has helpfully provided a minimal pom.xml that can be used for non-Java projects: it’s at https://github.com/folio-org/folio-module-descriptor-validator/blob/33e4375bd244743bb6791639a898c3d9a80c2f5b/README.md#non-project-usage but currently not merged to master.

Mike Taylor October 14, 2024 at 6:02 PM

Has anyone made a version of the module-descriptor validator that simple runs on a specified module descriptor, instead of needing all this messing about with pom.xml files and install.json and suchlike?

Mike Taylor September 20, 2024 at 5:36 PM

Sorry, . What I meant is that you can either move this ticket to MODREP and edit it accordingly; or close this ticket, and raise new on on MODREP.

Charlotte Whitt September 20, 2024 at 5:03 PM

- sorry. Can you maybe be a little more clear here, about what you recommend me to do. Right now the ticket just hang undecided.

Done

Details

Assignee

Reporter

Labels

Priority

Sprint

Development Team

Thor

Fix versions

Release

Ramsons (R2 2024)

TestRail: Cases

Open TestRail: Cases

TestRail: Runs

Open TestRail: Runs
Created September 4, 2024 at 10:27 AM
Updated October 15, 2024 at 5:58 PM
Resolved October 15, 2024 at 1:39 PM
TestRail: Cases
TestRail: Runs

Flag notifications