Konfigurer eksterne klientapps, der kan pakkes

Eksterne klientapps er en fremragende løsning, når de oprettes og bruges lokalt. Men de er designet med tanke på administreret pakning. Pakkede apps kan implementeres i andre organisationer. Bestem, om din app skal pakkes eller bevares lokalt. Pakkede apps, der inkluderer et OAuth-plugin, kan implementeres til at generere deres egne unikke OAuth-indstillinger, eller de kan henvise til indstillingerne for den organisation, hvor appen blev udviklet.

Hvis du vil arbejde med scratch-organisationer, skal du først aktivere Developer Hub (Dev Hub) i din organisation. De tilladelser, der er angivet i scratch-organisationens definitionsfil, genkendes kun, hvis de er aktiveret i Dev Hub.

Dette afsnit beskriver de forskellige måder at pakke, distribuere og frakoble en ekstern klientapp, der inkluderer et OAuth-plugin. For at opsætte miljøet for demos i dette afsnit aktiverede vi eksterne klientappbrugere og tilladelser på tre organisationer. Hver bruges til en anden ekstern formatering af klientapp.

• Organisation 1 er den kildeorganisation, der lagrer den globale OAuth-indstillingsfil. Alle implementerede eksterne klientapps, der ikke har deres egen globale indstillingsfil, refererer til den globale indstillingsfil i denne organisation. I et virkelighedsscenarie skal denne organisation være en ikke-efemeral organisation, der forbliver aktiv, så længe alle eksterne klientapps, der er tilknyttet, er i brug. Eksempelbrugernavnet for denne organisation er johndoe@example.com.
• Organisation 2 indeholder en ekstern klientapp, der implementeres fra organisation 1. Den refererer til organisationens globale indstillingsfil for OAuth-legitimationsoplysninger. Eksempelbrugernavnet for denne organisation er johndoe@example2.com.
• Organisation 3 indeholder en ekstern klientapp, der implementeres fra organisation 1, men den indeholder sin egen globale indstillingsfil med entydige OAuth-legitimationsoplysninger. Eksempelbrugernavnet for denne organisation er johndoe@example3.com.

Eksporter metadata, og implementer på ny organisation

Eksporter metadataene fra din kildeorganisation, og implementer dem derefter i en anden organisation. Når denne proces er fuldført, refererer både kildeorganisationen (organisationen 1) og den nye organisation (organisationen 2) til den globale indstillingsfil og OAuth-forbrugerdetaljerne for kildeorganisationen. Politikfilen er valgfri, når den implementeres i den anden organisation. Hvis den eksisterende politikfil ikke er angivet i sidehovedet, genererer implementeringsprocessen en ny politikfil med standardværdier. Den nye organisation kan ikke hente metadata fra den globale indstillingsfil, da kildeorganisationen ejer dem, og den nye organisation kun kan henvise til dem.

Bemærk Hvis du sletter den eksterne klientapp fra kildeorganisationen, afbrydes den nye organisations eksterne klientapp. Da den nye organisation kræver en global indstillingsfil på kildeorganisationen, medfører fjernelse af filen, at OAuth-forløbet mislykkes i den nye organisation.

• Hent data fra kildeorganisationen
  Hent eksterne klientappmetadata fra kildeorganisationen ved brug af en hentningshandling.
• Implementer en ekstern klientapp, der refererer til kildeorganisationens globale OAuth-indstillingsfil
  Implementer en ekstern klientapp i en ny organisation, og få den til at henvise til kildeorganisationens legitimationsoplysninger. Hvis du vil konfigurere denne relation, skal du redigere OAuth-linket i OAuth-indstillingsfilen og fjerne referencen til den globale OAuth-indstillingsfil i pakke.xml-manifestfilen for den nye organisation.
• Implementer en ekstern klientapp med en ny global OAuth-indstillingsfil
  Implementer kildeorganisationens metadata på en organisation med dens egen OAuth-forbruger. Hvis du vil konfigurere appen, skal du fjerne OAuth-linket i OAuth-indstillingsfilen og føje en reference til den globale OAuth-indstillingsfil i pakke.xml-manifestfilen på den nye organisation.
• Tilknytning og afbrydelse af eksterne klientapps
  Eksterne klientapps er designet til andengenerationspakke (2GP), hvilket betyder, at de er optimeret til kildestyret udvikling på scratch-organisationer.