File: certs-dir.rst

package info (click to toggle)
txacme 0.9.3-3
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 644 kB
  • sloc: python: 5,715; makefile: 189
file content (25 lines) | stat: -rw-r--r-- 972 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
Certificates directory
======================

The layout of the certificates directory used by ``DirectoryStore`` (and thus
the ``le:`` and ``lets:`` endpoints) is coordinated with `txsni`_ to allow
sharing a certificates directory with other applications. The txsni and txacme
maintainers have committed to coordination of any future changes to the
contents of this directory to ensure continued compatibility.

.. _txsni: https://github.com/glyph/txsni

At present, the following entries may exist in this directory:

* ``<server name>.pem``

  A file containing a certificate and matching private key valid for ``<server
  name>``, serialized in PEM format.

* ``client.key``

  A file containing an ACME client key, serialized in PEM format.

All other filenames are currently reserved for future use; introducing
non-specified files or directories into a certificates directory may result in
conflicts with items specified by future versions of txacme and/or txsni.