Harmony DoH 接入手册

本文档介绍了鸿蒙(HarmonyOS)应用使用DoH方式的接入指导。

概述

开发者利用本DoH方案,可以在自己的鸿蒙APP中轻松接入移动解析HTTPDNS,解决域名解析异常被劫持问题,同时还能提升域名解析调度精准性、加速域名解析变更在全网的生效速度、降低DNS解析时延。

获取DoH地址

  1. 访问云解析DNS-移动解析HTTPDNS

  2. 点击接入配置,并在方式三:DoT/DoH接入处启用加密地址。

    image

接入

网络请求中使用方式

通过控制台获取加密DoH服务URL,然后在HTTP请求配置中使用它作为dnsOverHttps参数。

let httpRequest = http.createHttp();
httpRequest.request(
  "https://www.aliyun.com",
  {
    dnsOverHttps: "https://*****-****2cik1m8wysgb.alidns.com/dns-query",
    method: http.RequestMethod.GET, 
    header: [{
      'Content-Type': 'application/json'
    }],
    expectDataType: http.HttpDataType.STRING, 
    usingCache: false,
    priority: 1, 
    connectTimeout: 3000, 
    readTimeout: 3000,
    usingProxy: false, 
  }, (err: BusinessError, data: http.HttpResponse) => {
 
  }
);

webview中的使用方式

通过web_webview.WebviewController.setHttpDns方法,设置Webview使用的安全DNS模式为自动,并传入在控制台获取的DOH URL。

web_webview.WebviewController.setHttpDns(web_webview.SecureDnsMode.AUTO, "https://*****-****2cik1m8wysgb.alidns.com/dns-query")