在 Azure Functions 中使用存取金鑰

1. 登入 Azure 入口網站，然後搜尋並選擇功能應用程式。

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 觸發的函式。

$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 入口網站，然後搜尋並選擇功能應用程式。

2. 選取您想要使用的函式應用程式。

3. 在左側功能表中，展開 [函式]，然後選取 [應用程式金鑰]。

   [應用程式金鑰] 頁面隨即出現。 在這個頁面上，會顯示主機金鑰，你可以用它來存取應用程式中的任何功能。 系統金鑰也會顯示，讓任何系統管理員等級的人員能夠存取所有函式應用程式 API。

4. 在你想續約的金鑰旁邊選擇 「續約」金鑰值 ，然後選擇 「續約並儲存」。

您可以從特定 HTTP 觸發函式的 [函式金鑰] 索引標籤續訂函式金鑰。

在 Azure Cloud Shell 中執行下列命令。 此指令會更新 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 終端機中執行。

函式所產生的新金鑰值會隨即顯示以供參考。 安全地將這個新金鑰值分發給任何依賴主機金鑰的應用程式。 因為輸出包含敏感性資訊，因此不會保存輸出或保護任何保存的檔案輸出。

執行下列指令碼。 腳本會使用 REST API 來更新 default 主機金鑰，並由 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

在此指令碼中，將 <RESOURCE_GROUP> 和 <APP_NAME> 分別替換為資源群組和您的函式應用程式名稱。

函式所產生的新金鑰值會隨即傳回以供參考。 安全地將此金鑰分發給依賴主機金鑰的應用程式。 因為輸出包含敏感性資訊，因此不會保存輸出或保護任何保存的檔案輸出。