Definer en ældre navngivet legitimationsoplysning
Opret en ældre navngiven legitimationsoplysning for at angive URL'en for et udkaldsslutpunkt og dens påkrævede godkendelsesparametre i en definition. Du kan derefter angive den ældre navngivne legitimationsoplysning som et udkaldsslutpunkt for at lade Salesforce håndtere al godkendelse. Du kan også springe over indstillinger for fjernlokalitet, som ellers kræves for udkald til eksterne lokaliteter, for den lokalitet, der er defineret i de ældre navngivne legitimationsoplysninger.
Nødvendige utgaver
| Tilgjengelig i både Salesforce Classic og Lightning Experience |
| Tilgjengelig i alle versjoner |
| Nødvendige brukertillatelser | |
|---|---|
| Hvis du vil se ældre navngivne legitimationsoplysninger: | Vise oppsett og konfigurasjon |
| Hvis du vil oprette, redigere eller slette ældre navngivne legitimationsoplysninger: | Behandle navngitt legitimasjon eller tilpasse programmer |
Tidligere navngitt legitimasjon støttes i disse typene oppkallsdefinisjoner:
- Apex-oppkall
- Eksterne datakilder av disse typene:
- Salesforce Connect: OData 2.0
- Salesforce Connect: OData 4.0
- Salesforce Connect: Tilpassede (utviklet med Apex Connector Framework)
- Salesforce Connect: Amazon DynamoDB
- Eksterne tjenester
Slik konfigurerer du en tidligere navngitt legitimasjon:
- Skriv inn Navngitt legitimasjon i Hurtigsøk-feltet i Oppsett, og velg deretter Navngitt legitimasjon.
- Hvis du vil opprette en tidligere navngitt legitimasjon, klikker du på Ny tidligere fra rullegardinmenyen. Hvis du vil redigere en eksisterende tidligere legitimasjon, klikker du på lenken til den og klikker på Rediger.
-
Angiv oplysninger i felterne.
-
Velg godkjenningsprotokollen.
- Hvis du velger Passordgodkjenning, fyller du ut brukernavn og passord for tilgang til det eksterne systemet.
- Hvis du velger OAuth 2.0, fyller du ut følgende felt.
Felt Beskrivelse Godkjenningsleverandør Velg leverandøren. Se Godkjenningsleverandører. Omfang Angir omfanget av tillatelser for å be om tilgangstoken. Godkjenningsleverandører bestemmer verdiene som er tillatt. Se Bruke scope-parameteren.
- Verdien du oppgir, erstatter verdien for Standard omfang som er definert i den angitte godkjenningsleverandøren.
- Om omfang defineres eller ikke, kan påvirke om OAuth-flyten viser brukeren et samtykkeskjermbilde.
- Vi anbefaler at du ber om et oppdateringstoken eller offline-tilgang. Eller mister du tilgang til det eksterne systemet når tokenet utløper.
Start godkjenningsflyt ved lagring Merk denne avmerkingsboksen for å godkjennes i det eksterne systemet og hente et OAuth-token. Denne godkjenningsprosessen kalles en OAuth-flyt.
Når du klikker på Lagre, blir du bedt om å logge på det eksterne systemet. Etter vellykket pålogging gir det eksterne systemet deg et OAuth-token for tilgang til data fra denne organisasjonen.
Gjenta OAuth-flyten når du trenger et nytt token, for eksempel hvis tokenet utløper, eller hvis du redigerer feltene Omfang eller Godkjenningsleverandør. Når tokenet utløper, returnerer det eksterne systemet en 401 HTTP-feilstatus.
- Fyll ut følgende felt hvis du velger JWT eller JWT-tokenutveksling.
Felt Beskrivelse Utsteder Angi hvem som utstedte JWT, og bruk en streng som skiller mellom store og små bokstaver. Omfang Bare for JWT-tokenutveksling. Bestemmer hvilke tillatelser som skal knyttes tokenet du ber om. URL-adresse for tokensluttpunkt Bare for JWT-tokenutveksling. URL-adressen til godkjenningsleverandøren. JSON Web Token-forespørsler sendes til leverandøren i bytte for tilgangstokener. Per bruker-emne Bare for identitetstypen Per bruker. Formelstreng som beregner JWT-emnet. Inkluder API-navn og konstantstrenger i anførselstegn. Gir mulighet for et dynamisk emne som er unikt per bruker som ber om tokenet. For eksempel 'User='+$User.Id. Navngitt hovedbruker-emne Bare for identitetstypen Navngitt hovedbruker. Skriv statisk tekst, uten anførselstegn, som angir JWT-emnet. Målgrupper Ekstern tjeneste eller andre tillatte mottakere for JWT. Lagre hver målgruppe som en streng der det skilles mellom store og små bokstaver, på en ny linje. Token gyldig i Hvor lang tid tokenet skal være gyldig for å godkjenne brukeren for det eksterne systemet. JWT-signeringssertifikat Sertifikat som kontrollerer JWT-tokenets pålitelighet for eksterne systemer. - Hvis du velger AWS-signatur versjon 4, fyller du ut følgende felt.
Felt Beskrivelse AWS-tilgangsnøkkel-ID Første del av tilgangsnøkkelen som brukes til å signere programmatiske forespørsler til AWS. AWS hemmelig tilgangsnøkkel Andre del av tilgangsnøkkel som brukes til å signere programmatiske forespørsler til AWS. AWS-område AWS-områdenavn for den ældre navngivne legitimationsoplysnings slutpunkt. For eksempel us-east-1. AWS-tjeneste AWS-verktøyet som skal brukes.
-
Hvis du vil bruke tilpassede hoder eller innhold i oppkallene, aktiverer du de aktuelle alternativene.
Felt Beskrivelse Generer godkjenningshode Salesforce genererer som standard et godkjenningshode og bruker det på hvert oppkall som referer til den tidligere navngitte legitimasjonen.
Fjern merket for dette alternativet hvis en av følgende gjelder.
- Det eksterne sluttpunktet støtter ikke godkjenningshoder.
- Godkjenningshodene leveres på andre måter. I Apex-oppkall kan utvikleren for eksempel få koden til å konstruere et tilpasset godkjenningshode for hvert oppkall.
Dette alternativet kreves hvis du refererer til den tidligere navngitte legitimasjonen fra en ekstern datakilde.
Tillat flettefelt i HTTP-hode
Tillat flettefelt i HTTP-innholdstekst
I hvert Apex-oppkall angir koden hvordan HTTP-hodet og -forespørselsteksten skal konstrueres. Apex-koden kan for eksempel angi verdien til en informasjonskapsel i godkjenningshodet.
Disse alternativene aktiverer Apex-koden til å bruke flettefelt til å fylle ut HTTP-hodet og -forespørselsteksten med organisasjonsdata når oppkallet utføres.
Disse indstillinger er ikke tilgængelige, hvis du refererer til den ældre navngivne legitimationsoplysning fra en ekstern datakilde.
Hvis du vil referere til en forældet navngiven legitimationsoplysning fra en udkaldsdefinition, skal du bruge den forældede navngivne legitimationsoplysnings-URL. En URL-adresse for tidligere navngitt legitimasjon inneholder skjemaets callout:, navnet på den tidligere navngitte legitimasjonen og en valgfri bane. Eksempel: callout:My_Named_Credential/some_path.
Du kan føje en forespørgselsstreng til en forældet navngiven legitimationsoplysnings-URL. Brug et spørgsmålstegn (?) som separator mellem den ældre navngivne legitimationsoplysnings-URL og forespørgselsstrengen. Eksempel: callout:My_Named_Credential/ some_path?format=json.

