# SCA Configuration - SecContacts.Defaults

### SecContacts.Defaults <a href="#seccontacts.licenses-this-setting-is-for-applying-the-app-license-s-." id="seccontacts.licenses-this-setting-is-for-applying-the-app-license-s-."></a>

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:

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

{% hint style="danger" %}
Please be aware that “SecContacts.Defaults” is the **Name** of this setting.\
As **Value** you need to create a JSON Array
{% endhint %}

{% hint style="info" %}
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**.
{% endhint %}

### List of features or default name

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

#### **Enable or Disable Features**

<table><thead><tr><th width="240">Feature name</th><th width="134.33333333333331" align="center">Default value</th><th>Description</th></tr></thead><tbody><tr><td>SMSButton_Enabled</td><td align="center">true</td><td>True to enable or false to disable the SMS/iMessage feature</td></tr><tr><td>WhatsAppButton_Enabled</td><td align="center">false</td><td>True to enable or false to disable the WhatsApp Messenger feature. <a href="../deployment-sca/app-protection-policy-ios-only-integration-in-microsoft-intune/requirement-open-whatsapp">Allow this</a> in the App Protection policy, if necessary</td></tr><tr><td>SignalButton_Enabled</td><td align="center">false</td><td>True to enable or false to disable the Signal Messenger feature</td></tr><tr><td>TelegramButton_Enabled</td><td align="center">false</td><td>True to enable or false to disable the Telegram Messenger feature</td></tr><tr><td>EmailButton_Enabled</td><td align="center">true</td><td>True to enable or false to disable the EmailButton feature</td></tr><tr><td>TeamsButton_Enabled</td><td align="center">true</td><td>True to enable or false to disable the TeamsButton feature</td></tr><tr><td>FaceTimeButton_Enabled</td><td align="center">false</td><td>True to enable or false to disable the FaceTimeButton feature. <a href="../deployment-sca/app-protection-policy-ios-only-integration-in-microsoft-intune/requirement-open-facetime">Allow this</a> in the App Protection policy, if necessary</td></tr><tr><td>WebExTeamsButton_Enabled</td><td align="center">false</td><td>True to enable or false to disable the WebExTeamsButton feature. <a href="../deployment-sca/app-protection-policy-ios-only-integration-in-microsoft-intune/requirement-open-webexteams">Allow this</a> in the App Protection policy, if necessary</td></tr><tr><td>AnonymousCall_Enabled</td><td align="center">true</td><td>True to enable or false to disable the AnonymousCall feature (Enterprise License only)</td></tr><tr><td>TeamsStatus_Enabled</td><td align="center">true</td><td>True to enable or false to disable the TeamsStatus feature (Enterprise License only)</td></tr><tr><td>ShortCutPanel_Enabled</td><td align="center">true </td><td>True to enable or false to disable the ShortCutPanel feature</td></tr><tr><td>AAD_Enabled</td><td align="center">true</td><td>True to enable or false to disable the datasource AAD</td></tr><tr><td>APC_Enabled</td><td align="center">true</td><td>True to enable or false to disable the datasource APC</td></tr><tr><td>GAL_Enabled</td><td align="center">true</td><td>True to enable or false to disable the datasource GAL</td></tr><tr><td>D365_Enabled </td><td align="center">false</td><td>True to enable or false to disable the datasource D365 (Enterprise License only)</td></tr><tr><td>DVRS_Enabled </td><td align="center">false</td><td>True to enable or false to disable the datasource DVRS (Enterprise License only)</td></tr><tr><td>ABS_Enabled</td><td align="center">false</td><td>True to enable or false to disable the datasource ABS (Enterprise License only)</td></tr><tr><td>SMC_Enabled</td><td align="center">false</td><td>True to enable or false to disable the datasource SMC (Enterprise License only)</td></tr><tr><td>vCard_Enabled</td><td align="center">true</td><td>True to enable or false to disable the vCard feature</td></tr><tr><td>SettingsMenu_Enabled</td><td align="center">true</td><td>True to enable or false to disable access to SCA settings menu</td></tr><tr><td>VacationMode_Enabled</td><td align="center">true</td><td>True to enable or false to disable the Vacation Mode feature (Enterprise License only)</td></tr><tr><td>OfficeLocation_Enabled</td><td align="center">true</td><td>True to enable or false to disable the displaying office location.  (Enterprise License only)</td></tr><tr><td>OrganisationChart_Enabled</td><td align="center">true</td><td>True to enable or false to disable the displaying AAD manager / organisation chart. (Enterprise License only)</td></tr><tr><td>ContactAddresses_Enabled</td><td align="center">true</td><td>True to enable or false to disable the display of the contact addresses. Addresses can be tapped to open Maps. <a href="../deployment-sca/app-protection-policy-ios-only-integration-in-microsoft-intune/requirement-open-maps-app">Allow this</a> in the App Protection policy, if necessary (Enterprise License only)</td></tr><tr><td>iOSForceOutlook_Enabled</td><td align="center">false</td><td>Set to <code>true</code> to force Outlook as default Email Client for SCA on iOS. This provides an alternative way to achieve the same result as using an Intune <a href="../deployment-sca/app-protection-policy-ios-only-integration-in-microsoft-intune/requirement-open-email-link-from-sca-in-outlook">App Protection Policy</a>.</td></tr><tr><td>iOSForceGoogleMaps_Enabled</td><td align="center">false</td><td>Set to <code>true</code> to use GoogleMaps App instead of iOS's native Maps App. <a href="../deployment-sca/app-protection-policy-ios-only-integration-in-microsoft-intune/requirement-open-googlemaps-app">Allow this</a> in the App Protection policy, if necessary.</td></tr><tr><td>MobilePhoneToMessengerBinding_Enabled</td><td align="center">true</td><td>False to allow MobilePhone related functions for any phone number instead of just for "mobile" phone numbers</td></tr><tr><td>ContactNotes_Enabled</td><td align="center">true</td><td>Set to <code>true</code> to allow notes in contacts. Set to <code>false</code> to hide and disable the notes field. </td></tr><tr><td>ContactHintText_Enabled</td><td align="center">true</td><td>Set to <code>true</code> to display or <code>false</code> to hide the Info text at contact details page bottom.</td></tr><tr><td>ShareContacts_Enabled</td><td align="center">false</td><td>Set to <code>true</code> to enable share contacts feature. Set to <code>false</code> to disable share contacts feature.<br>(Enterprise License only)</td></tr></tbody></table>

#### **Initial Value set by default**

{% hint style="warning" %}
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.
{% endhint %}

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

#### Appearance and Functions

<table><thead><tr><th width="279.7142333984375">Name</th><th width="149.9998779296875" align="center">Default value</th><th>Description</th></tr></thead><tbody><tr><td>PhoneNumberParseCountryCode_Option</td><td align="center">false</td><td>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. </td></tr><tr><td>PhoneNumberIngoreInvalid_Option</td><td align="center">false</td><td><p>The default value "false" will add all phone numbers to SCA without filtering.</p><p><br>Use "true" to filter out phone numbers without valid international format. </p></td></tr><tr><td>PhoneNumberExtensionInfix_Option</td><td align="center">null</td><td>Replaces phone number extension marker e.g. 'ext' > '398' to any custom infix provided.</td></tr><tr><td>ForceSync2LocalContacts_Option</td><td align="center">false</td><td>If set to <code>true</code> SCA will always use sync to local contacts for android caller id mode. If set to <code>false</code> SCA will use auto detection for android caller id mode. (Android only)</td></tr><tr><td>AADuseUPNasEmail_Option</td><td align="center">false</td><td>If set to <code>true</code> SCA uses <strong>two Email sources</strong> for <strong>AAD</strong> contacts (UserPrincipalName and Email)<br>If set to <code>false</code> SCA uses just one Email source for <strong>AAD</strong> contacts (Email)</td></tr><tr><td>ContactHintTextDE_Option</td><td align="center">Alle Kontakte in dieser App sind schreibgeschützt, mit Ausnahme deiner persönlichen Kontakte</td><td>Customize the Info text at contact details page (de)</td></tr><tr><td>ContactHintTextEN_Option</td><td align="center">All contacts in this app are read-only, except for your personal contacts</td><td>Customize the Info text at contact details page (en)</td></tr><tr><td>ContactHintTextES_Option</td><td align="center">Todos los contactos de esta aplicación son de sólo lectura, excepto tus contactos personales</td><td>Customize the Info text at contact details page (es)</td></tr><tr><td>ContactHintTextFR_Option</td><td align="center">Tous les contacts de cette application sont en lecture seule, à l'exception de vos contacts personnels</td><td>Customize the Info text at contact details page (fr)</td></tr><tr><td>TeamsStatusLocked_Option</td><td align="center">false</td><td>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.</td></tr><tr><td>UseMSTeamsForOutboundPhoneCalls_Option</td><td align="center">false</td><td>True to route outbound "phone" calls to Teams instead of Phone App</td></tr><tr><td>SortDataSourcesByName_Option</td><td align="center">false</td><td>True to change data source sorting in settings from “by ID” to “by Name”</td></tr><tr><td>CustomTermsOfUseUrl_Option</td><td align="center">null</td><td>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.</td></tr><tr><td>DisplayCompanyInCallerID_Option</td><td align="center">true</td><td>Set to <code>true</code> to display the company name in the caller ID. Set to <code>false</code> to show only the first and last name without the company name.</td></tr><tr><td>AADonlyEnabledAccounts_Option</td><td align="center">true</td><td>Set to <code>true</code> to include only <em>enabled</em> AAD user accounts in the AAD data source. Set to <code>false</code> to include <em>all</em> AAD user accounts.</td></tr></tbody></table>

#### Personal Contacts

<table><thead><tr><th width="290">Name</th><th width="129.80924479166669" align="center">Default value</th><th>Desciption</th></tr></thead><tbody><tr><td>APCeditor_Enabled</td><td align="center">true</td><td>Set to <code>true</code> to enable, or <code>false</code> to disable the ability for users to create, edit, and delete their own personal Outlook contacts (APC) directly within the app. (Enterprise License only)</td></tr><tr><td>APCfolders_Enabled</td><td align="center">false</td><td>Set to <code>true</code> to include personal Outlook contacts (APC) stored in (hidden) folders. Set to <code>false</code> to include only contacts stored in the root folder of the APC.</td></tr><tr><td>APCfoldersCombine_Enabled</td><td align="center">true</td><td>Set to <code>true</code> to combine all contacts from all APC folders into a single data source. Set to <code>false</code> to display each APC folder as a separate data source (auto-enumerated).</td></tr><tr><td>APChighPrioCombine_Option</td><td align="center">true</td><td>Set to <code>true</code> to give APC contacts the highest priority during contact merging. Set to <code>false</code> to apply standard contact combination rules.</td></tr><tr><td>AllowContactWithoutPhoneNumberAPC_Option</td><td align="center">true</td><td>Set to <code>true</code> to allow contacts without phone number for APC. Set to <code>false</code> to not allow contacts without phone number for APC.</td></tr></tbody></table>

#### Service Menu Access

<table><thead><tr><th width="290">Name</th><th width="129.80924479166669" align="center">Default value</th><th>Desciption</th></tr></thead><tbody><tr><td>ServiceMenu_Enabled</td><td align="center"><a data-footnote-ref href="#user-content-fn-1">true</a></td><td>True to enable or false to disable access to hidden Service Menu</td></tr><tr><td>ServiceMenu_SetAccessPin</td><td align="center">1234</td><td>Set a new Pin for accessing Service Menu</td></tr></tbody></table>

#### Resync Reminder

<table><thead><tr><th width="289.5239664713542">Name</th><th width="130.4285888671875" align="center">Default value</th><th>Desciption</th></tr></thead><tbody><tr><td>ResyncReminder_Enabled</td><td align="center">true</td><td>True to enable or false to disable the Resync Reminder feature.</td></tr><tr><td>ResyncReminderInterval_Option</td><td align="center">720</td><td>To set an interval (in hours) to generate a Resync Reminder Notification (default = 720) == 30 days</td></tr></tbody></table>

#### vCard Defaults

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

#### CI customization options

<table><thead><tr><th width="303">Name</th><th width="125" align="center">Default value</th><th>Description</th></tr></thead><tbody><tr><td>HighlightColor_Option</td><td align="center">#328DE2</td><td>Set primary button, switch, link &#x26; UI color for Light and Dark mode at once.
<br>(Enterprise License only)</td></tr><tr><td>HighlightColorLightMode_Option</td><td align="center">#328DE2</td><td>Set primary button, switch, link &#x26; UI color for Light mode.
<br>(Enterprise License only)</td></tr><tr><td>HighlightColorDarkMode_Option</td><td align="center">#328DE2</td><td>Set primary button, switch, link &#x26; UI color for Dark mode.
<br>(Enterprise License only)</td></tr><tr><td>CDimageUri_Option<br><br><em>MenuImageURI_Option (legacy)</em></td><td align="center">null</td><td>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<strong>.</strong> (Enterprise License only)</td></tr></tbody></table>

{% hint style="success" %}
More information about **CI Customization** and configuration instructions can be found [here](https://docs.secure-contacts.com/documentation/app-configuration-policy-name-values-for-sca/sca-configuration-ci-customization)
{% endhint %}

#### iOS Contact Provider (CPE)

<table><thead><tr><th width="303">Name</th><th width="125" align="center">Default value</th><th>Description</th></tr></thead><tbody><tr><td>CPE_Enabled</td><td align="center">false</td><td><p>Enables or disables the CPE functionality entirely. If set to <code>true</code> contacts from specified SCA data sources can be made system-wide available in iOS via the CPE. </p><p>(Enterprise License only)</p></td></tr><tr><td>CPEDataSources_Option</td><td align="center">APC</td><td>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. <code>"AAD,APC,GAL"</code> </td></tr><tr><td>CPEDataSources_Enabled</td><td align="center">true</td><td>Specifies whether users can select the available SCA data sources themselves. If set to <code>true</code> users will see an option within the app to choose sources. If set to <code>false</code> the selection is locked and a predefined configuration is enforced. </td></tr><tr><td>CPECompany_Enabled</td><td align="center">true</td><td>Defines whether a contact's company name can be shared with iOS.
</td></tr><tr><td>CPEJobtitle_Enabled</td><td align="center">true</td><td>Defines whether a contact's job title can be shared with iOS.
</td></tr><tr><td>CPEDepartment_Enabled</td><td align="center">true</td><td>Defines whether a contact's department name can be shared with iOS.</td></tr><tr><td>CPEAddresses_Enabled</td><td align="center">true</td><td>Defines whether a contact's address(es) can be shared with iOS.</td></tr><tr><td>CPEPhonenumbers_Enabled</td><td align="center">true</td><td>Defines whether a contact's phone number(s) can be shared with iOS.</td></tr><tr><td>CPEEmailaddresses_Enabled</td><td align="center">true</td><td>Defines whether a contact's email address(es) can be shared with iOS.</td></tr></tbody></table>

{% hint style="success" %}
More information about **iOS Contact Provider (CPE)** and configuration instructions can be found [here](https://docs.secure-contacts.com/sca-3.0-public-beta/ios-contact-provider-cpe)
{% endhint %}

[^1]: