// Copyright 2023 Google LLC. // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // https://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. // Package linux contains a linux-specific client for accessing the PKCS#11 APIs directly, // bypassing the RPC-mechanism of the universal client. package linux import ( "crypto" "io" "github.com/googleapis/enterprise-certificate-proxy/internal/signer/linux/pkcs11" ) // SecureKey is a public wrapper for the internal PKCS#11 implementation. type SecureKey struct { key *pkcs11.Key } // CertificateChain returns the SecureKey's raw X509 cert chain. This contains the public key. func (sk *SecureKey) CertificateChain() [][]byte { return sk.key.CertificateChain() } // Public returns the public key for this SecureKey. func (sk *SecureKey) Public() crypto.PublicKey { return sk.key.Public() } // Sign signs a message digest, using the specified signer opts. Implements crypto.Signer interface. func (sk *SecureKey) Sign(_ io.Reader, digest []byte, opts crypto.SignerOpts) (signed []byte, err error) { return sk.key.Sign(nil, digest, opts) } // Encrypt encrypts a plaintext msg into ciphertext, using the specified encrypt opts. func (sk *SecureKey) Encrypt(_ io.Reader, msg []byte, opts any) (ciphertext []byte, err error) { return sk.key.Encrypt(msg, opts) } // Decrypt decrypts a ciphertext msg into plaintext, using the specified decrypter opts. Implements crypto.Decrypter interface. func (sk *SecureKey) Decrypt(_ io.Reader, msg []byte, opts crypto.DecrypterOpts) (plaintext []byte, err error) { return sk.key.Decrypt(msg, opts) } // Close frees up resources associated with the underlying key. func (sk *SecureKey) Close() { sk.key.Close() } // NewSecureKey returns a handle to the first available certificate and private key pair in // the specified PKCS#11 Module matching the filters. func NewSecureKey(pkcs11Module string, slotUint32Str string, label string, userPin string) (*SecureKey, error) { k, err := pkcs11.Cred(pkcs11Module, slotUint32Str, label, userPin) if err != nil { return nil, err } return &SecureKey{key: k}, nil }