EllipticCurveKeyPair下載EllipticCurveKeyPair源代碼下載

EllipticCurveKeyPair

其他源碼

1.0.0

下載

橢圓曲線密鑰對

使用iOS和MACOS上的安全飛地簽名，驗證，加密和解密。

特徵

創建私人關鍵
將私鑰存儲在安全飛地上
將公共密鑰存儲在鑰匙扣中
每次使用專用密鑰時
將公共密鑰以X.509 der的形式導出。 1個標頭 /結構
用openSSL輕鬆驗證簽名

支持faceID，TouchID，設備通過代碼和應用程序密碼。

關於

使用安全框架可能會有些混亂。這就是為什麼我創建這個。您可以將其用作示例代碼和指導，也可以將其用作微框架。

我發現很難弄清楚如何使用Swift 3中的SecKeyRawVerify ， SecKeyGeneratePair和SecItemCopyMatching c apis，但是由於出色的Swift功能，實現非常直接。

安裝

手動的

只需將Sources/EllipticCurveKeyPair.swift和Sources/SHA256.swift拖放到您的Xcode Project中即可。

可可錄

 pod EllipticCurveKeyPair

迦太基

 github "agens-no/EllipticCurveKeyPair"

用例

安全飛地有很多很大的可能性。這裡有一些例子

加密

使用公共密鑰對消息進行加密
使用私鑰解密消息 - 僅可與faceID / touchID /設備銷一起訪問

僅在iOS 10及以上可用

簽名

使用私鑰簽名服務器接收到的一些數據 - 只能使用FaceID / TouchID / Device Pin訪問
驗證使用公共密鑰是否有效該簽名有效

用例可能是

用戶要求新協議 /購買
服務器發送一個應簽名的會話令牌的推動
在設備上，我們使用專用密鑰在會話令牌上簽名 - 提示用戶確認使用觸摸ID
然後將簽名令牌發送到服務器
服務器已經擁有公鑰，並使用公共密鑰驗證簽名
服務器現在有信心用戶通過觸摸ID簽署了本協議

例子

有關更多示例，請參見演示應用。

創建Keypair Manager

 struct KeyPair {
    static let manager : EllipticCurveKeyPair . Manager = {
        let publicAccessControl = EllipticCurveKeyPair . AccessControl ( protection : kSecAttrAccessibleAlwaysThisDeviceOnly , flags : [ ] )
        let privateAccessControl = EllipticCurveKeyPair . AccessControl ( protection : kSecAttrAccessibleAfterFirstUnlockThisDeviceOnly , flags : [ . userPresence , . privateKeyUsage ] )
        let config = EllipticCurveKeyPair . Config (
            publicLabel : " payment.sign.public " ,
            privateLabel : " payment.sign.private " ,
            operationPrompt : " Confirm payment " ,
            publicKeyAccessControl : publicAccessControl ,
            privateKeyAccessControl : privateAccessControl ,
            token : . secureEnclave )
        return EllipticCurveKeyPair . Manager ( config : config )
    } ( )
}

如果使用不同的訪問控制標誌，則您也可以優雅地退縮以使用鑰匙串：

 let privateAccessControl = EllipticCurveKeyPair . AccessControl ( protection : kSecAttrAccessibleAfterFirstUnlockThisDeviceOnly , flags : {
    return EllipticCurveKeyPair . Device . hasSecureEnclave ? [ . userPresence , . privateKeyUsage ] : [ . userPresence ]
} ( ) )

在這種情況下，您需要記住將Config Object中的token變量設置為.secureEnclaveIfAvailable 。

獲取Der格式的公共密鑰

 do {
    let key = try KeyPair . manager . publicKey ( ) . data ( ) . DER // Data
} catch {
    // handle error
}

有關工作示例，請參見演示應用

獲取PEM格式的公共密鑰

 do {
    let key = try KeyPair . manager . publicKey ( ) . data ( ) . PEM // String
} catch {
    // handle error
}

簽名

 do {
    let digest = " some text to sign " . data ( using : . utf8 ) !
    let signature = try KeyPair . manager . sign ( digest , hash : . sha256 )
} catch {
    // handle error
}

簽名時，您也可以通過lactext對象

加密

 do {
    let digest = " some text to encrypt " . data ( using : . utf8 ) !
    let encrypted = try KeyPair . manager . encrypt ( digest , hash : . sha256 )
} catch {
    // handle error
}

在其他設備/OS/平台上加密

您也可以使用公共密鑰在其他設備/OS/平台上加密。如果您想了解有關如何以Secure Enclave理解的格式加密的所有詳細信息，那麼您絕對需要閱讀@DSChuetz的出色文章！

https://darthnull.org/security/2018/05/31/secure-enclave-ecies/

解密

 do {
    let encrypted = ...
    let decrypted = try KeyPair . manager . decrypt ( encrypted , hash : . sha256 )
    let decryptedString = String ( data : decrypted , encoding : . utf8 )
} catch {
    // handle error
}

解密時您也可以通過lactext對象

錯誤處理

最常見的事情是捕獲與

安全飛地不可用
用戶取消指紋對話框
沒有指紋註冊

與do/catch ：

 do {
    let decrypted = try KeyPair . manager . decrypt ( encrypted )
} catch EllipticCurveKeyPair . Error . underlying ( _ , let underlying ) where underlying . code == errSecUnimplemented {
    print ( " Unsupported device " )
} catch EllipticCurveKeyPair . Error . authentication ( let authenticationError ) where authenticationError . code == . userCancel {
    print ( " User cancelled/dismissed authentication dialog " )
} catch {
    print ( " Some other error occurred. Error ( error ) " )
}

if let ：

if case let EllipticCurveKeyPair . Error . underlying ( _ , underlying ) = error , underlying . code == errSecUnimplemented {
    print ( " Unsupported device " )
} else if case let EllipticCurveKeyPair . Error . authentication ( authenticationError ) , authenticationError . code == . userCancel {
  print ( " User cancelled/dismissed authentication dialog " )
} else {
  print ( " Some other error occurred. Error ( error ) " )
}

偵錯

為了檢查來迴向鍵鏈來回查詢，您可以打印以安裝該庫在這樣的鑰匙串上執行的每個突變

 EllipticCurveKeyPair . logger = { print ( $0 ) }

驗證簽名

在演示應用程序中，您會看到每次創建簽名時，都會記錄一些有用的信息到控制台。

示例輸出

 #! /bin/sh
echo 414243 | xxd -r -p > dataToSign.dat
echo 3046022100842512baa16a3ec9b977d4456923319442342e3fdae54f2456af0b7b8a09786b022100a1b8d762b6cb3d85b16f6b07d06d2815cb0663e067e0b2f9a9c9293bde8953bb | xxd -r -p > signature.dat
cat > key.pem << EOF
-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEdDONNkwaP8OhqFTmjLxVcByyPa19
ifY2IVDinFei3SvCBv8fgY8AU+Fm5oODksseV0sd4Zy/biSf6AMr0HqHcw==
-----END PUBLIC KEY-----
EOF
/usr/local/opt/openssl/bin/openssl dgst -sha256 -verify key.pem -signature signature.dat dataToSign.dat

為了運行此腳本，您可以

將其粘貼到文件中： verify.sh
使文件chmod u+x verify.sh
運行它： ./verify.sh

那你應該看到

Verified OK

PS：此腳本將在您當前目錄中創建4個文件。

關鍵字

Security framework, Swift 3, Swift 4, Swift, SecKeyRawVerify, SecKeyGeneratePair, SecItemCopyMatching, secp256r1, Elliptic Curve Cryptography, ECDSA, ECDH, ASN.1, Apple, iOS, Mac OS, kSecAttrKeyTypeECSECPrimeRandom, kSecAttrKeyTypeEC, kSecAttrTokenIDSecureEnclave, lactext，localauthentication，faceid，face id，touchID，觸摸ID，應用程序密碼，設備PIN，DEVICEPIN