General Settings Configuration

Database connections, multilingual support, email configuration, and Google Fonts integration

Database Settings

Database configuration controls the data storage backend and initialization options for IdentitySuite. Multiple database providers are supported with flexible connection string management.

Supported Database Providers:

SqlServerConnection: Microsoft SQL Server database provider. Recommended for Windows environments and Azure cloud deployments.
PostgreSqlConnection: PostgreSQL database provider. Open-source option, excellent for Linux deployments and cross-platform scenarios.
MySqlConnection: MySQL database provider. Popular choice for web applications and shared hosting environments.

Connection String Examples:

SQL Server:
copy
Server=localhost;Database=IdentitySuite;User Id=sa;Password=yourPassword;TrustServerCertificate=true
PostgreSQL:
copy
Host=localhost;Database=IdentitySuite;Username=postgres;Password=yourPassword
MySQL:
copy
Server=localhost;Database=IdentitySuite;Uid=root;Pwd=yourPassword;AllowUserVariables=true

Database Initialization Options:

Initialize Database: Creates the initial database schema and required tables when enabled. Use during first deployment.
Apply Migrations: When enabled, applies any pending Entity Framework migrations to update the database schema.

Languages Configuration

Multilingual support allows IdentitySuite to serve users in their preferred language across two key areas: the administrative interface and the authentication experience.

How Language Selection Works:

Administrative Interface: Language selection affects all UI elements in the IdentitySuite management interface used by administrators, including menus, forms, buttons, and system messages.
Authentication Experience: When clients connect through the IdentitySuite OpenID server, the authentication pages (login, consent, error pages) are automatically localized based on the enabled languages.
Example: If an Italian client connects to your IdentitySuite server and Italian is enabled, they will see the login screen in Italian. If Italian is not enabled, they will see the default language configured in IdentitySuite.

Supported Languages:

EN English (default)
IT Italian
ES Spanish
RU Russian
FR French
DE German

Language Management:

• Use the drag handles to reorder languages by priority
• Enable/disable specific languages using the toggle switches
• The first enabled language becomes the default fallback
• Only enabled languages are available for client authentication flows

Localization Coverage:

Administrative Interface:

  • • All UI elements and navigation
  • • Forms and input validation
  • • System messages and notifications
  • • Email templates and communications

Authentication Pages:

  • • Login and registration forms
  • • Consent and authorization pages
  • • Error and information messages
  • • Password reset and recovery flows

Important Note:

Language changes require an application restart to take effect, as localization settings are loaded during the startup phase.

Email Sending Configuration

Email configuration enables IdentitySuite to send transactional emails such as account confirmations, password resets, and notifications. Two email providers are supported for flexibility.

Supported Email Providers:

SMTP Standard

Traditional SMTP configuration compatible with most email providers including Gmail, Outlook, Yahoo, and custom mail servers.

Required fields: Host, Port, Username, Password, From, FromName
SendGrid

Cloud-based email service with advanced deliverability, analytics, and scalability. Recommended for high-volume email sending and production environments.

Required fields: API Key, From, FromName

Email Template Features:

• Responsive HTML templates for all email types
• Customizable branding and styling
• Automatic localization based on user language preference
• Support for custom email templates and layouts

Google Font Key Configuration

Google Fonts integration allows you to use Google's extensive font library for enhanced typography across your IdentitySuite application and Microsoft Identity pages.

Font Integration Scope:

Site Theme Customization: Use Google Fonts in your custom site themes and layouts. Apply consistent typography across your application's interface.
Microsoft Identity Pages: Customize fonts on all standard Microsoft Identity pages including: login, registration, profile editing, password change, email confirmation, and password reset pages.

Benefits of Google Fonts Integration:

  • • Access to 1,400+ high-quality, open-source font families
  • • Automatic font optimization and fast loading
  • • Consistent typography across all devices and browsers
  • • Regular updates and new font additions from Google
  • • Enhanced user experience with professional typography

Usage Notes:

  • • API key enables dynamic font loading and preview in the theme editor
  • • Without API key, only system fonts and web-safe fonts are available
  • • Google Fonts API has generous free usage limits for most applications