在 Azure Functions 中使用访问密钥

1. 登录 Azure 门户，然后搜索并选择功能应用。

2. 选择要使用的函数应用。

3. 在左侧菜单中，展开Functions，然后选择应用密钥。

   随即显示“应用密钥”页面。 在这一页上，会显示主机密钥，你可以用它访问应用中的任何功能。 还会显示系统密钥，该密钥向任何人授予对所有函数应用 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. 在左侧菜单中，展开Functions，然后选择应用密钥。

   随即显示“应用密钥”页面。 在这一页上，会显示主机密钥，你可以用它访问应用中的任何功能。 还会显示系统密钥，该密钥向任何人授予对所有函数应用 API 的管理员级别访问权限。

4. 选择你想续期的键旁边的 “续订”密钥值 ，然后选择 “续订并保存”。

还可以在特定 HTTP 触发的函数的“函数密钥”选项卡中续订函数密钥。

在 Azure Cli 中运行以下命令。 该命令会更新 default 主机键，并由函数生成一个新的键值。

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

在此命令中，将 <RESOURCE_GROUP> 和 <APP_NAME> 分别替换为资源组和你的函数应用名称。 此命令在 Azure Cli（Bash）中运行。 必须对其进行修改才能在 Windows 终端中运行。

系统将显示 Functions 生成的新密钥值供你参考。 安全地将这个新密钥值分发给任何依赖主机密钥的应用。 由于输出包含敏感信息，因此不保留输出或保护任何持久化文件输出。

运行以下脚本。 该脚本使用 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.chinacloudapi.cn/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 生成的新密钥值供你参考。 安全地将该密钥分发给所有依赖主机密钥的应用。 由于输出包含敏感信息，因此不保留输出或保护任何持久化文件输出。