pkcs11

Documentation

Overview

Copyright IBM Corp. 2016 All Rights Reserved.

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

http://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.

Index

• func FindPKCS11Lib() (lib, pin, label string)
• func New(opts PKCS11Opts, keyStore bccsp.KeyStore, options ...Option) (bccsp.BCCSP, error)
• type KeyIDMapping
• type Option
  • func WithKeyMapper(mapper func([]byte) []byte) Option
• type PKCS11Opts

Functions

func FindPKCS11Lib

func FindPKCS11Lib() (lib, pin, label string)

FindPKCS11Lib IS ONLY USED FOR TESTING This is a convenience function. Useful to self-configure, for tests where usual configuration is not available.

func New

func New(opts PKCS11Opts, keyStore bccsp.KeyStore, options ...Option) (bccsp.BCCSP, error)

New returns a new instance of a BCCSP that uses PKCS#11 standard interfaces to generate and use elliptic curve key pairs for signing and verification using curves that satisfy the requested security level from opts.

All other cryptographic functions are delegated to a software based BCCSP implementation that is configured to use the security level and hashing familly from opts and the key store that is provided.

Types

type KeyIDMapping

type KeyIDMapping struct {
	SKI string `json:"ski,omitempty"`
	ID  string `json:"id,omitempty"`
}

A KeyIDMapping associates the CKA_ID attribute of a cryptoki object with a subject key identifer.

type Option

type Option func(p *impl) error

An Option is used to configure the Provider.

func WithKeyMapper

func WithKeyMapper(mapper func([]byte) []byte) Option

WithKeyMapper returns an option that configures the Provider to use the provided function to map a subject key identifier to a cryptoki CKA_ID identifer.

type PKCS11Opts

type PKCS11Opts struct {
	// Default algorithms when not specified (Deprecated?)
	SecLevel   int    `mapstructure:"security" json:"security"`
	HashFamily string `mapstructure:"hash" json:"hash"`

	// Keystore options
	Ephemeral bool `mapstructure:"tempkeys,omitempty" json:"tempkeys,omitempty"`

	// PKCS11 options
	Library    string         `mapstructure:"library" json:"library"`
	Label      string         `mapstructure:"label" json:"label"`
	Pin        string         `mapstructure:"pin" json:"pin"`
	SoftVerify bool           `mapstructure:"softwareverify,omitempty" json:"softwareverify,omitempty"`
	Immutable  bool           `mapstructure:"immutable,omitempty" json:"immutable,omitempty"`
	AltID      string         `json:"altid,omitempty"`
	KeyIDs     []KeyIDMapping `json:"keyids,omitempty" mapstructure:"keyids"`
}

PKCS11Opts contains options for the P11Factory