Admin: Configuration
Overview
RPI’s inherent flexibility is realized by the provision of a number of configuration settings. Some of these settings are managed centrally in Server Workbench and apply to the cluster as a whole. Others are managed on a client-by-client basis in the System Configuration administration interface in the RPI client application.
Central configuration settings are managed in Server Workbench in the Configuration tab:

The tab consists of Cluster System Configuration and Selected Configuration Details sections.
Cluster System Configuration Section
This section contains a toolbar and system configuration settings list
Toolbar
Two buttons are exposed at the toolbar:
Save: invocation of this option persists any changes made to system configuration setting values in the core operational database.
Refresh: clicking this button re-loads the list of configuration settings and their values from the core operational database. System Configuration Settings List
The following columns are shown:
Group: one of Environment, Personalization or Web
Name
Value
Description
Data Type
State: one of Unchanged or Edited
The following configuration settings are displayed:
Group | Name | Default Value | Description |
---|---|---|---|
Authentication | AFDSAADInstance | [blank] | Instance used to login to Active Directory Federation Services |
Authentication | ADFSAudience | [blank] | Active Directory Federation Services audience that will be used during token validation |
Authentication | ADFSClientID | [blank] | Active Directory Federation Services client ID for the RPI native client application |
Authentication | ADFSInteractionResourceID | [blank] | Azure Active Directory resource ID representing the RPI Web API |
Authentication | ADFSMetadataEndpoint | [blank] | Metadata endpoint for the ADFS security token service that JWTs will be issued from |
Authentication | ADFSRealm | [blank] | Active Directory Federation Services authentication realm |
Authentication | ADFSRedirectUri | [blank] | Active Directory Federation Services redirect URI for the RPI Web API |
Authentication | ADFSTenant | [blank] | Active Directory Federation Services tenant the tokens are issued from |
Authentication | ADFSValidateAudience | [blank] | Validate the Active Directory Federation Services audience during token validation |
Authentication | ADFSValidateIssuerSigningKey | [blank] | Validate the Active Directory Federation Services security key that signed the security token |
Authentication | AzureADAADInstance | [blank] | Instance used to login to Azure Active Directory |
Authentication | AzureADAudience | [blank] | Azure Active Directory audience that will be used during token validation |
Authentication | AzureADClientID | [blank] | Azure Active Directory client ID for the RPI native client application |
Authentication | AzureADInteractionResourceID | [blank] | Azure Active Directory resource ID representing the RPI Web API |
Authentication | AzureADRedirectUri | [blank] | Azure Active Directory redirect URI for the RPI Web API |
Authentication | AzureADTenant | [blank] | Azure Active Directory tenant the tokens are issued from |
Authentication | EnableADFS | False | This server supports Active Directory Federation Services authentication |
Authentication | EnableAzureAD | False | This server supports Azure Active Directory authentication |
Authentication | EnableOpenIdAuthentication | False | This server supports OpenID authentication |
Authentication | OpenIdAudience | [blank] | OpenId application audience identifier |
Authentication | OpenIdAuthorizationHost | [blank] | OpenId authorization host address |
Authentication | OpenIdClientID | [blank] | OpenId client ID |
Authentication | OpenIdCustomScopes | [none provided] | List of custom scopes to request for the OpenId access token |
Authentication | OpenIdEnableRefreshTokens | False | If checked, refresh tokens will be requested to renew access tokens |
Authentication | OpenIdRedirectURL | [blank] | OpenId redirect address |
Authentication | OpenIdLogoutIdTokenParamete r | id_token_hint | Query parameter name used to pass the id token on logout |
Authentication | OpenIdUsePKCE | True | If checked, the Proof Key for Code Exchange authorization flow is used |
Authentication | OpenIdValidateAudience | True | If checked, the OpenIdAudience must match the audience name supplied in the access |
|
|
| token |
Connectors | DotMailerExternalDynamicCont entSharedFolderPath | C:\temp\Redpoint\dotdigital | DotMailer shared external dynamic content output folder path |
Connectors | DynUnsubscribeTempFolderPat h | C:\temp\Redpoint\DynUnsubs cribe | Dyn unsubscribe temporary output folder path |
Connectors | FacebookDataFileFolderPath | C:\temp\Redpoint\Facebook Offline Event\ | Facebook data file folder path |
Connectors | GoogleAdsCustomerMatchData FileFolderPath | C:\temp\RedPoint\Google Ads Customer Match\ | Google Ads Customer Match data file folder path |
Connectors | InstillerProcessEventFolderPath Format | C:\temp\Redpoint\Instiller\{0}\ Processed | Instiller process data file folder path format |
Connectors | MessenteDataFileFolderPath | C:\temp\Redpoint\Messente\ | Messente data file folder path |
Connectors | MobileConnectDataFileFolderP ath | C:\temp\Redpoint\MobileConn ect\ | MobileConnect data file folder path |
Connectors | OutboundDeliveryEventFolderP ath | C:\temp\Redpoint\OutboundD eliveryCallbackService | Outbound Delivery event delivery output folder path |
Connectors | SendGridEmailMetricsFolderPat h | C:\temp\Redpoint\SendGridCa llbackService | SendGrid email metrics output folder path |
Connectors | SendGridWebAPIExternalConte ntProviderSettings |
| Content provider settings json |
Connectors | SilverpopDataFileFolderPath | C:\temp\Redpoint\IBM Marketing Cloud\ | Silverpop data file folder path |
Connectors | SparkPostSaveEventFolderPath Format | C:\temp\Redpoint\SparkPost\{ 0:N}\Processed\{1:N}\{2:yyyyMM-ddThh_mm_ss} | SparkPost Post data file folder path format |
Connectors | UrbanAirshipDataFileFolderPath | C:\temp\Redpoint\UrbanAirshi p | UrbanAirship data file folder path |
Database | OracleTNSAdminRootFolderPat h |
| The folder location of Oracle TNS admin configuration files (tnsnames.ora and sqlnet.ora) |
Database | OracleTraceFileLocation | C:\temp\RedPoint Interaction\Oracle\Traces | The folder location where the generated trace files will be written |
Database | OracleTraceLevel | 0 | 0 = Tracing is disabled, 1 = PublicAPI, 2 = PrivateAPI, 4 = NetworkAPI/Data, 7 = All traces enabled |
Database | OracleTraceOption | 0 | 0 = Generates single trace file, 1 = Generates multiple trace files |
Environment | AccessTokenExpiryMinutes | 20 | Number of minutes access tokens remain valid after being issued |
Environment | AllowInsecureHttp | False | Controls whether the server allows insecure HTTP requests |
Environment | AllowSavingLoginDetails | True | When a user successfully logs into this server, allow the servername and credentials to be saved |
Environment | AlwaysShowClientsAtLogin | False | Force the Choose Clients dialog to appear at login even if the user has access to only one client |
Environment | ApplicationSupportURL | Web page URL that points to the application support page | |
Environment | AuditTaskEvents | False | Controls if system task stop and start events should be audited |
Environment | AzureADAADInstance | [blank] | Instance used to login to Azure Active Directory |
Environment | AzureADAudience | [blank] | Azure Active Directory Audience that will be used during token validation |
Environment | AzureADClientID | [blank] | Azure Active Directory client ID for the RPI native client application |
Environment | AzureADInteractionResourceID | [blank] | Azure Active Directory resource ID representing the RPI Web API |
Environment | AzureADRedirectUri | [blank] | Azure Active Directory redirect URL for the RPI Web API |
Environment | AzureADTenant | [blank] | Azure Active Directory tenant the tokens are issued from |
Environment | DefaultAccountLockoutTimesp an | 5 | Number of minutes a user is locked out for after MaxFailedAcessAttempts BeforeLockout is reached |
Environment | DeploymentFileShare | \\[server]\RPI Deployment | Path of the deployment files share |
Environment | EnableADFS | False | This server supports Active Directory Federation Services authentication |
Environment | EnableAzureAD | False | This server supports Azure Active Directory authentication |
Environment | EncryptionKey | C:\Resonance123 | System wide encryption key |
Environment | GlobalFileOutputAllowAllServer Locations | True | If checked, clients are allowed to specify any server location for data extract and export activities |
Environment | GlobalFileOutputAllowClientOve rrides | True | If checked, clients can configure and use the local FileOutput configuration settings |
Environment | GlobalFileOutputDirectory | C:\RPI File Output | Folder used to store any file assets exported via interactions or selection rules |
Environment | HelpStartPageURL | \\[server]\RedpointInteraction Help/index.html | URL of the help start page |
Environment | HelpTrainingStartPageURL | http://Redpoint- cbts.Redpointglobal.com/Red point-Interaction-CBT- Links.html | URL of the training materials start page |
Environment | ListenerQueueIsEnabled | False | If checked, the system will monitor the listener queue and execute any packages found |
Environment | ListenerQueueMaxBatchSize | 50 | The maximum number of listener queue packages processed by a single execution thread |
Environment | ListenerQueuePath | [blank] | The listener queue path |
Environment | ListenerQueueThreadPoolSize | 10 | The number of listener queue packages that can be processed concurrently |
Environment | ListenerQueueTimeoutMinutes | 60 | The maximum number of minutes to allow for processing a listener |
|
|
| queue package |
Environment | ListenerQueueUseMessageLoc ks | True | If set and supported by the queue provider, messages remain locked on the queue until processed |
Environment | MapControlConfiguration | Bing | Map control API configuration |
Environment | MaxFailedAttemptsBeforeLock out | 5 | Number of access attempts allowed before a user is locked out (if lockout is enabled) |
Environment | OperationalDatabaseType | SQLServer | The type of database server on which the cluster database is to be created |
Environment | PasswordRequireDigit | True | User passwords require a digit |
Environment | PasswordRequiredLength | 6 | Minimum required length of user passwords |
Environment | PasswordRequireLowercase | True | User passwords require a lower case letter |
Environment | PasswordRequireNonLetterOrDi git | True | User passwords require a non-letter or digit |
Environment | PasswordRequireUppercase | True | User passwords require a lower case letter |
Environment | ServerDateTimeSource | 1 | 0 = Server OS, 1 = Operational Database Instance |
Environment | ServiceHostName | [not set] | Host name client connects to |
Environment | ServiceHostPortNumber | 443 | Port number client connects on the service host |
Environment | SMTPCredentials | [not set] | The credentials used to sign into the SMTP server |
Environment | SMTPEnableSSL | False | Check if an SSL connection is required to connect to the SMTP server |
Environment | SMTPPortNumber | 25 | Port number used to connect to the SMTP server |
Environment | SMTPServerName | 10.100.1.10 | SMTP server to be used by the application for emailing Environment |
Environment | SMTPUseCredentials | False | Controls if authentication credentials are passed through to the SMTP server |
Environment | TaskTimeout | 60 | Number of minutes a task can execute before it is cancelled. Applies to queue tasks only |
Environment | TriggerCheckCriteriaInterval | 60 | Number of seconds interval between checking if trigger constraints have been met |
Environment | TriggersMaxDaysInactive | 180 | Maximum number of days a trigger can remain in an activated state without being fired |
Environment | UserLockoutEnabledByDefault | True | If true, will enable user lockout when users are created |
Environment | WorkflowPauseAllTimeout | 10 | The timeout limit in minutes that the workflow manager will wait for all workflows to pause |
Integration API | APIAccessTokenExpiryMinutes | 60 | Number of minutes access tokens remain valid after being issued |
Integration API | ApiMaxSearchResultCount | 256 | Number of managed asset search results returned per call |
Integration API | ApiSearchClientNames | [String Values] | List of RPI client names on which to apply ECP managed asset indexing |
Integration API | ApiSearchIndexingEnabled | True | If checked, the Integration API ECP managed asset indexing service will be enabled |
Integration API | ApiSearchIndexingInterval | 60 | The interval in minutes between ECP managed asset indexing jobs |
Integration API | ApiZendeskToken | 12CAA197-ED6C-4DCC-B920- F4CC769F2B4C | Zendesk endpoint authorization token |
Personalization | EmailSenderAddress | System email sender | |
|
|
| address |
Personalization | PasswordResetSubject | Resonance Password Reset | Email subject to be used for password reset email |
Web | GoalDrivenAssetWebServiceAd dress |
| The Redpoint machine learning web service address |
Note that setting AccessTokenExpiryMinutes requires an IIS restart for any changes to be applied.
Selected Configuration Details Section
This section displays the full details of the configuration setting selected currently in the list. The following read-only properties are shown:
Name
Group
Description
In addition, a single writable property is displayed:
Value