配置Android HTTPDNS SDK实现合规初始化-移动研发平台-阿里云

说明

根据《个人信息保护法》、《数据安全法》、《网络安全法》等法律法规和监管部门规章要求，App开发运营者（以下简称为“开发者”）在提供网络产品服务时应尊重和保护最终用户的个人信息，不得违法违规收集使用个人信息。为帮助开发者在使用HTTPDNS SDK的过程中更好地落实用户个人信息保护相关要求，避免出现侵害最终用户个人信息权益的情形，特制定本合规使用说明。

一、HTTPDNS SDK申请系统权限说明

权限内容	是否必选	权限用途
INTERNET	是	允许SDK联网的最基础权限，用于去云端进行域名解析。
ACCESS_NETWORK_STATE	是	查看网络状态，用于在网络切换时触发去云端解析缓存中域名的IP。

二、HTTPDNS SDK功能及相关个人信息

功能

采集个人信息字段

个人信息采集目的

功能配置方案及示例

域名解析

（基础功能）

不涉及

三、HTTPDNS SDK合规初始化配置方案

//SDK配置方法，仅设置HttpDns的配置信息
//配置方法耗时极少，不会影响App冷启动用户体验
public static void init(String accountId, InitConfig config);

//获取HTTPDNS服务实例，首次获取会初始化HttpDnsService
//您务必确保用户同意《隐私政策》之后再调用HttpDns.getService()。
public static HttpDnsService getService(Context applicationContext, String accountID)

重要

HttpDns.init()方法可以在用户同意《隐私政策》前调用。
您务必确保用户同意《隐私政策》之后再调用HttpDns.getService()方法。

代码示例

Android-Kotlin

InitConfig config = InitConfig.Builder()
    // 配置初始的region
    .setRegion(currentRegion)
    // 配置是否启用https，默认http
    .setEnableHttps(enableHttps)
    // 配置服务请求的超时时长，毫秒，默认2秒，最大5秒
    .setTimeout(2 * 1000)
    // 配置是否启用本地缓存，默认不启用
    .setEnableCacheIp(true)
    // 配置是否允许返回过期IP，默认允许
    .setEnableExpiredIp(true)
    // 配置ipv4探测域名
    .setIPRankingList(ipRankingItemJson.toIPRankingList())
    // 配置接口来自定义缓存的ttl时间
    .configCacheTtlChanger(ttlChanger)
    // 配置固定IP的域名列表，优化SDK的内部逻辑，减少解析频次
    .configHostWithFixedIp(hostListWithFixedIp)
    // 配置不使用HttpDns解析的域名策略
    .setNotUseHttpDnsFilter(notUseHttpDnsFilter)
    .build()

HttpDns.init(accountID, config);

//确保在用户阅读您的《隐私政策》并取得用户授权之后，再调用HttpDns.getService(...)方法。
HttpDns.getService(...)

Java

InitConfig config = new InitConfig.Builder()
    // 配置初始的region
    .setRegion(currentRegion)
    // 配置是否启用https，默认http
    .setEnableHttps(enableHttps)
    // 配置服务请求的超时时长，毫秒，默认2秒，最大5秒
    .setTimeout(2 * 1000)
    // 配置是否启用本地缓存，默认不启用
    .setEnableCacheIp(true)
    // 配置是否允许返回过期IP，默认允许
    .setEnableExpiredIp(true)
    // 配置ipv4探测域名
    .setIPRankingList(list)
    // 配置接口来自定义缓存的ttl时间
    .configCacheTtlChanger(ttlChanger)
    // 配置固定IP的域名列表，优化SDK的内部逻辑，减少解析频次
    .configHostWithFixedIp(hostListWithFixedIp)
    // 配置不使用HttpDns解析的域名策略
    .setNotUseHttpDnsFilter(notUseHttpDnsFilter)
    .build();

HttpDns.init(accountID, config);

//确保在用户阅读您的《隐私政策》并取得用户授权之后，再调用HttpDns.getService(...)方法。
HttpDns.getService(...);