Configurazione di app client esterne inseribili in pacchetti

Le app client esterne sono una soluzione eccellente in caso di creazione e utilizzo locale. Tuttavia, sono stati progettati pensando al packaging gestito. Le app del pacchetto possono essere distribuite ad altre organizzazioni. Determinare se inserire l'app in un pacchetto o mantenerla in locale. Le app del pacchetto che includono un plug-in OAuth possono essere distribuite per generare le proprie impostazioni OAuth univoche oppure per fare riferimento alle impostazioni dell'organizzazione in cui è stata sviluppata l'applicazione.

Per utilizzare organizzazioni vuote, prima abilitare il Developer Hub (Dev Hub) nella propria organizzazione. Le autorizzazioni specificate nel file di definizione dell'organizzazione vuota vengono riconosciute solo se sono abilitate nell'organizzazione Dev Hub.

Questa sezione descrive i diversi modi per inserire in pacchetti, distribuire e dissociare un'app client esterna che include un plug-in OAuth. Per impostare l'ambiente per le demo in questa sezione, sono stati abilitati gli utenti e le autorizzazioni dell'app client esterna in tre organizzazioni. Ciascuna viene utilizzata per la formazione di un'organizzazione diversa dell'app client esterna.

• L'organizzazione 1 è l'organizzazione di origine che memorizza il file delle impostazioni OAuth globali. Tutte le app client esterne distribuite che non dispongono di un proprio file di impostazioni globali fanno riferimento al file delle impostazioni globali in questa organizzazione. In uno scenario reale, questa organizzazione deve essere un'organizzazione non temporanea che rimane attiva per tutto il tempo in cui è in uso una delle app client esterne associate. Il nome utente di esempio per questa organizzazione è johndoe@example.com.
• L'organizzazione 2 include un'app client esterna distribuita dall'organizzazione 1. Fa riferimento al file delle impostazioni globali dell'organizzazione 1 per le credenziali OAuth. Il nome utente di esempio per questa organizzazione è johndoe@example2.com.
• L'organizzazione 3 include un'app client esterna distribuita dall'organizzazione 1, ma include un proprio file delle impostazioni globali con credenziali OAuth univoche. Il nome utente di esempio per questa organizzazione è johndoe@example3.com.

Esportazione dei metadati e distribuzione in una nuova organizzazione

Esportare i metadati dall'organizzazione di origine e quindi distribuirli in un'altra organizzazione. Al termine del processo, l'organizzazione di origine (organizzazione 1) e la nuova organizzazione (organizzazione 2) fanno riferimento al file delle impostazioni globali e ai dettagli consumatore OAuth per l'organizzazione di origine. Il file delle policy è facoltativo quando si esegue la distribuzione nell'altra organizzazione. Se il file delle policy esistente non è specificato nell'intestazione, il processo di distribuzione genera un nuovo file delle policy con valori predefiniti. La nuova organizzazione non può recuperare i metadati dal file delle impostazioni globali poiché ne è titolare l'organizzazione di origine e la nuova organizzazione può solo farvi riferimento.

Nota Se si elimina l'app client esterna dall'organizzazione di origine, l'app client esterna della nuova organizzazione smette di funzionare. Poiché nella nuova organizzazione è necessario un file di impostazioni globali delle impostazioniell'organizzazione di origine, la rimozione del file provoca l'errore del flusso OAuth nella nuova organizzazione.

• Recupero dei dati dall'organizzazione di origine
  È possibile ottenere i metadati dell'app client esterna dall'organizzazione di origine mediante un'operazione retrieve.
• Distribuzione di un'app client esterna che faccia riferimento al file delle impostazioni OAuth globali dell'organizzazione di origine
  Distribuire un'app client esterna in una nuova organizzazione e fare in modo che faccia riferimento alle credenziali dell'organizzazione di origine. Per configurare questa relazione, modificare il link OAuth nel file delle impostazioni OAuth e rimuovere il riferimento al file delle impostazioni OAuth globali nel file manifesto package.xml della nuova organizzazione.
• Distribuzione di un'app client esterna con un nuovo file delle impostazioni OAuth globali
  Distribuire i metadati dell'organizzazione di origine in un'organizzazione con un proprio consumatore OAuth. Per configurare l'app, rimuovere il link OAuth nel file delle impostazioni OAuth e aggiungere un riferimento al file delle impostazioni OAuth globali nel file manifesto package.xml della nuova organizzazione.
• Associazione e dissociazione di app client esterne
  Le app client esterne sono progettate per la creazione di pacchetti di seconda generazione (2GP), il che significa che sono ottimizzate per lo sviluppo basato sulle fonti nelle organizzazioni vuote.