TrustKitダウンロード - TrustKitソースコードのダウンロード

TrustKit

その他のソースコード

3.0.4

ダウンロード

TrustKit

TrustKitは、iOS 12+、MacOS 10.13+、TVOS 12+、またはWatchos 4+アプリでSSL公開キーのピン留めとレポートを簡単に展開できるようにするオープンソースフレームワークです。 SwiftとObjective-Cアプリの両方をサポートします。

SSLがAndroidアプリでピン留め/レポートが必要な場合。また、https://github.com/datatheorem/trustkit-androidでAndroidのTrustKitをリリースしました。

概要

TrustKitは次の機能を提供します。

SSLピン留めポリシーを構成し、アプリ内で実施する簡単なAPI。ポリシー設定は、HTTP公開キーのピン留め仕様に大きく基づいています。
証明書自体または公開キーのビットとは対照的に、証明書の件名の公開情報を固定することにより、正気の実装。
予期しない証明書チェーンが検出されたときに、アプリ内で発生する検証障害を固定することについてサーバーに通知するためのレポートメカニズム。これは、HPKP仕様で説明されているレポート-URI指令に似ています。レポートメカニズムは、TrustKitが送信したPIN検証通知を活用することにより、アプリ内でカスタマイズすることもできます。
アプリのHTTPS接続にピン留め検証を自動的に追加するために、アプリのnsurlconnectionとnsurlsessionデリゲートをスイズすることにより、自動ピンニング機能。これにより、アプリのソースコードを変更せずにTrustKitを展開できます。

はじめる

入門ガイドを読んでください。
APIドキュメントをご覧ください。
TrustKitは当初、Black Hat USA 2015でリリースされ、PayPalのエンジニアリングブログでも紹介されました。

サンプルの使用

アプリにSSLピン留めを展開するには、ピン留めポリシー（ドメイン、主題の公開情報のハッシュ、および追加設定）でTrustKitを初期化する必要があります。

ポリシーは、アプリのInfo.plist内で構成できます。

または、ピン留めポリシーをプログラムで設定できます。

    NSDictionary *trustKitConfig =
  @{
    kTSKSwizzleNetworkDelegates : @ NO ,
    kTSKPinnedDomains : @{
            @" www.datatheorem.com " : @{
                    kTSKExpirationDate : @" 2017-12-01 " ,
                    kTSKPublicKeyHashes : @[
                            @" HXXQgxueCIU5TTLHob/bPbwcKOKw6DkfsTWYHbxbqTY= " ,
                            @" 0SDf3cRToyZJaMsoS17oF72VMavLxj/N7WBNasNuiR8= "
                            ],
                    kTSKEnforcePinning : @ NO ,
                    },
            @" yahoo.com " : @{
                    kTSKPublicKeyHashes : @[
                            @" TQEtdMbmwFgYUifM4LDF+xgEtd0z69mPGmkp014d6ZY= " ,
                            @" rFjc3wG7lTZe43zeYTvPq8k4xdDEutCmIhI5dn4oCeE= " ,
                            ],
                    kTSKIncludeSubdomains : @ YES
                    }
            }};
    
    [TrustKit initSharedInstanceWithConfiguration: trustKitConfig];

ポリシーは、Swiftアプリでプログラム的に設定することもできます。

        let trustKitConfig = [
            kTSKSwizzleNetworkDelegates : false ,
            kTSKPinnedDomains : [
                " yahoo.com " : [
                    kTSKExpirationDate : " 2017-12-01 " ,
                    kTSKPublicKeyHashes : [
                        " JbQbUG5JMJUoI6brnx0x3vZF6jilxsapbXGVfjhN8Fg= " ,
                        " WoiWRyIOVNa9ihaBciRSC7XHjliYS9VwUGOIud4PB18= "
                    ] , ] ] ] as [ String : Any ]
        
        TrustKit . initSharedInstance ( withConfiguration : trustKitConfig )

TrustKitが初期化された後、 TSKPinningValidatorインスタンスをTrustKit Singletonから取得でき、アプリのネットワーク代表でSSLピン留め検証を実行するために使用できます。たとえば、nsurlsessiondelegate：

- ( void )URLSession:( NSURLSession *)session 
              task:( NSURLSessionTask *)task 
didReceiveChallenge:( NSURLAuthenticationChallenge *)challenge 
 completionHandler:( void (^)( NSURLSessionAuthChallengeDisposition disposition, NSURLCredential *credential))completionHandler {
{
    TSKPinningValidator *pinningValidator = [[TrustKit sharedInstance ] pinningValidator ];
    // Pass the authentication challenge to the validator; if the validation fails, the connection will be blocked
    if (![pinningValidator handleChallenge: challenge completionHandler: completionHandler])
    {
        // TrustKit did not handle this challenge: perhaps it was not for server trust
        // or the domain was not pinned. Fall back to the default behavior
        completionHandler ( NSURLSessionAuthChallengePerformDefaultHandling , nil );
    }
}