Summary

Add a guide and glossary on SSL/TLS configuration.

Review Request #15065 — Created May 18, 2026 and submitted May 19, 2026, 10:26 p.m.

Information

Owner

chipx86

Repository

Review Board

Branch

release-8.x

Bugs

Depends On

Reviewers

Groups

reviewboard

People

Description

Since there's a lot of terms thrown around, the glossary has been
updated to flesh out these terms and link back to this page.

In the future, this page will be a good place to document the cert
configuration UI and cert synchronization, once that's been written.

Testing Done

Checked for obvious spelling, link, or build errors. Ran it through
Claude to check for any notable issues.

Commits

Summary	ID
Add a guide and glossary on SSL/TLS configuration. This adds a new docs page covering how to manage SSL/TLS certificates and CA bundles. As of Review Board 8, these need to be configured manually on the filesystem. This guide walks through how to do that, and the various SSL options available. Since there's a lot of terms thrown around, the glossary has been updated to flesh out these terms and link back to this page. In the future, this page will be a good place to document the cert configuration UI and cert synchronization, once that's been written.	7d08121ff5fbdcacb0da4f308dfc246780b21d98

Summary

Add a guide and glossary on SSL/TLS configuration.

This adds a new docs page covering how to manage SSL/TLS certificates and CA bundles. As of Review Board 8, these need to be configured manually on the filesystem. This guide walks through how to do that, and the various SSL options available. Since there's a lot of terms thrown around, the glossary has been updated to flesh out these terms and link back to this page. In the future, this page will be a good place to document the cert configuration UI and cert synchronization, once that's been written.

7d08121ff5fbdcacb0da4f308dfc246780b21d98

Issues

Description	From	Last Updated
Instead of "they should also be lowercase", maybe "and the hostname must be lowercase" ?	david	May 18, 2026, 11:12 p.m.
Based on our matching this should be all first-level subdomains. We might want to clarify that and add a note …	david	May 18, 2026, 11:44 p.m.
There's an extra "*" in here.	david	May 18, 2026, 11:21 p.m.
Either we should have a term for "Private Key" or we should lowercase it.	david	May 18, 2026, 11:23 p.m.

flake8 passed.

JSHint passed.

docs/manual/admin/configuration/ssl-certificates.rst (Diff revision 1)
The issue has been resolved. Show all issues
```
Instead of "they should also be lowercase", maybe "and the hostname must be lowercase" ?
```

docs/manual/admin/configuration/ssl-certificates.rst (Diff revision 1)

The issue has been resolved. Show all issues

Based on our matching this should be all first-level subdomains. We might want to clarify that and add a note that nested subdomains will require their own cert.

chipx86

May 18, 2026, 11:46 p.m.

It supports subdomains. You just can't have a wildcard in the middle of a domain. *.corp.example.com is valid and in the test data. svn.*.example.com is not valid. I can document the wildcard placement.

docs/manual/glossary.rst (Diff revision 1)
The issue has been resolved. Show all issues
```
There's an extra "*" in here.
```
docs/manual/glossary.rst (Diff revision 1)
The issue has been resolved. Show all issues
```
Either we should have a term for "Private Key" or we should lowercase it.
```

Change Summary:


Changed wording around hostname naming requirements.
Added a note about how wildcards must be at the start of a domain, not in the middle.
Added a glossary definition for "Private Key" and "SSH" (which "Private Key" references).
Removed a * that didn't get removed when changing the way I was doing references.

Commits:

	Summary	ID
	Add a guide and glossary on SSL/TLS configuration. This adds a new docs page covering how to manage SSL/TLS certificates and CA bundles. As of Review Board 8, these need to be configured manually on the filesystem. This guide walks through how to do that, and the various SSL options available. Since there's a lot of terms thrown around, the glossary has been updated to flesh out these terms and link back to this page. In the future, this page will be a good place to document the cert configuration UI and cert synchronization, once that's been written.	8df83761fff30766a0092f5f2d0304888693aef1
	Add a guide and glossary on SSL/TLS configuration. This adds a new docs page covering how to manage SSL/TLS certificates and CA bundles. As of Review Board 8, these need to be configured manually on the filesystem. This guide walks through how to do that, and the various SSL options available. Since there's a lot of terms thrown around, the glossary has been updated to flesh out these terms and link back to this page. In the future, this page will be a good place to document the cert configuration UI and cert synchronization, once that's been written.	7d08121ff5fbdcacb0da4f308dfc246780b21d98

Diff:

Revision 2 (+658 -4)

Show changes

	docs/manual/glossary.rst
	docs/manual/admin/index.rst
	docs/manual/admin/configuration/index.rst
	docs/manual/admin/configuration/ssl-certificates.rst

Checks run (2 succeeded)

flake8 passed.

JSHint passed.

Ship it!

```
Ship It!
```

Status:: Completed
Change Summary:: Pushed to release-8.x (8e74a20)