• List
    • 参数
    • ListEntryType

    List

    list 适配器能够用来执行简单的黑白名单校验工作。可以把列表内容直接配置到适配器中,也可以要求适配器在指定 URL 中抓取列表内容。列表元素可以是简单的字符串、IP 地址或者正则表达式。

    该适配器支持 listentry 模板

    参数

    list 适配器的配置格式。

    字段类型描述
    providerUrlstring从哪里找到列表内容进行检查。如果使用本地列表,则可以省略该字段
    refreshIntervalgoogle.protobuf.Duration用于更新列表的频率
    ttlgoogle.protobuf.Duration列表的生效时间。一般来说 TTL 的值应该明显(两倍以上)超过 refreshInterval,从而确保操作的持续性
    cachingIntervalgoogle.protobuf.Duration该适配器的调用者可以将一个查询结果写入本地缓存,在这一字段所规定的时间之内无需再次向适配器进行查询
    cachingUseCountint32该适配器的调用者可以将一个查询结果写入本地缓存,在这一字段所规定的次数之内无需再次向适配器进行查询
    overridesstring[]在处理来自服务器的列表之前,首先查询该列表
    entryTypeListEntryType决定列表的类型
    blacklistbool如果为真,这一列表的操作符就是是黑名单,反之则是白名单

    ListEntryType

    列表的类型。

    字段描述
    STRINGS普通字符串列表
    CASE_INSENSITIVE_STRINGS不区分大小写的字符串列表
    IP_ADDRESSESIP 地址和范围的列表
    REGEXre2 规范的正则表达式