Email Service Configuration
Urban Strategy uses email for user authentication tasks, including account verification and password resets. These interactions are triggered via automated links sent directly to the user's registered email address.
Configuration Overview
All email settings are managed in the following configuration file on the server: core/auth/auth.ini
Urban Strategy utilizes a Mailkit-based package, allowing for flexible integration with local SMTP servers, external providers, or Azure services.
Configuration Options
Update the [settings] section of auth.ini using the parameters below.
General Settings
| Parameter | Description | Default |
|---|---|---|
| MailFromName | The display name shown to recipients. | Urban Strategy |
| MailFromAddress | The sender email address. | support@scenexus.com |
SMTP Settings (Standard Providers)
| Parameter | Description |
|---|---|
| MailHost | The hostname of your SMTP server (e.g., smtp.gmail.com). |
| MailPort | Port number. Use 0 to attempt defaults (e.g., 25). |
| MailSecureOption | 0: None, 1: Auto, 2: SSL, 3: StartTLS, 4: StartTLS (if available). |
| MailAuthenticateUser | SMTP username. |
| MailAuthenticatePassword | SMTP password. |
Azure Email Settings
Note: Defining these parameters will override standard SMTP settings.
| Parameter | Description |
|---|---|
| MailAzureTenantID | Directory (tenant) ID from Azure. |
| MailAzureClientID | Application (client) ID from Azure. |
| MailAzureClientSecret | The generated App Secret. |
| AzureSendEmailTimeOutMS | Timeout in milliseconds (Default: 15000). |
Configuration Examples
1. Local SMTP Server
The simplest setup, assuming a local smart host is enabled.
[settings]
MailHost=localhost
2. Google / Gmail
[settings]
MailHost=smtp.gmail.com
MailPort=465
MailSecureOption=2
MailAuthenticateUser=your_email@gmail.com
MailAuthenticatePassword=your_app_password
3. Microsoft Azure
[settings]
MailAzureTenantID=053d0b7a-04b7-4a52-aa7d-fdc2e1f8b242
MailAzureClientID=c1d9b6be-5c81-4c5c-befc-6542dd40a0a3
MailAzureClientSecret=Kk3^53jh349*i3hjHhj23k2osufj3*01378&3^54