tls-certificates-and-hostnames_ssl

SSL properties for the custom hostname.

APIs.ioEngineeringPlatform
View JSON Schema on GitHub

JSON Schema

apis-io-engineering-platform-tls-certificates-and-hostnames-ssl-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/tls-certificates-and-hostnames_ssl",
  "title": "tls-certificates-and-hostnames_ssl",
  "description": "SSL properties for the custom hostname.",
  "oneOf": [
    {
      "properties": {
        "bundle_method": {
          "default": "ubiquitous",
          "description": "A ubiquitous bundle has the highest probability of being verified everywhere, even by clients using outdated or unusual trust stores. An optimal bundle uses the shortest chain and newest intermediates. And the force bundle verifies the chain, but does not otherwise modify it.",
          "enum": [
            "ubiquitous",
            "optimal",
            "force"
          ],
          "example": "ubiquitous",
          "type": "string"
        },
        "certificate_authority": {
          "$ref": "#/components/schemas/tls-certificates-and-hostnames_certificate_authority"
        },
        "custom_certificate": {
          "description": "If a custom uploaded certificate is used.",
          "example": "-----BEGIN CERTIFICATE-----\\nMIIFJDCCBAygAwIBAgIQD0ifmj/Yi5NP/2gdUySbfzANBgkqhkiG9w0BAQsFADBN\\nMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMScwJQYDVQQDEx5E...SzSHfXp5lnu/3V08I72q1QNzOCgY1XeL4GKVcj4or6cT6tX6oJH7ePPmfrBfqI/O\\nOeH8gMJ+FuwtXYEPa4hBf38M5eU5xWG7\\n-----END CERTIFICATE-----\\n",
          "type": "string"
        },
        "custom_csr_id": {
          "description": "The identifier for the Custom CSR that was used.",
          "example": "7b163417-1d2b-4c84-a38a-2fb7a0cd7752",
          "type": "string"
        },
        "custom_key": {
          "description": "The key for a custom uploaded certificate.",
          "example": "-----BEGIN RSA PRIVATE KEY-----\nMIIEowIBAAKCAQEAwQHoetcl9+5ikGzV6cMzWtWPJHqXT3wpbEkRU9Yz7lgvddmG\ndtcGbg/1CGZu0jJGkMoppoUo4c3dts3iwqRYmBikUP77wwY2QGmDZw2FvkJCJlKn\nabIRuGvBKwzESIXgKk2016aTP6/dAjEHyo6SeoK8lkIySUvK0fyOVlsiEsCmOpid\ntnKX/a+50GjB79CJH4ER2lLVZnhePFR/zUOyPxZQQ4naHf7yu/b5jhO0f8fwt+py\nFxIXjbEIdZliWRkRMtzrHOJIhrmJ2A1J7iOrirbbwillwjjNVUWPf3IJ3M12S9pE\newooaeO2izNTERcG9HzAacbVRn2Y2SWIyT/18QIDAQABAoIBACbhTYXBZYKmYPCb\nHBR1IBlCQA2nLGf0qRuJNJZg5iEzXows/6tc8YymZkQE7nolapWsQ+upk2y5Xdp/\naxiuprIs9JzkYK8Ox0r+dlwCG1kSW+UAbX0bQ/qUqlsTvU6muVuMP8vZYHxJ3wmb\n+ufRBKztPTQ/rYWaYQcgC0RWI20HTFBMxlTAyNxYNWzX7RKFkGVVyB9RsAtmcc8g\n+j4OdosbfNoJPS0HeIfNpAznDfHKdxDk2Yc1tV6RHBrC1ynyLE9+TaflIAdo2MVv\nKLMLq51GqYKtgJFIlBRPQqKoyXdz3fGvXrTkf/WY9QNq0J1Vk5ERePZ54mN8iZB7\n9lwy/AkCgYEA6FXzosxswaJ2wQLeoYc7ceaweX/SwTvxHgXzRyJIIT0eJWgx13Wo\n/WA3Iziimsjf6qE+SI/8laxPp2A86VMaIt3Z3mJN/CqSVGw8LK2AQst+OwdPyDMu\niacE8lj/IFGC8mwNUAb9CzGU3JpU4PxxGFjS/eMtGeRXCWkK4NE+G08CgYEA1Kp9\nN2JrVlqUz+gAX+LPmE9OEMAS9WQSQsfCHGogIFDGGcNf7+uwBM7GAaSJIP01zcoe\nVAgWdzXCv3FLhsaZoJ6RyLOLay5phbu1iaTr4UNYm5WtYTzMzqh8l1+MFFDl9xDB\nvULuCIIrglM5MeS/qnSg1uMoH2oVPj9TVst/ir8CgYEAxrI7Ws9Zc4Bt70N1As+U\nlySjaEVZCMkqvHJ6TCuVZFfQoE0r0whdLdRLU2PsLFP+q7qaeZQqgBaNSKeVcDYR\n9B+nY/jOmQoPewPVsp/vQTCnE/R81spu0mp0YI6cIheT1Z9zAy322svcc43JaWB7\nmEbeqyLOP4Z4qSOcmghZBSECgYACvR9Xs0DGn+wCsW4vze/2ei77MD4OQvepPIFX\ndFZtlBy5ADcgE9z0cuVB6CiL8DbdK5kwY9pGNr8HUCI03iHkW6Zs+0L0YmihfEVe\nPG19PSzK9CaDdhD9KFZSbLyVFmWfxOt50H7YRTTiPMgjyFpfi5j2q348yVT0tEQS\nfhRqaQKBgAcWPokmJ7EbYQGeMbS7HC8eWO/RyamlnSffdCdSc7ue3zdVJxpAkQ8W\nqu80pEIF6raIQfAf8MXiiZ7auFOSnHQTXUbhCpvDLKi0Mwq3G8Pl07l+2s6dQG6T\nlv6XTQaMyf6n1yjzL+fzDrH3qXMxHMO/b13EePXpDMpY7HQpoLDi\n-----END RSA PRIVATE KEY-----\n",
          "type": "string"
        },
        "expires_on": {
          "description": "The time the custom certificate expires on.",
          "example": "2021-02-06T18:11:23.531995Z",
          "format": "date-time",
          "type": "string"
        },
        "hosts": {
          "description": "A list of Hostnames on a custom uploaded certificate.",
          "example": [
            "app.example.com",
            "*.app.example.com"
          ],
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "id": {
          "description": "Custom hostname SSL identifier tag.",
          "example": "0d89c70d-ad9f-4843-b99f-6cc0252067e9",
          "maxLength": 36,
          "minLength": 36,
          "type": "string"
        },
        "issuer": {
          "description": "The issuer on a custom uploaded certificate.",
          "example": "DigiCertInc",
          "type": "string"
        },
        "method": {
          "description": "Domain control validation (DCV) method used for this hostname.",
          "enum": [
            "http",
            "txt",
            "email"
          ],
          "example": "txt"
        },
        "serial_number": {
          "description": "The serial number on a custom uploaded certificate.",
          "example": "6743787633689793699141714808227354901",
          "type": "string"
        },
        "settings": {
          "$ref": "#/components/schemas/tls-certificates-and-hostnames_sslsettings"
        },
        "signature": {
          "description": "The signature on a custom uploaded certificate.",
          "example": "SHA256WithRSA",
          "type": "string"
        },
        "status": {
          "description": "Status of the hostname's SSL certificates.",
          "enum": [
            "initializing",
            "pending_validation",
            "deleted",
            "pending_issuance",
            "pending_deployment",
            "pending_deletion",
            "pending_expiration",
            "expired",
            "active",
            "initializing_timed_out",
            "validation_timed_out",
            "issuance_timed_out",
            "deployment_timed_out",
            "deletion_timed_out",
            "pending_cleanup",
            "staging_deployment",
            "staging_active",
            "deactivating",
            "inactive",
            "backup_issued",
            "holding_deployment"
          ],
          "example": "pending_validation",
          "readOnly": true
        },
        "type": {
          "description": "Level of validation to be used for this hostname. Domain validation (dv) must be used.",
          "enum": [
            "dv"
          ],
          "example": "dv"
        },
        "uploaded_on": {
          "description": "The time the custom certificate was uploaded.",
          "example": "2020-02-06T18:11:23.531995Z",
          "format": "date-time",
          "type": "string"
        },
        "validation_errors": {
          "description": "Domain validation errors that have been received by the certificate authority (CA).",
          "items": {
            "properties": {
              "message": {
                "description": "A domain validation error.",
                "example": "SERVFAIL looking up CAA for app.example.com",
                "type": "string"
              }
            },
            "type": "object"
          },
          "type": "array"
        },
        "validation_records": {
          "items": {
            "$ref": "#/components/schemas/tls-certificates-and-hostnames_validation_record"
          },
          "type": "array"
        },
        "wildcard": {
          "description": "Indicates whether the certificate covers a wildcard.",
          "example": false,
          "type": "boolean"
        }
      },
      "type": "object"
    }
  ],
  "type": "object"
}