Domains/Accounts

Very few Users should have access to the Domains/Accounts page. Those with access should use extreme caution when editing any values in a Domains/Accounts record. Some values should only be edited by ACS Technologies staff. If it says "*Do Not Edit*," please heed the warning and contact Support if you feel a change is needed.

Domain Configuration

Internal Server Name: Your MinistryPlatform server name. *Do Not Edit*
External Server Name: Your MinistryPlatform server name. *Do Not Edit*
Application Title: The name of your church that appears on your Platform login page.
Domain GUID: Your domain's unique ID. *Do Not Edit*
Company Contact: The Contact record for your organization.
Database Name: Your MinistryPlatform server name. *Do Not Edit*
Time Zone: The primary time zone or “standard time” of the Domain affects the default date and time in which data is stored. *Do Note Edit*
Locale:The primary locale or “culture” of the Domain affects the default formatting and storage of the date, time, and currency.
Enable User Time Zone: This setting is the best practice recommendation. The default setting will be set to True, allowing Users to set their own Time Zone and Locale preferences upon prompt at first login.
- If the church desires to Disable User Time Zone: Not recommended as best practice. Set field to False. SPoCs should Mass Assign User's Time Zone to NULL. Disabling Enable User Time Zone field will:
  - Remove Time Zone indication from the date/time fields in the User Interface in both Open Records and Grid.
  - Disables Time Zone drop-down on the Edit User record dialog.
  - Disables Time Zone/Locale prompt.
Login Screen Font Color: The RGB color code for the font color on your Platform login page. This field has been deprecated and is not used.
Login Screen Background Color: The RGB color code for the background color of your Platform login page. This field has been deprecated and is not used.
Base URL: Your MinistryPlatform base Uniform Resource Identifier. *Do Not Edit*
Contact Card Template: The fields and formatting for your Contact Card.
Contact Merge Fields: The merge fields are available in the Contact Fields drop-down of the New Message Tool.
Global Filter Page: Allows the data grid to be filtered by one Congregation at a time. The only currently supported values are null (clear) and Congregations.

Security Configuration

Password Authentication Enabled: True. *Do Not Edit*
Password Complexity Expression: The password complexity requirements for all Users for all applications. Supports JSON formats. See Password Requirements.
Password Complexity Message: The message that is displayed to explain password requirements to Users if a new password is attempted and requirements are not met.
Windows Authentication Enabled: If True, the Platform login page will include the User Windows checkbox option.
Max Login Attempts: Number of unsuccessful login attempts a User can make before being locked out. Once this value is reached, the User will be locked out. A locked-out User can be unlocked by resetting their password, a SPoC resetting the password on the locked out user's User Record, or a SPoC editing this value to zero. Leave blank if no lockout is desired.
API Service Anonymous User: API User. *Do Not Edit*
API Service Password: Your API password might need to be shared with 3rd party systems for integration.*Do Not Edit*

Reporting Configuration

Reporting Server Address
Reporting Server Domain
Reporting Server Username
Reporting Server Password
Reporting Server Timeout

SMTP (Simple Mail Transfer Protocol) Configuration

SMTP Server Name: The name of your SMTP server. *Do Not Edit*
SMTP Server Port: The port of your SMTP server. *Do Not Edit*
SMTP Server Username: The username for your SMTP server. *Do Not Edit*
SMTP Server Password: The password for your SMTP server. *Do Not Edit*
SMTP Enable SSL: True or False depending upon your SMTP server/provider and use of SSL/TLS *Do Not Edit*
Email Domain: Defines the sending email domain(s) for the Email Server. For example, if your email addresses are all in the form "joe@universalchurch.org", you would enter the domain "universalchurch.org" in this field. You can add one domain per line. Any email sent from a domain other than the one(s) defined here will use the Email Proxy From Address. If you do not want to use the proxy, leave this blank.
Email Proxy From Address: Defines the From email to be used when the sender is not on a specified Email Domain. This allows other domains to send emails through your domain. This address will be used in the From field, and the actual sender will be used as the Reply To address.

The values in this section affect platform Messages, Process Emails, and View Notifications. Other email sub-systems are configured elsewhere such as database Notifications, Portal messages, and Widget emails. If you need to update your email settings, please contact support and we will update and test each sub-system for you, working with your IT team to resolve any issues.

Account Configuration

Create Account Message Template: The Message template to be used for the New User Account Confirmation email sent when a User clicks Create Account on the Login screen. A default template is provided that can be modified. Supported (and required) tokens: [Link]. For security, these link is only valid for 10 minutes.
Recover Account Message Template: The Message template to be used for the Password Recovery Verification email sent when a User clicks Forgot Password on the Login screen. A default template is provided that can be modified. The token [Link] must be included in the Message body to allow resets. Optionally, the token [Login_Link] may also be included, allowing a one-time login without a password reset. For security, these links are only valid for 10 minutes.
Enable Simple Sign-On: When enabled, a mobile phone or email address would be valid in place of a username during login. Note: We strongly recommend enabling Simple Sign-On to help your users get into the Platform efficiently.
Custom Button Text: From the OAuth User Account dialog, the text is displayed as the button label. *Do Not Edit*
Custom Button URL: From the OAuth User Account dialog, the URL will be navigated to if the button is clicked. *Do Not Edit*

SMS Configuration

SMS Server User Name: Twillio Account SID.
SMS Server Password: Twillio Auth Token.
SMS Server Callback Secret: A generated GUID value.
SMTP Callback Secret: A GUID value generated when configuring SendGrid.
File Provider Settings: For Azure BLOB storage.
MFA Verification Email Template: The Message template to be used for the Multi-Factor Authentication email.
MFA Required: Determines whether multi-factor is required for some or all Users.
MFA Remember Day: The length of time between multi-factor authentications.
MFA Verification Text Template: The Message template to be used for the Multi-Factor Authentication text.
File Provider: The File Provider for this domain.
Google Maps API Key: Facilitates mapping inside various features. Learn more.
Default Country Code: Default Country Code for SMS texting.
Create Account Text Template: The Message template to be used for the New User Account Confirmation text sent when a User clicks Create Account on the Login screen. A default template is provided that can be modified. Supported (and required) tokens: [Link]. Important: You can modify this template, but the [Link] token resolves to 32 characters, so be sure to factor that in when you write the text. You really only have 128 characters for that message ;) For security, these links are only valid for 10 minutes.
Recover Account Text Template: The Message template to be used for the Password Recovery Verification text sent when a User clicks Forgot Password on the Login screen. A default template is provided that can be modified. The token [Link] must be included in the Message body to allow resets. Optionally, the token [Login_Link] may also be included, allowing a one-time login without a password reset. Important: You can modify this template, but the tokens resolve to 32 characters each, so be sure to factor that in when you write the text. You really only have 96 characters for the rest of the message. For security, these links are only valid for 15 minutes.
Link Shortener URL: Link shortener service provided in Azure. *Do Not Edit*
Link Shortener URL API Key: A unique key that provides access to the link shortener service. *Do Not Edit*
Auth Code Enabled: Set to Yes to allow Users to authenticate via code.
Auth Code Email Template: The Email Message template to be used to Authenticate Via Code when a User opts to authenticate via code and receives an email with the code.
Auth Code Text Template: The Text message template to be used to Authenticate Via Code when a User opts to authenticate via code and receives a text message with the code.
Recaptcha Site Key: The Google ReCaptcha site key necessary to allow Authentication Via Code.
Recaptcha Secret Key: The Google ReCaptcha secret key necessary to all Authentication Via Code.
Melissa License Key: Melissa Data license information required to leverage Address Validation and Notification of Change of Address.
Address Change Task User: User responsible for reviewing change of address notifications. Leave blank if you do not want to use the Melissa Data change of address notification feature.
Messaging Approval Process: When populated, the Send With Approval feature is enabled in the New Message Tool.
Message Curfew Start Time and Message Curfew End Time: When populated, a message displays if someone tries to send a text message between the start and end times. See Texting for more information on message curfew times.
Writing Assistant API Key and Writing Assistant Base Uri: Information related to the Writing Assistant feature. These are generated for your system. *Do Not Edit*