HTTPDNS:iOS クライアントで DoH を使用する

サンプルコード

NSURLSession を管理するために DataTaskManager を作成します。

@interface DataTaskManager : NSObject <NSURLSessionTaskDelegate>

#import "DataTaskManager.h"
@import Network;
@import Foundation;

- (instancetype)init {
    self = [super init];
    if (self) {
        _networkQueue = dispatch_queue_create("com.taskmanager.queue", DISPATCH_QUEUE_SERIAL);
        [self setupDoHConfiguration];
    }
    return self;
}
- (void)setupDoHConfiguration {
    dispatch_async(self.networkQueue, ^{
        NSLog(@"DoH 構成を設定しています...");
        
        // HTTPDNS DoH の URL エンドポイントを作成します
        const char *dohServerURL = "https://1xxxx3.aliyunhttpdns.com/dns-query";
        nw_endpoint_t urlEndpoint = nw_endpoint_create_url(dohServerURL);
        NSLog(@"DoH サーバーを使用しています: %s", dohServerURL);
        
        nw_resolver_config_t resolverConfig = nw_resolver_config_create_https(urlEndpoint);
        nw_privacy_context_require_encrypted_name_resolution(NW_DEFAULT_PRIVACY_CONTEXT, true, resolverConfig);
        NSLog(@"プライバシーコンテキストに DoH 構成が適用されました");
        
    });
}

ViewController.viewDidLoad で初期化を完了します。

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    ......
    self.dataTaskManager = [[DataTaskManager alloc] init];
    ......
}

解決パフォーマンスのイベントトラッキング

NSURLSessionTaskMetrics を使用して DNS プロセスを計測できます。これにより、DoH 解決が機能しているかどうかを確認し、DNS 解決時間を監視できます。

- (void)URLSession:(NSURLSession *)session task:(NSURLSessionTask *)task didFinishCollectingMetrics:(NSURLSessionTaskMetrics *)metrics {
    NSLog(@"\n=== %@ へのリクエストのメトリックを収集しています ===\n", task.originalRequest.URL);
    
    task.taskDescription = [NSString stringWithFormat:@"%.2f,%@", 
                          metrics.taskInterval.duration,
                          task.originalRequest.URL.absoluteString];
    
    if ([metrics.transactionMetrics count] > 0) {   
        [metrics.transactionMetrics enumerateObjectsUsingBlock:^(NSURLSessionTaskTransactionMetrics *_Nonnull obj, NSUInteger idx, BOOL *_Nonnull stop) {
            NSString *fetchTypeStr = @"不明";
            switch (obj.resourceFetchType) {
                case NSURLSessionTaskMetricsResourceFetchTypeNetworkLoad:
                    fetchTypeStr = @"ネットワークロード";
                    break;
                case NSURLSessionTaskMetricsResourceFetchTypeServerPush:
                    fetchTypeStr = @"サーバープッシュ";
                    break;
                case NSURLSessionTaskMetricsResourceFetchTypeLocalCache:
                    fetchTypeStr = @"ローカルキャッシュ";
                    break;
            }
            NSLog(@"フェッチタイプ: %@", fetchTypeStr);
            
            if (obj.resourceFetchType == NSURLSessionTaskMetricsResourceFetchTypeNetworkLoad) {
                NSURLSessionTaskMetricsDomainResolutionProtocol dnsProtocol = obj.domainResolutionProtocol;
                NSString *dnsProtocolStr = @"不明 (0)";
                BOOL isDoH = NO;
                
                switch (dnsProtocol) {
                    case NSURLSessionTaskMetricsDomainResolutionProtocolUDP:
                        dnsProtocolStr = @"UDP (1)";
                        break;
                    case NSURLSessionTaskMetricsDomainResolutionProtocolTCP:
                        dnsProtocolStr = @"TCP (2)";
                        break;
                    case NSURLSessionTaskMetricsDomainResolutionProtocolTLS:
                        dnsProtocolStr = @"TLS (3)";
                        break;
                    case NSURLSessionTaskMetricsDomainResolutionProtocolHTTPS:
                        dnsProtocolStr = @"HTTPS/DoH (4)";
                        isDoH = YES;
                        break;
                }
                
                NSLog(@"DNS プロトコル: %@", dnsProtocolStr);
                
                #if TARGET_OS_SIMULATOR
                    NSLog(@"シミュレータで実行中 - DNS プロトコル検出はサポートされていません");
                #else
                    if (!isDoH) {
                        NSLog(@"DoH が検出されませんでした");
                    }
                #endif
                
                // DNS 解決パフォーマンスデータを取得します
                if (obj.domainLookupStartDate && obj.domainLookupEndDate) {
                    int dnsLookupTime = ceil([obj.domainLookupEndDate timeIntervalSinceDate:obj.domainLookupStartDate] * 1000);
                    NSLog(@"DNS ルックアップの詳細:");
                    NSLog(@"  開始: %@", obj.domainLookupStartDate);
                    NSLog(@"  終了: %@", obj.domainLookupEndDate);
                    NSLog(@"  期間: %d ミリ秒", dnsLookupTime);
                } else {
                    NSLog(@"DNS ルックアップは実行されませんでした (キャッシュされている可能性があります)");
                }
                
                // ネットワークリクエストパフォーマンスデータを取得します
                if (obj.connectStartDate && obj.connectEndDate) {
                    NSTimeInterval connectionTime = [obj.connectEndDate timeIntervalSinceDate:obj.connectStartDate];
                    NSLog(@"接続時間: %.3f 秒", connectionTime);
                }
            }
        }];
    } else {
        NSLog(@"トランザクションメトリックは利用できません");
    }
}

フォールバックメカニズム

1. DNS 解決が失敗した場合に例外情報を迅速に取得するために、タイムアウト設定を構成します。

// 接続タイムアウトを設定します
NSURLSessionConfiguration *config = [NSURLSessionConfiguration defaultSessionConfiguration];
config.waitsForConnectivity = NO;
config.timeoutIntervalForRequest = 5;
config.timeoutIntervalForResource = 10;

2. 上記の計測チェーンでは、適切なフォールバック戦略を策定できます。DNS 例外が検出されたときにグローバルに LocalDNS にフォールバックする例を次に示します。

  ......
            
    if (obj.resourceFetchType == NSURLSessionTaskMetricsResourceFetchTypeNetworkLoad) {
        NSURLSessionTaskMetricsDomainResolutionProtocol dnsProtocol = obj.domainResolutionProtocol;
        NSString *dnsProtocolStr = @"不明 (0)";
        BOOL isDoH = NO;
        
        switch (dnsProtocol) {
            case NSURLSessionTaskMetricsDomainResolutionProtocolUDP:
                dnsProtocolStr = @"UDP (1)";
                break;
            case NSURLSessionTaskMetricsDomainResolutionProtocolTCP:
                dnsProtocolStr = @"TCP (2)";
                break;
            case NSURLSessionTaskMetricsDomainResolutionProtocolTLS:
                dnsProtocolStr = @"TLS (3)";
                break;
            case NSURLSessionTaskMetricsDomainResolutionProtocolHTTPS:
                dnsProtocolStr = @"HTTPS/DoH (4)";
                isDoH = YES;
                break;
        }
        
        NSLog(@"DNS プロトコル: %@", dnsProtocolStr);
        
        #if TARGET_OS_SIMULATOR
            NSLog(@"シミュレータで実行中 - DNS プロトコル検出はサポートされていません");
        #else
            if (!isDoH) {
                NSLog(@"DoH が検出されませんでした。ローカル DNS にフォールバックしています");
                dispatch_async(dispatch_get_main_queue(), ^{
                    // DoH を無効にして LocalDNS を使用します
                    nw_privacy_context_require_encrypted_name_resolution(NW_DEFAULT_PRIVACY_CONTEXT, false, nil);
                });
            }
        #endif  
    }
    
  ......