1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93
|
// 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.
//go:build darwin && cgo
// +build darwin,cgo
// Package darwin contains a darwin-specific client for accessing the keychain APIs directly,
// bypassing the RPC mechanism of the universal client.
package darwin
import (
"crypto"
"io"
"github.com/googleapis/enterprise-certificate-proxy/internal/signer/darwin/keychain"
)
// SecureKey is a public wrapper for the internal keychain implementation.
type SecureKey struct {
key *keychain.Key
}
// SecureKeyOptions encapsulates all supported keychain parameters
type SecureKeyOptions struct {
IssuerCN string
KeychainType string
}
// 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 MacOS Keychain matching the issuer CN filter. This includes both the current login keychain
// for the user as well as the system keychain.
func NewSecureKey(issuerCN string) (*SecureKey, error) {
k, err := keychain.Cred(issuerCN, "")
if err != nil {
return nil, err
}
return &SecureKey{key: k}, nil
}
// NewSecureKeyWithOptions returns a handle to the first available certificate and private key pair in
// the MacOS Keychain matching the SecureKeyOptions filter.
func NewSecureKeyWithOptions(options SecureKeyOptions) (*SecureKey, error) {
k, err := keychain.Cred(options.IssuerCN, options.KeychainType)
if err != nil {
return nil, err
}
return &SecureKey{key: k}, nil
}
// ImportPKCS12Cred imports a PKCS12 file containing a client certificate and private key into the keychain
func ImportPKCS12Cred(credPath, password string) error {
return keychain.ImportPKCS12Cred(credPath, password)
}
|