HTTPDNS helps avoid the failure to access the optimal access point during the traditional local DNS of ISPs. It works by replacing the traditional DNS protocol with the HTTP encryption protocol, without using domains throughout the process, which greatly reduces the possibility of DNS hijacking.
2. You have added domains to be resolved in the HTTPDNS console as instructed in Adding a Domain.
3. You have applied in the HTTPDNS console for SDK integration as instructed in SDK Activation Process.
4. After activating the service, you have been assigned the configuration information such as authorization ID, AES and DES encryption keys, and HTTPS token. You can also view them on the Development Configuration page.
Configuration information required for using the SDK for iOS:
Authorization ID: The unique ID of a development configuration used in HTTPDNS, namely, the dnsId parameter in the SDK used for DNS authentication.
DES encryption key: The dnsKey parameter in the SDK, which you need to pass in when using the DES encryption method.
AES encryption key: The dnsKey parameter in the SDK, which you need to pass in when using the AES encryption method.
HTTPS encryption token: The token parameter in the SDK, which you need to pass in when using the HTTPS encryption method.
iOS APPID (optional): Obtained from the HTTPDNS console for data reporting.
Installation package structure
Download the latest version of the SDK package here.
Applicable to projects with "Build Setting->C Language Dialect" configured as "GNU++98"and "Build Setting->C++ Standard Library" as"libstdc (GNU C standard library)" .
MSDKDns_intl.xcframework
MSDKDns.xcframework version for Tencent Cloud International
MSDKDns_C11.xcframework
Applicable to projects with "Build Setting->C Language Dialect" and "Build Setting->C Standard Library" configured as "GNU++11" and "libc++(LLVM C standard library with C11 support)", respectively.
MSDKDns_C11_intl.xcframework
MSDKDns_C11.xcframework version for Tencent Cloud International
Note:
If you want to use the version for Tencent Cloud International, obtain the initialization configuration from the HTTPDNS international console.
1. Add the following code in the Podfile of the project:
# Applicable to projects with "Build Setting->C++ Language Dialect" configured as **"GNU++98"** and "Build Setting->C++ Standard Library" as **"libstdc++(GNU C++ standard library)"**.
pod 'MSDKDns_intl'
# Applicable to projects with "Build Setting->C++ Language Dialect" and "Build Setting->C++ Standard Library" configured as **"GNU++11"** and **"libc++(LLVM C++ standard library with C++11 support)"**, respectively.
# pod 'MSDKDns_C11_intl'
2. Save, run pod install, and open the project with a file with the .xcworkspace extension.
1. Import dependency libraries, drag the framework from the HTTPDNSLibs directory into the corresponding Target, and select Copy items if needed in the pop-up box:
MSDKDns_C11_intl.framework (or MSDKDns_intl.framework, depending on the project configuration)
2. Import system libraries:
libz.tbd
libsqlite3.tbd
libc++ .tbd
Foundation.framework
CoreTelephony.framework
SystemConfiguration.framework
CoreGraphics.framework
Security.framework
Note：
Add the -ObjC flag in Other Linker Flags.
SDK initialization
Sample API call:
In an Objective-C project:
// Use the following method for a .m file:
DnsConfig config ={
.dnsId = DNS authorization ID,// Obtain the authorization ID from the HTTPDNS console, as shown in the upper-left corner of the screenshot in the "Preparations" section above.
.dnsKey =@"Encryption key",
.encryptType = HttpDnsEncryptTypeDES,
.debug = YES,
.timeout =2000,
};
[[MSDKDns sharedInstance] initConfig:&config];
// Use the following method for a .mm file:
DnsConfig *config = new DnsConfig();
config->dnsId = DNS authorization ID;// Obtain the authorization ID from the HTTPDNS console, as shown in the upper-left corner of the screenshot in the "Preparations" section above.
config->dnsKey =@"Encryption key";
config->encryptType = HttpDnsEncryptTypeDES;
config->debug = YES;
config->timeout =2000;
[[MSDKDns sharedInstance] initConfig: config];
In a Swift project:
let msdkDns =MSDKDns.sharedInstance()as?MSDKDns;
msdkDns?.initConfig(with:[
"dnsId":"DNS authorization ID",// Obtain the authorization ID from the HTTPDNS console, as shown in the upper-left corner of the screenshot in the "Preparations" section above.
"dnsKey":"Encryption key",
"encryptType":0,// 0: DES; 1: AES; 2: HTTPS
]);
Integration verification
Log verification
Enable the SDK DEBUG logging (set debug in DnsConfig to YES), find the printed api name:HDNSGetHostByName, data: { ... } log, and check the log info of the local DNS ( ldns_ip in the log) and HTTPDNS ( hdns_ip in the log) to determine whether the connection is successful.
The hdns_ip key indicates the DNS query results of A records provided by HTTPDNS.
The hdns_4a_ips key indicates the DNS query results of AAAA records provided by HTTPDNS.
If hdns_ip or hdns_4a_ips is not empty, the connection is successful.
The ldns_ip key indicates the DNS query results provided by the local DNS.
Notes
If the service on the client is bound to the host, such as the HTTP service or the CDN service of the host, you need to specify the host field of the HTTP header after replacing the domain in the URL with the IP returned by HTTPDNS. Example:
NSURLConnection
NSURLSession
curl
The `WWW` API of Unity
NSURL *httpDnsURL =[NSURL URLWithString:@"URL obtained by concatenating the resolved IP"];
Yes
No
Was this page helpful?