Exercise - Use stored access policies to delegate access to Azure Storage - Training

8 minutes

Instead of creating SASs individually, each with its own access permissions and expiration dates, you can associate them with a stored access policy. Changing the policy affects all the SASs associated with it.

Now that you know there's a better way to create and manage your company's SASs. You can update your new test pages to use stored access policies.

In this exercise, you update your web app to create SASs with stored access policies. Then you use Azure CLI commands to change the policies and test that access is revoked.

Add a method to create stored access policies

In Azure Cloud Shell, edit the PatientRecordController.cs file.
```
code ~/sas/Controllers/PatientRecordController.cs
```

At the bottom of the class, under the GetBlobSas method, write a method to create stored access policies.

// Use a stored access policy for the SAS
private void CreateStoredAccessPolicy()
{
    // Create a stored access policy for our blobs
    BlobSignedIdentifier identifier = new BlobSignedIdentifier
    {
        Id = _storedPolicyID,
        AccessPolicy = new BlobAccessPolicy
        {
            ExpiresOn = DateTimeOffset.UtcNow.AddHours(1),
            Permissions = "r"
        }
    };

    _container.SetAccessPolicy(permissions: new BlobSignedIdentifier[] { identifier });
}

This method uses a global variable for the access policy identifier. Add this variable at the top of the class under the declaration for the BlobContainerClient variable named _container.
```
private String _storedPolicyID = "patient-images-policy";
```

The stored access policy is used for each SAS token that's generated, so call the new method on the class instantiation. Add a call at the bottom of the method.

public PatientRecordsController(ILogger<PatientRecordsController> logger, IConfiguration iconfiguration)
{
    _logger = logger;
    _iconfiguration = iconfiguration; 
    _container = new BlobContainerClient(
        _iconfiguration.GetValue<string>("StorageAccount:ConnectionString"),
        _iconfiguration.GetValue<string>("StorageAccount:Container")
    );
    CreateStoredAccessPolicy();
}

Now GetBlobSas can be simplified to use the access policy. Change the method to use it.

 // Build a SAS token for the given blob
 private string GetBlobSas()
 {
     // Create a user SAS that only allows reading for a minute
     BlobSasBuilder sas = new BlobSasBuilder 
     {
         Identifier = _storedPolicyID,
         BlobContainerName = _iconfiguration.GetValue<string>("StorageAccount:Container")
     };

     // Use the shared key to access the blob
     var storageSharedKeyCredential = new StorageSharedKeyCredential(
         _iconfiguration.GetValue<string>("StorageAccount:AccountName"),
         _iconfiguration.GetValue<string>("StorageAccount:AccountKey")
     );

     return '?' + sas.ToSasQueryParameters(storageSharedKeyCredential).ToString();
 }

The code that handles the SAS token requests needs a small fix to call the updated method.

// GET PatientRecord/patient-nnnnnn/secure
[HttpGet("{Name}/{secure}")]
public PatientRecord Get(string name, string flag)
{
    BlobClient blob = _container.GetBlobClient(name);
    return new PatientRecord { name=blob.Name, imageURI=blob.Uri.AbsoluteUri, sasToken=GetBlobSas() };
}

Save your code changes by selecting Ctrl+S and then selecting Ctrl+Q.

Test the new code

In Cloud Shell, build the app.
```
cd ~/sas/
dotnet build
```
In case the port has closed since you finished the previous exercise, run the curl command to open it again.
```
curl -X POST http://localhost:8888/openPort/8000;
```
Run the update web app.
```
dotnet run
```
Go to the web app's URL, and make sure it ends in a slash (/).
On the home page, select Get all patients.
Copy an image filename. An example is patient-32589.jpg.
Select the External companies menu link at the top of the page.
Paste the image filename into the Patient image filename field.
Select Get Key to populate the SAS token.
Select View scan to view the image.

Edit the stored access policy

Sign in to the Azure portal using the same credentials you used to activate the sandbox.
In the Azure portal resource menu, select All resources.
In the list of resources, select the medical records storage account.
On the Overview pane, select Containers, and then select patient-images.
On the patient images menu, under Settings, select Access policy.
Notice that your web app created a patient-images-policy stored access policy.
On the right, select the ... menu, and then select Edit from the pop-up menu.
In the Edit policy, change the Permission from read to list and select OK to confirm.
Select Save on the patient-images | Access policy pane.

Test a new SAS

Return to your web app. On the External companies page, create a new SAS token by selecting Get Key.
Select View scan.

The image isn't returned from Azure Storage and you get a 403 authentication error.

Continue

Exercise - Use stored access policies to delegate access to Azure Storage

Add a method to create stored access policies

Test the new code

Edit the stored access policy

Test a new SAS

Feedback