org.shredzone.acme4j

Class ClientTest

java.lang.Object

org.shredzone.acme4j.ClientTest

public class ClientTest
extends Object

A simple client test tool.

Pass the names of the domains as parameters.

Constructor Summary

Constructors

Constructor and Description
ClientTest()

Method Summary

Modifier and Type	Method and Description
void	acceptAgreement(Registration reg, URI agreement) Presents the user a link to the Terms of Service, and asks for confirmation.
void	acceptChallenge(String message) Presents the instructions for preparing the challenge validation, and waits for dismissal.
Challenge	dnsChallenge(Authorization auth, String domain) Prepares a DNS challenge.
void	fetchCertificate(Collection<String> domains) Generates a certificate for the given domains.
Challenge	httpChallenge(Authorization auth, String domain) Prepares a HTTP challenge.
static void	main(String... args) Invokes this example.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ClientTest

public ClientTest()

Method Detail

fetchCertificate

public void fetchCertificate(Collection<String> domains)
                      throws IOException,
                             AcmeException

Generates a certificate for the given domains. Also takes care for the registration process.

Parameters:

domains - Domains to get a common certificate for

Throws:

IOException

AcmeException

httpChallenge

public Challenge httpChallenge(Authorization auth,
                               String domain)
                        throws AcmeException

Prepares a HTTP challenge.

The verification of this challenge expects a file with a certain content to be reachable at a given path under the domain to be tested.

This example outputs instructions that need to be executed manually. In a production environment, you would rather generate this file automatically, or maybe use a servlet that returns Http01Challenge.getAuthorization().

Parameters:

auth - Authorization to find the challenge in

domain - Domain name to be authorized

Returns:

Challenge to verify

Throws:

AcmeException

dnsChallenge

public Challenge dnsChallenge(Authorization auth,
                              String domain)
                       throws AcmeException

Prepares a DNS challenge.

The verification of this challenge expects a TXT record with a certain content.

This example outputs instructions that need to be executed manually. In a production environment, you would rather configure your DNS automatically.

Parameters:

auth - Authorization to find the challenge in

domain - Domain name to be authorized

Returns:

Challenge to verify

Throws:

AcmeException

acceptChallenge

public void acceptChallenge(String message)
                     throws AcmeException

Presents the instructions for preparing the challenge validation, and waits for dismissal. If the user cancelled the dialog, an exception is thrown.

Parameters:

message - Instructions to be shown in the dialog

Throws:

AcmeException

acceptAgreement

public void acceptAgreement(Registration reg,
                            URI agreement)
                     throws AcmeException

Presents the user a link to the Terms of Service, and asks for confirmation. If the user denies confirmation, an exception is thrown.

Parameters:

reg - Registration User's registration

agreement - URI of the Terms of Service

Throws:

AcmeException

main

public static void main(String... args)

Invokes this example.

Parameters:

args - Domains to get a certificate for