Usare le chiavi di accesso in Funzioni di Azure

1. Accedere al portale di Azure e quindi cercare e selezionare App per le funzioni.

2. Selezionare l'app per le funzioni che si desidera usare.

3. Nel riquadro sinistro espandere Funzioni, quindi selezionare Chiavi dell'app.

   Viene visualizzata la pagina Chiavi dell'app. In questa pagina vengono visualizzate le chiavi host, che possono essere usate per accedere a qualsiasi funzione nell'app. Viene visualizzata anche la chiave di sistema, che consente a chiunque l'accesso a livello di amministratore a tutte le API dell'app per le funzioni.

È inoltre possibile avvalersi di privilegi minimi usando la chiave per una funzione specifica. È possibile ottenere chiavi specifiche della funzione dalla scheda Chiavi funzione di una specifica funzione attivata da HTTP.

Eseguire lo script seguente in Azure Cloud Shell, il cui output è la chiave host default, che può essere usata per accedere a qualsiasi funzione attivata tramite HTTP nell'app per le funzioni.

az functionapp keys list --resource-group <RESOURCE_GROUP> --name <APP_NAME> --query functionKeys.default --output tsv

In questo script, sostituire <RESOURCE_GROUP> e <APP_NAME> rispettivamente con il gruppo di risorse e il nome dell'app per le funzioni.

Poiché l'output contiene informazioni sensibili, non rendere persistente l'output né proteggere gli output dei file persistenti.

Eseguire lo script seguente, il cui output è la chiave host default, che può essere usata per accedere a qualsiasi funzione attivata tramite HTTP nell'app per le funzioni.

$subName = '<SUBSCRIPTION_ID>'
$rGroup = '<RESOURCE_GROUP>'
$appName = '<APP_NAME>'
$path = "/subscriptions/$((Get-AzContext).Subscription.Id)/resourceGroups/$rGroup/providers/Microsoft.Web/sites/$appName/host/default/listKeys?api-version=2018-11-01"
((Invoke-AzRestMethod -Path $path -Method POST).Content | ConvertFrom-JSON).functionKeys.default

In questo script, sostituire <RESOURCE_GROUP> e <APP_NAME> rispettivamente con il gruppo di risorse e il nome dell'app per le funzioni.

1. Accedere al portale di Azure e quindi cercare e selezionare App per le funzioni.

2. Selezionare l'app per le funzioni che si desidera usare.

3. Nel riquadro sinistro espandere Funzioni, quindi selezionare Chiavi dell'app.

   Viene visualizzata la pagina Chiavi dell'app. In questa pagina vengono visualizzate le chiavi host, che possono essere usate per accedere a qualsiasi funzione nell'app. Viene visualizzata anche la chiave di sistema, che consente a chiunque l'accesso a livello di amministratore a tutte le API dell'app per le funzioni.

4. Selezionare Rinnova il valore della chiave accanto alla chiave da rinnovare, quindi selezionare Rinnova e salva.

È inoltre possibile rinnovare una chiave di funzione nella scheda Chiavi funzione di una specifica funzione attivata da HTTP.

Eseguire lo script seguente in Azure Cloud Shell, che rinnova la chiave host default con un nuovo valore chiave generato da Funzioni.

az functionapp keys set --resource-group <RESOURCE_GROUP> --name <APP_NAME> --key-type functionKeys --key-name default

In questo script, sostituire <RESOURCE_GROUP> e <APP_NAME> rispettivamente con il gruppo di risorse e il nome dell'app per le funzioni. Questo script è stato creato per l'esecuzione in Azure Cloud Shell (Bash). È necessario modificarlo per l'esecuzione in un terminale Windows.

Il nuovo valore della chiave generato da Funzioni viene mostrato come riferimento. Questo nuovo valore della chiave deve essere distribuito in modo sicuro in tutte le app che si basano sulla chiave host. Poiché l'output contiene informazioni sensibili, non rendere persistente l'output né proteggere gli output dei file persistenti.

Eseguire lo script seguente, che usa le API REST per rinnovare la chiave host default con un nuovo valore chiave generato da Funzioni.

# Variables - replace these with your actual values
$resourceGroupName = "<RESOURCE_GROUP>"
$functionAppName = "<APP_NAME>" 

# Construct the URI for the REST API call
$uri = "https://management.azure.com/subscriptions/$((Get-AzContext).Subscription.Id)/resourceGroups/$resourceGroupName/providers/Microsoft.Web/sites/$functionAppName/host/default/listkeys?api-version=2021-02-01"

# Construct the body of the request
$body = @{
    properties = @{
        name = "default"
    }
} | ConvertTo-Json

# Invoke the REST API to create or update the host-level secret
$response = Invoke-AzRestMethod -Method Post -Uri $uri -Payload $body

# Output the updated key for reference
($response.Content | ConvertFrom-Json).functionKeys.default

In questo script, sostituire <RESOURCE_GROUP> e <APP_NAME> rispettivamente con il gruppo di risorse e il nome dell'app per le funzioni.

Il nuovo valore della chiave generato da Funzioni viene restituito come riferimento. Deve essere distribuito in modo sicuro in tutte le app che si basano sulla chiave host. Poiché l'output contiene informazioni sensibili, non rendere persistente l'output né proteggere gli output dei file persistenti.