SCA Configuration - SecContacts.Defaults

SecContacts.Defaults

This setting is for customizing app features and change defaults.

Secure Contacts App has several features and defaults that can be changed via SecContacts.Defaults.

• Name: SecContacts.Defaults

• Value: [{"name":"<feature or default name>", "value":"<custom value>"}]

The Value property is a JSON Array of name value pairs. You can add one or multiple defaults here.

Replace <feature or default name> with a name of a feature or default to be changed.

• e.g. AAD_Enabled or Favorites_Enabled etc.

See List of available feature and default below.

Replace <custom value> with a value for the feature or default to be changed.

• e.g. true or false or 0 or 1 or 2 or 3

For example, if you want to add more features use , as delimiter:

[ 
  {"name":"<feature or default name>", "value":"<custom value>"} ,
  {"name":"<feature or default name>", "value":"<custom value>"} ,
  {"name":"<feature or default name>", "value":"<custom value>"} 
] 

Please be aware that “SecContacts.Defaults” is the Name of this setting. As Value you need to create a JSON Array

When you make changes to your app configuration, it may take some time for the updates to be applied to the device, depending on your MDM system and enrollment type. To force immediate application, the user must log out and log back in.

List of features or default name

The following tables show available values for the corresponding feature or default below:

Enable or Disable Features

Feature name	Default value	Description
SMSButton_Enabled	true	True to enable or false to disable the SMS/iMessage feature
WhatsAppButton_Enabled	false	True to enable or false to disable the WhatsApp Messenger feature. Allow this in the App Protection policy, if necessary
SignalButton_Enabled	false	True to enable or false to disable the Signal Messenger feature
TelegramButton_Enabled	false	True to enable or false to disable the Telegram Messenger feature
EmailButton_Enabled	true	True to enable or false to disable the EmailButton feature
TeamsButton_Enabled	true	True to enable or false to disable the TeamsButton feature
FaceTimeButton_Enabled	false	True to enable or false to disable the FaceTimeButton feature. Allow this in the App Protection policy, if necessary
WebExTeamsButton_Enabled	false	True to enable or false to disable the WebExTeamsButton feature. Allow this in the App Protection policy, if necessary
AnonymousCall_Enabled	true	True to enable or false to disable the AnonymousCall feature (Enterprise License only)
TeamsStatus_Enabled	true	True to enable or false to disable the TeamsStatus feature (Enterprise License only)
ShortCutPanel_Enabled	true	True to enable or false to disable the ShortCutPanel feature
AAD_Enabled	true	True to enable or false to disable the datasource AAD
APC_Enabled	true	True to enable or false to disable the datasource APC
GAL_Enabled	true	True to enable or false to disable the datasource GAL
D365_Enabled	false	True to enable or false to disable the datasource D365 (Enterprise License only)
DVRS_Enabled	false	True to enable or false to disable the datasource DVRS (Enterprise License only)
ABS_Enabled	false	True to enable or false to disable the datasource ABS (Enterprise License only)
SMC_Enabled	false	True to enable or false to disable the datasource SMC (Enterprise License only)
vCard_Enabled	true	True to enable or false to disable the vCard feature
SettingsMenu_Enabled	true	True to enable or false to disable access to SCA settings menu
VacationMode_Enabled	true	True to enable or false to disable the Vacation Mode feature (Enterprise License only)
OfficeLocation_Enabled	true	True to enable or false to disable the displaying office location. (Enterprise License only)
OrganisationChart_Enabled	true	True to enable or false to disable the displaying AAD manager / organisation chart. (Enterprise License only)
ContactAddresses_Enabled	true	True to enable or false to disable the display of the contact addresses. Addresses can be tapped to open Maps. Allow this in the App Protection policy, if necessary (Enterprise License only)
iOSForceGoogleMaps_Enabled	false	True to use GoogleMaps App instead of iOS's native Maps App. Allow this in the App Protection policy, if necessary.
MobilePhoneToMessengerBinding_Enabled	true	False to allow MobilePhone related functions for any phone number instead of just for "mobile" phone numbers
🆕ContactNotes_Enabled	true	Set to true to allow notes in contacts. Set to false to hide and disable the notes field.
🆕ContactHintText_Enabled	true	Set to true to display or false to hide the Info text at contact details page bottom.
🆕ShareContacts_Enabled	false	Set to true to enable share contacts feature. Set to false to disable share contacts feature. (Enterprise License only)

Initial Value set by default

InitValues are only set once after the app has been started for the very first time. For testing purposes proceed like below: The best practice for testing recently changed _InitValue settings is: 1) Logoff from the app, 2) Delete the app from the device, 3) Download and launch the app again.

Default name	Default value	Description
Favorites_InitValue	false	True for initially activate or false to deactivate Favorites switch in settings.
LogViewer_InitValue	false	True for initially activate or false to deactivate the LogViewer switch in settings.
FullnameOrder_InitValue	false	True for initially activate or false to deactivate the Fullname order reverse switch in settings.
ShowCompanyName_InitValue	false	True for initially activate or false to deactivate the Show Company Name switch in settings.
ShowDepartment_InitValue	false	True for initially activate or false to deactivate the Show Department switch in settings.
🆕ShowJobtitle_InitValue	false	True for initially activate or false to deactivate the Show Jobtitle switch in settings.
ShowDataSource_InitValue	false	True for initially activate or false to deactivate the Show Data Source switch in settings.
TeamsStatus_InitValue	0	Initially set the TeamsStatus option to list (3) + details or contact details (2) or contact list (1) or disabeled (0).
SearchAllDatasources_InitValue	true	True for initially activate or false to deactivate the Search all Datasources switch in settings.
AAD_InitValue	true	True for initially activate or false to deactivate the AAD Datasource switch in settings.
APC_InitValue	true	True for initially activate or false to deactivate the APC Datasource switch in settings.
GAL_InitValue	false	True for initially activate or false to deactivate the GAL Datasource switch in settings.
D365_InitValue	false	True for initially activate or false to deactivate the D365 Datasource switch in settings. (Enterprise License only)
DVRS_InitValue	false	True for initially activate or false to deactivate the DVRS Datasource switch in settings. (Enterprise License only)
ABS_InitValue	false	True for initially activate or false to deactivate the ABS Datasource switch in settings. (Enterprise License only)
SMC_InitValue	false	True for initially activate or false to deactivate the SMC Datasource switch in settings. (Enterprise License only)

Appearance and Functions

Name	Default value	Description
PhoneNumberParseCountryCode_Option	false	Specify a 2-letter country code, e.g. "DE" or "US". Phone numbers that do not have the full international format, will be completed with the regional format of the country code defined.
PhoneNumberIngoreInvalid_Option	false	The default value "false" will add all phone numbers to SCA without filtering. Use "true" to filter out phone numbers without valid international format.
PhoneNumberExtensionInfix_Option	null	Replaces phone number extension marker e.g. 'ext' > '398' to any custom infix provided.
🆕ForceSync2LocalContacts_Option	false	If set to true SCA will always use sync to local contacts for android caller id mode. If set to false SCA will use auto detection for android caller id mode. (Android only)
AADuseUPNasEmail_Option	false	If set to true SCA uses two Email sources for AAD contacts (UserPrincipalName and Email) If set to false SCA uses just one Email source for AAD contacts (Email)
ContactHintTextDE_Option	Alle Kontakte in dieser App sind schreibgeschützt, mit Ausnahme deiner persönlichen Kontakte	Customize the Info text at contact details page (de)
ContactHintTextEN_Option	All contacts in this app are read-only, except for your personal contacts	Customize the Info text at contact details page (en)
🆕ContactHintTextES_Option	Todos los contactos de esta aplicación son de sólo lectura, excepto tus contactos personales	Customize the Info text at contact details page (es)
🆕ContactHintTextFR_Option	Tous les contacts de cette application sont en lecture seule, à l'exception de vos contacts personnels	Customize the Info text at contact details page (fr)
TeamsStatusLocked_Option	false	True to lock or false to unlock the TeamsStatus Button. If locked the user can no longer change a predefined TeamsStatus_InitValue. To set a fixed TeamsStatus mode, e.g. to be displayed only on the contact details page.
UseMSTeamsForOutboundPhoneCalls_Option	false	True to route outbound "phone" calls to Teams instead of Phone App
SortDataSourcesByName_Option	false	True to change data source sorting in settings from “by ID” to “by Name”
🆕CustomTermsOfUseUrl_Option	null	URL for a custom Terms of Use; set this if you want your users to accept your own Terms of Use before they can use SCA.
🆕DisplayCompanyInCallerID_Option	true	Set to true to display the company name in the caller ID. Set to false to show only the first and last name without the company name.
🆕AADonlyEnabledAccounts_Option	true	Set to true to include only enabled AAD user accounts in the AAD data source. Set to false to include all AAD user accounts.

Personal Contacts

Name	Default value	Desciption
🆕APCeditor_Enabled	true	Set to true to enable, or false to disable the ability for users to create, edit, and delete their own personal Outlook contacts (APC) directly within the app.
🆕APCfolders_Enabled	false	Set to true to include personal Outlook contacts (APC) stored in (hidden) folders. Set to false to include only contacts stored in the root folder of the APC.
🆕APCfoldersCombine_Enabled	true	Set to true to combine all contacts from all APC folders into a single data source. Set to false to display each APC folder as a separate data source (auto-enumerated).
🆕APChighPrioCombine_Option	true	Set to true to give APC contacts the highest priority during contact merging. Set to false to apply standard contact combination rules.
🆕AllowContactWithoutPhoneNumberAPC_Option	true	Set to true to allow contacts without phone number for APC. Set to false to not allow contacts without phone number for APC.

Service Menu Access

Name	Default value	Desciption
ServiceMenu_Enabled		True to enable or false to disable access to hidden Service Menu
ServiceMenu_SetAccessPin	1234	Set a new Pin for accessing Service Menu

Resync Reminder

Name	Default value	Desciption
ResyncReminder_Enabled	true	True to enable or false to disable the Resync Reminder feature.
ResyncReminderInterval_Option	720	To set an interval (in hours) to generate a Resync Reminder Notification (default = 720) == 30 days

vCard Defaults

Name	Default value	Description
vCard_enabled	true	True to enable or false to disable the vCard feature
vCard_Url	null	null by default Optionally, you can define a default URL for your vCard e.g. https://webpage.domain
vCard_Street	auto	If set to "null" the street input field is empty. If set to "auto" the street input field gathers the data from Azure AD. Optionally, you can define a default value for your street here.
vCard_PostalCode	auto	If set to "null" the postal code input field is empty. If set to "auto" the postal code input field gathers the data from Azure AD. Optionally, you can define a default value for your postal code here.
vCard_City	auto	If set to "null" the city input field is empty. If set to "auto" the city input field gathers the data from Azure AD. Optionally, you can define a default value for your city here.
vCard_Country	auto	If set to "null" the county input field is empty. If set to "auto" the county input field gathers the data from Azure AD. Optionally, you can define a default value for your county here.
🆕vCardDefaultReadOnly_Option	false	Set to true to make the default/system vCard read-only. Set to false to allow editing of the default/system vCard.
🆕vCardOnlyDefaultAllowed_Option	false	Set to true to make only the default/system vCard available. Set to false to allow users to create additional vCards.

CI customization options

Name	Default value	Description
🆕HighlightColor_Option	#328DE2	Set primary button, switch, link & UI color for Light and Dark mode at once. (Enterprise License only)
HighlightColorLightMode_Option	#328DE2	Set primary button, switch, link & UI color for Light mode. (Enterprise License only)
HighlightColorDarkMode_Option	#328DE2	Set primary button, switch, link & UI color for Dark mode. (Enterprise License only)
🆕CDimageUri_Option MenuImageURI_Option (legacy)	null	Set set image URI for the optional company logo image visible on loading page, vcard qr-code and license viewer page. https only. Will be auto download once and then cached indefinitely until new URI is set. Supports JPG and PNG images. Square or rectangular PNG with transparent background recommended. (Enterprise License only)

iOS Contact Provider (CPE)

Name	Default value	Description
🆕CPE_Enabled	false	Enables or disables the CPE functionality entirely. If set to true contacts from specified SCA data sources can be made system-wide available in iOS via the CPE. (Enterprise License only)
🆕CPEDataSources_Option	APC	Defines which SCA data sources may be shared with iOS through the CPE. This is a comma-separated list of SCA source IDs e.g. "AAD,APC,GAL"
🆕CPEDataSources_Enabled	true	Specifies whether users can select the available SCA data sources themselves. If set to true users will see an option within the app to choose sources. If set to false the selection is locked and a predefined configuration is enforced.
🆕CPECompany_Enabled	true	Defines whether a contact's company name can be shared with iOS.
🆕CPEJobtitle_Enabled	true	Defines whether a contact's job title can be shared with iOS.
🆕CPEDepartment_Enabled	true	Defines whether a contact's department name can be shared with iOS.
🆕CPEAddresses_Enabled	true	Defines whether a contact's address(es) can be shared with iOS.
🆕CPEPhonenumbers_Enabled	true	Defines whether a contact's phone number(s) can be shared with iOS.
🆕CPEEmailaddresses_Enabled	true	Defines whether a contact's email address(es) can be shared with iOS.