Overview


The 10.25.9.30 release (and later) includes enhanced security features and new configuration options for database connections.


Default Option Changes


Encrypt

The system will automatically default to strict if not otherwise configured.

Workstation ID

The system will automatically transmit your web server or reporting server's machine name on each SQL connection as the Workstation ID for improved connection tracking and auditing.


New Configuration Options


The AeriesReportingConfig file now supports additional connection string options under the <GlobalConnectionOptions> section.

Important Configuration Settings:


SettingDescriptionExample Value
Application NameIdentifies your application in SQL Server sessionsAeriesSandbox
EncryptConnection encryption requirementMandatory
TrustServerCertificateTrust server certificate without validationTrue


Configuration Example

Add the following section to your AeriesReportingConfig files to customize connection settings:

  • Note: Remember your AeriesReportingConfig files exist in your web servers' "appsettings" folders and your AeriesReporting/Service folder.

xml

<GlobalConnectionOptions>
    <ApplicationName>AeriesProduction</ApplicationName>
    <Encrypt>Mandatory</Encrypt>
    <TrustServerCertificate>false</TrustServerCertificate>
</GlobalConnectionOptions>


Windows Authentication Support


Integrated Security Configuration

When the UserName and/or Password fields in AeriesNetConnections are left blank or omitted, the system will automatically enable Integrated Security. This allows Aeries to authenticate using the Application Pool Identity.

Setup Requirements for Windows Authentication:

  1. Leave the UserName and Password fields empty in AeriesNetConnections

  2. Add the Application Pool Identity user as a login on your SQL Server

  3. Grant appropriate database permissions to this user for accessing your Aeries database

Notes


  • All settings in GlobalConnectionOptions are optional, with the caveat that your servers support encrypt being set as the new default value strict (requires Windows Server 2022+ and SQL Server 2022+)
  • If not specified, SQL Server default values will be used

  • These settings apply globally to all Aeries database connections

  • Changes require a service restart to take effect

  • When installing Aeries Updates, IIS will lock the Microsoft.Data.SqlClient.SNI.dll. Be sure to stop IIS before installing this or any future Aeries Update.

For additional assistance with configuration, please contact Aeries Support.


Advanced Options

Do not attempt to configure these unless you have fully tested them in production-like test environments and are fully aware of their impacts.


SettingDescriptionExample Value
AttestationProtocolEnclave attestation protocolNone
AuthenticationAuthentication methodActiveDirectoryServicePrincipal
ColumnEncryptionSettingColumn-level encryption configurationDisabled
CommandTimeoutCommand execution timeout (seconds)120
ConnectRetryCountNumber of connection retry attempts3
ConnectRetryIntervalDelay between retry attempts (seconds)10
ConnectTimeoutConnection timeout (seconds)30
EnclaveAttestationUrlURL for enclave attestation'https://attestationprovider.domain.net'
IPAddressPreferenceIP version preferenceIPv4First
LoadBalanceTimeoutLoad balance timeout (seconds)0
MaxPoolSizeMaximum connection pool size100
MinPoolSizeMinimum connection pool size0
MultipleActiveResultSetsEnable MARSTrue
PacketSizeNetwork packet size (bytes)8000
PoolBlockingPeriodConnection pool blocking behaviorAuto
PoolingEnable connection poolingTrue
TransparentNetworkIPResolutionEnable transparent network IP resolutionTrue