Oman identiteetintarjoajan yhdistäminen asiakastileihin

Sopimusvaatimus

Oman identiteetintarjoajan yhdistäminen koskee vain sellaisia kauppoja, joilla on Shopify Plus ‑sopimus. Jos kaupallasi on Shopify Plus ‑sopimus ja Identiteetintarjoaja-osio ei näy Shopify Adminin Asiakastilit-sivulla, ota yhteyttä Shopify Plus ‑tukitiimiin saadaksesi ominaisuuden käyttöösi.

Voit yhdistää oman OpenID Connect (OIDC) -yhteensopivan identiteetintarjoajasi asiakastileihin, jotta asiakkaillasi olisi yhdenmukainen kirjautumiskokemus eri alustoillasi.

Kun olet muodostanut yhteyden omaan identiteetintarjoajaasi, asiakkaat voivat kirjautua kaupassasi oleville tileilleen identiteetintarjoajasi kautta kertakäyttöistä kirjautumista käyttäen. Tämä kirjautumistapa korvaa Shopifyn oletusarvoisen kirjautumistavan.

Vaikka voit yhdistää useita identiteetintarjoajia Shopifyhin, voit aktivoida vain yhden identiteetintarjoajan kerrallaan verkkokaupassasi.

Huomaa

Kun olet yhdistänyt oman identiteetintarjoajan asiakastileihin, asiakkaat eivät enää voi kirjautua sisään Shop-palvelulla kaupassasi.

Identiteetintarjoajille asetettavat vaatimukset

Identiteetintarjoajan, johon muodostat yhteyden, on täytettävä seuraavat vaatimukset, jotta se voisi integroitua Shopify-kauppaasi:

• Identiteetintarjoaja tukee OAuth 2.0 -valtuutuskoodin (authorization code) kulkua.
• Identiteetintarjoaja tukeeProof Key for Code Exchange (PKCE) -laajennusta julkisten asiakkaiden osalta.
• Identiteetintarjoaja on oltava OpenID Connect (OIDC) -todennusstandardissa asetettujen vaatimusten mukainen.
• Identiteetintarjoaja tukee sähköpostia käyttäjien yksilöllisenä tunnisteena, ja sähköpostin vahvistaminen on osa rekisteröintiprosessia.

Identiteetintarjoajan, johon muodostat yhteyden, on myös tuettava seuraavia päätepisteitä:

Pakolliset identiteetintarjoajan päätepisteet

Pakollinen päätepiste	Esimerkki verkkotunnuksesta ja polusta	Selitykset
Authorization	https://auth.provider.com/authorize	RFC 6749 Section 4.1
Token	https://auth.provider.com/token	RFC 6749 Section 4.1.3 and RFC 6749 Section 6
JWKS	https://auth.provider.com/.well-known/jwks.jsn	RFC 7517 Section 5
Discovery	https://auth.provider.com/.well-known/openid-configuration	OpenID Discovery 1.0

Jos et ole varma, täyttääkö identiteetintarjoaja vaatimukset, tarkista identiteetintarjoajan toimittamat asiakirjat tai ota yhteyttä identiteetintarjoajaan tukea saadaksesi.

Mobiilivaatimukset

Jos kaupassasi on mobiilisovellus, identiteetintarjoajan Authorization-päätepisteen on tuettava seuraavia parametreja:

• code_challenge: Vahvistaa, että tunnusta (token) pyytävä asiakas on sama kuin pyynnön alullepannut asiakas.
• code_challenge_method: Tämä päätepiste on asetettava arvoon S256.

Yhteyden muodostaminen asiakastilien ja oman identiteetintarjoajasi välille

Jotta voit muodostaa yhteyden omaan identiteetintarjoajaasi, sinun on tehtävät seuraavat tehtävät järjestyksessä:

• Muodostaa yhteys identiteetintarjoajaan Asiakastilit-asetuksissa
• Konfiguroida asetukset identiteetintarjoajan dashboardissa
• Viimeistellä yhteys identiteetintarjoajaan Shopify Adminissa

Vaihe 1: Yhteyden muodostaminen identiteetintarjoajaan

1. Siirry Shopify Adminissa kohtaan Asetukset > Asiakastilit.

2. Klikkaa Identiteetintarjoaja-osiossa Hallinnoi.

3. Klikkaa Yhdistä palveluntarjoajaan.

4. Anna identiteetintarjoajan nimi todennuspalvelulle.

5. Pidä tämä Yhdistä identiteetintarjoajaan -sivu auki, jotta voit kopioida Takaisinsoiton URL-osoitteet- ja Uloskirjautumissivun URL-osoitteet Asenna konfiguraatiot -osiosta, kun määrität identiteetin tarjoajan asetukset.

Vaihe 2: Identiteetintarjoajan asetusten konfigurointi

Kun olet suorittanut Shopify Adminissa kaikki vaiheet, jotka yhteyden muodostamiseen identiteetintarjoajaan tavitaan, sinun on konfiguroitava seuraavat asetukset identiteetintarjoajan dashboardissa. Määritysvaiheet ovat erilaisia käyttämästäsi palveluntarjoajasta riippuen. Ota yhteyttä identiteetintarjoajaasi saadaksesi tukea tämän dashboardin määritysvaiheiden suorituksessa.

Ohjeet:

1. Avaa identiteetintarjoajan dashboard erillisellä selaimen välilehdellä.

2. Rekisteröi hakemuksesi: Luo luottamuksellinen hakemus identiteetintarjoajan dashboardissa ja hanki sitten client_id ja client_secret.

3. Konfiguroi uudelleenohjauksen ja uloskirjautumisen URL-osoitteet: Anna identiteetintarjoajan dashboardin Takaisinsoitto-URL - ja Uloskirjautumis-URL-osoitteet, jotka ovat Shopify Adminin Yhdistä identiteetintarjoajaan -sivun Määrityskonfiguraatioissa.

4. Määritä laajuudet: Varmista identiteetintarjoajan dashboardissa, että laajuudet sisältävät parametrit email ja openid.

5. Määritä päätepisteet: Varmista, että seuraavat päätepisteet on määritetty identiteetintarjoajan dashboardissa:

   • Authorization
   • Token
   • JWKS
   • Näkyvyys: Identiteetintarjoajasta riippuen Näkyvyys-päätepisteellä voi olla myös jokin muu nimi, kuten Määritys tai Tunnettu määritys.

6. Etsi identiteetintarjoajan kirjautumisen jälkeisen uudelleenohjauksen URI-parametri. Identiteetintarjoajasta riippuen nimi voi olla post_logout_redirect_uri, logout_uri tai returnTo.

7. Pidä tämä sivu auki selaimen välilehdellä, jotta voit käyttää sitä viitteenä, kun viimeistelet yhteyden muodostamisen identiteetin tarjoajaan.

Vaihe 3: Identiteetintarjoajan yhteyden viimeistely

Kun olet konfiguroinut identiteetintarjoajan asetukset identiteetintarjoajan dashboardissa, sinun täytyy palata Shopify Adminiin viimeistelemään yhteyden luominen.

Ohjeet:

1. Palaa Shopify Adminin Yhdistä identiteetintarjoajaan -sivulle.
2. Täytä Hakemuksen tiedot -osiossa pakolliset tiedot siten, kun ne näkyvät identiteetintarjoajan asetuksissa.
3. Klikkaa Tallenna.
4. Klikkaa Testaa yhteyttä ja testaa, että identiteetintarjoajan todennus uudelleenohjaa asiakastileihisi. Jos olet äskettäin kirjautunut asiakastilillesi verkkokaupassasi, sinun on ehkä kirjauduttava ulos ja uudelleen sisään, jotta voit kokeilla uutta kirjautumista.
5. Kun olet testannut yhteyttä, klikkaa Aktivoi.

Kun olet aktivoinut oletusarvoisen identiteetintarjoajan, Aktiivinen-tunnus näkyy uuden identiteetintarjoajan vieressä Asiakastilit-asetusten Identiteetintarjoaja-osiossa.

Huomaa

Kun olet aktivoinut uuden identiteetintarjoajan, sisään kirjautuneiden asiakkaiden on kirjauduttava uudelleen sisään kauppaasi tätä uutta todennuspalvelua käyttämällä.

Palaa takaisin oletusarvoiseen identiteetintarjoajaan Shopifyihin

Voit milloin tahansa vaihtaa identiteetintarjoajasi takaisin asiakkaan sisäänkirjautumisen oletusmenetelmään.

Ohjeet:

1. Siirry Shopify Adminissa kohtaan Asetukset > Asiakastilit.

2. Klikkaa Identiteetintarjoaja-osiossa Hallinnoi.

3. Valitse Oletusidentiteetintarjoaja- pudotusvalikosta Aktivoi.

Kun olet aktivoinut oletusarvoisen identiteetintarjoajan, Aktiivinen-tunnus näkyy oletusarvoisen identiteetintarjoajan vieressä Asiakastilit-asetusten Identiteetintarjoaja-osiossa.

Asiakasdatan hallinnointi

Jos asiakas pyytää henkilötietonsa poistamista Shopify-kaupastasi, voit poistaa asiakkaan henkilötiedot Shopify Administa.

Jos olet muodostanut yhteyden omaan identiteetintarjoajaasi, sinun on poistettava kaikki asiaan liittyvät asiakastiedot myös palveluntarjoajan dashboardista. Lue lisää identiteetintarjoajan asiakastietojen poistamista koskevista ohjeista.

Lisäresurssit

Lisätietoja OpenID Connect (OIDC) -yhteensopivasta identiteetintarjoajista saat seuraavista kolmannen osapuolen resursseista:

• RFC 6749 - The OAuth 2.0 Authorization Framework
• RFC 7636 - Proof Key for Code Exchange by OAuth Public Clients
• OpenID Connect Core 1.0 incorporating errata set 2
• OpenID Connect Conformance Profiles v3.0
• How to Certify Your Implementation - OpenID Foundation