barbican/doc/source
Douglas Mendizábal 601f5ec733 Use serial number or label for PKCS#11 tokens
The PKCS#11 standard does not make any guarantees about
slot numbering, so the slot ID alone should not be used
to identify a token.  Instead, the token's Serial Number
or Label should be used to ensure the correct token
is being used.

This patch adds two new config options to the p11_crypto
plugin: token_serial_number and token_label.

These new options allow for more flexibility in configuring
the PKCS#11 module.  The config may include either the token's
serial number or its label.

Serial numbers should be unique, so they take higher precedence.

Some devices allow tokens to have the same label, so this patch
ensures that only one token with the specified label is present.

If both serial number and label are given, only the serial number
will be checked and an error will be raised if it is not found.

slot_id continues to work as expected, although its use is discouraged
and may be deprecated in a future patch.  If the conf contains
only the slot_id, it will be used.  If the serial number or
label are also provided, the new logic will ignore the slot_id
and search for the serial number or label instead.

Change-Id: I115cf1a7006a6c85f37c5e50ded13134a3dfd1a3
(cherry picked from commit 69459a0ecf)
2020-10-30 16:21:41 +00:00
..
_extra allow redirects in .htaccess files on the static web servers 2017-08-03 14:41:32 +05:30
_static Ensure doc/source/_static to fix docs gate 2019-09-06 10:07:26 +09:00
admin Update api-ref location 2019-08-05 17:58:16 +02:00
api Update api-ref location 2019-08-05 17:58:16 +02:00
cli Add barbican-status upgrade check command framework 2019-01-15 06:16:53 +00:00
configuration Replace git.openstack.org URLs with opendev.org URLs 2019-05-23 12:50:09 +08:00
contributor Fix stable/train gates 2020-10-29 15:22:33 -05:00
images Use local images instead of references 2016-02-07 15:42:48 -06:00
install Use serial number or label for PKCS#11 tokens 2020-10-30 16:21:41 +00:00
conf.py Activate html_static_path config option 2018-07-03 16:59:27 +07:00
index.rst Update api-ref location 2019-08-05 17:58:16 +02:00
sample_config.rst Add sample config and policy to documentation 2018-02-09 08:16:03 +00:00
sample_policy.rst Add sample config and policy to documentation 2018-02-09 08:16:03 +00:00