import { MessageSecurityMode } from '../generated/MessageSecurityMode'; import { SignatureData } from '../generated/SignatureData'; import { DerivedKeys, PrivateKey } from '../crypto'; type BinaryLike = ArrayBufferLike | ArrayBufferView; /** * @class SecurityPolicy * @static * * OPCUA Spec Release 1.02 page 15 OPC Unified Architecture, Part 7 * * @property Basic128Rsa15 Security Basic 128Rsa15 * ----------------------- * A suite of algorithms that uses RSA15 as * Key-Wrap-algorithm and 128-Bit for encryption algorithms. * -> SymmetricSignatureAlgorithm - HmacSha1 -(http://www.w3.org/2000/09/xmldsig#hmac-sha1). * -> SymmetricEncryptionAlgorithm - Aes128 -(http://www.w3.org/2001/04/xmlenc#aes128-cbc). * -> AsymmetricSignatureAlgorithm - RsaSha1 -(http://www.w3.org/2000/09/xmldsig#rsa-sha1). * -> AsymmetricKeyWrapAlgorithm - KwRsa15 -(http://www.w3.org/2001/04/xmlenc#rsa-1_5). * -> AsymmetricEncryptionAlgorithm - Rsa15 -(http://www.w3.org/2001/04/xmlenc#rsa-1_5). * -> KeyDerivationAlgorithm - PSha1 -(http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512/dk/p_sha1). * -> DerivedSignatureKeyLength - 128 * -> MinAsymmetricKeyLength - 1024 * -> MaxAsymmetricKeyLength - 2048 * -> CertificateSignatureAlgorithm - Sha1 * * @property Basic256 Security Basic 256: * ------------------- * A suite of algorithms that are for 256-Bit encryption, algorithms include: * -> SymmetricSignatureAlgorithm - HmacSha1 -(http://www.w3.org/2000/09/xmldsig#hmac-sha1). * -> SymmetricEncryptionAlgorithm - Aes256 -(http://www.w3.org/2001/04/xmlenc#aes256-cbc). * -> AsymmetricSignatureAlgorithm - RsaSha1 -(http://www.w3.org/2000/09/xmldsig#rsa-sha1). * -> AsymmetricKeyWrapAlgorithm - KwRsaOaep-(http://www.w3.org/2001/04/xmlenc#rsa-oaep-mgf1p). * -> AsymmetricEncryptionAlgorithm - RsaOaep SHA1 -(http://www.w3.org/2001/04/xmlenc#rsa-oaep). * -> KeyDerivationAlgorithm - PSha1 -(http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512/dk/p_sha1). * -> DerivedSignatureKeyLength - 192. * -> MinAsymmetricKeyLength - 1024 * -> MaxAsymmetricKeyLength - 2048 * -> CertificateSignatureAlgorithm - Sha1 * * @property Basic256 Security Basic 256 Sha256 * -------------------------------------------- * A suite of algorithms that are for 256-Bit encryption, algorithms include. * -> SymmetricSignatureAlgorithm - Hmac_Sha256 -(http://www.w3.org/2000/09/xmldsig#hmac-sha256). * -> SymmetricEncryptionAlgorithm - Aes256_CBC -(http://www.w3.org/2001/04/xmlenc#aes256-cbc). * -> AsymmetricSignatureAlgorithm - Rsa_Sha256 -(https://www.w3.org/2000/09/xmldsig#rsa-sha256). * -> AsymmetricKeyWrapAlgorithm - KwRsaOaep -(http://www.w3.org/2001/04/xmlenc#rsa-oaep-mgf1p). * -> AsymmetricEncryptionAlgorithm - Rsa_Oaep SHA1 -(http://www.w3.org/2001/04/xmlenc#rsa-oaep). * -> KeyDerivationAlgorithm - PSHA256 -(http://docs.oasis-open.org/ws-sx/ws-secureconversation/200512/dk/p_sha256). * -> DerivedSignatureKeyLength - 256 * -> MinAsymmetricKeyLength - 2048 * -> MaxAsymmetricKeyLength - 4096 * -> CertificateSignatureAlgorithm - Sha256 * * Support for this security profile may require support for a second application instance certificate, with a larger * keysize. Applications shall support multiple Application Instance Certificates if required by supported Security * Polices and use the certificate that is required for a given security endpoint. * * */ export declare enum SecurityPolicy { Invalid = "invalid", None = "http://opcfoundation.org/UA/SecurityPolicy#None", Basic128 = "http://opcfoundation.org/UA/SecurityPolicy#Basic128", Basic128Rsa15 = "http://opcfoundation.org/UA/SecurityPolicy#Basic128Rsa15",// deprecated Basic192 = "http://opcfoundation.org/UA/SecurityPolicy#Basic192", Basic192Rsa15 = "http://opcfoundation.org/UA/SecurityPolicy#Basic192Rsa15", Basic256 = "http://opcfoundation.org/UA/SecurityPolicy#Basic256",// deprecated Basic256Rsa15 = "http://opcfoundation.org/UA/SecurityPolicy#Basic256Rsa15", Basic256Sha256 = "http://opcfoundation.org/UA/SecurityPolicy#Basic256Sha256", Aes128_Sha256_RsaOaep = "http://opcfoundation.org/UA/SecurityPolicy#Aes128_Sha256_RsaOaep", Aes256_Sha256_RsaPss = "http://opcfoundation.org/UA/SecurityPolicy#Aes256_Sha256_RsaPss", EccNistP256 = "http://opcfoundation.org/UA/SecurityPolicy#EccNistP256", EccNistP384 = "http://opcfoundation.org/UA/SecurityPolicy#EccNistP384" } export declare function fromURI(uri?: string | null): SecurityPolicy; export declare function toUri(value: SecurityPolicy | string): string; export declare function coerceSecurityPolicy(value?: any): SecurityPolicy; export interface DerivedKeys1 { derivedClientKeys: DerivedKeys | null; derivedServerKeys: DerivedKeys | null; algorithm: string | null; } export declare function computeDerivedKeys(cryptoFactory: ICryptoFactory, serverNonce?: Uint8Array, clientNonce?: Uint8Array): Promise; /** * ECC channel key derivation (Part 6 §6.8.1). * Unlike RSA policies, the caller must first agree the ECDH shared secret * (IKM) from the ephemeral nonces, then call this to get symmetric keys that * plug into the existing AES-CBC/HMAC DerivedKeys pipeline. */ export declare function computeEccDerivedKeys(cryptoFactory: ICryptoFactory, clientNonce: Uint8Array, serverNonce: Uint8Array, sharedSecret: Uint8Array): Promise; export interface ICryptoFactory { securityPolicy: SecurityPolicy; symmetricKeyLength: number; derivedEncryptionKeyLength: number; derivedSignatureKeyLength: number; encryptingBlockSize: number; signatureLength: number; minimumAsymmetricKeyLength: number; maximumAsymmetricKeyLength: number; asymmetricVerifyChunk: (chunk: Uint8Array, certificate: Uint8Array) => PromiseLike; asymmetricSign: (chunk: BinaryLike, key: PrivateKey) => Promise; asymmetricVerify: (block_to_verify: Uint8Array, signature: Uint8Array, certificate: Uint8Array) => PromiseLike; asymmetricSignatureAlgorithm: 'http://www.w3.org/2000/09/xmldsig#rsa-sha1' | 'http://www.w3.org/2000/09/xmldsig#rsa-sha256' | 'http://www.w3.org/2000/09/xmldsig#rsa-pss' | 'http://www.w3.org/2001/04/xmldsig-more#ecdsa-sha256' | 'http://www.w3.org/2001/04/xmldsig-more#ecdsa-sha384'; generatePublicKeyFromDER: (der: Uint8Array) => PromiseLike; asymmetricEncrypt: (block: Uint8Array, publicKey: CryptoKey) => PromiseLike; asymmetricDecrypt: (block: Uint8Array, privateKey: PrivateKey) => Promise; asymmetricEncryptionAlgorithm: string; blockPaddingSize: number; symmetricEncryptionAlgorithm: string; sha1or256: 'SHA-1' | 'SHA-256' | 'SHA-384'; /** * Fixed asymmetric (OPN) signature length in bytes, when known. Set for ECC * policies (ECDSA r||s: 64 P-256, 96 P-384). RSA policies leave this * undefined: their OPN signature length depends on the sender's cert key * and is derived per-message via `rsaKeyLength()`. */ asymmetricSignatureLength?: number; /** * Set for ECC policies only (Part 6 §6.8.1). When present, OpenSecureChannel * nonces are ephemeral ECDH public keys and channel keys come from * computeEccChannelKeys(), not RSA P_SHA derivation. */ eccCurve?: 'P-256' | 'P-384'; eccNonceLength?: number; } export declare function getCryptoFactory(securityPolicy: SecurityPolicy): ICryptoFactory | null; export declare function computeSignature(senderCertificate: Uint8Array | undefined, senderNonce: Uint8Array | undefined, receiverPrivatekey: PrivateKey | null | undefined, securityPolicy: SecurityPolicy): Promise | undefined; export declare function verifySignature(receiverCertificate: Uint8Array, receiverNonce: Uint8Array, signature: SignatureData, senderCertificate: Uint8Array, securityPolicy: SecurityPolicy): boolean | PromiseLike; export declare function getOptionsForSymmetricSignAndEncrypt(securityMode: MessageSecurityMode, derivedKeys: DerivedKeys): { signatureLength: number; signBufferFunc: (chunk: Uint8Array) => Promise; } | { plainBlockSize: number; cipherBlockSize: number; encryptBufferFunc: (chunk: Uint8Array) => Promise>; signatureLength: number; signBufferFunc: (chunk: Uint8Array) => Promise; }; export declare function getRSAOAEPPadding(hash: string): number; export {}; //# sourceMappingURL=security_policy.d.ts.map