The first step in granting access to a user is to create that user in the Users tab.
The second step is to assign a credential to that user. Once a credential is assigned to the user, they should have the right permissions and access levels to collections and the Independent Media Items. If they are missing access to something, chances are there's a setting that needs to be fixed in the credential or the access permissions.
A credential is assigned to a user. The settings in a credential determine:
You can create as many credentials as needed, and assign them to your users. You will always have an "Anonymous User" credential. This credential is automatically assigned to any user that registers an account with the LUNA Viewer. Typically this credential is for users who are mainly accessing the LUNA Viewer.
Anonymous credential (1 of 3 defaults in LUNA)
Use the Anonymous credential to make collections available to your audience without requiring a user to login. This credential is also automatically assigned to users who register an account via the LUNA Viewer. A user with this credential will not have access to any of the other tools in the LUNA suite and will not be able to export images or use My Uploads in the Viewer. Typically, the collection(s) you assign to this credential will be associated with the “restricted” access permission.
Good for granting public access to your collections.
Local Users credential (1 of 3 defaults in LUNA)
Use the Local Users credential to make collections available to general users at your institution. A user with this credential will not have access to any of the other tools in the LUNA suite, but they will be able to export images and use My Uploads in the Viewer. Typically, the collection(s) you assign to this credential will be associated with the “general” access permission which allows users to export images up to size 5 (up to 3072 pixels on long side).
Good for students, staff, researchers.
Administrator credential (1 of 3 defaults in LUNA)
Use the Administrator credential for administrators of the LUNA system and any users authorized to create and manage user accounts and settings. A user with this credential will have full access to all the tools in the LUNA suite. Typically, the collection(s) you assign to this credential will be associated with the “admin” access permission which grants the highest level of permissions.
Good for administrators of the LUNA system and collections within LUNA.
Customized credential (sample)
Say you want to create a credential for a user whose responsibility it is to create and manage collections & data templates. You can design a custom credential that allows for access to the Viewer and Collection Manager while restricting access to the Administrator. Check create, edit and delete under the Templates settings and check create and delete under the collections settings to grant the appropriate permissions in the Collection Manager. Note, the permission to allow “editing” of a collection is set in the access permission. In this same credential, you’ll also grant access to export images and use My Uploads in the Viewer. Typically, the collection(s) you assign to this credential will be associated with the “admin” access permission or a customized access permission.
Good for visual resource librarians, faculty, curators.
LUNA comes with a set of 5 default access permissions which you can choose from or you can create your own by clicking "Add Access Permission.” You may create as many as you like this way. You may edit the default 5 if you like as well.
Access permissions are added to a credential. The credential grants permission to certain LUNA tools and features, while an access permission pertains only to a specific collection and what a user can do with that collection. For each collection you have added, you can create 1 or more access permissions that you can assign in the Credentials tab to the different credentials to set they kind of access they have to the collection.
Without an access permission a user cannot gain access to a collection in order to create, edit, or view it.
When a collection is made 5 default access permissions are created. You can think of these as representing different roles, from admin to restricted. So all you have to do is pick one of the 5 access permissions for a collection and add it to the credential. The settings for these 5 default access permissions are:
Dimensions for LUNA sizes 0-8:
up to 96 pixels on long side
|Size 1||up to 192 pixels on long side|
|Size 2||up to 384 pixels on long side|
|Size 3||up to 768 pixels on long side|
|Size 4||up to 1536 pixels on long side|
|Size 5||up to 3072 pixels on long side|
|Size 6||up to 6144 pixels on long side|
|Size 7||up to 12288 pixels on long side|
|Size 8||up to 24576 pixels on long side|
Editing Access Permissions
There are 2 ways to edit an access permission.
Tip: Since you can't edit the name of an access permission, simply create a new one if you need a name different than the default name created.
Give your AP a name to help you easily identify it. (if creating a new access permission)
Set the max export resolution in the LUNA Viewer to specify the largest size it will allow a user to download an item. (see sizes above)
LUNA collection Manager settings allow you to decide if a user has editing/saving of the collection properties
Default Access permission for LUNA Viewer -
Note: Authorities are the only feature that are not automatically assigned to an access permission. By default a collection creator will have permission to read, add, edit, delete authorities. For all other users you'll need to manually assign the permission to the access permission for the collection.
Example 1: "Anonymous User" credential.
As explained above, you will always have an "Anonymous User". This is the default credential and is the one automatically assigned to users who register an account via the LUNA Viewer. Typically this credential is used only to grant access to specific collections in the LUNA Viewer.
In this credential (based on image below) the anonymous user will be able to:
Example 2: Collection Administrator credential
In this credential (based on image below) the user will be able to:
*General and Admin are profiles defined in the Access Permissions tab.