crds-catalog/cert-manager.io/order_v1.json

189 lines
9.0 KiB
JSON
Raw Normal View History

2023-03-08 12:21:48 +00:00
{
"description": "Order is a type to represent an Order with an ACME server",
"type": "object",
"required": [
"metadata",
"spec"
],
"properties": {
"apiVersion": {
2024-06-05 16:38:23 +00:00
"description": "APIVersion defines the versioned schema of this representation of an object.\nServers should convert recognized schemas to the latest internal value, and\nmay reject unrecognized values.\nMore info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
2023-03-08 12:21:48 +00:00
"type": "string"
},
"kind": {
2024-06-05 16:38:23 +00:00
"description": "Kind is a string value representing the REST resource this object represents.\nServers may infer this from the endpoint the client submits requests to.\nCannot be updated.\nIn CamelCase.\nMore info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
2023-03-08 12:21:48 +00:00
"type": "string"
},
"metadata": {
"type": "object"
},
"spec": {
"type": "object",
"required": [
"issuerRef",
"request"
],
"properties": {
"commonName": {
2024-06-05 16:38:23 +00:00
"description": "CommonName is the common name as specified on the DER encoded CSR.\nIf specified, this value must also be present in `dnsNames` or `ipAddresses`.\nThis field must match the corresponding field on the DER encoded CSR.",
2023-03-08 12:21:48 +00:00
"type": "string"
},
"dnsNames": {
2024-06-05 16:38:23 +00:00
"description": "DNSNames is a list of DNS names that should be included as part of the Order\nvalidation process.\nThis field must match the corresponding field on the DER encoded CSR.",
2023-03-08 12:21:48 +00:00
"type": "array",
"items": {
"type": "string"
}
},
"duration": {
2024-06-05 16:38:23 +00:00
"description": "Duration is the duration for the not after date for the requested certificate.\nthis is set on order creation as pe the ACME spec.",
2023-03-08 12:21:48 +00:00
"type": "string"
},
"ipAddresses": {
2024-06-05 16:38:23 +00:00
"description": "IPAddresses is a list of IP addresses that should be included as part of the Order\nvalidation process.\nThis field must match the corresponding field on the DER encoded CSR.",
2023-03-08 12:21:48 +00:00
"type": "array",
"items": {
"type": "string"
}
},
"issuerRef": {
2024-06-05 16:38:23 +00:00
"description": "IssuerRef references a properly configured ACME-type Issuer which should\nbe used to create this Order.\nIf the Issuer does not exist, processing will be retried.\nIf the Issuer is not an 'ACME' Issuer, an error will be returned and the\nOrder will be marked as failed.",
2023-03-08 12:21:48 +00:00
"type": "object",
"required": [
"name"
],
"properties": {
"group": {
"description": "Group of the resource being referred to.",
"type": "string"
},
"kind": {
"description": "Kind of the resource being referred to.",
"type": "string"
},
"name": {
"description": "Name of the resource being referred to.",
"type": "string"
}
},
"additionalProperties": false
},
"request": {
2024-06-05 16:38:23 +00:00
"description": "Certificate signing request bytes in DER encoding.\nThis will be used when finalizing the order.\nThis field must be set on the order.",
2023-03-08 12:21:48 +00:00
"type": "string",
"format": "byte"
}
},
"additionalProperties": false
},
"status": {
"type": "object",
"properties": {
"authorizations": {
2024-06-05 16:38:23 +00:00
"description": "Authorizations contains data returned from the ACME server on what\nauthorizations must be completed in order to validate the DNS names\nspecified on the Order.",
2023-03-08 12:21:48 +00:00
"type": "array",
"items": {
2024-06-05 16:38:23 +00:00
"description": "ACMEAuthorization contains data returned from the ACME server on an\nauthorization that must be completed in order validate a DNS name on an ACME\nOrder resource.",
2023-03-08 12:21:48 +00:00
"type": "object",
"required": [
"url"
],
"properties": {
"challenges": {
2024-06-05 16:38:23 +00:00
"description": "Challenges specifies the challenge types offered by the ACME server.\nOne of these challenge types will be selected when validating the DNS\nname and an appropriate Challenge resource will be created to perform\nthe ACME challenge process.",
2023-03-08 12:21:48 +00:00
"type": "array",
"items": {
2024-06-05 16:38:23 +00:00
"description": "Challenge specifies a challenge offered by the ACME server for an Order.\nAn appropriate Challenge resource can be created to perform the ACME\nchallenge process.",
2023-03-08 12:21:48 +00:00
"type": "object",
"required": [
"token",
"type",
"url"
],
"properties": {
"token": {
2024-06-05 16:38:23 +00:00
"description": "Token is the token that must be presented for this challenge.\nThis is used to compute the 'key' that must also be presented.",
2023-03-08 12:21:48 +00:00
"type": "string"
},
"type": {
2024-06-05 16:38:23 +00:00
"description": "Type is the type of challenge being offered, e.g. 'http-01', 'dns-01',\n'tls-sni-01', etc.\nThis is the raw value retrieved from the ACME server.\nOnly 'http-01' and 'dns-01' are supported by cert-manager, other values\nwill be ignored.",
2023-03-08 12:21:48 +00:00
"type": "string"
},
"url": {
2024-06-05 16:38:23 +00:00
"description": "URL is the URL of this challenge. It can be used to retrieve additional\nmetadata about the Challenge from the ACME server.",
2023-03-08 12:21:48 +00:00
"type": "string"
}
},
"additionalProperties": false
}
},
"identifier": {
"description": "Identifier is the DNS name to be validated as part of this authorization",
"type": "string"
},
"initialState": {
2024-06-05 16:38:23 +00:00
"description": "InitialState is the initial state of the ACME authorization when first\nfetched from the ACME server.\nIf an Authorization is already 'valid', the Order controller will not\ncreate a Challenge resource for the authorization. This will occur when\nworking with an ACME server that enables 'authz reuse' (such as Let's\nEncrypt's production endpoint).\nIf not set and 'identifier' is set, the state is assumed to be pending\nand a Challenge will be created.",
2023-03-08 12:21:48 +00:00
"type": "string",
"enum": [
"valid",
"ready",
"pending",
"processing",
"invalid",
"expired",
"errored"
]
},
"url": {
"description": "URL is the URL of the Authorization that must be completed",
"type": "string"
},
"wildcard": {
2024-06-05 16:38:23 +00:00
"description": "Wildcard will be true if this authorization is for a wildcard DNS name.\nIf this is true, the identifier will be the *non-wildcard* version of\nthe DNS name.\nFor example, if '*.example.com' is the DNS name being validated, this\nfield will be 'true' and the 'identifier' field will be 'example.com'.",
2023-03-08 12:21:48 +00:00
"type": "boolean"
}
},
"additionalProperties": false
}
},
"certificate": {
2024-06-05 16:38:23 +00:00
"description": "Certificate is a copy of the PEM encoded certificate for this Order.\nThis field will be populated after the order has been successfully\nfinalized with the ACME server, and the order has transitioned to the\n'valid' state.",
2023-03-08 12:21:48 +00:00
"type": "string",
"format": "byte"
},
"failureTime": {
2024-06-05 16:38:23 +00:00
"description": "FailureTime stores the time that this order failed.\nThis is used to influence garbage collection and back-off.",
2023-03-08 12:21:48 +00:00
"type": "string",
"format": "date-time"
},
"finalizeURL": {
2024-06-05 16:38:23 +00:00
"description": "FinalizeURL of the Order.\nThis is used to obtain certificates for this order once it has been completed.",
2023-03-08 12:21:48 +00:00
"type": "string"
},
"reason": {
2024-06-05 16:38:23 +00:00
"description": "Reason optionally provides more information about a why the order is in\nthe current state.",
2023-03-08 12:21:48 +00:00
"type": "string"
},
"state": {
2024-06-05 16:38:23 +00:00
"description": "State contains the current state of this Order resource.\nStates 'success' and 'expired' are 'final'",
2023-03-08 12:21:48 +00:00
"type": "string",
"enum": [
"valid",
"ready",
"pending",
"processing",
"invalid",
"expired",
"errored"
]
},
"url": {
2024-06-05 16:38:23 +00:00
"description": "URL of the Order.\nThis will initially be empty when the resource is first created.\nThe Order controller will populate this field when the Order is first processed.\nThis field will be immutable after it is initially set.",
2023-03-08 12:21:48 +00:00
"type": "string"
}
},
"additionalProperties": false
}
}
}