diff options
author | Remigiusz Janeczek <remigiusz.janeczek@nokia.com> | 2021-07-28 12:52:27 +0200 |
---|---|---|
committer | Joanna Jeremicz <joanna.jeremicz@nokia.com> | 2021-07-29 12:30:00 +0200 |
commit | d732520d8bb853ad82d691a18bb2e8e055bfb18b (patch) | |
tree | feeb5d7f652b15afb01c4a67b0c597c3ac4ffe8c | |
parent | 333966e38367d2d889bbfeee13eb688d7eab7346 (diff) |
Update RTD Offered APIs section to use OpenAPI.yaml file
Update Certificate update section in RTD
Issue-ID: OOM-2754
Signed-off-by: Remigiusz Janeczek <remigiusz.janeczek@nokia.com>
Change-Id: Ia673a8bf449fca3fba52fb88374b7b418c23c6eb
Signed-off-by: Joanna Jeremicz <joanna.jeremicz@nokia.com>
-rw-r--r-- | docs/sections/offeredapis.rst | 164 | ||||
-rw-r--r-- | docs/sections/usage.rst | 3 |
2 files changed, 5 insertions, 162 deletions
diff --git a/docs/sections/offeredapis.rst b/docs/sections/offeredapis.rst index 21a4bb60..47a24ceb 100644 --- a/docs/sections/offeredapis.rst +++ b/docs/sections/offeredapis.rst @@ -1,6 +1,6 @@ .. This work is licensed under a Creative Commons Attribution 4.0 International License. .. http://creativecommons.org/licenses/by/4.0 -.. Copyright 2020 NOKIA +.. Copyright 2020-2021 NOKIA .. _offeredapis: Offered APIs @@ -9,163 +9,5 @@ Offered APIs OOM Cert Service Api -------------------- -.. code-block:: yaml - - openapi: 3.0.1 - info: - title: CertService Documentation - description: Certification service API documentation - version: 1.0.0 - servers: - - url: http://localhost:8080 - description: Generated server url - tags: - - name: Actuator - description: Monitor and interact - externalDocs: - description: Spring Boot Actuator Web API Documentation - url: https://docs.spring.io/spring-boot/docs/current/actuator-api/html/ - paths: - /v1/certificate/{caName}: - get: - tags: - - CertificationService - summary: sign certificate - description: Web endpoint for requesting certificate signing. Used by system - components to gain certificate signed by CA. - operationId: signCertificate - parameters: - - name: caName - in: path - description: Name of certification authority that will sign CSR. - required: true - schema: - type: string - - name: CSR - in: header - description: Certificate signing request in form of PEM object encoded in - Base64 (with header and footer). - required: true - schema: - type: string - - name: PK - in: header - description: Private key in form of PEM object encoded in Base64 (with header - and footer). - required: true - schema: - type: string - responses: - "200": - description: certificate successfully signed - content: - application/json; charset=utf-8: - schema: - $ref: '#/components/schemas/CertificationModel' - "500": - description: something went wrong during connecting to cmp client - content: - application/json; charset=utf-8: - schema: - $ref: '#/components/schemas/ErrorResponseModel' - "404": - description: CA not found for given name - content: - application/json; charset=utf-8: - schema: - $ref: '#/components/schemas/ErrorResponseModel' - "400": - description: given CSR or/and PK is incorrect - content: - application/json; charset=utf-8: - schema: - $ref: '#/components/schemas/ErrorResponseModel' - /ready: - get: - tags: - - CertificationService - summary: check is container is ready - description: Web endpoint for checking if service is ready to be used. - operationId: checkReady - responses: - "200": - description: configuration is loaded and service is ready to use - content: - application/json; charset=utf-8: - schema: - type: string - "503": - description: configuration loading failed and service is unavailable - content: - application/json; charset=utf-8: - schema: - type: string - /reload: - get: - tags: - - CertificationService - summary: reload service configuration from file - description: Web endpoint for performing configuration reload. Used to reload - configuration file from file. - operationId: reloadConfiguration - responses: - "200": - description: configuration has been successfully reloaded - content: - application/json; charset=utf-8: - schema: - type: string - "500": - description: something went wrong during configuration loading - content: - application/json; charset=utf-8: - schema: - $ref: '#/components/schemas/ErrorResponseModel' - /actuator/health: - get: - tags: - - Actuator - summary: Actuator web endpoint 'health' - operationId: handle_0 - responses: - "200": - description: default response - content: {} - /actuator/health/**: - get: - tags: - - Actuator - summary: Actuator web endpoint 'health-path' - operationId: handle_1 - responses: - "200": - description: default response - content: {} - /actuator: - get: - tags: - - Actuator - summary: Actuator root web endpoint - operationId: links_2 - responses: - "200": - description: default response - content: {} - components: - schemas: - ErrorResponseModel: - type: object - properties: - errorMessage: - type: string - CertificationModel: - type: object - properties: - certificateChain: - type: array - items: - type: string - trustedCertificates: - type: array - items: - type: string +.. include:: resources/OpenAPI.yaml + :code:
\ No newline at end of file diff --git a/docs/sections/usage.rst b/docs/sections/usage.rst index cd48b55a..848852bf 100644 --- a/docs/sections/usage.rst +++ b/docs/sections/usage.rst @@ -154,7 +154,8 @@ Here is an example of generated *secret* containing certificates: Certificate update ------------------------------ -When the certificate already exists, but its date has expired or certificate data should be changed, then the certificate update scenario can be executed. +When the certificate already exists, but its date is close to expire or certificate data should be changed, then the certificate update scenario can be executed. +It is performed automatically by cert-manager close to the expiration date or can be triggered manually. This use case requires the update endpoint configured for *CMPv2Issuer* CRD: .. code-block:: yaml |