Differences

This shows you the differences between two versions of the page.

--- rootdir_security [2022/02/11 14:48]
yves
+++ rootdir_security [2022/08/06 19:34]
yves [Accessing secured content]
@@ Line 7: / Line 7: @@
       * Configure public/secret key combinations for S3 resources
       * Configure account credentials to be used when accessing a UNC network resource path
-  * Prevent users from access mounted content through root directories that they are or are not allowed to do
+  * Prevent [[user_management|users]] from access mounted content through root directories that they are or are not allowed to do
       * Define Access control lists
@@ Line 16: / Line 16: @@
 Based on the type of data storage that a root directory's mounting point refers to, the configuration offers different options:
-=== Local hard disk entry points ===
+  * [[rootdir_local|Local hard disk entry points]]
+  * [[rootdir_network|Network storage and UNC paths]]
+  * [[rootdir_s3|S3 storage]]
+  * [[rootdir_azure|Azure storage]]
-If you want to expose a local folder on the server's hard disk as a root directory in PMA.core, you have to give the IIS user account access rights to the folder using the Windows Explorer:
+=== Azure storage ===
-{{ :rootdir_local10.png?direct&400 |}}
+Microsoft Azure has its own protocol, and so we provide a separate mounting point type of it.
-Note that even though the dialog shows impersonation options, you can't use these in a local path reference context. The impersonation properties are reserved for networked content, and if you fill them in, PMA.core tries to interpret your local reference as a network path, and subsequently fails trying to access it.
+Let's say that you have an Azure container defined and put some slides in it already:
-{{ ::rootdir_local20.png?direct&400 |}}
+{{ :rootdir_azure_10.png?direct&400 |}}
-So when defining local hard disk paths, make sure the impersonation options are left blank.
+You can convert these credentials in a connectionstring:
-=== Network storage (UNC paths) ===
+''%%DefaultEndpointsProtocol=https;AccountName=pathomation;AccountKey=SUPERSECRET;BlobEndpoint=https://pathomation.blob.core.windows.net/;QueueEndpoint=https://pathomation.queue.core.windows.net/;TableEndpoint=https://pathomation.table.core.windows.net/;FileEndpoint=https://pathomation.file.core.windows.net/;%%''
-Pathomation runs under a certain application pool. This application pool is associated with a user identify, which may not have access to the network path that you try to access. Giving access for the application pool to access the network resource may be difficult for a variety of reasons.
+This text snippet is then pasted in the connection string field of the mounting point properties:
-If you can't immediately access the network path with default (i.e. application pool) credentials, you can provide additional information.
+{{ :rootdir_azure_20.png?direct&400 |}}
-In the case below we've created a dedicated pma_read user that is permitted to acces the shared \\MALTA1767\reference path:
+If all goes well, you can now serve your slides from your Azure storage repositories.
-{{ :rootdir_network10.png?direct&400 |}}
+==== Public vs private ====
-We can enter this as a path for the mounting point, and add the impersionation information for our pma_read user:
+As you have more [[user_management|users]] and more root-directories, it becomes undesirable that everybody is allowed to see everything.
-{{ :rootdir_network20.png?direct&400 |}}
+Therefore, root-directories can be marked "public" or "private":
-The mounting point shows up, and you can activate the View slides tab to inspect its content:
+{{ :rootdir_public_private_switch.png?direct&200 |}}
-{{ :rootdir_network30.png?direct&400 |}}
+Public root directories are marked "public", it means every user has access to them. They can be accessed by anybody who is a registered user in [[user_management|the PMA.core user repository]].
-If the credentials are faulty, an error appears
+Private root directories are marked "private", it means only select users can see the content. They are only accessible by those who have been explicitly given access to be allowed to access the folder through the directory's [[rootdir_security#access_control_list|access control list]].
-=== S3 storage ===
+==== Access control lists ====
-PMA.core is one of the few vendors that [[https://www.prweb.com/releases/pathomation_announces_support_for_cloud_storage_and_file_transfer_protocol_ftp_servers/prweb18296771.htm|supports cloud storage natively]].
+Once marked private, you can select what users are allowed to see the content of the root directory, and which ones aren't: Do this by pressing the "Edit access control list" link after you selected the "private" option:
-Let's say that you have an S3 bucket and put slides in it:
+{{ :acl.png?nolink&400 |}}
-{{ ::rootdir_s3_10.png?direct&400 |}}
+An interactive overview grid is available via the Root directories management view:
-To protect access, you should create a dedicated entity that can only access that content.
+{{ :rootdir_acl_20.png?direct&400 |}}
-{{ ::rootdir_s3_20.png?direct&400 |}}
+As you get even more root-directories and more users, it is useful to get an overview of who has access to what. For that, you can request the ACL report from the root-directories view.
-You can then create a pair of dedicated access / secret keys for the new entity:
+{{ :overview.png?nolink&400 |}}
-{{ :rootdir_s3_30.png?direct&400 |}}
+The resulting report looks like this:
-These keys are then used to configure the S3 mounting point at the PMA.core side:
+{{ :overview2.png?nolink&400 |}}
-The mounting point only functions when the provided credentials are still active on the S3 storage side.
-You can now browse your slides directly from your S3 content.
-=== Azure storage ===
-==== Public vs private ====
-As you have more users and more root-directories, it becomes undesirable that everybody is allow to see everything.
-Therefore, root-directories can be marked "public" or "private":
-Public root directories are marked "public", it means every user has access to them. They can be accessed by anybody who is a registered user in the PMA.core user repository.
-Private root directories are marked "private", it means only select users can see the content. They are only accessible by those who have been explicitly given access to be allowed to access the folder through the directory's [[acl|access control list]].
-==== Access control lists ====
-Once marked private, you can select what users are allowed to see the content of the root directory, and which ones aren't: Do this by pressing the "Edit access control list" link after you selected the "private" option:
-{{ :acl.png?nolink&400 |}}

PMA.core 3.0.1

User Tools

Site Tools

Differences

Page Tools