Télécharger TrustKit - TrustKit Code Source Download

TrustKit

Autre code source

3.0.4

Télécharger

Faire confiance

Trustkit est un framework open source qui facilite le déploiement de la clé publique SSL et des rapports dans toute application iOS 12+, macOS 10.13+, TVOS 12+ ou WatchOS 4+; Il prend en charge les applications Swift et Objective-C.

Si vous avez besoin d'épinglage / de rapport SSL dans votre application Android. Nous avons également publié Trustkit pour Android sur https://github.com/datatheorem/trustkit-android.

Aperçu

Trustkit fournit les fonctionnalités suivantes:

API simple pour configurer une stratégie SSL Pinning et l'appliquer dans une application. Les paramètres de stratégie sont fortement basés sur la spécification d'épinglage de la clé publique HTTP.
Implémentation saine en épinglant les informations de clé publique du sujet du certificat, par opposition au certificat lui-même ou aux bits clés publics.
Mécanisme de rapport pour informer un serveur des défaillances de validation épinglent dans l'application, lorsqu'une chaîne de certificat inattendue est détectée. Ceci est similaire à la directive Report-URI décrite dans la spécification HPKP. Le mécanisme de rapport peut également être personnalisé dans l'application en tirant parti des notifications de validation des broches envoyées par Trustkit.
Fonctionnalités de pointe automatique en swizzing les délégués NSURLConnection et NSURLSession de l'application afin d'ajouter automatiquement la validation d'épinglage aux connexions HTTPS de l'application; Cela permet de déployer Trustkit sans même modifier le code source de l'application.

Commencer

Lisez le guide de démarrage.
Consultez la documentation de l'API.
Trustkit a été initialement publié chez Black Hat USA 2015 et a également été présenté sur le blog d'ingénierie de PayPal.

Utilisation des échantillons

Le déploiement d'épinglage SSL dans l'application nécessite l'initialisation de Trustkit avec une politique d'épinglage (domaines, hachages d'informations de clés publiques sujet et paramètres supplémentaires).

La stratégie peut être configurée dans l' Info.plist de l'application:

Alternativement, la politique d'épinglage peut être définie par programme:

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

La politique peut également être définie par programme dans des applications Swift:

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

Une fois que Trustkit a été initialisé, une instance TSKPinningValidator peut être récupérée à partir du Trustkit Singleton et peut être utilisée pour effectuer la validation de l'épinglage SSL dans les délégués réseau de l'application. Par exemple dans un 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 );
    }
}