Praca z kluczami dostępu w usłudze Azure Functions

1. Zaloguj się do witryny Azure Portal, a następnie wyszukaj i wybierz pozycję Aplikacja funkcji.

2. Wybierz aplikację funkcji, z którą chcesz pracować.

3. W okienku po lewej stronie rozwiń węzeł Funkcje, a następnie wybierz pozycję Klucze aplikacji.

   Zostanie wyświetlona strona Klucze aplikacji. Na tej stronie są wyświetlane klucze hosta, które mogą służyć do uzyskiwania dostępu do dowolnej funkcji w aplikacji. Zostanie również wyświetlony klucz systemowy, który zapewnia każdemu użytkownikowi dostęp na poziomie administratora do wszystkich interfejsów API aplikacji funkcji.

Możesz również ćwiczyć najmniejsze uprawnienia przy użyciu klucza dla określonej funkcji. Klucze specyficzne dla funkcji można pobrać z karty Klucze funkcji określonej funkcji wyzwalanej przez protokół HTTP.

Uruchom następujący skrypt w usłudze Azure Cloud Shell, którego dane wyjściowe są kluczem default hosta, który może służyć do uzyskiwania dostępu do dowolnej funkcji wyzwalanej przez protokół HTTP w aplikacji funkcji.

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

W tym skrypcie zastąp wartości <RESOURCE_GROUP> i <APP_NAME> grupą zasobów oraz nazwą aplikacji funkcji odpowiednio.

Ponieważ dane wyjściowe zawierają poufne informacje, nie utrwalaj danych wyjściowych ani nie zabezpieczaj żadnych utrwałych danych wyjściowych pliku.

Uruchom następujący skrypt, którego wynikiem jest default klucz hosta, który może służyć do uzyskiwania dostępu do dowolnej funkcji wyzwalanej przez protokół HTTP w aplikacji funkcji.

$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

W tym skrypcie zastąp wartości <RESOURCE_GROUP> i <APP_NAME> grupą zasobów oraz nazwą aplikacji funkcji odpowiednio.

1. Zaloguj się do witryny Azure Portal, a następnie wyszukaj i wybierz pozycję Aplikacja funkcji.

2. Wybierz aplikację funkcji, z którą chcesz pracować.

3. W okienku po lewej stronie rozwiń węzeł Funkcje, a następnie wybierz pozycję Klucze aplikacji.

   Zostanie wyświetlona strona Klucze aplikacji. Na tej stronie są wyświetlane klucze hosta, które mogą służyć do uzyskiwania dostępu do dowolnej funkcji w aplikacji. Zostanie również wyświetlony klucz systemowy, który zapewnia każdemu użytkownikowi dostęp na poziomie administratora do wszystkich interfejsów API aplikacji funkcji.

4. Wybierz pozycję Odnów wartość klucza obok klucza, który chcesz odnowić, a następnie wybierz pozycję Odnów i zapisz.

Możesz również odnowić klucz funkcji na karcie Klucze funkcji określonej funkcji wyzwalanej przez protokół HTTP.

Uruchom następujący skrypt w usłudze default Azure Cloud Shell, który odnawia klucz hosta przy użyciu nowej wartości klucza wygenerowanej przez usługę Functions.

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

W tym skrypcie zastąp wartości <RESOURCE_GROUP> i <APP_NAME> grupą zasobów oraz nazwą aplikacji funkcji odpowiednio. Ten skrypt został utworzony do uruchomienia w usłudze Azure Cloud Shell (Bash). Należy zmodyfikować go tak, aby był uruchamiany w terminalu systemu Windows.

Nowa wartość klucza wygenerowana przez usługę Functions jest wyświetlana dla twojego odwołania. Ta nowa wartość klucza musi być bezpiecznie dystrybuowana do wszystkich aplikacji, które opierają się na kluczu hosta. Ponieważ dane wyjściowe zawierają poufne informacje, nie utrwalaj danych wyjściowych ani nie zabezpieczaj żadnych utrwałych danych wyjściowych pliku.

Uruchom następujący skrypt, który używa interfejsów API REST do odnowienia default klucza hosta przy użyciu nowej wartości klucza wygenerowanej przez usługę Functions.

# 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

W tym skrypcie zastąp wartości <RESOURCE_GROUP> i <APP_NAME> grupą zasobów oraz nazwą aplikacji funkcji odpowiednio.

Nowa wartość klucza wygenerowana przez usługę Functions jest zwracana dla twojego odwołania. Musi być bezpiecznie dystrybuowana do wszystkich aplikacji, które opierają się na kluczu hosta. Ponieważ dane wyjściowe zawierają poufne informacje, nie utrwalaj danych wyjściowych ani nie zabezpieczaj żadnych utrwałych danych wyjściowych pliku.