Všetky príručky

Sociálne prihlásenie

Ako zapnúť prihlásenie zákazníkov cez Google, Facebook, Apple, Microsoft, GitHub alebo LinkedIn.

Pre: Technický správcaV administrácii:/admin/plugins/social-login/settings

Plugin Sociálne prihlásenie umožní zákazníkom prihlásiť sa a zaregistrovať sa cez šesť externých poskytovateľov namiesto vypĺňania hesla. Každý poskytovateľ sa zapína a nastavuje samostatne, vlastnými OAuth kľúčmi.

Kde to nájdete

Systém > Pluginy > Sociálne prihlásenie na /admin/plugins.

Obrazovka „Sociálne prihlásenie“ v administrácii
Obrazovka „Sociálne prihlásenie“ v administrácii

1. Vyberte poskytovateľov

Pre každého zo šiestich poskytovateľov (Google, Facebook, Apple, Microsoft, GitHub, LinkedIn) je samostatný prepínač — všetky sú predvolene vypnuté. Zapnite len tých, pre ktorých máte alebo viete založiť OAuth aplikáciu.

2. Založte OAuth aplikáciu u poskytovateľa a vyplňte kľúče

Pri každom poskytovateľovi treba Client ID (alebo App ID / Services ID) a Client Secret — a v jeho vývojárskom rozhraní nastaviť presnú návratovú adresu (redirect/callback URI):

PoskytovateľKde založiť aplikáciuRedirect/Callback URI
GoogleGoogle Cloud Console → OAuth client (Web)https://VAŠA-DOMÉNA/auth/google/callback
Facebookdevelopers.facebook.com → Facebook Loginhttps://VAŠA-DOMÉNA/auth/facebook/callback
AppleApple Developer → Sign in with Apple (Services ID)https://VAŠA-DOMÉNA/auth/apple/callback
MicrosoftAzure Portal → App registrationshttps://VAŠA-DOMÉNA/auth/microsoft/callback
GitHubgithub.com/settings/developers → OAuth Appshttps://VAŠA-DOMÉNA/auth/github/callback
LinkedInlinkedin.com/developers → Sign In with LinkedInhttps://VAŠA-DOMÉNA/auth/linkedin/callback

Namiesto VAŠA-DOMÉNA použite skutočnú doménu vášho e-shopu. Client Secret sa po uložení zašifruje a v administrácii sa už nezobrazuje.

Polia a nastavenia

PolePovinné (pri zapnutom poskytovateľovi)Význam
{poskytovateľ}_enabled—Zapnutie konkrétneho poskytovateľa
Client ID / App ID / Services IDánoVerejný identifikátor OAuth aplikácie
Client SecretánoTajný kľúč; pri Apple ide o vygenerovaný JWT

Čo sa deje na pozadí

Zákazník, ktorý sa prihlási cez poskytovateľa, dostane bežný zákaznícky účet rovnako, ako keby sa registroval e-mailom — nič v objednávkach ani v ostatných funkciách sa preň nemení. Prvé prihlásenie cez poskytovateľa účet založí; ak už účet s rovnakým e-mailom existuje, prepojí sa naň.

Poznámka: Plugin rieši výhradne prihlásenie zákazníkov na e-shope. Prihlásenie do administrácie (/admin) je oddelený systém a týmto pluginom sa neriadi ani neovplyvňuje.

Časté problémy

  • Prihlásenie skončí chybou u poskytovateľa → redirect/callback URI v jeho vývojárskom rozhraní nesedí presne s adresou vyššie (vrátane https:// a bez lomítka navyše).
  • Tlačidlo poskytovateľa sa na e-shope nezobrazuje → prepínač {poskytovateľ}_enabled je vypnutý, alebo chýba Client ID/Secret.
  • Apple prihlásenie zlyhá s neplatným secretom → Apple Client Secret je JWT s obmedzenou platnosťou; treba ho podľa pravidiel Apple pravidelne pregenerovať.
  • Zákazník má dva účty namiesto jedného → prihlásil sa raz e-mailom a raz cez iného poskytovateľa s iným e-mailom; prepojenie funguje len pri zhode e-mailovej adresy.
  • Chcem vypnúť len jedného poskytovateľa, nie celý plugin → stačí vypnúť jeho vlastný prepínač, ostatní poskytovatelia fungujú ďalej.

Súvisí

Bola táto stránka užitočná?