Skip to content

Commit 569ff69

Browse files
dchristidisbari12
authored andcommitted
Document X509 identity format
1 parent 05bc3d1 commit 569ff69

File tree

1 file changed

+19
-0
lines changed

1 file changed

+19
-0
lines changed

docs/operator/configuration.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -60,6 +60,25 @@ option:
6060
jdoe
6161
```
6262

63+
### X509 identity format
64+
65+
By default, X509 identities must be formatted according to the relevant RFCs: a
66+
comma-separated list of the DN components, ordered last-to-first (e.g.
67+
`CN=jdoe,OU=Users,OU=Organic Units,DC=blih,DC=blah`). However, operators might
68+
prefer to store them in the legacy format: a slash-separated list of the DN
69+
components, starting with a slash, ordered first-to-last (e.g.
70+
`/DC=blah/DC=blih/OU=Organic Units/OU=Users/CN=jdoe`).
71+
72+
To do so, it is necessary to enable the `LegacyDNStringFormat` configuration
73+
option of mod_ssl. When using the official Rucio container images, one must set
74+
the `RUCIO_HTTPD_LEGACY_DN` environmental variable to `True`. For custom
75+
installations, one must edit the appropriate Apache configuration file so that
76+
the `SSLOptions` directive looks like this:
77+
78+
```
79+
SSLOptions +StdEnvVars +LegacyDNStringFormat
80+
```
81+
6382
## Creating scope
6483

6584
One needs then to create some scopes associated with the accounts:

0 commit comments

Comments
 (0)