Modul org.shredzone.acme4j

Package org.shredzone.acme4j

Klasse Login

java.lang.Object

org.shredzone.acme4j.Login

public class Login
extends Object

A Login into an account.

A login is bound to a Session. However, a Session can handle multiple logins in parallel.

To create a login, you need to specify the location URI of the Account, and need to provide the KeyPair the account was created with. If the account's location URL is unknown, the account can be re-registered with the AccountBuilder, using AccountBuilder.onlyExisting() to make sure that no new account will be created. If the key pair was lost though, there is no automatic way to regain access to your account, and you have to contact your CA's support hotline for assistance.

Note that Login objects are intentionally not serializable, as they contain a keypair and volatile data. On distributed systems, you can create a Login to the same account for every service instance.

Konstruktorübersicht

Konstruktoren

Konstruktor	Beschreibung
Login(URL accountLocation, KeyPair keyPair, Session session)	Creates a new Login.

Methodenübersicht

Modifizierer und Typ	Methode	Beschreibung
Authorization	bindAuthorization(URL location)	Creates a new instance of an existing Authorization and binds it to this login.
Certificate	bindCertificate(URL location)	Creates a new instance of an existing Certificate and binds it to this login.
Challenge	bindChallenge(URL location)	Creates a new instance of an existing Challenge and binds it to this login.
<C extends Challenge> C	bindChallenge(URL location, Class<C> type)	Creates a new instance of an existing Challenge and binds it to this login.
Order	bindOrder(URL location)	Creates a new instance of an existing Order and binds it to this login.
RenewalInfo	bindRenewalInfo(URL location)	Creates a new instance of an existing RenewalInfo and binds it to this login.
RenewalInfo	bindRenewalInfo(X509Certificate certificate)	Creates a new instance of an existing RenewalInfo and binds it to this login.
Challenge	createChallenge(JSON data)	Creates a Challenge instance for the given challenge data.
Account	getAccount()	Gets the Account that is bound to this login.
URL	getAccountLocation()	Gets the location URL of the account.
KeyPair	getKeyPair()	Gets the KeyPair of the ACME account.
Session	getSession()	Gets the Session that is used.
OrderBuilder	newOrder()	Creates a builder for a new Order.
protected void	setKeyPair(KeyPair keyPair)	Sets a different KeyPair.

Von Klasse geerbte Methoden java.lang.Object

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

Konstruktordetails

Login

public Login(URL accountLocation,
 KeyPair keyPair,
 Session session)

Creates a new Login.

Parameter:

accountLocation - Account location URL

keyPair - KeyPair of the account

session - Session to be used

Methodendetails

getSession

public Session getSession()

Gets the Session that is used.

getKeyPair

public KeyPair getKeyPair()

Gets the KeyPair of the ACME account.

getAccountLocation

public URL getAccountLocation()

Gets the location URL of the account.

getAccount

public Account getAccount()

Gets the Account that is bound to this login.

Gibt zurück:

Account bound to the login

bindAuthorization

public Authorization bindAuthorization(URL location)

Creates a new instance of an existing Authorization and binds it to this login.

Parameter:

location - Location of the Authorization

Gibt zurück:

Authorization bound to the login

bindCertificate

public Certificate bindCertificate(URL location)

Creates a new instance of an existing Certificate and binds it to this login.

Parameter:

location - Location of the Certificate

Gibt zurück:

Certificate bound to the login

bindOrder

public Order bindOrder(URL location)

Creates a new instance of an existing Order and binds it to this login.

Parameter:

location - Location URL of the order

Gibt zurück:

Order bound to the login

bindRenewalInfo

public RenewalInfo bindRenewalInfo(URL location)

Creates a new instance of an existing RenewalInfo and binds it to this login.

Parameter:

location - Location URL of the renewal info

Gibt zurück:

RenewalInfo bound to the login

Seit:

3.0.0

bindRenewalInfo

public RenewalInfo bindRenewalInfo(X509Certificate certificate)
                            throws AcmeException

Creates a new instance of an existing RenewalInfo and binds it to this login.

Parameter:

certificate - X509Certificate to get the RenewalInfo for

Gibt zurück:

RenewalInfo bound to the login

Löst aus:

AcmeException

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.

bindChallenge

public Challenge bindChallenge(URL location)

Creates a new instance of an existing Challenge and binds it to this login. Use this method only if the resulting challenge type is unknown.

Parameter:

location - Location URL of the challenge

Gibt zurück:

Challenge bound to the login

Seit:

2.8

Siehe auch:

• bindChallenge(URL, Class)

bindChallenge

public <C extends Challenge> C bindChallenge(URL location,
 Class<C> type)

Creates a new instance of an existing Challenge and binds it to this login. Use this method if the resulting challenge type is known.

Parameter:

location - Location URL of the challenge

type - Expected challenge type

Gibt zurück:

Challenge bound to the login

Löst aus:

AcmeProtocolException - if the challenge found at the location does not match the expected challenge type.

Seit:

2.12

createChallenge

public Challenge createChallenge(JSON data)

Creates a Challenge instance for the given challenge data.

Parameter:

data - Challenge JSON data

Gibt zurück:

Challenge instance

newOrder

public OrderBuilder newOrder()

Creates a builder for a new Order.

Gibt zurück:

OrderBuilder object

Seit:

3.0.0

setKeyPair

protected void setKeyPair(KeyPair keyPair)

Sets a different KeyPair. The new key pair is only used locally in this instance, but is not set on server side!