„Amazon“ prisijungimas su „Amazon“ darbo pradžia
Prisijunkite naudodami „Amazon“: darbo pradžios vadovas Websvetaines Autorių teisės © 2017 m. „Amazon Services, LLC“ arba jos filialai. Visos teisės saugomos.
„Amazon“ ir „Amazon“ logotipas yra „Amazon.com, Inc.“ ar jos filialų prekių ženklai. Visi kiti
prekių ženklai, nepriklausantys „Amazon“, yra jų atitinkamų savininkų nuosavybė.
Prisiregistruokite prisijungdami prie „Amazon“
Prieš naudodami prisijungimą naudodami „Amazon“ a websvetainėje arba mobiliojoje programėlėje, turite užregistruoti programą naudodami Prisijunkite naudodami „Amazon“. Jūsų prisijungimo naudojant „Amazon“ programa yra registracija, kurioje yra pagrindinė informacija apie jūsų verslą ir informacija apie kiekvieną websukurta svetainė arba programa mobiliesiems, kuri palaiko prisijungimą naudojant „Amazon“. Ši verslo informacija rodoma vartotojams kiekvieną kartą, kai jie naudojasi „Prisijungti naudojant Amazon“. websvetainę ar programą mobiliesiems. Vartotojai matys jūsų programos pavadinimą, jūsų logotipą ir nuorodą į jūsų privatumo politiką. Šie veiksmai parodo, kaip užregistruoti „Android“ programą naudoti prisijungiant prie „Amazon“.
Užregistruokite savo prisijungimą naudodami „Amazon“ programą
- Eikite į https://login.amazon.com.
- Jei anksčiau prisiregistravote prisijungti prie „Amazon“, spustelėkite „App Console“. Kitu atveju spustelėkite „Prisiregistruoti“. Būsite nukreipti į „Seller Central“, kuris tvarko „Login with Amazon“ programos registraciją. Jei tai tavo
pirmą kartą naudodamiesi „Seller Central“, jūsų bus paprašyta nustatyti „Seller Central“ sąskaitą. - Spustelėkite Registruoti naują programą. Parodykite savo paraiškos registravimo formą:
a. Registracijos paraiškoje formoje turite įvesti savo paraiškos pavadinimą ir aprašą.
The Vardas yra vardas, rodomas sutikimo ekrane, kai naudotojai sutinka bendrinti informaciją su jūsų programa. Šis pavadinimas taikomas „Android“, „iOS“ ir webjūsų programos svetainės versijos. Aprašas padeda atskirti kiekvieną „Login“ naudojant „Amazon“ programas ir nėra rodomas vartotojams.
b. Įveskite a Privatumas URL už jūsų prašymą.
Privatumo pranešimas URL yra jūsų įmonės ar programos privatumo politikos vieta (pvzampčia, http: //www.example.com/privacy.html). Ši nuoroda vartotojams rodoma sutikimo ekrane.
c. Jei norite pridėti a Logotipo vaizdas savo programai spustelėkite Pasirinkite File ir raskite tinkamą vaizdą.
Šis logotipas rodomas prisijungimo ir sutikimo ekrane, kad atspindėtų jūsų verslą arba websvetainėje. Logotipas bus sumažintas iki 50 pikselių aukščio, jei jis bus aukštesnis nei 50 pikselių; logotipo plotis neribojamas. - Spustelėkite Išsaugoti. Jūsų sampregistracija turėtų atrodyti taip:
Išsaugoję pagrindinius programos nustatymus, galite pridėti konkrečių nustatymų websvetaines ir programas mobiliesiems, kurios naudos šį prisijungimą naudojant „Amazon“ paskyrą
Pridėti Websvetainės nustatymus į savo programą
- Programos ekrane spustelėkite Web Nustatymai. Jums bus automatiškai priskirtos kliento ID ir kliento paslapties vertės. Kliento ID identifikuoja jūsų websvetainė, ir paslaptis pirkėju tam tikromis aplinkybėmis naudojamas jūsų patvirtinimui websvetainė yra autentiška. Kliento paslaptis, kaip ir slaptažodis, yra konfidenciali. Į view kliento paslaptis, spustelėkite „Show Secret“.
- Norėdami pridėti Leidžiama „JavaScript“ kilmė or Leidžiama grįžti URLs prie savo programos spustelėkite Redaguoti.
Pastaba: Norėdami naudoti „Login with Amazon“ su websvetainėje, turite nurodyti arba leistiną „JavaScript“ kilmę (netiesioginei dotacijai), arba leistiną grąžą URL (suteikiant leidimo kodą). Jei naudojate „Amazon Pay“, turite nurodyti leistiną „JavaScript“ kilmę.
a. Jei jūsų websvetainė „Login“ su „Amazon SDK“ naudos „JavaScript“, pridėkite savo websvetainės kilmė į Leidžiama „JavaScript“ kilmė.
Kilmė yra protokolo, domeno vardo ir prievado derinys (pvzampčia, https: // www.example.com:8443). Leidžiamos kilmės vietos turi naudoti HTTPS protokolą. Jei naudojate standartinį prievadą (80 arba 443 prievadą), turite nurodyti tik domeno pavadinimą (pvzampčia, https: // www.example.com).
Čia pridėjus domeną, „JavaScript“ SDK gali bendrauti su jūsų websvetainę tiesiogiai
prisijungimo proceso metu. Web naršyklės paprastai blokuoja skirtingų kilmių ryšį tarp scenarijų, nebent scenarijus tai konkrečiai leidžia.
Norėdami pridėti daugiau nei vieną kilmę, spustelėkite Pridėkite kitą.
b. Jei jūsų websvetainė skambins HTTPS prisijungimo prie „Amazon“ prieigos tarnybai ir nurodys „redirect_uri“ atsakymams, pridėkite tuos peradresavimo URI prie Leidžiama grįžti URLs. Grįžimas URL apima protokolą, domeną, kelią ir užklausos eilutę (pvzampčia, https: // www.example.com/login.php).
Norėdami pridėti daugiau nei vieną grąžą URL, spustelėkite Pridėk kitą. - Spustelėkite Išsaugoti
Tada pridėkite mygtuką Prisijungti naudojant „Amazon“ websvetainėje. Galite pasirinkti iš įvairių mygtukų ir pasirinkti vaizdą, kuris geriausiai tinka jums websvetainę. Žr. Prisijungimo su „Amazon“ stiliaus gaires geriausios praktikos pavyzdžių ir pasirinktų vaizdų sąrašą.
- Pridėkite šį kodą prie savo websvetainę, kurioje norėtumėte, kad būtų rodomas mygtukas. Šiame vadove tai turi būti HTTPS websvetainė:
<img border=”0″ alt=“Prisijunkite naudodami „Amazon“
src = ”https://images-na.ssl-images-amazon.com/images/G/01/lwa/
btnLWA_gold_156x32.png “
plotis = ”156 ″ aukštis =” 32 ″ />
- Neprivaloma. Pridėkite šią nuorodą prie savo websvetainę, kurioje norėtumėte, kad būtų rodomas raginimas „Atsijungti“:
- Atnaujinkite puslapį, kad patvirtintumėte, jog mygtukas dabar rodomas jūsų websvetainę.
Atsijungti
Pridėkite „JavaScript“ prisijungimą naudodami „Amazon SDK“
Prisijungimas naudojant „Amazon“ SDK, skirtas „JavaScript“, atliks visas sudėtingas prisijungimo su „Amazon“ integravimo į jūsų dalis dalis websvetainę.
- Po atidarymo pridėkite šį kodą savo puslapyje, kad į savo puslapį įkeltumėte „JavaScript“:
window.onAmazonLoginReady = funkcija () {
amazon.Login.setClientId ('TAVO KLIENTO ID');
};
(funkcija d) {
var a = d.createElement ('scenarijus'); a.type = 'text / javascript';
a.async = tiesa; a.id = 'amazon-login-sdk';
a.src =
„https://assets.loginwithamazon.com/sdk/na/login1.j
s “; d.getElementById ('amazon-root'). appendChild (a);
}) (dokumentas);
- Pakeiskite JŪSŲ KLIENTO ID su kliento ID, kurį gaunate, kai jūs Prisiregistruokite prisijungdami prie „Amazon“.
- Pridėkite šią „JavaScript“ po savo svetainėje esančiu mygtuku Prisijungti naudodami „Amazon“.
document.getElementById ('LoginWithAmazon'). onclick = function () {
parinktys = {apimtis: 'profile'};
amazon.login.authorize (parinktys,
„https: //www.example.com/handle_login.php ');
return false;
};
- Pakeiskite www.example.com su jūsų domenu websvetainę.
Pastaba: Pagal numatytuosius nustatymus „JavaScript“ SDK parodys prisijungimo ekraną iššokančiame lange. Galite nustatyti parinkčių parametro iššokančiojo ypatybės reikšmę „false“, kad nukreiptumėte klientus į naują puslapį prisijungti. Iššokantys langai nepalaikomi „iOS“ WebView-pagrįstos programos. Jei „iOS“ programoje ketinate naudoti „Login with Amazon“, rekomenduojame naudoti arba ios-gsg._TTH [PDF] arba įdiegti peradresuotą prisijungimo patirtį. Žr website-sdk-reference._TTH [PDF], jei norite gauti informacijos apie parinkčių parametro pritaikymą. - Kai vartotojas prisijungs ir sutiks bendrinti nurodytus duomenis, dabartinis langas bus nukreiptas į nurodytą URI ir prie užklausos eilutės bus pridėtas autorizacijos atsakymas. URI turi naudoti https protokolą ir būti tame pačiame domene kaip ir dabartinis langas.
- Neprivaloma. Kai vartotojai bus įgalioti, turėtumėte pridėti prieigą prie savo svetainės atsijungimo hipersaito ar mygtuko, kad jie galėtų atsijungti. Pridėkite šią „JavaScript“, kad vartotojai galėtų atsijungti:
document.getElementById ('Atsijungti'). onclick = function () {
amazon.Login.logout ();
};
Jūs tvarkysite „Amazon“ atsakymą naudodami /handle_login.php websvetainę kitame skyriuje. Vėliau galėsite pakeisti šį kelią į vieną iš jūsų pasirinktų.
Gaukite „Pro“file Informacija
Galite įsigyti vartotojo profesionaląfile informacija iš „Amazon“ naudojant Prieigos prieigos raktas grąžino SDK.
- Savo serverio programoje tvarkykite užklausą, pateiktą /handle_login.php, ir gaukite „pro“file informaciją naudojant prieigos raktą ir „Pro“file REST API. PvzampŽemiau yra PHP, „Python“, „Java“ ir „Ruby“.
- Paleiskite savo websvetainę ir patvirtinkite, kad galite prisijungti naudodami savo „Amazon.com“ kredencialus.
PHP pvzample
// Patikrinkite, ar prieigos raktas priklauso mums // Ženklas turi būti url- užkoduota, kai perduota tokeninfo $ c = curl_init ('https://api.amazon.com/auth/o2/tokeninfo?access_token='. urlkoduoti ($ _ REQUEST ['access_token'])); curl_setopt ($ c, CURLOPT_RETURNTRANSFER, tiesa); $ r = curl_exec ($ c); curl_uždaryti ($ c); $ d = json_decode ($ r); if ($ d-> aud! = 'YOUR-CLIENT-ID') {// prieigos raktas nepriklauso mums antraštei ('HTTP/1.1 404 Not Found'); echo 'Puslapis nerastas'; išeiti;} // Pakeiskite prieigos raktą į user profile $ r = curl_exec ($ c); curl_uždaryti ($ c); echo sprintf ('% s% s% s', $ d-> vardas, $ d-> el. paštas, $ d-> user_id); |
Python Example
Turite atsisiųsti pycurl biblioteka naudotis šia sampkodas.
importuoti pikurl importuoti urllib importuoti Json importuoti StringIO… b = StringIO.StringIO ()# Patikrinkite, ar prieigos raktas priklauso mums # Ženklas turi būti url- užkoduota, kai perduota tokeninfo c = pycurl.Curl() c. setopt (pycurl.URL, „Https://api.amazon.com/auth/o2/tokeninfo?access_token=“ + urllib.quote_plus (access_token)) c.setopt (pycurl.SSL_VERIFYPEER, 1) c.setopt (pycurlRAŠYMO FUNKCIJA, b. Rašyti) c. atlikti () jei d ['aud']! = 'JŪSŲ KLIENTO ID': # Pakeiskite prieigos raktą į „user pro“file c = pycurl.Curl() c. atlikti () spausdinti „% s% s% s“% (d ['vardas'], d ['el. paštas], d [' vartotojo_ID ']) |
„Java“ pavyzdysample
Turite atsisiųsti Džeksonas ir „HttpComponents“ bibliotekos naudotis šia sampkodas.
importuoti com.fasterxml.jackson.core.type.TypeReference; importuoti com.fasterxml.jackson.databind.ObjectMapper; importuoti org.apache.http.client.fluent.Content; importuoti org.apache.http.client.fluent.Request; importuoti java.net.URLKoduotojas; importuoti java.util.Map;… // Patikrinkite, ar prieigos raktas priklauso mums // Ženklas turi būti url- užkoduota, kai perduota tokeninfo Žemėlapis m = new ObjectMapper (). ReadValue (c.toString (), new TypeReference> () jei (! „TAVO KLIENTO ID“. yra lygus (m.get („aud“))) { } // Pakeiskite prieigos raktą į user profile System.out.println (String.format („% s% s% s“, m.get („vardas“), |
Ruby Example
reikalauti „rubygemų“ reikalauti „net / https“ reikalauti „Json“ reikalauti „uri“…# Patikrinkite, ar prieigos raktas priklauso mums # Ženklas turi būti url- užkoduota, kai perduota tokeninfo uri = URI.parse („https://api.amazon.com/auth/o2/tokeninfo?access_token=“ + URI.encode (access_token)) req = Grynasis :: HTTP :: Get.new (uri.request_uri) http = „Net“: HTTP.new (uri.host, uri.port) http.use_ssl = tiesa http.verify_mode = OpenSSL :: SSL :: VERIFY_PEERresponse = http.request (req) iššifruoti = JSON.parse (response.body) jei dekoduoti ['aud']! = 'JŪSŲ KLIENTO ID " pabaiga # Pakeiskite prieigos raktą į „user pro“file atsakymas = http.request (req) pateikia sprintf „% s% s% s“, iššifruoti ['vardas'], iššifruoti ['el. paštas'], |
Užbaikite integraciją su savo Websvetainę
Dabar jūs žinote, kaip pridėti prisijungimą prie „Amazon“ prie savo websvetainėje. Kiti veiksmai yra integruoti „Amazon“ naudotojų paskyras į savo paskyros valdymo sistemą ir naudoti jas asmeniniams poreikiams pritaikyti websvetainė „Amazon“ klientams. Daugiau informacijos rasite:
- Prisijungimas su „Amazon“ Kūrėjo vadovas Websvetaines
- https://login.amazon.com/documentation/combining-user-accounts
Reikia daugiau pagalbos? Patikrinkite mūsų forumuose.
Žodynėlis
prieigos apimtis Prieigos sritis apibrėžia „user pro“ tipąfile kliento duomenys
prašydamas. Pirmą kartą prisijungęs vartotojas mato elementų sąrašą
prieigos sritį ir turi sutikti pateikti duomenis klientui
nutartis tęsti.
prieigos raktas Prieigos žetoną suteikia autorizacijos serveris, kai vartotojas prisijungia
į svetainę. Prieigos žetonas būdingas klientui, vartotojui ir prieigai
taikymo sritį. Prieigos žetonų maksimalus dydis yra 2048 baitai. Klientas privalo
naudokite prieigos raktą, kad gautumėte „Customer Pro“file duomenis.
leidžiama „JavaScript“ kilmė „JavaScript“ kilmė yra protokolo, domeno ir prievado, iš kurio kyla „JavaScript“ skambutis, derinys. Pagal numatytuosius nustatymus web naršyklės blokuoja vienos kilmės „JavaScript“ skambučius, kurie bando iškviesti scenarijų kita kilme. Prisijungimas naudojant „Amazon“ SDK, skirtas „JavaScript“, leidžia skambinti iš kitos kilmės, jei jie nurodyti kaip an taikymas.
Registruodamiesi a webprisijungimo prie „Amazon“ svetainėje, įveskite. schemą, domeną ir pasirinktinai prievadą webpuslapis, kuriame yra „JavaScript“ prisijungimo naudojant „Amazon“ SDK (pvzampčia, http: //www.example.com arba https: // localhost: 8080).
leido grįžti URL Grįžimas URL yra adresas a websvetainė, kuri naudoja prisijungimą naudojant „Amazon“.
The autorizacijos tarnyba kai jie baigs prisijungti, nukreipia vartotojus šiuo adresu.
Taip pat žr nukreipti URL.
API raktas Identifikatorius, kurį reikia prisijungti naudojant „Amazon“ SDK, kad būtų galima identifikuoti programą mobiliesiems prie autorizacijos tarnybos. API raktai sugeneruojami, kai registruojate programą mobiliesiems.
taikymas Programa yra registracija, kurioje yra informacijos, kurią autorizacijos tarnyba turi patikrinti klientui, kad šis klientas galėtų pasiekti „Customer Pro“files. Jame taip pat pateikiama pagrindinė informacija apie jūsų verslą, kuri rodoma vartotojams kiekvieną kartą, kai jie naudoja „Login with Amazon“ websvetainę ar programą mobiliesiems.
taikymas Paraiška yra registracija, kurioje yra informacijos autorizacijos tarnyba turi patikrinti klientą, kad klientas galėtų pasiekti klientas proffiles. Jame taip pat pateikiama pagrindinė informacija apie jūsų verslą, kuri rodoma vartotojams kiekvieną kartą, kai jie naudoja „Login with Amazon“ websvetainę ar programą mobiliesiems.
„Appstore“ ID „AppStore ID“ unikaliai identifikuoja mobiliąją programą „Amazon AppStore“.
leidimo kodas Autorizacijos kodas yra vertė, kurią naudoja Leidimo kodo suteikimas leisti a websvetainę, kad galėtumėte paprašyti prieigos raktas.
leidimo kodo suteikimas Autorizacijos kodo suteikimas yra autorizacijos suteikimas, kuris naudojasi
serveris pagrįstas apdorojimas, norint pateikti užklausą prieigos raktas. Naudodamas autorizacijos kodo suteikimą, serveris gauna leidimo kodas kaip užklausos parametrą vartotojui prisijungus. Serveris keičia autorizacijos kodą, kliento identifikatorius, ir paslaptis pirkėju prieigos prieigos raktui ir atnaujinimo prieigos raktui.
leidimo suteikimas Leidimo suteikimas yra procesas, kai autorizacijos tarnyba patikrina klientą websvetainės prašymas suteikti prieigą prie a klientas proffile. Norint gauti leidimą, reikia: kliento identifikatorius ir an prieigos apimtisir gali reikalauti a paslaptis pirkėju. Jei procesas pavyks, websvetainei suteiktas prieigos raktas.
Yra dvi autorizacijos dotacijų rūšys: Numanoma dotacija ir an Leidimo kodo suteikimas.
autorizacijos tarnyba „Login with Amazon“ autorizacijos paslauga yra „Amazon“ teikiamų galinių taškų rinkinys, leidžiantis klientui prisijungti prie vartotojo leidimų suteikimas. Patvirtinimo tarnyba vartotojams pateikia prisijungimo ekraną ir leidimų ekraną. Tai suteikia prieigos žetonai, atnaujinti žetonus, ir klientas proffile duomenis prisijungti prie „Amazon“ klientų.
paketo identifikatorius Grupės identifikatorius yra unikalus „iOS“ programos identifikatorius. Jie paprastai būna com.comįmonėspavadinimas.appname.
klientas Klientas yra a websvetainė arba programa mobiliesiems, kuri naudoja prisijungimą naudojant „Amazon“.
kliento identifikatorius Kliento identifikatorius yra klientui priskirta vertė, kai jie registruojasi prisijungdami prie „Amazon“. Jo maksimalus dydis yra 100 baitų. Kliento identifikatorius naudojamas kartu su kliento paslaptimi, siekiant patikrinti kliento tapatybę, kai jie prašo suteikti įgaliojimą iš autorizacijos tarnyba. Kliento identifikatorius nėra slaptas.
paslaptis pirkėju Kliento paslaptis, kaip ir kliento identifikatoriusyra reikšmė, priskirta klientui, kai jie registruojasi prisijungdami prie „Amazon“. Jo maksimalus dydis yra 64 baitai. Kliento paslaptis naudojama kartu su kliento identifikatoriumi, siekiant patikrinti kliento tapatybę, kai jie prašo aįteisinimo dotacija iš autorizacijos tarnyba. Kliento paslaptis turi būti konfidenciali.
sutikimo ekranas Kai vartotojas prisijungia prie websvetainę ar programą mobiliesiems pirmą kartą, jiems pateikiamas sutikimo ekranas, jei programa prašo profesionalofile duomenis.
Sutikimo ekrane rodomas pavadinimas, logotipo vaizdas file, ir privatumo pranešimas URL susietas su programa kartu su prieigos apimtis programa prašo.
klientas proffile Klientų profesionalasfile yra informacijos apie „Login with Amazon“ klientą, įskaitant jo vardą, el. pašto adresą, pašto kodą ir unikalų identifikatorių. A websvetainė turi gauti prieigos raktas prieš jiems įsigyjant klientų profesionalusfile. Profesoriaus rūšisfile grąžintus duomenis lemia prieigos apimtis.
numanomą dotaciją Numanoma dotacija yra leidimo suteikimas kurį galima užbaigti naudojant tik vartotojo web naršyklė. Naudodamasi numanoma dotacija, naršyklė gauna prieigos raktas kaip URI fragmentas. Netiesioginei dotacijai reikia: kliento identifikatorius ir an prieigos apimtis. Netiesioginė dotacija negrąžina a atnaujinti prieigos raktą.
prisijungimo ekranas Prisijungimo ekranas yra HTML puslapis, pateikiamas vartotojams, kai jie bando prisijungti prie websvetainę ar programą mobiliesiems naudojant „Login with Amazon“. Šiame puslapyje vartotojai gali įvesti esamą „Amazon“ paskyrą arba sukurti naują.
logotipo vaizdas file PNG file teikia klientas steigdamas taikymas. Tai rodoma leidimų ekrane, jei vartotojas nesuteikė prieigos prie kliento websvetainėje. Logotipas simbolizuoja klientą websvetainę.
paketo pavadinimas Paketo pavadinimas yra unikalus „Android“ programos identifikatorius. Paprastai jie yra formos com.companyname.appname.
privatumo pranešimas URL A URL teikia klientas steigdamas taikymas. Tai rodoma sutikimo ekrane, jei vartotojas nesuteikė prieigos prie kliento websvetainėje. URL turėtų nukreipti vartotojus į kliento privatumo politiką websvetainę.
nukreipti URL A URL pateikė klientas autorizacijos tarnyba. Vartotojui prisijungus, paslauga nukreips vartotojo naršyklę šiuo adresu. Taip pat žiūrėkite leidžiamą grįžti URL.
atnaujinti prieigos raktą Atnaujinimo prieigos raktą suteikia autorizacijos tarnyba kai
klientas naudoja Leidimo kodo suteikimas. Klientas gali naudoti atnaujinimo prieigos raktą, kad paprašytų naujo prieigos prieigos rakto, kai dabartinis prieigos raktas pasibaigia. Atnaujinimo žetonų maksimalus dydis yra 2048 baitai. Parašas yra SHA-256 maišos vertė, įterpta į programą mobiliesiems, kuri patikrina programos tapatybę. Jie paprastai būna
01:23:45:67:89:ab:cd:ef:01:23:45:67:89:ab:cd:
ef:01:23:45:67:89:ab:cd:ef:01:23:45:67:89:ab:cd:ef.
naudotojas Vartotojas yra asmuo, kuris lanko klientą websvetainę ir bando prisijungti naudodami „Login with Amazon“.
versija Versija yra tam tikras „Login with Amazon“ kliento, užregistruoto „ taikymas. Prisijungimas naudojant „Amazon“ programą gali turėti kelias versijas, kurių kiekviena palaiko „Android“, „iOS“ arba web.
„Amazon“ prisijungimas naudojant „Amazon“ darbo pradžios vadovą Websvetainės - Atsisiųsti [optimizuota]
„Amazon“ prisijungimas naudojant „Amazon“ darbo pradžios vadovą Websvetainės - Atsisiųsti