TrustKit 다운로드 - TrustKit 소스 코드 다운로드

TrustKit

기타 소스코드

3.0.4

다운로드

트러스트 키트

TrustKit은 iOS 12+, MacOS 10.13+, TVOS 12+ 또는 WatchOS 4+ 앱에 SSL Public Key 고정 및보고를 쉽게 배포 할 수있는 오픈 소스 프레임 워크입니다. Swift 및 Objective-C 앱을 모두 지원합니다.

Android 앱에서 SSL 고정/보고가 필요한 경우 우리는 또한 https://github.com/datatheorem/trustkit-android에서 Android for Android를 출시했습니다.

개요

Trustkit은 다음과 같은 기능을 제공합니다.

SSL 고정 정책을 구성하고 앱 내에서 시행하는 간단한 API. 정책 설정은 HTTP 공개 키 고정 사양을 기반으로합니다.
인증서 자체 또는 공개 키 비트와 달리 인증서의 주제 공개 키 정보를 고정하여 제정신 구현.
예기치 않은 인증서 체인이 감지 될 때 앱 내에서 발생하는 유효성 검사 실패를 고정하는 것에 대해 서버에 알리는 메커니즘보고. 이는 HPKP 사양에 설명 된 보고서 -URI 지침과 유사합니다. 보고 메커니즘은 Trustkit에서 보낸 핀 검증 알림을 활용하여 앱 내에서 사용자 정의 할 수 있습니다.
앱의 https 연결에 고정 유효성 검사를 자동으로 추가하기 위해 앱의 nsurlconnection 및 nsurlsession 대의원을 스위핑하여 자동 고정 기능; 이를 통해 앱의 소스 코드를 수정하지 않고도 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 인스턴스를 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 );
    }
}