TrustKit Download - TrustKit Quellcode Download

TrustKit

Anderer Quellcode

3.0.4

Herunterladen

Trustkit

TrustKit ist ein Open -Source -Framework, mit dem die Bereitstellung von SSL Public Key Pining und Berichterstattung in jedem iOS 12+, macOS 10.13+, TVOS 12+ oder WatchOS 4+ -App einfach bereitgestellt werden kann. Es unterstützt sowohl schnelle als auch objektive C-Apps.

Wenn Sie SSL Pinning/Reporting in Ihrer Android -App benötigen. Wir haben auch Trustkit für Android unter https://github.com/datatheorem/trustkit-android veröffentlicht.

Überblick

TrustKit bietet die folgenden Funktionen:

Einfache API zur Konfiguration einer SSL -Pinning -Richtlinie und zur Durchsetzung einer App. Die Richtlinieneinstellungen basieren stark auf der Spezifikation der HTTP Public Key.
Sane Implementierung, indem die öffentlichen Schlüsselinformationen des Zertifikats im Gegensatz zum Zertifikat selbst oder der öffentlichen Schlüsselbits festgehalten werden.
Der Berichtsmechanismus zum Benachrichtigen eines Servers über das Pittieren von Validierungsfehlern innerhalb der App, wenn eine unerwartete Zertifikatskette erkannt wird. Dies ähnelt der in der HPKP-Spezifikation beschriebenen Berichts-URI- Richtlinie. Der Berichtsmechanismus kann auch innerhalb der App angepasst werden, indem die von TrustKit gesendeten PIN -Validierungsbenachrichtigungen eingesetzt werden.
Auto-Pinning-Funktionalität, indem Sie die NSURLConnection- und NSURLSession- Delegierten der App reduzieren, um den HTTPS-Verbindungen der App automatisch eine Pinning-Validierung hinzuzufügen; Dies ermöglicht die Bereitstellung von TrustKit , ohne den Quellcode der App zu ändern.

Erste Schritte

Lesen Sie den Leitfaden für Erste Schritte.
Schauen Sie sich die API -Dokumentation an.
Trustkit wurde zunächst bei Black Hat USA 2015 veröffentlicht und auch im Ingenieurblog von PayPal vorgestellt.

Stichprobenverbrauch

Das Bereitstellen von SSL -Pinning in der App erfordert das Initialisieren von TrustKit mit einer Pin -Richtlinie (Domänen, Fach -Key -Info -Hashes und zusätzliche Einstellungen).

Die Richtlinie kann in der Info.plist der App konfiguriert werden.

Alternativ kann die Pinning -Richtlinie programmgesteuert festgelegt werden:

    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];

Die Richtlinie kann auch programmgesteuert in Swift -Apps festgelegt werden:

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

Nach der Initialisierung von TrustKit kann eine TSKPinningValidator -Instanz aus dem Trustkit Singleton abgerufen werden und zur Durchführung von SSL -Pinning -Validierung in den Netzwerkdelegierten der App. Zum Beispiel in einem 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 );
    }
}