Azure Functions でアクセス キーを操作する

1. Azure portal にサインインし、"関数アプリ" を検索して選択します。

2. 操作する関数アプリを選択します。

3. 左側のペイン内で、[関数] を展開してから、[アプリ キー] を選択します。

   [アプリ キー] ページが表示されます。 このページ上にはホスト キーが表示されます。これは、アプリ内の任意の関数にアクセスするために使用できます。 システム キーも表示されます。これは、すべての関数アプリ API への管理者レベルのアクセスを、どのユーザーに対しても付与します。

特定の関数用のキーを使用して、最小限の特権を実践することもできます。 関数固有のキーは、特定の HTTP によってトリガーされる関数の [関数キー] タブから取得できます。

Azure Cloud Shell 内で次のスクリプトを実行します。その出力は default ホスト キーであり、関数アプリ内で HTTP によってトリガーされる関数にアクセスするために使用できます。

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

このスクリプト内では、<RESOURCE_GROUP> と <APP_NAME> をそれぞれリソース グループと関数アプリ名に置き換えます。

この出力には機密情報が含まれているため、出力を保持しないか、永続化されたファイル出力をセキュリティで保護してください。

次のスクリプトを実行します。その出力は default ホスト キーであり、関数アプリ内で HTTP によってトリガーされる関数にアクセスするために使用できます。

$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

このスクリプト内では、<RESOURCE_GROUP> と <APP_NAME> をそれぞれリソース グループと関数アプリ名に置き換えます。

1. Azure portal にサインインし、"関数アプリ" を検索して選択します。

2. 操作する関数アプリを選択します。

3. 左側のペイン内で、[関数] を展開してから、[アプリ キー] を選択します。

   [アプリ キー] ページが表示されます。 このページ上にはホスト キーが表示されます。これは、アプリ内の任意の関数にアクセスするために使用できます。 システム キーも表示されます。これは、すべての関数アプリ API への管理者レベルのアクセスを、どのユーザーに対しても付与します。

4. 更新するキーの横にある [キー値の更新] を選択してから、[更新して保存] を選択します。

特定の HTTP によってトリガーされる関数の [関数キー] タブ内で関数キーを更新することもできます。

Azure Cloud Shell 内で次のスクリプトを実行します。これにより、Functions によって生成された新しいキー値で default ホスト キーが更新されます。

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

このスクリプト内では、<RESOURCE_GROUP> と <APP_NAME> をそれぞれリソース グループと関数アプリ名に置き換えます。 このスクリプトは、Azure Cloud Shell (Bash) 内で実行するために作成されています。 これを Windows ターミナル内で実行するには変更する必要があります。

Functions によって生成された新しいキー値が、参照用に表示されます。 この新しいキー値は、ホスト キーに依存するすべてのアプリに安全に配布する必要があります。 この出力には機密情報が含まれているため、出力を保持しないか、永続化されたファイル出力をセキュリティで保護してください。

次のスクリプトを実行します。これは REST API を使用して、Functions によって生成された新しいキー値で default ホスト キーを更新します。

# 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

このスクリプト内では、<RESOURCE_GROUP> と <APP_NAME> をそれぞれリソース グループと関数アプリ名に置き換えます。

Functions によって生成された新しいキー値が、参照用に返されます。 これを、ホスト キーに依存するすべてのアプリに安全に配布する必要があります。 この出力には機密情報が含まれているため、出力を保持しないか、永続化されたファイル出力をセキュリティで保護してください。