diff options
| author | Benjamin Kaduk <bkaduk@akamai.com> | 2018-10-04 13:49:21 -0500 |
|---|---|---|
| committer | Ben Kaduk <kaduk@mit.edu> | 2018-10-08 16:41:33 -0500 |
| commit | a7ee1ef61b1893038008691a4a6979cf2da91439 (patch) | |
| tree | 9251f3a26fe1ccd2609f8e0f048312ac98630361 /doc | |
| parent | 521738e990a5ef36334ee0296706697b49b48e4a (diff) | |
apps: allow empty attribute values with -subj
Historically (i.e., OpenSSL 1.0.x), the openssl applications would
allow for empty subject attributes to be passed via the -subj argument,
e.g., `opensl req -subj '/CN=joe/O=/OU=local' ...`. Commit
db4c08f0194d58c6192f0d8311bf3f20e251cf4f applied a badly needed rewrite
to the parse_name() helper function that parses these strings, but
in the process dropped a check that would skip attributes with no
associated value. As a result, such strings are now treated as
hard errors and the operation fails.
Restore the check to skip empty attribute values and restore
the historical behavior.
Document the behavior for empty subject attribute values in the
corresponding applications' manual pages.
Reviewed-by: Matt Caswell <matt@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/7349)
(cherry picked from commit 3d362f190306b62a17aa2fd475b2bc8b3faa8142)
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/man1/ca.pod | 6 | ||||
| -rw-r--r-- | doc/man1/req.pod | 6 | ||||
| -rw-r--r-- | doc/man1/storeutl.pod | 7 |
3 files changed, 13 insertions, 6 deletions
diff --git a/doc/man1/ca.pod b/doc/man1/ca.pod index 9b282e6479..e998eabf83 100644 --- a/doc/man1/ca.pod +++ b/doc/man1/ca.pod @@ -250,8 +250,10 @@ for all available algorithms. =item B<-subj arg> Supersedes subject name given in the request. -The arg must be formatted as I</type0=value0/type1=value1/type2=...>, -characters may be escaped by \ (backslash), no spaces are skipped. +The arg must be formatted as I</type0=value0/type1=value1/type2=...>. +Keyword characters may be escaped by \ (backslash), and whitespace is retained. +Empty values are permitted, but the corresponding type will not be included +in the resulting certificate. =item B<-utf8> diff --git a/doc/man1/req.pod b/doc/man1/req.pod index 113cd9b6c9..c76d63d6fd 100644 --- a/doc/man1/req.pod +++ b/doc/man1/req.pod @@ -221,8 +221,10 @@ see L<openssl(1)/COMMAND SUMMARY>. Sets subject name for new request or supersedes the subject name when processing a request. -The arg must be formatted as I</type0=value0/type1=value1/type2=...>, -characters may be escaped by \ (backslash), no spaces are skipped. +The arg must be formatted as I</type0=value0/type1=value1/type2=...>. +Keyword characters may be escaped by \ (backslash), and whitespace is retained. +Empty values are permitted, but the corresponding type will not be included +in the request. =item B<-multivalue-rdn> diff --git a/doc/man1/storeutl.pod b/doc/man1/storeutl.pod index 3f26ab500b..083f028246 100644 --- a/doc/man1/storeutl.pod +++ b/doc/man1/storeutl.pod @@ -82,8 +82,11 @@ returned. =item B<-subject arg> Search for an object having the subject name B<arg>. -The arg must be formatted as I</type0=value0/type1=value1/type2=...>, -characters may be escaped by \ (backslash), no spaces are skipped. +The arg must be formatted as I</type0=value0/type1=value1/type2=...>. +Keyword characters may be escaped by \ (backslash), and whitespace is retained. +Empty values are permitted but are ignored for the search. That is, +a search with an empty value will have the same effect as not specifying +the type at all. =item B<-issuer arg> |