Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Access Control is an enhancement for existing S3 mirroring feature. It adds ability to presign pr-esign S3 URLs which allows libraries to share allow access to protected books only to authenticated patrons and only for specific amount of time.

...

  • All the covers will be mirrored to Book Covers Bucket
  • All the books will be mirrored to Protected Access Content Bucket
  • New collections will be created in Circulation Manager for each metadata file

...

Fulfillment workflow

After the collection is imported into Circulation Manager patrons can access the content. The actual workflow is depicted on the picture below: during a fulfilment fulfillment process Circulation Manager creates a signed link and returns it back to the client which is used by the patron to download the actual content.

...

  • Circulation Manager ver 3.X.X
  • MARC or ONIX Files
  • EPUBs or PDF files
  • Cover Art (jpegsJPEG, pngsPNG) for the respective EPUBs or PDFs.
  • Network reachable location (for example, a file share in LAN).

...

  1. Create a new collection in Circulation Manager and set up the following settings:
    1. Covers Mirror should be set up to the newly created S3 storage (it will appear in the dropdown only in the case you filled in Book Covers Bucket in S3 settings)
    2. Protected access mirror should be set up to the newly created S3 storage (it will appear in the dropdown only in the case you filled in Protected Access Content Bucket in S3 settings)
    3. URL signing should be set up to Sign URL and make them expirable

Image Modified



  1. Import an ONIX collection into Circulation Manager: 

    Code Block
    /bin/directory_import \
        --collection Manual \
        --collection-type PROTECTED_ACCESS \
        --data-source-name oapen \
        --metadata-format onix \
        --metadata-file ./onix_collection/onix2.xml \
        --ebook-directory ./onix_collection \
        --rights-uri http://librarysimplified.org/terms/rights-status


    Info

    Please make sure that MARC/ONIX files, books and their covers are located on a local machine or at a network reachable location (for example, a file share in LAN).


  2. Update the search index: 

    Code Block
    /bin/search_index_refresh


  3. Try to download a book and Circulation Manager must generate a pre signed URL