Filespace shares form the basis of our Access Control List (ACL) and enable administrators to provide, read, read-write access throughout the Filespace of folders and subsequently the files they contain to particular users. 


Before you begin implementing your shares permission structure, you will need to create your users. Please review Manage Filespace Users FAQ for a detailed overview of administering your users.


Permissions for each user can be granted access across the entire Filespace hierarchical tree structure via assigning a user shared access.


Shares are an important way of securing access to certain data, enabling users to participate in project collaboration, or gain access to areas of a Filespace when required. Administrators can apply or revoke access as required, promoting users with read access, to read-write as their access requirements evolve, or remove access entirely.


Creating shares and allocating users and permissions can be achieved via our LucidLink client dashboard and the manage users and shares tab.

Shares are assigned to users with read, read & write permissions. 

Add a share.

1. Select a user.

2. Choose a share path.

3. Specify access type, read or read,write and select add share.

Existing shares can be modified, additional users added, or user permissions updated or revoked by expanding the share, adding users or selecting more options on existing users.


Filespace shares can also be administered from the command line and easily scripted. 

lucid help share

usage:
Lucid share [--list]
Lucid share --set path --user username [--permissions flags]
Lucid share --delete path --user username
Lucid share --get path

Share management - requires root permissions

Options:

    --password password      Your current password
    --list                   Display the list of existing shares
    --set path               Set share permissions. Path starts at the file space root, not the local file system root
    --delete path            Delete a share
    --get path               Get share permissions
    --user username          Username
    --permissions flags      Comma separated list of flags: read,write. Default: --permissions read,write

Share a Filespace root path to a user with read-write permissions.

lucid share --set / --user user1 --permissions read,write

Share a folder with read only access permissions.

lucid share --set /company --user user1 --permissions read

Promote previously user shared folder from read only access to read,write permissions.

lucid share --set /company --user user1 --permissions read,write

Share a folder to a user with read-write access permissions.

lucid share --set /sales --user user1 --permissions read,write

Revoke a users write permissions from a folder share.

lucid share --set /sales --user user1 --permissions read

Revoke a users access from a folder share.

lucid share --delete /sales --user user1

Display share structure for an entire Filespace.

lucid share --list
Enter your current password:

SHARED PATH        USERNAME        SHARED AS        PERMISSIONS
Company            User1           Company          read, write
Company            User2           Company          read, write
Company            User3           Company          read, write
Company            User4           Company          read, write
Company            User5           Company          read, write
Development        User4           Development      read, write
Development        User5           Development      read, write
Marketing          User1           Marketing        read
Marketing          User2           Marketing        read
Marketing          User3           Marketing        read, write
Sales              User1           Sales            read, write
Sales              User2           Sales            read
Sales              User3           Sales            read
Support            User1           Support          read
Support            User2           Support          read
Support            User4           Support          read, write
Support            User5           Support          read, write
Users/User1        User1           User1            read, write
Users/User2        User2           User2            read, write
Users/User3        User3           User3            read, write
Users/User4        User4           User4            read, write
Users/User5        User5           User5            read, write

Display a particular folder's share properties.

lucid share --get /marketing
Enter your current password:

SHARED PATH        USERNAME        SHARED AS        PERMISSIONS
marketing          User1           Marketing        read
marketing          User2           Marketing        read
marketing          User3           Marketing        read, write

If you'd like to bulk create your shares, we have an example Powershell script in our tips and tricks Bulk Share Creation FAQ.