---
schema_version: "1"
id: 0f5e731304c53d4f9d201540fc33eeedcc6e827516b8dde5b3f52275c6855606
title: ExtlClntAppConfigurablePolicies
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/api_meta/meta_extlclntappconfigurablepolicies.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/meta_extlclntappconfigurablepolicies.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 8bc79f80ab9fd2ec8e1d45f66bc19c116e651bc61e73ad90d3a70522beb23143
description: Represents the policies for an external client app to disable or enable plugins.
---
# ExtlClntAppConfigurablePolicies

Represents the policies for an external client app to disable or enable plugins.

## Parent Type

This type extends the [Metadata](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/metadata.htm "The base class for all metadata types. You can’t edit this object. A component is an instance of a metadata type.") metadata type and inherits its fullName field.

## File Suffix and Directory Location

ExtlClntAppConfigurablePolicies components have the suffix .ecaPlcy and are stored in the extlClntAppPolicies folder.

## Version

ExtlClntAppConfigurablePolicies components are available in API version 60.0 and later.

## Special Access Rules

The View all External Client Apps, view their settings, and edit their policies user permission is required for users with admin roles to configure OAuth policies.

## Fields

| Field Name | Description |
| --- | --- |
| externalClientApplication | 
Field Type

string

Description

Required.

The name of the external client app associated with the plugins.



 |
| isEnabled | 

Field Type

boolean

Description

Required.

If true, all plugins are enabled unless individually disabled. If false, all plugins are disabled. The default value is true. Available in API version 60.0 and later.



 |
| isCanvasPluginEnabled | 

Field Type

boolean

Description

If true, the Canvas app plugin is enabled. If false, the Canvas app plugin is disabled. The default value is true. Available in API version 66.0 and later.



 |
| isMobilePluginEnabled | 

Field Type

boolean

Description

If true, the Mobile plugin is enabled. If false, the Mobile plugin is disabled. The default value is true. Available in API version 63.0 and later.



 |
| isNotificationPluginEnabled | 

Field Type

boolean

Description

If true, the Notification plugin is enabled. If false, the Notification plugin is disabled. The default value is true. Available in API version 63.0 and later.



 |
| isOauthPluginEnabled | 

Field Type

boolean

Description

If true, the OAuth plugin is enabled. If false, the OAuth plugin is disabled. The default value is true. Available in API version 60.0 and later.



 |
| isPushPluginEnabled | 

Field Type

boolean

Description

If true, the Push Notification plugin is enabled. If false, the Push Notification plugin is disabled. The default value is true. Available in API version 63.0 and later.



 |
| isSamlPluginEnabled | 

Field Type

boolean

Description

If true, the SAML plugin is enabled. If false, the SAML plugin is disabled. The default value is true. Available in API version 63.0 and later.



 |
| label | 

Field Type

string

Description

The OAuth policies name for the external client app.



 |
| startPage | 

Field Type

ExtlClntAppStartPage (enumeration type of string)

Description

Determines which URL to use for the start page.

- Custom
- None
- OAuth

Available in API version 63.0 and later.



 |
| startUrl | 

Field Type

string

Description

The custom URL where users are directed after they authenticate. For example, direct users to a specific page in the service provider app. Available in API version 63.0 and later.



 |

## Declarative Metadata Sample Definition

This example shows an ExtlClntAppConfigurablePolicies component.

<?xml version="1.0" encoding="UTF-8"?>
<ExtlClntAppConfigurablePolicies xmlns="http://soap.sforce.com/2006/04/metadata">
    <externalClientApplication>myeca</externalClientApplication>
    <isEnabled>true</isEnabled>
....<isCanvasPluginEnabled>true</isCanvasPluginEnabled>
    <isMobilePluginEnabled>true</isMobilePluginEnabled>
    <isNotificationPluginEnabled>true</isNotificationPluginEnabled>    
    <isOauthPluginEnabled>true</isOauthPluginEnabled>
    <isPushPluginEnabled>true</isPushPluginEnabled>
    <isSamlPluginEnabled>true</isSamlPluginEnabled>
    <label>myecapolicy</label>
    <startPage>OAuth</startPage>
    <startUrl>https://example.org</startUrl>
</ExtlClntAppConfigurablePolicies>

This example package.xml references the previous definition.

<?xml version="1.0" encoding="UTF-8"?>
<Package xmlns="http://soap.sforce.com/2006/04/metadata">
    <types\>
        <members\>\*</members\>
        <name\>ExternalClientApplication</name\>
    </types\>
    <types\>
        <members\>\*</members\>
        <name\>ExtlClntAppOauthSettings</name\>
    </types\>
    <types\>
        <members\>\*</members\>
        <name\>ExtlClntAppGlobalOauthSettings</name\>
    </types\>
    <types\>
        <members\>\*</members\>
        <name\>ExtlClntAppOauthConfigurablePolicies</name\>
    </types\>
    <types\>
        <members\>\*</members\>
        <name\>ExtlClntAppConfigurablePolicies</name\>
    </types\>
    <version\>60.0</version\>
</Package\>

## Wildcard Support in the Manifest File

This metadata type supports the wildcard character \* (asterisk) in the package.xml manifest file. For information about using the manifest file, see [Deploying and Retrieving Metadata with the Zip File](https://developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/file_based_zip_file.htm "The deploy() and retrieve() calls are used to deploy and retrieve a .zip file. Within the .zip file is a project manifest (package.xml) that lists what to retrieve or deploy, and one or more XML components that are organized into folders.").