Azure Functions隔离式运行时：如何实现自定义令牌替换功能？

在非隔离模式的Azure Functions中，可通过实现INameResolver接口完成自定义令牌的查找与替换，但隔离模式下该接口已被移除。以下是两种可行的替代方案：

方案一：全局配置级令牌替换（推荐） #

利用.NET的IConfiguration体系，通过扩展配置构建器，在配置加载阶段统一处理所有%token%格式的令牌替换，效果和INameResolver的全局替换一致。

实现步骤 #

1. 编写自定义配置扩展，添加令牌解析逻辑：

public static class ConfigurationExtensions
{
    public static IConfigurationBuilder AddCustomTokenResolver(this IConfigurationBuilder builder)
    {
        builder.Add(new CustomTokenResolverSource());
        return builder;
    }

    private class CustomTokenResolverSource : IConfigurationSource
    {
        public IConfigurationProvider Build(IConfigurationBuilder builder)
        {
            return new CustomTokenResolverProvider(builder.Build());
        }
    }

    private class CustomTokenResolverProvider : ConfigurationProvider
    {
        private readonly IConfiguration _innerConfig;

        public CustomTokenResolverProvider(IConfiguration innerConfig)
        {
            _innerConfig = innerConfig;
        }

        public override void Load()
        {
            foreach (var kvp in _innerConfig.AsEnumerable())
            {
                if (kvp.Value?.Contains("%") == true)
                {
                    Data[kvp.Key] = ResolveTokens(kvp.Value);
                }
                else
                {
                    Data[kvp.Key] = kvp.Value;
                }
            }
        }

        private string ResolveTokens(string value)
        {
            // 自定义令牌解析逻辑，可根据需求扩展（比如从数据库、密钥库获取值）
            var tokenRegex = new Regex(@"%(\w+)%");
            return tokenRegex.Replace(value, match =>
            {
                var tokenKey = match.Groups[1].Value;
                // 优先从环境变量获取，再执行自定义逻辑
                var envValue = Environment.GetEnvironmentVariable(tokenKey);
                if (!string.IsNullOrEmpty(envValue))
                {
                    return envValue;
                }
                // 此处替换为你的自定义令牌查询逻辑
                return $"CustomResolved_{tokenKey}";
            });
        }
    }
}

2. 在Program.cs中启用该扩展：

var host = new HostBuilder()
    .ConfigureFunctionsWorkerDefaults()
    .ConfigureAppConfiguration(builder =>
    {
        builder.AddCustomTokenResolver();
    })
    .Build();

host.Run();

配置加载完成后，所有包含%token%格式的配置项（包括触发器绑定中的引用）都会被自动解析替换。

方案二：局部代码级令牌替换 #

如果仅需针对特定函数或绑定处理令牌，可以在代码中手动注入IConfiguration，编写解析方法处理目标配置值。

示例（以ServiceBus触发器为例）：

public class CustomTokenFunction
{
    private readonly IConfiguration _config;

    public CustomTokenFunction(IConfiguration config)
    {
        _config = config;
    }

    [Function("CustomTokenFunction")]
    public async Task Run(
        [ServiceBusTrigger("%MessageTopic%", "%MessageSubscription%", Connection = "ConnectionString")]
        ServiceBusReceivedMessage message,
        FunctionContext context)
    {
        // 手动解析配置中的令牌
        var resolvedTopic = ResolveToken(_config["MessageTopic"]);
        // 业务逻辑处理...
    }

    private string ResolveToken(string value)
    {
        if (string.IsNullOrEmpty(value)) return value;
        var tokenRegex = new Regex(@"%(\w+)%");
        return tokenRegex.Replace(value, match =>
        {
            var tokenKey = match.Groups[1].Value;
            // 自定义令牌获取逻辑，比如查询外部服务
            return GetTokenValueFromCustomSource(tokenKey);
        });
    }

    private string GetTokenValueFromCustomSource(string tokenKey)
    {
        // 实现你的自定义令牌查询逻辑
        return $"Resolved_{tokenKey}";
    }
}

补充：密钥保管库场景 #

如果令牌存储在Azure Key Vault中，隔离模式可直接通过配置绑定引用密钥，无需额外编写解析逻辑，格式如下：

{
  "MessageTopic": "@Microsoft.KeyVault(SecretUri=https://your-vault.vault.azure.net/secrets/your-topic-secret)"
}

内容的提问来源于stack exchange，提问作者Jonathan Stanton