Trustmary yhdistyy Salesforceen pienen sovelluksen kautta, joka luodaan asiakkaan omaan Salesforce-organisaatioon. Tiedot pysyvät organisaation omassa hallinnassa — Trustmarylla ei ole koskaan pääavainta jokaisen asiakkaan Salesforceen, vain ne tunnukset, jotka organisaatio itse luo ja antaa sille.

Koko asennus kestää noin 15 minuuttia, minkä lisäksi Salesforce tarvitsee hetken muutosten käyttöönottoon.

Vaatii: Salesforce-käyttäjän, jolla on ylläpitäjän oikeudet (System Administrator -profiili tai vastaava).

Vaiheet lyhyesti

1. Avaa Salesforcen Määritykset, sieltä Sovellusten hallinta, ja napsauta Uusi ulkoinen asiakassovellus.
2. Valitse Ota OAuth käyttöön, lisää vaikutusalue Hallitse käyttäjätietoja sovellusliittymien kautta (api), valitse Ota asiakassovelluksen tunnusten kulku käyttöön ja napsauta Luo.
3. Avaa sovelluksen Käytännöt-välilehti, napsauta Muokkaa, ota asiakassovelluksen tunnusten kulku käyttöön ja täytä Suorita nimellä -kenttä.
4. Avaa Asetukset-välilehdeltä OAuth-asetukset → Kuluttaja-avain ja -salaisuus ja kopioi molemmat arvot.
5. Avaa Määrityksistä Oma toimialueeni ja kopioi Nykyisen oman toimialueen URL-osoite.
6. Avaa Trustmaryssa Integraatiot → Salesforce ja syötä Kuluttaja-avain, toimialueen URL ja Kuluttajasalaisuus.

Vaihe 1 — Luo ulkoinen asiakassovellus (External Client App)

1. Napsauta hammasrataskuvaketta oikeassa yläkulmassa ja valitse Määritykset.
2. Jos Salesforce avautuu vanhempaan Classic-näkymään, napsauta ensin avataria oikeassa yläkulmassa ja valitse Siirry Lightning Experienceen — uudemmat asetussivut ovat helpompia seurata.
3. Kirjoita Määritysten pikahakuun Sovellusten hallinta ja avaa se.
4. Napsauta Uusi ulkoinen asiakassovellus oikeassa yläkulmassa.
5. Täytä perustiedot:
6. • Ulkoisen asiakassovelluksen nimi: Trustmary Integration
   • API-nimi: täyttyy automaattisesti
   • Yhteyshenkilön sähköpostiosoite: ylläpitäjän oma sähköpostiosoite

Vaihe 2 — Ota API-käyttöoikeus käyttöön

1. Valitse samalla sivulla Ota OAuth käyttöön osiossa API (Ota OAuth käyttöön).
2. Syötä kohtaan Callback URL osoite https://login.salesforce.com/services/oauth2/success. Salesforce vaatii osoitteen, mutta sitä ei koskaan käytetä — Trustmary ei ohjaa ketään sen kautta.
3. Lisää kohtaan OAuth-vaikutusalueet vaikutusalue Hallitse käyttäjätietoja sovellusliittymien kautta (api) valittujen listaan.
4. Valitse Ota asiakassovelluksen tunnusten kulku käyttöön. Salesforce näyttää turvallisuusvaroituksen — lue se ja vahvista.
5. Napsauta Luo.

Vaihe 3 — Valitse, minkä käyttäjän puolesta integraatio toimii

Client Credentials Flow tarvitsee tietyn Salesforce-käyttäjän, jonka puolesta se toimii. Kyseisen käyttäjän tavanomaiset käyttöoikeudet määrittävät, mitä integraatio voi nähdä ja muuttaa.

1. Avaa Trustmary Integration -sovelluksen sivulla Käytännöt-välilehti ja napsauta Muokkaa.
2. Etsi kohta OAuth-kulkujen ja ulkoisen asiakassovelluksen parannukset ja valitse Ota asiakassovelluksen tunnusten kulku käyttöön.
3. Kirjoita Suorita nimellä -kenttään sen käyttäjän käyttäjätunnus, jonka puolesta integraatio toimii. Oma käyttäjätunnus löytyy oikean yläkulman valikosta kohdasta Asetukset → Omat tiedot.
4. Napsauta Tallenna.

Vaihe 4 — Hae Kuluttaja-avain ja Kuluttajasalaisuus

Kuluttaja-avain (Consumer Key) ja Kuluttajasalaisuus (Consumer Secret) ovat sovelluksen tunnus ja salasana, joilla Trustmary kirjautuu Salesforceen.

1. Vaihda sovelluksen sivulla Asetukset-välilehdelle.
2. Avaa OAuth-asetukset-osio.
3. Napsauta Kuluttaja-avain ja -salaisuus.
4. Salesforce lähettää vahvistuskoodin tilin sähköpostiin — syötä se jatkaaksesi.
5. Kopioi sivulla näkyvät Kuluttaja-avain ja Kuluttajasalaisuus.

Vaihe 5 — Etsi My Domain -URL-osoite

1. Hae Määritysten pikahaulla Oma toimialueeni.
2. Kopioi sivun yläreunassa näkyvä Nykyisen oman toimialueen URL-osoite. Se on muotoa https://yourcompany.my.salesforce.com.

Vaihe 6 — Yhdistä integraatio Trustmaryssa

Avaa Trustmaryssa Integraatiot ja valitse Salesforce. Syötä Kuluttaja-avain ja Toimialueen URL, napsauta sitten Avaimet ja salaisuudet ja liitä Kuluttajasalaisuus. Tallenna, niin Trustmary käyttää näitä tunnuksia seuraavan kerran, kun se ottaa yhteyden Salesforceen.

Lopuksi

Yhteys on käytettävissä heti tallennuksen jälkeen, mutta Salesforcella voi kestää jopa 10 minuuttia hyväksyä vasta luotu sovellus. Kun yhteys toimii, integraatio voi lähettää kyselyitä Salesforcen kontakteille ja kirjoittaa vastaukset takaisin Salesforceen. Synkronoinnin asetukset löytyvät integraation sivulta Trustmaryssa.

Vianmääritys

Asiakassovelluksen tunnusten kulun osio ei näy Muokkaa-näkymässä. Varmista, että vaiheessa 2 valinta Ota asiakassovelluksen tunnusten kulku käyttöön oli päällä tallennettaessa — osio näkyy vasta sen jälkeen.

Trustmary ei saa yhteyttä heti asennuksen jälkeen. Odota 10 minuuttia. Uuden sovelluksen asetusten käyttöönotto kestää Salesforcessa hetken.

Yhteys toimii, mutta osa kontakteista tai kentistä puuttuu. Tarkista, että vaiheessa 3 valitulla käyttäjällä on pääsy kyseisiin tietueisiin ja kenttiin Salesforcessa. Integraatio näkee täsmälleen sen, mitä käyttäjä näkee.

Salesforce hylkää yhteyden virheellä invalid_client. Tarkista, että Kuluttaja-avain ja Kuluttajasalaisuus on kopioitu ilman ylimääräisiä välilyöntejä tai rivinvaihtoja ja että ne ovat samasta sovelluksesta, jossa asiakassovelluksen tunnusten kulku otettiin käyttöön.

Salesforce hylkää yhteyden virheellä unsupported_grant_type. Trustmaryyn syötetty toimialueen URL on lähes varmasti väärä — useimmiten osoiteriviltä kopioitu .lightning.force.com-osoite Oma toimialueeni -sivun .my.salesforce.com-osoitteen sijaan. Kopioi osoite uudelleen sieltä ja tallenna.

Päivitetty: 05/11/2026