TrustKit скачать - скачать исходный код TrustKit

TrustKit

Другой исходный код

3.0.4

Скачать

TrustKit

TrustKit - это структура с открытым исходным кодом, которая позволяет легко развернуть SSL Public Key Pinning и отчетность в любом приложении iOS 12+, MacOS 10.13+, TVOS 12+ или WatchOS 4+; Он поддерживает как Swift, так и Objective-C приложения.

Если вам нужно SSL Pinning/Reporting в вашем приложении Android. Мы также выпустили TrustKit для Android по адресу https://github.com/datatheorem/trustkit-android.

Обзор

TrustKit предоставляет следующие функции:

Простой API для настройки политики SSL прикрепления и применения в приложении. Настройки политики в значительной степени основаны на спецификации закрепления открытого ключа HTTP.
Вновь реализация, закрепляя информацию об открытом ключе сертификата, в отличие от самого сертификата или битов открытого ключа.
Механизм отчетности, чтобы уведомить сервер о закреплении сбоев проверки, происходящих в приложении, когда обнаруживается неожиданная цепочка сертификатов. Это похоже на директиву отчета-URI, описанной в спецификации HPKP. Механизм отчетности также может быть настроен в рамках приложения, используя уведомления о проверке PIN -код, отправленные TrustKit.
Функциональность автоматической сшивки путем взрыва делегатов NSURLConnection и NSURLSession для автоматического добавления проверки прикрепления к подключениям HTTPS приложения; Это позволяет развернуть 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 );
    }
}