تنزيل TrustKit - تنزيل رمز مصدر TrustKit

TrustKit

شفرة المصدر الأخرى

3.0.4

تنزيل

Trustkit

TrustKit هو إطار مفتوح المصدر يجعل من السهل نشر مفتاح SSL العام في أي من iOS 12+ أو MacOS 10.13+ أو TVOS 12+ أو Watchos 4+ ؛ وهو يدعم كل من تطبيقات Swift و Objective-C.

إذا كنت بحاجة إلى تثبيت/تقارير SSL في تطبيق Android الخاص بك. لقد أصدرنا أيضًا TrustKit لـ Android على https://github.com/datatheorem/trustkit-android.

ملخص

يوفر TrustKit الميزات التالية:

API البسيطة لتكوين سياسة تثبيت SSL وفرضها داخل التطبيق. تعتمد إعدادات السياسة اعتمادًا كبيرًا على مواصفات تثبيت مفتاح HTTP العامة.
تنفيذ عاقل عن طريق تثبيت معلومات المفتاح العام للشهادة ، بدلاً من الشهادة نفسها أو بتات المفاتيح العامة.
آلية الإبلاغ لإخطار خادم حول تثبيت فشل التحقق من الصحة التي تحدث داخل التطبيق ، عند اكتشاف سلسلة شهادة غير متوقعة. هذا مشابه لتوجيه التقرير-URI الموضح في مواصفات HPKP. يمكن أيضًا تخصيص آلية الإبلاغ داخل التطبيق من خلال الاستفادة من إشعارات التحقق من صحة الدبوس المرسلة من قبل TrustKit.
وظائف الربط التلقائي عن طريق swizzling من مندوبي NSURLCONNECTION من NSURLSASTER من أجل إضافة التحقق تلقائيًا إلى اتصالات 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];

يمكن أيضًا تعيين السياسة برمجيًا في التطبيقات السريعة:

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

بعد تهيئة TrustKit ، يمكن استرداد مثيل TSKPinningValidator من 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 );
    }
}