Interface IMailHandler
-
- All Superinterfaces:
IAPIHandler
,Serializable
- All Known Implementing Classes:
MailHandler
public interface IMailHandler extends IAPIHandler
- Author:
- XIMA MEDIA GmbH
-
-
Method Summary
All Methods Instance Methods Abstract Methods Deprecated Methods Modifier and Type Method Description boolean
sendClientMail(Mandant client, IBaseMailData mailData)
Sends an email as the given clientboolean
sendEmailVerificationMail(UserContext uc, UserEmail email, String baseUrl)
Sends a mail with a user email verification linkboolean
sendFeedbackMail(UserContext uc, Mandant client, IFeedbackMailData feedbackMailData)
Send a feedback mail from the given client.boolean
sendInviteMail(UserContext uc, Vorgang vorgang, String mailTo, DefaultReplacerParameters params)
boolean
sendLoginChanged(UserContext uc, Benutzer benuter, String passwort)
Deprecated.boolean
sendOptInMail(UserContext uc, Vorgang vorgang)
Send a feedback mail from the given client.boolean
sendPrimaryEmailChangeMail(UserContext uc, UserEmail email, String baseUrl)
Sends a mail with a link to change the primary email of the user profile to theUserEmail
given.boolean
sendResetPasswordMail(UserContext uc, Benutzer user, String url)
Deprecated.boolean
sendSupportMail(UserContext uc, Mandant client, ISupportInquiryData supportInquiryData)
Send a support mail from the given client.boolean
sendUserCredentialsResetMail(UserContext uc, UserProfile profile, String baseUrl, String verifiedTargetEmailAddress)
Sends a mail with a user credentials set/reset link.boolean
sendUserIdentityConnectedMail(UserContext uc, UserIdentity identity, String connectorEmail, Instant isntant, String remoteAddr, String userAgent, String baseUrl)
Sends a mail informing the user profile owner about the connection of a newaccount
with the option to remove the account.boolean
sendUserIdentityRemovalMail(UserContext uc, UserIdentity identity, String baseUrl)
Sends a mail with a link to remove the given user identity to the primaryUserEmail
of the identity's profile.boolean
sendUserMfaEmailCodeMail(IUser user, Locale defaultLocale)
Sends a mail with an MFA code.boolean
sendUserMfaRemovalMail(UserContext uc, UserProfileMfa mfaConfig, String baseUrl)
Sends a mail with an MFA removal link to the users primary email address.boolean
sendUserMfaTotpRegistrationMail(UserContext uc, UserProfileMfa mfaConfig, String baseUrl)
Sends a mail with an MFA TOTP registration link to the users primary email address.boolean
sendUserProfileDeleteRequestMail(UserContext uc, UserProfile userProfile, String baseUrl)
Sends a mail with a user profile delete request containing a link to delete the user profile.boolean
sendUserProfileMergeRequestMail(UserContext uc, UserProfile userProfile, UserProfile toBeMerged, String baseUrl)
Sends a mail with a user profile merge link.-
Methods inherited from interface de.xima.fc.com.interfaces.IAPIHandler
getName
-
-
-
-
Method Detail
-
sendClientMail
boolean sendClientMail(Mandant client, IBaseMailData mailData)
Sends an email as the given client- Parameters:
client
-Mandant
sending the emailmailData
-IBaseMailData
content of the mail- Returns:
Boolean
whether or not the email could be sent successfully- Since:
- 6.0.0
-
sendSupportMail
boolean sendSupportMail(UserContext uc, Mandant client, ISupportInquiryData supportInquiryData)
Send a support mail from the given client. If no client is given tries using the system mail settings- Parameters:
uc
-UserContext
the user context in which the action is to be performed.client
-Mandant
for which to send the mailsupportInquiryData
-SupportInquiryData
containing support inquiry information- Returns:
- Whether or not the email was sent successfully
- Since:
- 6.0.0
-
sendFeedbackMail
boolean sendFeedbackMail(UserContext uc, Mandant client, IFeedbackMailData feedbackMailData)
Send a feedback mail from the given client. If no client is given, attempt to use the system mail settings.- Parameters:
uc
-UserContext
the user context in which the action is to be performed.client
-Mandant
for which to send the mailfeedbackMailData
-IFeedbackMailData
containing feedback information- Returns:
- Whether or not the email was sent successfully
- Since:
- 6.0.0
-
sendOptInMail
boolean sendOptInMail(UserContext uc, Vorgang vorgang)
Send a feedback mail from the given client. If no client is given, attempt to use the system mail settings.- Parameters:
uc
-UserContext
the user context in which the action is to be performed.vorgang
-Vorgang
for which to send the mail- Returns:
- Whether or not the email was sent successfully
- Since:
- 6.0.0
-
sendInviteMail
boolean sendInviteMail(UserContext uc, Vorgang vorgang, String mailTo, DefaultReplacerParameters params)
-
sendUserCredentialsResetMail
boolean sendUserCredentialsResetMail(UserContext uc, UserProfile profile, String baseUrl, String verifiedTargetEmailAddress)
Sends a mail with a user credentials set/reset link. The mail will be send to the users primary email address.- Parameters:
uc
-UserContext
to use.profile
- for which to send the credentials mail.baseUrl
- base URL to use when building the credentials mail.verifiedTargetEmailAddress
- email address that should receive the user credentials reset request. This email needs to exists in the given user profile and it needs to be verified. A user credentials reset mail cannot be send otherwise!- Returns:
- Whether or not an email was sent successfully.
- Since:
- 8.0.0
-
sendEmailVerificationMail
boolean sendEmailVerificationMail(UserContext uc, UserEmail email, String baseUrl)
Sends a mail with a user email verification link- Parameters:
uc
-UserContext
to use.email
- Email to send the verification request to.baseUrl
- base URL to use when building the verification URL- Returns:
- Whether or not an email was sent successfully.
- Since:
- 8.0.0
-
sendPrimaryEmailChangeMail
boolean sendPrimaryEmailChangeMail(UserContext uc, UserEmail email, String baseUrl)
Sends a mail with a link to change the primary email of the user profile to theUserEmail
given.- Parameters:
uc
-UserContext
to use.email
- Email to send the verification request to and change to primary mail.baseUrl
- base URL to use when building the verification URL- Returns:
- Whether or not an email was sent successfully.
- Since:
- 8.0.0
-
sendUserIdentityConnectedMail
boolean sendUserIdentityConnectedMail(UserContext uc, UserIdentity identity, String connectorEmail, Instant isntant, String remoteAddr, String userAgent, String baseUrl)
Sends a mail informing the user profile owner about the connection of a newaccount
with the option to remove the account.- Parameters:
uc
-UserContext
to use.identity
- that has been connected to the user profileconnectorEmail
- that was used to connect the identity with the user profileisntant
- when the connection was maderemoteAddr
- of the client that triggered the connectionuserAgent
- of the client that triggered the connectionbaseUrl
- base URL to use when building URLs- Returns:
- Whether or not an email was sent successfully.
- Since:
- 8.0.0
-
sendUserIdentityRemovalMail
boolean sendUserIdentityRemovalMail(UserContext uc, UserIdentity identity, String baseUrl)
Sends a mail with a link to remove the given user identity to the primaryUserEmail
of the identity's profile.- Parameters:
uc
-UserContext
to use.identity
- Identity to send the removal request for.baseUrl
- base URL to use when building the verification URL- Returns:
- Whether or not an email was sent successfully.
- Since:
- 8.0.0
-
sendUserProfileMergeRequestMail
boolean sendUserProfileMergeRequestMail(UserContext uc, UserProfile userProfile, UserProfile toBeMerged, String baseUrl)
Sends a mail with a user profile merge link.- Parameters:
uc
-UserContext
to use.userProfile
- user profile that will receive the merge request via email.toBeMerged
- user profile that should be merged into the profile that will receive the merge request.baseUrl
- base URL to use when building the merge URL.- Returns:
- Whether or not an email was sent successfully.
- Since:
- 8.0.0
-
sendUserProfileDeleteRequestMail
boolean sendUserProfileDeleteRequestMail(UserContext uc, UserProfile userProfile, String baseUrl)
Sends a mail with a user profile delete request containing a link to delete the user profile.- Parameters:
uc
-UserContext
to use.userProfile
- to be deleted.baseUrl
- base URL to use when building the delete URL.- Returns:
true
if the mail has been send successfully andfalse
otherwise.- Since:
- 8.0.0
-
sendUserMfaTotpRegistrationMail
boolean sendUserMfaTotpRegistrationMail(UserContext uc, UserProfileMfa mfaConfig, String baseUrl)
Sends a mail with an MFA TOTP registration link to the users primary email address.- Parameters:
uc
-UserContext
to use.mfaConfig
- to send MFA registration mail for.baseUrl
- base URL to use when building the registration URL- Returns:
- Whether or not an email was sent successfully.
- Since:
- 8.0.0
-
sendUserMfaRemovalMail
boolean sendUserMfaRemovalMail(UserContext uc, UserProfileMfa mfaConfig, String baseUrl)
Sends a mail with an MFA removal link to the users primary email address. Is intended for users to confirm the removal of the MFA from their account.- Parameters:
uc
-UserContext
to use.mfaConfig
- to send MFA removal mail for.baseUrl
- base URL to use when building the removal URL- Returns:
- Whether or not an email was sent successfully.
- Since:
- 8.0.0
-
sendUserMfaEmailCodeMail
boolean sendUserMfaEmailCodeMail(IUser user, Locale defaultLocale)
Sends a mail with an MFA code. This is for MFAs of typeEMultiFactorAuthenticationType.EMAIL
.- Parameters:
user
- to send email with authentication code to.defaultLocale
- locale to use for localization of the email message if the user does not have a default locale.- Returns:
- Whether or not an email was sent successfully.
- Since:
- 8.0.0
-
sendLoginChanged
@Deprecated boolean sendLoginChanged(UserContext uc, Benutzer benuter, String passwort)
Deprecated.Send login changed.- Parameters:
benuter
- User whose login should be changed.passwort
- The new password.- Returns:
- Whether the login could be changes successfully.
-
sendResetPasswordMail
@Deprecated boolean sendResetPasswordMail(UserContext uc, Benutzer user, String url)
Deprecated.Sends an email to theBenutzer
for resetting their password- Parameters:
uc
-UserContext
in which the operation should be performeduser
-Benutzer
which should receive the emailurl
-String
url for resetting the password- Returns:
Boolean
whether the operation was successful or not
-
-