789edad0e8
Coming out of the Nova midcycle we decided we really needed to deprecate the os-certificates API and service. It is not used by any of the rest of Nova. It's an API that requires a dedicated daemon to be run. It's making Nova assume the responsibility for generating secure certificates, even though it's not really managing entropy in any sane way (which is why nova-cert is a service, so you could stick these on all your computes so as to not run out of entropy). Change-Id: I0ffa9200d8b4f52da4751e731aecffe09fd3d4be
69 lines
1.5 KiB
ReStructuredText
69 lines
1.5 KiB
ReStructuredText
.. -*- rst -*-
|
|
|
|
=====================================
|
|
Root certificates (os-certificates)
|
|
=====================================
|
|
|
|
Creates and shows details for a root certificate.
|
|
|
|
.. warning::
|
|
|
|
This API existed solely because of the need to build euca bundles
|
|
when Nova had an in tree EC2 API. It no longer interacts with any
|
|
parts of the system besides it's own certificate daemon. It is
|
|
deprecated and will be removed in the near future.
|
|
|
|
Create Root Certificate
|
|
=======================
|
|
|
|
.. rest_method:: POST /os-certificates
|
|
|
|
Creates a root certificate.
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes: unauthorized(401), forbidden(403)
|
|
|
|
Response
|
|
--------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- certificate: certificate
|
|
- data: data
|
|
- private_key: private_key
|
|
|
|
|
|
|
|
|
**Example Create Root Certificate**
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-certificates/certificate-create-resp.json
|
|
:language: javascript
|
|
|
|
Show Root Certificate Details
|
|
=============================
|
|
|
|
.. rest_method:: GET /os-certificates/root
|
|
|
|
Shows details for a root certificate.
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes: unauthorized(401), forbidden(403), itemNotFound(404), notImplemented(501)
|
|
|
|
Response
|
|
--------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- certificate: certificate
|
|
- data: data
|
|
- private_key: private_key
|
|
|
|
|
|
|
|
|
**Example Show Root Certificate Details**
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-certificates/certificate-get-root-resp.json
|
|
:language: javascript
|