Configuring Emails for Self-Service Registration
To configure emails for self-service registration, you can add the following code block to the selfservice-registration.json
file:
{
"name" : "emailValidation",
"identityEmailField" : "mail",
"emailServiceUrl" : "external/email",
"emailServiceParameters" : {
"waitForCompletion" : false
},
"from" : "info@example.com",
"subject" : "Register new account",
"mimeType" : "text/html",
"subjectTranslations" : {
"en" : "Register new account",
"fr" : "Créer un nouveau compte"
},
"messageTranslations" : {
"en" : "<h3>This is your registration email.</h3><h4><a href=\"%link%\">Email verification link</a></h4>",
"fr" : "<h3>Ceci est votre mail d'inscription.</h3><h4><a href=\"%link%\">Lien de vérification email</a></h4>"
},
"verificationLinkToken" : "%link%",
"verificationLink" : "https://localhost:8443/#/registration/"
},
As suggested by the code block, it includes default registration email messages in English (en
) and French (fr
). The verificationLink
sent with the email takes users to the IDM self-registration URL.
As noted in "Managing User Self-Registration Over REST", you can make these changes over the following endpoint URI: /openidm/config/selfservice/registration
If desired, you can also configure self-service registration emails through the Admin UI. Select Configure > User Registration. If needed, activate the Enable User Registration Option. Under the Options tab, in the Email Validation box, select the icon. The Configure Validation Email pop-up should appear.
When you use the Admin UI to customize self-registration emails, you can review the changes in the selfservice-registration.json
file.