Yhteyksien luominen ja hallinta API-rajapinnoillesi
Luo yhteyksiä valtuuttaaksesi toimintojen käytön, joita aktivoit MuleSoft API -rajapinnoille ja HTTP-kutsuille Salesforcessa. Luot yhteyksiä muille ulkoisille API-lähteille API-katalogin ulkopuolelta ja voit tarkastella yhteyksiä katalogista.
Vaaditut versiot
| Käytettävissä: Lightning Experiencessa |
| Käytettävissä: Developer Edition-, Enterprise Edition-, Performance Edition- ja Unlimited Edition -versioissa |
Luo yhteyksiä ennen kuin aktivoit toiminnon API-rajapinnoillesi. Jos MuleSoft API:lla ei ole vielä yhteyttä, kun aktivoit API:lle toimintoja, sinua ohjataan yhteyden luontiprosessin läpi.
- Kirjoita Salesforcen Määritykset-valikon Pikahaku-kenttään API-katalogi ja valitse API-katalogi.
- Valitse MuleSoft API, jolle haluat aktivoida toimintoja.
- Luo yhteys ja aktivoi toimintoja napsauttamalla Aktivoi toiminnot.
- Valitse API-versio.
- Jos haluat mukauttaa yhteyden oletusarvoista otsikkoa ja nimeä, kirjoita ne ylle.
- Anna kuvaus.
-
Valitse kohde-URL (API-esiintymä), jota käytetään hallituksi nimetyksi tunnukseksi tälle Salesforce-yhteydelle. Jos et pääse valitsemaasi kohteeseen, pyydä Anypoint Platform -pääkäyttäjääsi hyväksymään käyttöoikeus ja tarkastamaan sen tila uudelleen. Valitse palvelutasosopimus tarvittaessa. Lisätietoja on kohdassa MuleSoft-dokumentaatio: Asiakassovellukset, sopimukset ja tunnukset.
Huomautus Kohde-URL-osoitteessa voi olla vain yksi yhteys. -
Napsauta Luo ja jatka.
Yhteyden kokoonpano luodaan automaattisesti API-rajapinnoille, jotka käyttävät asiakastunnusten käyttöönottoa MuleSoftin kautta, mukaan lukien ulkoiset tunnukset, nimetyt tunnukset, ulkoiset palvelut ja käyttöoikeusjoukot.
Jos API käyttää ulkoisia tai mukautettuja todennusprotokollia, API-katalogi luo nimetyn tunnuksen ja määrittää yhteyden todennuksen tilaksi Mukautettu. Kun olet suorittanut yhteyden, vahvista yhteyden tunnukset ja määritä ne tarvittaessa. Lisätietoja on kohdassa Ulkoisen tunnuksen luominen tai muokkaaminen.
Ensimmäinen luomasi yhteys määritetään automaattisesti oletusarvoiseksi yhteydeksi. Jos haluat käyttää automaatioissasi toista yhteyttä, määritä se oletusarvoiseksi yhteydeksi.
Et voi palata päivittämään yhteyttä välittömästi, mutta voit aktivointiprosessin jälkeen. Kun olet luonut yhteyden, voit päivittää vain yhteyden otsikon ja kuvauksen. Jos haluat käyttää toista kohdesi URL-osoitetta, luo API-versiolle toinen yhteys käyttämällä uutta kohdesi URL-osoitetta.
Muista kohdistaa luomillesi yhteyksille käyttöoikeudet välttyäksesi käyttöoikeusvirheiltä, kun suoritat API-toimintoja.
Jatka toimintojen aktivoimista API:lle. Lisätietoja on kohdassa Kutsuttavien toimintojen aktivointi API-rajapinnoille.
Useiden yhteyksien luominen MuleSoft API:lle
Jos MuleSoft API:lla on useita kohde-URL-osoitteita (API-esiintymiä), voit luoda API:lle useita yhteyksiä. Sinulla voi kuitenkin olla vain yksi aktiivinen yhteys kerralla jokaiselle kohdesi URL-osoitteelle.
- Kirjoita Salesforcen Määritykset-valikon Pikahaku-kenttään API-katalogi ja valitse sitten API-katalogi.
- Valitse API, jolle haluat luoda yhteyden.
- Napsauta Uusi yhteys.
- Valitse API-versio.
- Jos haluat mukauttaa yhteyden oletusarvoista otsikkoa ja nimeä, joka on oletusarvoisesti API-nimi ja -versio, korvaa otsikko ja nimi.
- Anna kuvaus.
- Valitse kohde-URL (API-esiintymä), jota käytetään hallituksi nimetyksi tunnukseksi tälle Salesforce-yhteydelle. Jos et voi käyttää valitsemaasi kohdesi URL-osoitetta, pyydä Anypoint Platform -pääkäyttäjääsi hyväksymään käyttöoikeus ja tarkastamaan sen tila uudelleen. Valitse palvelutasosopimus tarvittaessa. Lisätietoja on kohdassa MuleSoft-dokumentaatio: Asiakassovellukset, sopimukset ja tunnukset.
-
Napsauta Valmis.
Yhteyden kokoonpano luodaan automaattisesti MuleSoftia käyttäville API-rajapinnoille, mukaan lukien ulkoiset tunnukset, nimetyt tunnukset, ulkoiset palvelut ja käyttöoikeusjoukot.
Jos API käyttää ulkoisia tai mukautettuja todennusprotokollia, API-katalogi luo nimetyn tunnuksen ja määrittää yhteyden todennuksen tilaksi Mukautettu. Kun olet suorittanut yhteyden, vahvista yhteyden tunnukset ja määritä ne tarvittaessa. Lisätietoja on kohdassa Ulkoisen tunnuksen luominen tai muokkaaminen.
Ensimmäinen luomasi yhteys määritetään automaattisesti oletukseksi. Jos haluat käyttää automaatioissasi toista yhteyttä, määritä se oletusarvoiseksi yhteydeksi.
Oletusarvoisten yhteyksien määrittäminen MuleSoft API -rajapinnoille
Määritä yhteys oletusarvoiseksi yhteydeksi, jota käyttävät automaatiot, jotka suorittavat asiaan liittyvän MuleSoft API:n toiminnot. Ensimmäinen luomasi yhteys määritetään automaattisesti oletukseksi.
- Valitse MuleSoft API:n versiolle Yhteydet-välilehti.
- Jos haluat määrittää yhteyden oletusarvoiseksi, valitse Määritä oletukseksi -toiminto .
Yhteyden luominen HTTP-callout-kutsulle
Jos haluat luoda yhteyden, joka tukee HTTP-callout-kutsua, luo yhteys suorittamatta aktivointitoimintoa.
- Kirjoita Salesforcen Määritykset-valikon Pikahaku-kenttään API-katalogi ja valitse sitten API-katalogi.
- Valitse API, jolle haluat luoda yhteyden.
- Napsauta Uusi yhteys.
- Valitse API-versio.
- Jos haluat mukauttaa yhteyden oletusarvoista otsikkoa ja nimeä, joka on oletusarvoisesti API-nimi ja -versio, korvaa otsikko ja nimi.
- Anna kuvaus.
- Valitse kohde-URL, jota käytetään hallitun nimetyn tunnuksenä tälle yhteydelle Salesforceen. API-katalogissa näytetään vain aktiiviset kohdesi-URL-osoitteet, joita hallitaan Anypoint API Managerissa.
-
Napsauta Valmis.
Yhteyskokoonpano luodaan automaattisesti, mukaan lukien ulkoiset tunnukset, nimetyt tunnukset, ulkoiset palvelut ja käyttöoikeusjoukot.
Käyttöoikeuksien kohdistaminen yhteyksille
Kun olet luonut yhteyden, myönnä tietyille Salesforce-käyttäjille aktivoitujen toimintojen käyttöoikeudet, jotta he voivat käyttää niitä Salesforce-automaatioissaan. Sinua pyydetään kohdistamaan API-yhteyksien käyttöoikeudet osana yhteyksien luontiprosessia. Jos ohitat tämän vaiheen, voit kohdistaa käyttöoikeudet myöhemmin. Kohdista käyttöoikeudet ennen kuin yrität käyttää niihin liittyviä API-toimintoja välttyäksesi käyttöoikeusvirheiltä.
- Kirjoita Salesforcen Määritykset-valikon Pikahaku-kenttään API-katalogi ja valitse sitten API-katalogi.
- Valitse API, jolle haluat määrittää yhteyden käyttöoikeudet.
-
Jos Käyttöoikeustila ei ole kohdistettu API:lle tai haluat päivittää käyttöoikeuden kohdistuksen, napsauta Kohdista.
API-käyttöoikeusjoukkosivu avautuu.
- Hallitse ja lisää käyttäjien kohdistuksia organisaatiosi standardien mukaisesti. Lisätietoja on kohdassa Käyttöoikeusjoukkojen kohdistusten hallinta.
Yhteyksien muokkaaminen
Voit päivittää yhteyksien otsikon tai kuvauksen.
- Kirjoita Salesforcen Määritykset-valikon Pikahaku-kenttään API-katalogi ja valitse sitten API-katalogi.
- Valitse muokattava API-versio.
- Napsauta Yhteydet-välilehdestä Muokkaa.
- Päivitä yhteyden otsikko tai kuvaus.
Jos haluat käyttää toista kohdesi URL-osoitetta, luo API-versiolle toinen yhteys käyttämällä uutta kohdesi URL-osoitetta.
Yhteyksien poistaminen
Poista käyttämättömät yhteydet, jotka eivät ole oletusarvoisia.
- Kirjoita Salesforcen Määritykset-valikon Pikahaku-kenttään API-katalogi ja valitse sitten API-katalogi.
- Valitse API, jonka yhteyden haluat poistaa.
-
Valitse Yhteydet-välilehdestä yhteys, joka ei ole oletusarvoinen, ja napsauta Poista.
Jos haluat poistaa oletusarvoiseksi määritetyn yhteyden, määritä eri yhteys oletusarvoiseksi ja poista sitten ei-oletusarvoinen yhteys. Lisätietoja on kohdassa Yhteyksien luominen ja hallinta API-rajapinnoillesi.
