Difference between revisions of "Set Up an Azure File Share"

From wiki.fine.cz
Jump to navigation Jump to search
(Created page with "ToDo")
 
 
Line 1: Line 1:
ToDo
Follow these steps in order to use the Azure File Share in Fine applications:
 
==== Make sure you have a Microsoft Azure account and login into the [https://portal.azure.com Azure portal] ====
 
==== Create a new "Storage account" resource ====
Select "Create a resource":<br>
[[File:Azure-create-resource.png|frameless|Select "Create a resource".]]
 
Select "Create a new Storage account":<br>
[[File:Azure-create-resource-2.png|frameless|Create a new Storage account]]
 
On the "Advanced" tab make sure the option "Enable storage account key access" is checked:<br>
[[File:Azure-enable-SAS.png|frameless|Enable storage account key access]]
 
Setup other properties to match your needs.
 
==== Create a file share in the storage account ====
On the Storage account page, select "File shares" and "+ File share":<br>
[[File:Azure-add-file-share.png|frameless|Add a new file share]]
 
Setup the properties of the file share to match your needs.
 
==== Create a "Shared access signature" ====
Fine applications use the "Shared access signature" (SAS) to login into the Azure file share. Still on the Storage account page, select "Shared access signature":<br>
[[File:Azure-create-SAS.png|frameless|Create a SAS connection string to for Fine applications]]
 
Check "File" within allowed services and all Allowed resource types. Make sure you setup a reasonable expiration date/time.
 
Click on "Generate SAS and connection string" to generate the "Connection string".
 
Copy "Connection string", paste it into the "New Azure File Share account" dialog and select the share you want to use with the drop-down button:<br>
[[File:Azure-Fine-new-account.png|frameless|Connect to the Azure file share in a Fine application]]
 
Now, you can use the Azure file share to save, load and transfer your Fine documents.
 
==== How to remove access to the file share? ====
If you need to remove access to the file share (e.g. because a co-worker left your company), you have to invalidate the access key you used when generating the SAS.
 
Go to the "Access keys" tab and click on "Rotate key" at either key1 or key2 depending what key you used to generate the SAS:<br>
[[File:Azure-rotate-access-keys.png|frameless|Rotate keys to invalidate SAS]]
 
Now all the SASs will be invalidated and the users won't be able to access the file share anymore. You will have to create a new SAS to access the share.

Latest revision as of 17:16, 24 April 2024

Follow these steps in order to use the Azure File Share in Fine applications:

Make sure you have a Microsoft Azure account and login into the Azure portal

Create a new "Storage account" resource

Select "Create a resource":
Select "Create a resource".

Select "Create a new Storage account":
Create a new Storage account

On the "Advanced" tab make sure the option "Enable storage account key access" is checked:
Enable storage account key access

Setup other properties to match your needs.

Create a file share in the storage account

On the Storage account page, select "File shares" and "+ File share":
Add a new file share

Setup the properties of the file share to match your needs.

Create a "Shared access signature"

Fine applications use the "Shared access signature" (SAS) to login into the Azure file share. Still on the Storage account page, select "Shared access signature":
Create a SAS connection string to for Fine applications

Check "File" within allowed services and all Allowed resource types. Make sure you setup a reasonable expiration date/time.

Click on "Generate SAS and connection string" to generate the "Connection string".

Copy "Connection string", paste it into the "New Azure File Share account" dialog and select the share you want to use with the drop-down button:
Connect to the Azure file share in a Fine application

Now, you can use the Azure file share to save, load and transfer your Fine documents.

How to remove access to the file share?

If you need to remove access to the file share (e.g. because a co-worker left your company), you have to invalidate the access key you used when generating the SAS.

Go to the "Access keys" tab and click on "Rotate key" at either key1 or key2 depending what key you used to generate the SAS:
Rotate keys to invalidate SAS

Now all the SASs will be invalidated and the users won't be able to access the file share anymore. You will have to create a new SAS to access the share.