breadcrumbDescription
Opret og rediger en navngivet legitimationsoplysning
Konfigurer en navngiven legitimationsoplysning for at angive URL'en for et udkaldsslutpunkt. Hvis du vil angive de krævede godkendelsesparametre for udkaldet, skal du tilslutte de navngivne legitimationsoplysninger til en ekstern legitimationsoplysning.
EditionsHeading
| Tilgængelig i: både Salesforce Classic (ikke tilgængelig i alle organisationer) og Lightning Experience |
| Tilgængelig i: Alle versioner |
| Brugertilladelser påkrævet | |
|---|---|
| Hvis du vil se navngivne legitimationsoplysninger: | Vis opsætning og konfiguration |
| Hvis du vil oprette, redigere eller slette navngivne legitimationsoplysninger: | Administrer navngivne legitimationsoplysninger, eller tilpas applikationer |
Før du opretter en navngiven legitimationsoplysning, skal du oprette en ekstern legitimationsoplysning, som du kan linke den til. Se Opret eller rediger en ekstern legitimationsoplysning. Hvis du ønsker en oversigt over de trin, der kræves for at konfigurere en navngivet legitimationsoplysning, kan du se Opret navngivne legitimationsoplysninger og eksterne legitimationsoplysninger.
- Skriv Navngivne legitimationsoplysninger i feltet Find hurtigt i Opsætning, og vælg derefter Navngivne legitimationsoplysninger.
- Klik på Navngivne legitimationsoplysninger.
-
Hvis du vil oprette en ny navngiven legitimationsoplysning, skal du klikke på Ny. Hvis du vil redigere en eksisterende navngiven legitimationsoplysning, skal du klikke på dens link på listen over navngivne legitimationsoplysninger og derefter klikke på Rediger.
Bemærk Hvis du ønsker at oprette en ældre navngivet legitimationsoplysning, skal du vælge Ny ældre fra rullemenuen i stedet for og følge instruktionerne i Definer en ældre navngivet legitimationsoplysning. Forældede navngivne legitimationsoplysninger opdateres eller forbedres ikke længere. -
Udfyld felterne
Felt Beskrivelse Betegnelse Et brugervenligt navn for den navngivne legitimationsoplysning, der vises i Salesforce-brugergrænsefladen, f.eks. i listevisninger. Navn En entydig identifikator, der bruges til at referere til denne navngivne legitimationsoplysning fra udkaldsdefinitioner og gennem API'en.
Navnet må kun indeholde understregningstegn og alfanumeriske tegn. Det skal være entydigt og begynde med et bogstav og må ikke indeholde mellemrum, ikke ende med en understregning og ikke indeholde to understregningstegn efter hinanden.
URL URL'en eller rod-URL'en for udkaldsslutpunktet. Skal starte med
https://. Kan inkludere en sti, men ikke en forespørgselsstreng. Eksempel:https://my_endpoint.example.com/secure/payrollDu kan dog tilføje en forespørgselsstrng og en specifik sti i udkaldsdefinitionens reference til de navngivne legitimationsoplysninger.
F.eks. kan et Apex-udkald referere til den navngivne legitimationsoplysning "My_Payroll_System" på følgende måde.
HttpRequest req = new HttpRequest(); req.setEndpoint('callout:My_Payroll_System/paystubs?format=json');Aktiveret for udkald Som standard er muligheden for at foretage udkald med de navngivne legitimationsoplysninger aktiveret. Der er to undtagelser, hvor dette felt er deaktiveret: Når de navngivne legitimationsoplysninger oprettes fra en Apex, eller når ethvert slutpunkt i den navngivne legitimationsoplysning eller dens relaterede eksterne legitimationsoplysninger eller godkendelsesidentitetsudbyder opdateres fra en Apex. Vær opmærksom på sikkerhedsovervejelser, når du aktiverer udkald for navngivne legitimationsoplysninger, der stammer fra eller opdateres fra Apex. Godkendelse Ekstern legitimationsoplysning Navnet på en ekstern legitimationsoplysning. Se Opret eller rediger en ekstern legitimationsoplysning. Klientcertifikat Valgfrit. Hvis du angiver et certifikat, leverer Salesforce-organisationen det, når du etablerer hver to-vejs SSL-forbindelse med det eksterne system. Certifikatet bruges til digitale signaturer, der bekræfter, at anmodninger kommer fra din Salesforce-organisation. Udkaldsindstillinger Generer godkendelsessidehoved Salesforce genererer som standard et godkendelsessidehoved og anvender det på hvert udkald, der henviser til den navngivne legitimationsoplysning.
Fravælg kun denne indstilling, hvis en af følgende erklæringer gælder.
- Fjernslutpunktet understøtter ikke godkendelsessidehoveder.
- Du genererer et godkendelsessidehoved ved at oprette et tilpasset sidehoved og navngive det "Godkendelse". Opret f.eks. et tilpasset godkendelsessidehoved, hvis du bruger HTTP-basisgodkendelse. På samme måde kan du i Apex-udkald få koden til at konstruere et tilpasset godkendelsessidehoved for hvert udkald.
Denne indstilling kræves, hvis du refererer til den navngivne legitimationsoplysning fra en ekstern datakilde. Se Tilpassede sidehoveder og hovedtekster for Apex-udkald, der bruger navngivne legitimationsoplysninger.
Tillad formler i HTTP-sidehoved Brug legitimationsoplysningsfelter som formelfelter i tilpassede sidehoveder for navngivne legitimationsoplysninger, tilpassede sidehoveder for eksterne legitimationsoplysninger og Apex HTTP-sidehoveder. Eksempel:
Client-ID: {!$Credential.MyExtCred.MyClientId}Standard er falsk. Se Tilpassede sidehoveder og hovedtekster for Apex-udkald, der bruger navngivne legitimationsoplysninger.
Tillad formler i HTTP-brødtekst Tillad Apex at konstruere udkaldets HTTP-brødtekst med legitimationsoplysningsfelter, der er tilgængelige som formelfelter. Standard er falsk. Se Tilpassede sidehoveder og hovedtekster for Apex-udkald, der bruger navngivne legitimationsoplysninger. Udgående netværksforbindelse Brug en privat forbindelse, der tilsidesætter det offentlige internet. Angiv navnet på en eksisterende udgående netværksforbindelse. Se Sikre kryds-cloud-integrationer med Private Connect.
Hvis du vælger denne indstilling, har din nye navngivne legitimationsoplysning PrivateEndpoint som dens type. Ellers har de navngivne legitimationsoplysninger typen SecuredEndpoint.
Tilladte navneområder for udkald Valgfri liste over navneområder, der identificerer de administrerede pakker, der har tilladelse til at foretage udkald ved brug af disse navngivne legitimationsoplysninger.
- For administrerede pakker skal abonnenten føje pakkens navneområde til en navngiven legitimationsoplysnings liste over tilladte navneområder for at aktivere udkald. Denne handling er ikke nødvendig, hvis de navngivne legitimationsoplysninger er installeret som en del af den samme pakke.
- Hvis du har flere organisationer, kan du oprette navngivne legitimationsoplysninger med det samme navn, men med en forskellig slutpunkts-URL i hver organisation. Du kan derefter pakke og implementere - på alle organisationerne - en udkaldsdefinition, der refererer til det delte navn for disse navngivne legitimationsoplysninger. Hver af disse navnegivne legitimationsoplysninger i hver organisation kan f.eks. have forskellige slutpunkts-URL'er for at tage højde for forskelle i udviklings- og produktionsmiljøer. Hvis et Apex-udkald angiver det delte navn for de navngivne legitimationsoplysninger, kan Apex-klassen, der definerer udkaldet, være pakket og implementeret på alle disse organisationer, uden at miljøet kontrolleres via programmering.
Navngivne legitimationsoplysninger føjes ikke automatisk til pakker. Hvis du pakker en ekstern datakilde eller Apex-kode, der angiver navngivne legitimationsoplysninger som et udkaldsslutpunkt, skal du føje de navngivne legitimationsoplysninger til pakken. Du kan også sørge for, at abonnentorganisationen har gyldige navngivne legitimationsoplysninger med det samme navn.
- Klik på Save (Gem). Du føres til skærmen Navngivne legitimationsoplysninger.
- Opret et tilpasset sidehoved for denne navngivne legitimationsoplysning, eller rediger et eksisterende tilpasset sidehoved. Se Opret og rediger tilpassede sidehoveder.
Hvis du vil referere til en navngiven legitimationsoplysning fra en udkaldsdefinition, skal du bruge den navngivne legitimations-URL. En navngivet legitimationsoplysnings-URL indeholder skemaudkaldet callout:, navnet på den navngivne legitimationsoplysning og en eventuel sti. Eksempel: callout:My_Named_Credential/ some_path.
Du kan tilføje en forespørgselsstreng til en navngivet legitimationsoplysnings-URL. Brug et spørgsmålstegn (?) som separator mellem den navngivne legitimationsoplysnings-URL og forespørgselsstrengen. Eksempel: callout:My_Named_Credential/ some_path?format=json.
Du har fuldført hovedtrinene til at oprette en navngivet legitimationsoplysning. Tildel derefter adgang til eksterne legitimationsoplysninger og eksterne brugerlegitimationsoplysninger for at autorisere brugere til at foretage godkendte udkald.
