com.atlassian.confluence.user
Interface SignupManager

All Known Implementing Classes:

DefaultSignupManager

public interface SignupManager

Provides methods for adding users easily.

Since:

4.1

Method Summary

boolean	canSignUpWith(String token) Return true if the given token is valid for a user to self-sign-up.
String	createUserPendingConfirmation(com.atlassian.user.User user, String passw) Creates a new user and marks her disabled pending her email confirmation?
boolean	doesUserHaveOutdatedSignupToken(com.atlassian.user.User user)
void	enableConfirmedUser(com.atlassian.user.User user) Enable previously disabled user who signed up and confirmed her email.
String	getRelativeSignupURL()
String	getRestrictedDomains() Returns comma separated list of domains.
String	getSignUpToken() Gets the current sign-up token, or creates a new one and returns it.
String	getSignupURL()
boolean	isDomainRestrictedSignupEnabled()
boolean	isEmailSentOnInviteSignUp()
boolean	isPendingConfirmation(com.atlassian.user.User user) Is given user tried to sign up but hasn't confirmed her email yet?
boolean	isPublicSignupPermitted() Returns true if users can sign themselves for this instance.
boolean	isTokenForUserValid(com.atlassian.user.User user, String token)
String	refreshAndGetToken() Creates a new sign-up token and returns it.
String	restorePreviousToken() Restore the previous private-signup token and returns it.
NotificationSendResult	sendInvites(SendUserInviteEvent event) Send invitation emails with a message to a list of email addresses.
void	setDomainRestrictedSignupMode(String allowedDomains) Set the domains that user's email address should belong to to be able to sign up.
void	setEmailSentOnInviteSignUp(boolean notify)
void	setPrivateSignupMode()
void	setPublicSignupMode()

Method Detail

getSignUpToken

String getSignUpToken()

Gets the current sign-up token, or creates a new one and returns it.

Returns:

a random sign-up token

canSignUpWith

boolean canSignUpWith(String token)

Return true if the given token is valid for a user to self-sign-up.

Parameters:

token - a sign-up token from a URL given to an invited user

refreshAndGetToken

String refreshAndGetToken()

Creates a new sign-up token and returns it. This invalidates the previous token.

Returns:

a random sign-up token

isEmailSentOnInviteSignUp

boolean isEmailSentOnInviteSignUp()

Returns:

true if notification emails should be sent to admins when a user signs themselves up.

setEmailSentOnInviteSignUp

void setEmailSentOnInviteSignUp(boolean notify)

Parameters:

notify - true if notification emails should be sent to admins when a user signs themselves up, false if not

restorePreviousToken

String restorePreviousToken()

Restore the previous private-signup token and returns it.

getSignupURL

String getSignupURL()

getRelativeSignupURL

String getRelativeSignupURL()

isPublicSignupPermitted

boolean isPublicSignupPermitted()

Returns true if users can sign themselves for this instance.

sendInvites

NotificationSendResult sendInvites(SendUserInviteEvent event)

Send invitation emails with a message to a list of email addresses.

Returns:

the number of emails sent

setPublicSignupMode

void setPublicSignupMode()

setPrivateSignupMode

void setPrivateSignupMode()

setDomainRestrictedSignupMode

void setDomainRestrictedSignupMode(String allowedDomains)

Set the domains that user's email address should belong to to be able to sign up.

Parameters:

allowedDomains - comma separated list of domains

getRestrictedDomains

String getRestrictedDomains()

Returns comma separated list of domains. Users with email in those domains are allowed to sign up. Provided domain restricted sign up is enabled.

Returns:

comma separated list of domains

isPendingConfirmation

boolean isPendingConfirmation(com.atlassian.user.User user)

Is given user tried to sign up but hasn't confirmed her email yet?

Parameters:

user -

Returns:

true if the given user tried to sign up but hasn't confirmed her email yet.

createUserPendingConfirmation

String createUserPendingConfirmation(com.atlassian.user.User user,
                                     String passw)
                                     throws com.atlassian.crowd.exception.runtime.OperationFailedException,
                                            com.atlassian.crowd.exception.InvalidUserException,
                                            com.atlassian.crowd.exception.InvalidCredentialException,
                                            com.atlassian.crowd.exception.OperationNotPermittedException

Creates a new user and marks her disabled pending her email confirmation?

Parameters:

user -

passw -

Returns:

the token that the user must validate against in order to confirm her email

Throws:

com.atlassian.crowd.exception.runtime.OperationFailedException

com.atlassian.crowd.exception.InvalidUserException

com.atlassian.crowd.exception.InvalidCredentialException

com.atlassian.crowd.exception.OperationNotPermittedException

enableConfirmedUser

void enableConfirmedUser(com.atlassian.user.User user)
                         throws com.atlassian.crowd.exception.runtime.UserNotFoundException,
                                com.atlassian.crowd.exception.runtime.OperationFailedException,
                                com.atlassian.crowd.exception.InvalidUserException,
                                com.atlassian.crowd.exception.OperationNotPermittedException

Enable previously disabled user who signed up and confirmed her email.

Parameters:

user -

Throws:

com.atlassian.crowd.exception.runtime.UserNotFoundException

com.atlassian.crowd.exception.runtime.OperationFailedException

com.atlassian.crowd.exception.InvalidUserException

com.atlassian.crowd.exception.OperationNotPermittedException

isTokenForUserValid

boolean isTokenForUserValid(com.atlassian.user.User user,
                            String token)

Parameters:

user -

token -

Returns:

true if given token a valid token that was issued when the given user tried to signup

doesUserHaveOutdatedSignupToken

boolean doesUserHaveOutdatedSignupToken(com.atlassian.user.User user)

Parameters:

user -

Returns:

true if a given user has tried to sign up but hasn't confirmed her email within a reasonable time (1 month)

isDomainRestrictedSignupEnabled

boolean isDomainRestrictedSignupEnabled()

Returns:

true if sign up is enabled only for some specified domains