TrustKit下载 - TrustKit源代码下载

TrustKit

其他源码

3.0.4

下载

TrustKit

TrustKit是一个开源框架，可以轻松在任何iOS 12+，MACOS 10.13+，TVOS 12+或WatchOS 4+应用程序中部署SSL公共密钥固定和报告；它支持Swift和Objective-C应用程序。

如果您需要在Android应用中固定/报告。我们还在https://github.com/datatheorem/trustkit-android上发布了Android的TrustKit 。

概述

TrustKit提供以下功能：

简单的API配置SSL固定策略并在应用程序中执行。策略设置大大基于HTTP公共密钥固定规范。
通过固定证书的公共密钥信息，而不是证书本身或公共密钥位来实施SANE。
在检测到意外证书链时，报告机制将通知服务器固定验证失败。这类似于HPKP规范中描述的报告-URI指令。还可以通过利用TrustKit发送的PIN验证通知来在应用程序中自定义报告机制。
通过浏览应用程序的Nsurlconnection和Nsurlsession代表来自动定位功能，以自动将固定验证添加到应用程序的HTTPS连接中；这允许在不修改应用程序源代码的情况下部署TrustKit 。

入门

阅读入门指南。
查看API文档。
TrustKit最初在2015年Black Hat USA上发行，还在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后，可以从TrustKit Singleton中检索TSKPinningValidator实例，并可用于在应用程序网络委托中执行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 );
    }
}