Dev Portal SMTP Configuration

The following property reference outlines each email and email variable used by the Dev Portal to send emails to Kong admins and developers.

These settings can be modified in the Kong Manager under the Dev Portal Settings / Email tab, or by running the following command:

  1. curl http://localhost:8001/workspaces/<WORKSPACE_NAME> \
  2. --data "config.<PROPERTY_NAME>=off"

If they are not modified manually, the Dev Portal will use the default value defined in the Kong Configuration file.

In 1.3.0.1 or greater, Dev Portal email content and styling can be customized via template files

portal_invite_email

Default: on

Description: When enabled, Kong admins will be able to invite developers to a Dev Portal by using the Invite button in the Kong Manager.

Email:

  1. Subject: Invite to access Dev Portal <WORKSPACE_NAME>
  2. Hello Developer!
  3. You have been invited to create a Dev Portal account at %s.
  4. Please visit `<DEV_PORTAL_URL/register>` to create your account.

portal_email_verification

Default: off

Description: When enabled, developers will receive an email upon registration to verify their account. Developers will not be able to use the Dev Portal until their account is verified, even if auto-approve is enabled.

portal_access_request_email

Default: on

Description: When enabled, Kong Admins specified by smtp_admin_emails will receive an email when a Developer requests access to a Dev Portal.

  1. Subject: Request to access Dev Portal <WORKSPACE NAME>
  2. Hello Admin!
  3. <DEVELOPER NAME> has requested Dev Portal access for <WORKSPACE_NAME>.
  4. Please visit <KONG_MANAGER_URL/developers/requested> to review this request.

portal_approved_email

Default: on

Description: When enabled, developers will receive an email when access to a Dev Portal has been approved.

  1. Subject: Dev Portal access approved
  2. Hello Developer!
  3. You have been approved to access <WORKSPACE_NAME>.
  4. Please visit <DEV PORTAL URL/login> to login.

portal_reset_email

Default: on

Description: When enabled, developers will be able to use the Reset Password flow on a Dev Portal and will receive an email with password reset instructions.

When disabled, developers will not be able to reset their account passwords.

  1. Subject: Password Reset Instructions for Dev Portal <WORKSPACE_NAME>.
  2. Hello Developer,
  3. Please click the link below to reset your Dev Portal password.
  4. <DEV_PORTAL_URL/reset?token=12345>
  5. This link will expire in <portal_reset_token_exp>
  6. If you didn't make this request, keep your account secure by clicking
  7. the link above to change your password.

portal_reset_success_email

Default: on

Description: When enabled, developers will receive an email after successfully reseting their Dev Portal account password.

When disabled, developers will still be able to reset their account passwords, but will not receive a confirmation email.

  1. Subject: Dev Portal password change success
  2. Hello Developer,
  3. We are emailing you to let you know that your Dev Portal password at <DEV_PORTAL_URL> has been changed.
  4. Click the link below to sign in with your new credentials.
  5. <DEV_PORTAL_URL>

portal_emails_from

Default: nil

Description: The name and email address for the ‘From’ header included in all Dev Portal emails.

Example :

  1. portal_emails_from = Your Name <example@example.com>

portal_emails_reply_to

Default: nil

Description: The email address for the ‘Reply-To’ header included in all Dev Portal emails.

Example :

  1. portal_emails_reply_to: noreply@example.com