> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.trustmary.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Salesforce integraatio Trustmaryyn (natiivi)

# Salesforce-asetusopas

Trustmary yhdistyy Salesforceen pienen sovelluksen kautta, jonka luot omaan Salesforce-organisaatioosi. Näin tietosi pysyvät omassa hallinnassasi — Trustmarylla ei ole koskaan pääavainta jokaisen asiakkaan Salesforceen, vain ne tunnukset, jotka itse luot ja annat sille.

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

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

## Vaihe 1 — Luo Connected App (yhdistetty sovellus)

1. Napsauta hammasrataskuvaketta oikeassa yläkulmassa ja valitse **Määritykset**.
2. Jos päädyt vanhempaan Salesforce Classic -näkymään, napsauta avatartasi oikeassa yläkulmassa ja valitse **Siirry Lightning Experienceen** ensin — uudemmat asetussivut ovat helpompia seurata.
3. Kirjoita Määritykset-pikahaussa **Sovellusten hallinta** ja avaa se.
4. Napsauta **Uusi ulkoinen asiakassovellus** oikeassa yläkulmassa.
5. Täytä perustiedot:
    * **Ulkoisen asiakassovelluksen nimi**: Trustmary Integraatio
    * **API-nimi**: täyttyy automaattisesti
    * **Yhteyshenkilön sähköpostiosoite**: oma sähköpostiosoitteesi

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

1. Samalla sivulla, valitse **Ota OAuth käyttöön**, joka löytyy API (Ota OAuth käyttöön) -osiosta.
2. Kohtaan **Callback URL**, syötä https://login.salesforce.com/services/oauth2/success. Salesforce vaatii tämän URL-osoitteen, mutta sitä ei tosiasiassa koskaan käytetä — Trustmary ei koskaan ohjaa ketään sen kautta.
3. Kohtaan **OAuth-vaikutusalueet**, lisää **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**.

> **Huomio:** Salesforcella voi kestää jopa 10 minuuttia ottaa uuden yhdistetyn sovelluksen asetukset käyttöön. Jos seuraavat vaiheet eivät toimi heti, odota muutama minuutti ja yritä uudelleen.

## 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 — tämä määrittää, mitä integraatio voi nähdä ja muuttaa, kyseisen käyttäjän tavanomaisten käyttöoikeuksien mukaisesti.

1. "Trustmary Integration" -sovelluksen sivulla (jossa sinun pitäisi olla vaiheen 2 valmistuttua), välilehdellä **Käytännöt**, napsauta **Muokkaa**.
2. Paikanna **OAuth-kulkujen ja ulkoisen asiakassovelluksen parannukset**. Napsauta **Ota asiakassovelluksen tunnusten kulku käyttöön**. Lisää käyttäjätunnuksesi kenttään **Suorita nimellä**. Löydät oman käyttäjänimesi oikean yläkulman valikosta valitsemalla **Asetukset** ja etsimällä **Omat tiedot**
3. Napsauta **Tallenna**.

> **Mitä tahansa tämä käyttäjä näkee ja voi muokata Salesforcessa, sen integraatio näkee ja voi muokata myös** — ei enempää. Jos kontakteja tai jokin mukautettu kenttä ei myöhemmin näy Trustmaryssa, tämä on ensimmäinen paikka tarkistaa.

## Vaihe 4 — Hae Consumer Key ja Consumer Secret

1. **Ulkoisen asiakassovelluksen hallinnoija** -näkymässä, jossa sinun pitäisi jo olla vaiheen 3 valmistuttua, vaihda välilehdelle **Asetukset** ja paina **Muokkaa**-nappia.
2. Avaa **OAuth-asetukset** -osio.
3. Napsauta **Kuluttaja-avain ja -salaisuus**.
4. Salesforce lähettää vahvistuskoodin sähköpostiisi — syötä se jatkaaksesi.
5. Kopioi sivulla näkyvät **Kuluttaja-avain** ja **-salaisuus.**

> **Käsittele Kuluttajasalaisuutta kuin salasanaa.** Kopioi se suoraan Trustmaryyn, älä sähköpostiin, chat-viestiin tai dokumenttiin. Sivu pysyy avoinna vain noin 5 minuuttia, ennen kuin se pyytää vahvistusta uudelleen.

## Vaihe 5 — Etsi My Domain -URL-osoitteesi

1. Määritykset-pikahaussa, etsi **Oma toimialueeni**.
2. Kopioi sivun yläreunassa näkyvä **Nykyisen oman toimialueen URL-osoite**— se näyttää tältä: https://yourcompany.my.salesforce.com.

> **Älä kopioi tätä selaimen osoiterivistä.** Kun klikkailet Määritykset-valikossa, osoiterivi näyttää eri verkkotunnuksen, joka päättyy .lightning.force.com — se on Lightning-sovelluksen käyttöliittymä, ei API-verkkotunnus, eikä Trustmary voi yhdistää sen kautta. Hae URL-osoite aina [My Domain]-sivulta itsestään.

## Vaihe 6 — Yhdistä se Trustmaryssa

Palaa Trustmaryyn, avaa **Integraatiot → Salesforce** ja syötä yllä kopioimasi **Kuluttaja-avain ja kuluttajasalaisuus ja toimialueen URL**. Tallenna, ja Trustmary käyttää näitä tietoja yhdistyäkseen Salesforceen seuraavan kerran, kun se tarvitsee sitä.

##