Crear una aplicación cliente externa local con API de metadatos

Después de crear un proyecto de Salesforce DX, configure el proyecto para crear una aplicación cliente externa local.

1. Actualice su archivo de configuración de proyecto denominado sfdx-project.json agregando la URL de su dominio al parámetro sfdcLoginUrl.
   Para buscar la URL de Mi dominio, ingrese Mi dominio en el cuadro Búsqueda rápida y, a continuación, haga clic en Mi dominio.

   {
     "packageDirectories": [
       {
         "path": "force-app",
         "default": true
       }
     ],
     "name": "myEca",
     "namespace": "",
     "sfdcLoginUrl": "https://<URL from My Domain>",
     "sourceApiVersion": "61.0"
   }

2. Agregue estos parámetros al archivo de definición de organización borrador denominado project-scratch-def.json.
   • En el campo features, agregue ExternalClientApps y ExtlClntAppSecretExposeCtl.
   • En el campo settings, agregue el externalClientAppSettings y establezca la configuración de enableExternalClientApps en true.

     "features": ["EnableSetPasswordInApi", "ExternalClientApps", "ExtlClntAppSecretExposeCtl"],
     "settings": {
       "externalClientAppSettings": {
         "enableExternalClientApps": true
       },

3. Cree un archivo de manifiesto package.xml en el directorio de proyectos que hace referencia a este tipo.
   • ExternalClientApplication

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

4. En el directorio <directorio de proyecto>/force-app/main/default/, cree un directorio denominado externalClientApps.
5. En el directorio externalClientApps, cree un archivo denominado [ECAPP_NAME].eca-meta.xml. Por ejemplo, myeca.eca-meta.xml. Este archivo es el archivo de encabezado, que se utiliza para definir la aplicación cliente externa.
6. Configure el archivo de encabezado [ECAPP_NAME].eca-meta.xml. Asegúrese de que el estado de distribución está establecido como local y configure el archivo con esta información.

   Campo	Descripción
   contactEmail	Este campo es obligatorio. Tipo: Cadena. La dirección de email que Salesforce o el equipo de asistencia utilizan para hacer contacto con usted.
   descripción	Este campo es opcional. Tipo: Cadena. Una descripción opcional para su aplicación.
   distributionState	Este campo es obligatorio. Tipo: Cadena. El estado de distribución de una aplicación cliente externa. Los valores pueden ser Local o Packaged. Una aplicación cliente externa local no funciona fuera del contexto de una organización. La selección del estado Packaged hace que la aplicación cliente externa 2GP se pueda empaquetar.
   iconUrl	Este campo es opcional. Tipo: Cadena. Reservado para uso futuro.
   infoUrl	Este campo es opcional. Tipo: Cadena. URL opcional para una página web que muestra más información sobre su aplicación.
   label	Este campo es obligatorio. Tipo: Cadena. El nombre de la aplicación.
   logoUrl	Este campo es opcional. Tipo: Cadena. El logotipo aparece con la entrada de la aplicación en la lista de aplicaciones y en la página de consentimiento que ve el usuario al autenticarse.
   isProtected	Este campo es opcional. Tipo: Booleano. El concepto de un componente protegido proviene del empaquetado y los desarrolladores de paquetes pueden utilizar este indicador para controlar la visibilidad y la capacidad de modificación de sus componentes en organizaciones de suscriptor.
   orgScopedExternalApp	Este campo se genera durante la implementación inicial. Después de crearse, este campo es obligatorio. Tipo: Cadena. Identificador exclusivo de la aplicación cliente externa para la aplicación y la organización. Generado automáticamente durante la primera implementación. Valor previsto: [Organization_ID]:[Nombre de aplicación cliente externa].

   Este ejemplo muestra un archivo de encabezado de aplicación cliente externa.

   
   <?xml version="1.0" encoding="UTF-8"?>
   <ExternalClientApplication xmlns="http://soap.sforce.com/2006/04/metadata">
       <contactEmail>johndoe@example.com</contactEmail>
       <description>Test external client app</description>
       <distributionState>Local</distributionState>
       <isProtected>false</isProtected>
       <label>myeca</label>
   </ExternalClientApplication>

• Implementar una aplicación cliente externa local
  Todas las aplicaciones cliente externas se crean utilizando las operaciones de implementación y recuperación en la API de metadatos. Tras configurar el archivo package.xml, implemente la aplicación cliente externa.
• Habilitación de complementos de OAuth con API de metadatos
  En una aplicación cliente externa, el archivo de manifiesto package.xml hace referencia a los archivos de políticas y configuración para cada complemento. Para activar complementos de aplicaciones cliente externas, configure los archivos de configuración y haga referencia al complemento en el archivo de manifiesto.
• Implementar el complemento de OAuth de la aplicación cliente externa
  Tras configurar el archivo de configuración de OAuth y el archivo de configuración de OAuth global, implemente los cambios para actualizar la aplicación cliente externa.
• Verificar la generación de parámetros y políticas de OAuth
  Cuando se implementa el complemento de OAuth, se generan varios componentes de aplicaciones cliente externas. Existen algunas ubicaciones que puede comprobar para verificar si la implementación se realizó con éxito.
• Completar el flujo de OAuth
  Para verificar que la aplicación cliente externa funciona correctamente, realice una solicitud de extremo de autorización y una solicitud de extremo de token. La solicitud de extremo de token genera un token de acceso de API que se puede utilizar para acceder a cualquier API de Salesforce.