The following roles can configure distributed access to electronic resources:
- Repository Administrator
- General System Administrator
The Network Zone can distribute access to electronic resources for the institutions of a collaborative network implementing a Network Zone. See Configuring Distributed Access to Electronic Resources When Working with a Network Zone.
Alma enables you to permit or deny access to electronic resources (portfolios, services, or collections) from specific libraries and campuses within an institution. When access is limited, patrons searching or browsing in Discovery from a restricted location (based on their IP address) do not see the resource in the search results, and cannot access the resource contents.
Alma uses inventory management groups to control distributed access. An inventory management group is a set of libraries or campuses. These groups can be assigned to portfolios, services, or electronic collections.
For example, if a library purchases electronic resources and wants them to be available only in the library, the library can define the resources to be available for a group that contains only that library. When a patron tries to access a resource, the patron's IP address is matched against the IP range of the library to determine if he or she is at the library. If the patron's IP address is not within the IP range, access to the electronic service is not enabled. A campus or library may belong to more than one group.
Inventory management groups are managed on the Inventory 'Available For' Management Groups page (Configuration Menu > Resources > General > Inventory Network Groups).
Inventory 'Available For' Management Groups Page
Inventory management groups must be enabled by a General System Administrator. The Inventory Network Groups link appears in the Resources configuration menu only if the parameter multi_campus_inventory_management is enabled in the General Customer Parameters mapping table. For more information, see Configuring Other Settings.
To add an inventory management group:
- Ensure that your libraries and campuses are defined and the IP addresses of each library and campus is set correctly. See Adding/Editing IP Definitions for a Library.
- On the Inventory 'Available For' Management Groups page, select Add Group. The Add Group dialog box appears.
- Enter a name for the group, optionally enter a description, and select Add and Close. The group appears on the Inventory 'Available For' Management Groups page.
- Select Edit from the group's actions list. The Inventory Management Group Details page appears.
- Select the library and/or campus to add to the group and select Add Library or Add Campus, respectively. The library or campus is added to the group..
Inventory Management Group Details Page
- When you are finished, select Save.
The group is now configured. You can delete the group on the Inventory 'Available For' Management Groups page.
After configuring the group, locate the portfolios, services, or electronic collections that you want to make available only for the group and configure them. For more information, see Associating a Resource with the Inventory Management Group.
If you delete an inventory management group that is connected to inventory, the relevant setting in the inventory is also deleted and cannot be automatically restored.
Unless you define specific inventory management group restrictions for portfolios and services separately from the inventory management group restrictions that are defined for the electronic collections with which they're associated, portfolios inherit inventory management group restrictions from electronic services, and services from electronic collections. These restrictions appear at the top of the Group Settings tab of the service or collection. For example, the following service has inherited restrictions from its parent collection.
Inherited Available For Group Settings
Inherited Group Settings Defined
For more information about inheriting group restrictions, see the E-Resources: Inherited ”Available For” Groups video.
The following sections that describe working with inventory management group settings use the following example information:
- There is a campus called The Science and Law Libraries Campus that includes the Science Library and the Law Library.
- There is another library called the Graduate Library.
The Science and Law Libraries Campus
IP Definition for The Science and Law Libraries Campus
Graduate Library IP Definition
- On the Inventory Network Groups page (Configuration Menu > Resources > General > Inventory Network Groups), select Add Group. The Add Group dialog box appears.
- Add the group The Science and Law Libraries Campus Group and select Add and Close.
Adding The Science and Law Libraries Campus Group
- Select Edit from the group row actions to add campuses and libraries to this group.
Additional Campuses and Libraries Can Be AddedFor each campus, select the campus and select Add Campus. For each library, select the library and select Add Library.
- Select Save.
- Open the Law & policy portfolio in the Electronic Portfolio Editor and select the Group Settings tab.
- Select Add Settings for Group. The Available For Information dialog box appears.
The Available For Information Dialog Box
- Select the group The Science and Law Libraries Campus Group.
- Select Save.
When Law & policy appears in a search, the results indicate that this resource is only available for a specific group.
Resource Identified as Available For a Specific Group
A guest is someone trying to access a resource while not logged in to the system. A logged in user can be explicitly associated with a campus in the user's definition; if the user is not associated with a specific campus, the user's IP range is checked, as for a guest.
Since the management group The Science and Law Libraries Campus Group was added to the resource Law & policy and the management group The Science and Law Libraries Campus Group includes the campus The Science and Law Libraries Campus with the IP 192.168.1.40-192.168.2.30, a guest coming from IP 192.168.2.30 is able to access the resource, Law & policy.
IP Range Definition
See below for an illustration of the guest's search results for Law & policy. The guest has access to the Law & policy resource.
Guest Search Results (from IP 192.168.2.30)
If the IP of the guest is not within the IP range defined for the campus, the guest is denied access to the electronic resource.
Guest Search Results with Access Denied
Associating an Electronic Collection with an Inventory Management Group
You can associate an inventory management group with an entire collection. The restriction of the collection applies to all the resources associated with the collection (unless restrictions are defined separately for the services/portfolios).
In the following example, the inventory management group The Science and Law Libraries Campus Group is associated with all the resources that are part of the EBSCOhost Criminal Justice Abstracts with Full Text electronic collection.
EBSCOhost Criminal Justice Abstracts with Full Text Electronic Collection
The repository search results show that The Science and Law Libraries Campus Group inventory management group applies at the electronic collection level and to all the resources in the electronic collection.
Electronic Collection Level Management Group Access
Access to All Resources in the Electronic Collection
In the following example, an inventory management group is associated with the Graduate Library, not a campus. The only member of the The Graduate Library Group (a management group) is the Graduate Library.
The Graduate Library Group Configured
The Graduate Library has an IP address range of 126.96.36.199-188.8.131.52. When the inventory management group The Graduate Library Group is applied to a resource, only users coming from IP’s within this range are able to access it.
In the example below, Law & policy is now also associated with the management group The Graduate Library Group.
Resource Assigned to the Graduate Library Group
Similar to the example in Understanding the Effects of the Inventory Management Group above, If the IP of the guest is within the IP range defined for the Graduate Library, the guest is allowed access to the electronic resource Law & policy. If the IP of the guest is not within the IP range defined for the library, the guest is denied access to Law & policy.
A user can be explicitly associated with a campus. In this case, the user's explicit association is used to determine whether the user is at the campus and able to access resources restricted to the campus.
When using inventory management groups restricted to a campus:
- A guest (not logged in) is able to view the resource only if coming from an IP within the range (demonstrated above).
- If a user is logged in and is not associated with a campus, the user is able to view the resource only coming from an IP within the range (demonstrated above).
- If a user is logged in and not within the IP range, the user is able to view the resource if the user is explicitly associated with a campus that is part of the inventory management group associated with the resource.
- If a user is logged in and is not coming from an IP in the range and is not associated with a campus that is part of the inventory management group, the user is not able to see the resource.
In the following example, there is a resource that is associated with an inventory management group that includes a campus with an IP range of 192.168.1.40-192.168.2.30. The logged in patron tries to access the resource from an IP address that is not within this range.
The patron Dean Andrews comes from a different IP range and is not associated with a campus. As a result, he will have no access to the resource.
No Campus Definition
However, if the patron Dean Andrews comes from a different IP range and is associated with a campus (that is part of an inventory management group associated with the electronic resource), he has access to the resource even though he is not in the IP range.
Patron with a Campus Definition
When a resource is restricted by campus, you can add a campus parameter to the OpenURL to enable access to the resource. When the resource is accessed with this parameter, Alma considers the request to come from within the campus named by the parameter.
An OpenURL request using this feature must still be sent with valid proxy account details or from a correct IP range.
In the following example, the electronic resource Law & policy is associated with the group The Science and Law Libraries Campus Group that includes the campus The Science and Law Libraries Campus.
The Science and Law Libraries Campus Group Management Group Example
The user is coming from outside the IP range, is a guest, and has no associated campus, but the user can specify a campus in the OpenURL. To illustrate how using the openURL method works, the following three examples highlight both successful and unsuccessful access to resources in Alma.
The OpenURL syntax uses the following components:
- The Alma URL begins with https://uni.alma.exlibrisgroup.com
- The Alma institution code is: EXLDEV1_INST
- The campus code for this example is ScienceLaw
Example 1: http://uni.alma.exlibrisgroup.com/view/uresolver/EXLDEV1_TEST/openurl-ScienceLaw?rft.mms_id=994387020000121
This OpenURL has the correct syntax that uses the correct campus code and provides access to the resources for the user.
Correct OpenURL Syntax/Access Provided
Example 2: http://uni.alma.exlibrisgroup.com/view/uresolver/EXLDEV1_TEST/openurl-Law?rft.mms_id=994387020000121
Access is not provided with this OpenURL, because the wrong campus code is used.
Wrong Campus Code Used/Access Not Provided
Example 3: http://uni.alma.exlibrisgroup.com/view/uresolver/EXLDEV1_TEST/openurl?rft.mms_id=994387020000121
Access is not provided with this OpenURL. There is no campus code, and Alma correctly responds with No full text available.
No Campus Code/Access Not Provided
When configuring an environment in which campuses and libraries are given distributed access to electronic resources, you must configure Primo and the Primo Central Index (PCI) to support the availability of these resources per campus/library. Refer to the following documents to configure Primo and the PCI for a multicampus environment: