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

Schnittstelle AcmeProvider

Alle bekannten Implementierungsklassen:
AbstractAcmeProvider, GenericAcmeProvider
public interface AcmeProvider
An AcmeProvider provides methods to be used for communicating with the ACME server. Implementations handle individual features of each ACME server.

Provider implementations must be registered with Java's ServiceLoader.

  • Methodendetails

    • accepts

      boolean accepts(URI serverUri)
      Checks if this provider accepts the given server URI.
      Parameter:
      serverUri - Server URI to test
      Gibt zurück:
      true if this provider accepts the server URI, false otherwise

    • resolve

      URL resolve(URI serverUri)
      Resolves the server URI and returns the matching directory URL.
      Parameter:
      serverUri - Server URI
      Gibt zurück:
      Resolved directory URL
      Löst aus:
      IllegalArgumentException - if the server URI is not accepted

    • connect

      Connection connect(URI serverUri, NetworkSettings networkSettings)
      Creates a Connection for communication with the ACME server.
      Parameter:
      serverUri - Server URI
      networkSettings - NetworkSettings to be used for the connection
      Gibt zurück:
      Connection that was generated

    • directory

      @Nullable JSON directory(Session session, URI serverUri) throws AcmeException
      Returns the provider's directory. The structure must contain resource URLs, and may optionally contain metadata.

      The default implementation resolves the server URI and fetches the directory via HTTP request. Subclasses may override this method, e.g. if the directory is static.

      Parameter:
      session - Session to be used
      serverUri - Server URI
      Gibt zurück:
      Directory data, as JSON object, or null if the directory has not been changed since the last request.
      Löst aus:
      AcmeException

    • createChallenge

      @Nullable Challenge createChallenge(Login login, JSON data)
      Creates a Challenge instance for the given challenge data.
      Parameter:
      login - Login to bind the challenge to
      data - Challenge JSON data
      Gibt zurück:
      Challenge instance, or null if this provider is unable to generate a matching Challenge instance.

    • getProposedEabMacAlgorithm

      default Optional<String> getProposedEabMacAlgorithm()
      Returns a proposal for the EAB MAC algorithm to be used. Only set if the CA requires External Account Binding and the MAC algorithm cannot be correctly derived from the MAC key. Empty otherwise.
      Gibt zurück:
      Proposed MAC algorithm to be used for EAB, or empty for the default behavior.
      Seit:
      3.5.0