discoverygarden/embargo

A module for managing embargo policies with access restrictions on content

v1.7.1 2024-08-05 15:26 UTC

Requires

• discoverygarden/islandora_hierarchical_access: ^1
• discoverygarden/update-helper: ^1

Requires (Dev)

• discoverygarden/islandora_test_support: ^1

GPL-2.0-or-later

README

Embargo content indefinitely or till specified date, limiting access to specific users and/or IP addresses.

This module is intended to be a successor to https://github.com/discoverygarden/embargoes

Installation

Install as usual.

Migrating from embargoes

Migrations exist in the migrate_embargoes_to_embargo module for migrating from embargoes's entities onto embargo's. See the module's docs for more info.

Configuration

Configuration options can be set at admin/config/content/embargo, including a contact email and notification message.

Embargoes can be managed at admin/content/embargo.

To add an IP range for use on embargoes, navigate to admin/content/embargo/range and click 'Add IP range'. Ranges created via this method can then be used as IP address whitelists when creating embargoes. This CIDR to IPv4 Conversion utility can be helpful in creating valid CIDR IP ranges.

search_api processor(s)

We have multiple search_api processors which attempt to constrain search results based on the effects of embargoes on the entities represented by search results, including:

• embargo_processor ("Embargo access (deprecated)")
  • Adds additional properties to the indexed rows, requiring additional index maintenance on mutation of the entities under consideration, but should theoretically work with any search_api backend
• embargo_join_process ("Embargo access, join-wise")
  • Requires Solr/Solarium-compatible index, and indexing of embargo entities in the same index as the node/media/files to be search, tracking necessary info and performing Solr joins to constrain results

Typically, only one should be used in any particular index.

Usage

Applying an embargo

An embargo can be applied to an existing node by clicking the "Embargoes" tab on a node, or navigating to embargoes/node/{node_id}. From here, an embargo can be applied if it doesn't already exist, and existing embargoes can be modified or removed.

Known Issues/FAQ

• Embargoed items show up in search results
  • Enable one of our search_api processors to handle applying embargo restrictions.
• "Embargo access, join-wise" does not show up as an available processor
  • Ensure embargo entities are being indexed in the given index.
  • Ensure that eligible node/media/files entities are being indexed in the given index.

Troubleshooting/Issues

Having problems or solved a problem? Contact discoverygarden.

Maintainers/Sponsors

• discoverygarden

Attribution

This module is heavily based on and includes contributions from discoverygarden/embargoes which was forked from fsulib authored by Bryan J. Brown.

License

GPLv2