Integrar un proveedor de servicio de SSO de SAML como una aplicación cliente externa

Crear la aplicación cliente externa principal

<?xml version="1.0" encoding="UTF-8"?>
<ExternalClientApplication xmlns="http://soap.sforce.com/2006/04/metadata">
    <contactEmail>johndoe@example.com</contactEmail>
    <description>SAML external client app to integrate third-party service provider</description>
    <distributionState>Local</distributionState>
    <isProtected>false</isProtected>
    <label>mysamleca</label>
</ExternalClientApplication>

Crear la configuración de políticas de aplicación cliente externa

1. En el directorio <directorio de proyecto>/force-app/main/default/, cree un directorio denominado extlClntAppPolicies.
2. En extlClntAppPolicies, cree un archivo denominado <nombre de política de CEPA>.ecaPlcy-meta.xml.
3. Configure el archivo <ECA policy name>.ecaPlcy-meta.xml con estos campos.

   Campo	Descripción
   externalClientApplication	El nombre de la aplicación cliente externa principal como se especifica en su campo de etiqueta.
   isEnabled	Define si la aplicación cliente externa puede utilizar complementos. Establezca este campo como true.
   isOauthPluginEnabled	Define si la aplicación cliente externa puede utilizar el complemento de OAuth. Como el complemento isEnabled activa automáticamente todos los complementos y esta aplicación solo es para SAML, establezca este campo en false.
   isSamlPluginEnabled	Determina si la aplicación cliente externa puede utilizar el complemento SAML. Establezca este campo como true.
   label	El nombre de las políticas configurables.

   Este es un archivo de ejemplo <nombre de política de ECA>.ecaPlcy-meta.xml.

   <?xml version="1.0" encoding="UTF-8"?>
          <ExtlClntAppConfigurablePolicies xmlns="http://soap.sforce.com/2006/04/metadata">
           <externalClientApplication>mysamleca</externalClientApplication>
           <isEnabled>true</isEnabled>
           <isSamlPluginEnabled>true</isSamlPluginEnabled>
           <isOauthPluginEnabled>false</isOauthPluginEnabled>
           <label>myecapolicy</label>
          </ExtlClntAppConfigurablePolicies>

Crear la configuración de políticas SAML de la aplicación cliente externa

1. En su directorio <directorio project>/force-app/main/default/, cree un directorio denominado extlClntAppSamlConfigurablePolicies.
2. En extlClntAppSamlConfigurablePolicies, cree un archivo denominado <nombre de política SAML de ECA>.ecaSamlPlcy-meta.xml.
3. Configure los campos para el archivo <ECA SAML policy name>.ecaSamlPlcy-meta.xml.
   Para obtener información detallada acerca de qué campos incluir, consulte el tipo de metadatos ExtlClntAppSamlConfigurablePolicies en la Guía de referencia de API de metadatos.
   Este es un archivo de ejemplo <nombre de política SAML de ECA>.ecaSamlPlcy-meta.xml. Esta definición incluye atributos personalizados, que se especifican en los subtipos ExtlClntAppSamlConfigurablePoliciesAttribute.

   <?xml version="1.0" encoding="UTF-8"?>
   <ExtlClntAppSamlConfigurablePolicies xmlns="http://soap.sforce.com/2006/04/metadata">
       <acsUrl>https://www.<serviceprovideracsurl>.com</acsUrl>
       <entityUrl>https://www.<serviceproviderentityid>.com</entityUrl>
       <externalClientApplication>mysamleca</externalClientApplication>
       <issuer>https://mydomainname.my.salesforce.com</issuer>
       <label>myeca_samlpolicies</label>
       <nameIdFormat>Unspecified</nameIdFormat>
       <singleLogoutUrl>https://www.<serviceprovidersinglelogouturl>.com</singleLogoutUrl>
       <singleLogoutBindingType>RedirectBinding</singleLogoutBindingType>
       <subjectType>CustomAttribute</subjectType>
       <subjectCustomAttribute>MyCustomField</subjectCustomAttribute>
       <certificate>MIIDzDCCArQCCQCFaZKGsGqZ...</certificate>
       <encryptionCertificate>MIIDzDCCArQCCQCFaZKGsGqZ...</encryptionCertificate>
       <encryptionType>AES_128</encryptionType>
       <signingAlgorithmType>SHA1</signingAlgorithmType>
       <customAttributes>
           <key>User Firstname</key>
           <formula>$User.FirstName</formula>
       </customAttributes>
       <customAttributes>
           <key>User Country</key>
           <formula>$User.Country</formula>
       </customAttributes>
   </ExtlClntAppSamlConfigurablePolicies>

Crear el archivo package.xml

1. En su <directorio de proyectos>, cree un archivo denominado package.xml. No cree una subcarpeta para este archivo. Esta es la estructura del archivo.
   
2. Agregue referencias a los tipos de metadatos ExternalClientApplication, ExtlClntAppConfigurablePolicies y ExtlClntAppSamlConfigurablePolicies al archivo package.xml.
   A continuación se incluye un ejemplo del archivo package.xml.

   <?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>ExtlClntAppConfigurablePolicies</name>
       </types>
       <types>
           <members>*</members>
           <name>ExtlClntAppSamlConfigurablePolicies</name>
       </types>
       <version>63.0</version>
   </Package>

Implementar la aplicación cliente externa activada por SAML

Envíe los cambios desde su directorio de proyecto local a Salesforce.

1. Abra una nueva ventana Terminal.
2. Vaya al <directorio de proyectos>.
3. Para implementar el archivo package.xml, ejecute este comando.

   sf project deploy start --manifest package.xml -o <username@targetorg.com>

4. Para verificar que los metadatos se implementaron correctamente, ejecute este comando.

   sf project retrieve start --source-dir force-app -o <username@targetorg.com>

   Después de implementar la aplicación cliente externa, puede verla en el Gestor de aplicación cliente externa en Configuración. Pero no puede ver o modificar su información de configuración de SAML desde Configuración.

Modificar la aplicación cliente externa activada por SAML

Si es necesario, realice modificaciones en la configuración SAML de su aplicación cliente externa.

1. Actualice los archivos de componentes de metadatos correspondientes en su directorio <directorio de proyecto>/force-app/main/default/.
   • Para actualizar información general sobre la aplicación cliente externa, como su descripción o correo electrónico de contacto, modifique el archivo <nombre de aplicación cliente externa>.eca-meta.xml.
   • Para actualizar las políticas de la aplicación cliente externa, como la etiqueta para el componente de políticas, modifique el archivo <nombre de política de ECA>.ecaPlcy-meta.xml.
   • Para actualizar la información de configuración de SAML, modifique el archivo <ECA SAML policy name>.ecaSamlPlcy-meta.xml.
2. Para enviar los cambios a Salesforce, implemente el archivo package.xml de nuevo ejecutando este comando.

   sf project deploy start --manifest package.xml -o <username@targetorg.com>

   Complete este paso incluso si modifica solo uno de los componentes. No puede implementar un único componente.
3. Para verificar que los metadatos se implementaron correctamente, ejecute este comando.

   sf project retrieve start --source-dir force-app -o <username@targetorg.com>