Modul org.shredzone.acme4j
Package org.shredzone.acme4j

Klasse OrderBuilder

java.lang.Object
org.shredzone.acme4j.OrderBuilder
public class OrderBuilder extends Object
Start a new certificate Order.

Use Login.newOrder() or Account.newOrder() to create a new OrderBuilder instance. Both methods are identical.

  • Konstruktordetails

  • Methodendetails

    • domain

      public OrderBuilder domain(String domain)
      Adds a domain name to the order.
      Parameter:
      domain - Name of a domain to be ordered. May be a wildcard domain if supported by the CA. IDN names are accepted and will be ACE encoded automatically.
      Gibt zurück:
      itself

    • domains

      public OrderBuilder domains(String... domains)
      Adds domain names to the order.
      Parameter:
      domains - Collection of domain names to be ordered. May be wildcard domains if supported by the CA. IDN names are accepted and will be ACE encoded automatically.
      Gibt zurück:
      itself

    • domains

      public OrderBuilder domains(Collection<String> domains)
      Adds a collection of domain names to the order.
      Parameter:
      domains - Collection of domain names to be ordered. May be wildcard domains if supported by the CA. IDN names are accepted and will be ACE encoded automatically.
      Gibt zurück:
      itself

    • identifier

      public OrderBuilder identifier(Identifier identifier)
      Adds an Identifier to the order.
      Parameter:
      identifier - Identifier to be added to the order.
      Gibt zurück:
      itself
      Seit:
      2.3

    • identifiers

      public OrderBuilder identifiers(Collection<Identifier> identifiers)
      Adds a collection of Identifier to the order.
      Parameter:
      identifiers - Collection of Identifier to be added to the order.
      Gibt zurück:
      itself
      Seit:
      2.3

    • notBefore

      public OrderBuilder notBefore(Instant notBefore)
      Sets a "not before" date in the certificate. May be ignored by the CA.
      Parameter:
      notBefore - "not before" date
      Gibt zurück:
      itself

    • notAfter

      public OrderBuilder notAfter(Instant notAfter)
      Sets a "not after" date in the certificate. May be ignored by the CA.
      Parameter:
      notAfter - "not after" date
      Gibt zurück:
      itself

    • autoRenewal

      public OrderBuilder autoRenewal()
      Enables short-term automatic renewal of the certificate, if supported by the CA.

      Automatic renewals cannot be combined with notBefore(Instant) or notAfter(Instant).

      Gibt zurück:
      itself
      Seit:
      2.3

    • autoRenewalStart

      public OrderBuilder autoRenewalStart(Instant start)
      Sets the earliest date of validity of the first issued certificate. If not set, the start date is the earliest possible date.

      Implies autoRenewal().

      Parameter:
      start - Start date of validity
      Gibt zurück:
      itself
      Seit:
      2.3

    • autoRenewalEnd

      public OrderBuilder autoRenewalEnd(Instant end)
      Sets the latest date of validity of the last issued certificate. If not set, the CA's default is used.

      Implies autoRenewal().

      Parameter:
      end - End date of validity
      Gibt zurück:
      itself
      Seit:
      2.3
      Siehe auch:

    • autoRenewalLifetime

      public OrderBuilder autoRenewalLifetime(Duration duration)
      Sets the maximum validity period of each certificate. If not set, the CA's default is used.

      Implies autoRenewal().

      Parameter:
      duration - Duration of validity of each certificate
      Gibt zurück:
      itself
      Seit:
      2.3
      Siehe auch:

    • autoRenewalLifetimeAdjust

      public OrderBuilder autoRenewalLifetimeAdjust(Duration duration)
      Sets the amount of pre-dating each certificate. If not set, the CA's default (0) is used.

      Implies autoRenewal().

      Parameter:
      duration - Duration of certificate pre-dating
      Gibt zurück:
      itself
      Seit:
      2.7

    • autoRenewalEnableGet

      public OrderBuilder autoRenewalEnableGet()
      Announces that the client wishes to fetch the auto-renewed certificate via GET request. If not used, the STAR certificate can only be fetched via POST-as-GET request. Metadata.isAutoRenewalGetAllowed() must return true in order for this option to work.

      This option is only needed if you plan to fetch the STAR certificate via other means than by using acme4j. acme4j is fetching certificates via POST-as-GET request.

      Implies autoRenewal().

      Gibt zurück:
      itself
      Seit:
      2.6

    • profile

      public OrderBuilder profile(String profile)
      Notifies the CA of the desired profile of the ordered certificate.

      Optional, only supported if the CA supports profiles. However, in this case the client may include this field.

      Parameter:
      profile - Identifier of the desired profile
      Gibt zurück:
      itself
      Seit:
      3.5.0
      Draft:
      This method is currently based on RFC draft draft-aaron-acme-profiles. It may be changed or removed without notice to reflect future changes to the draft. SemVer rules do not apply here.

    • replaces

      public OrderBuilder replaces(String uniqueId)
      Notifies the CA that the ordered certificate will replace a previously issued certificate. The certificate is identified by its ARI unique identifier.

      Optional, only supported if the CA provides renewal information. However, in this case the client should include this field.

      Parameter:
      uniqueId - Certificate's renewal unique identifier.
      Gibt zurück:
      itself
      Seit:
      3.2.0
      Draft:
      This method is currently based on an RFC draft. It may be changed or removed without notice to reflect future changes to the draft. SemVer rules do not apply here.

    • replaces

      public OrderBuilder replaces(X509Certificate certificate)
      Notifies the CA that the ordered certificate will replace a previously issued certificate.

      Optional, only supported if the CA provides renewal information. However, in this case the client should include this field.

      Parameter:
      certificate - Certificate to be replaced
      Gibt zurück:
      itself
      Seit:
      3.2.0
      Draft:
      This method is currently based on an RFC draft. It may be changed or removed without notice to reflect future changes to the draft. SemVer rules do not apply here.

    • replaces

      public OrderBuilder replaces(Certificate certificate)
      Notifies the CA that the ordered certificate will replace a previously issued certificate.

      Optional, only supported if the CA provides renewal information. However, in this case the client should include this field.

      Parameter:
      certificate - Certificate to be replaced
      Gibt zurück:
      itself
      Seit:
      3.2.0
      Draft:
      This method is currently based on an RFC draft. It may be changed or removed without notice to reflect future changes to the draft. SemVer rules do not apply here.

    • create

      public Order create() throws AcmeException
      Sends a new order to the server, and returns an Order object.
      Gibt zurück:
      Order that was created
      Löst aus:
      AcmeException