amazon Oanmelde mei Amazon Getting Started
Oanmelde by Amazon: Getting Started Guide foar Websites Copyright © 2017 Amazon Services, LLC of har filialen. Alle rjochten foarbehâlden.
Amazon en it Amazon-logo binne hannelsmerken fan Amazon.com, Inc. of har filialen. Alle oare
hannelsmerken dy't net eigendom binne fan Amazon binne it eigendom fan har respektive eigners.
Registrearje by Login by Amazon
Foardat jo kinne brûke Login mei Amazon op in website of yn in mobile app, jo moatte registrearje in applikaasje mei Login mei Amazon. Jo oanmelde by Amazon-applikaasje is de registraasje dy't basisynformaasje befettet oer jo bedriuw, en ynformaasje oer elk webside of mobile app dy't jo oanmeitsje dy't Login mei Amazon stipet. Dizze saaklike ynformaasje wurdt werjûn oan brûkers elke kear as se brûke Login mei Amazon op jo webside of mobile app. Brûkers sille de namme fan jo applikaasje, jo logo, en in keppeling nei jo privacybelied sjen. Dizze stappen litte sjen hoe jo jo Android -app kinne registrearje foar gebrûk by Login mei Amazon.
Registrearje jo oanmelding mei Amazon-applikaasje
- Gean nei https://login.amazon.com.
- As jo jo earder oanmeld hawwe foar Oanmelde by Amazon, klikje jo op App Console. Klikje oars op Oanmelde. Jo wurde trochferwiisd nei Seller Central, dy't applikaasjeregistraasje foar Oanmelde by Amazon behannelet. As dit is dyn
De earste kear dat jo Seller Central brûke, wurde jo frege om in Seller Central-akkount yn te stellen. - Klikje Nije applikaasje registrearje. It Registrearje jo oanfraachformulier sil ferskine:
a. Yn it Registrearje jo oanfraachformulier moatte jo in namme en in beskriuwing ynfiere foar jo oanfraach.
De Namme is de namme werjûn op it ynstimmingsskerm as brûkers ynstimme om ynformaasje te dielen mei jo applikaasje. Dizze namme jildt foar Android, iOS, en webside ferzjes fan jo applikaasje. De beskriuwing helpt jo elk fan jo oanmelden te ûnderskieden mei Amazon-applikaasjes, en wurdt net werjûn oan brûkers.
b. Fier a Privacy URL foar jo applikaasje.
De privacyferklearring URL is de lokaasje fan it privacybelied fan jo bedriuw of applikaasje (bglample, http://www.example.com/privacy.html). Dizze keppeling wurdt werjûn oan brûkers op it tastimmingskerm.
c. As jo wolle tafoegje a Logo Image foar jo applikaasje, klik Kieze File en sykje de jildende ôfbylding.
Dit logo wurdt werjûn op it oanmeld- en tastimmingskerm om jo bedriuw te fertsjintwurdigjen of website. It logo wurdt krimp nei 50 piksels yn hichte as it is heger as 50 piksels; der is gjin beheining op de breedte fan it logo. - Klikje Rêde. Jo sampDe registraasje soe der sa útsjen moatte:
Neidat jo basis applikaasje ynstellings binne bewarre, kinne jo tafoegje ynstellings foar spesifike websiden en mobile apps dy't dizze Login brûke mei Amazon-akkount
Add Webside Ynstellings nei jo applikaasje
- Fan it Applikaasje skerm, klikje Web Ynstellings. Jo sille automatysk wurde tawiisd wearden foar Client ID en Client Secret. De client ID identifisearret jo website, en de klant geheim wurdt yn guon omstannichheden brûkt om jo website is autentyk. It klantgeheim, lykas in wachtwurd, is fertroulik. Nei view de klant geheim, klik Geheim sjen litte.
- Om ta te foegjen Tastiene JavaScript Origins or Tastiene Return URLs nei jo applikaasje, klikje Bewurkje.
Noat: Om te brûken Login mei Amazon mei in webside, moatte jo in tastiene JavaScript-oarsprong opjaan (foar de ymplisite subsydzje) of in tastiene weromreis URL (foar it subsydzje fan autorisaasjekoade). As jo Amazon Pay brûke, moatte jo in tastiene JavaScript-oarsprong opjaan.
a. As dyn webside sil de Login mei Amazon SDK brûke foar JavaScript, foegje jo ta website oarsprong oan Tastiene JavaScript Origins.
In oarsprong is de kombinaasje fan protokol, domeinnamme en poarte (bglample, https://www.example.com:8443). Tastiene oarsprong moat it HTTPS-protokol brûke. As jo in standert poarte brûke (poarte 80 of poarte 443) hoege jo allinich de domeinnamme op te nimmen (bgl.ample, https://www.example.com).
It tafoegjen fan jo domein hjir lit de SDK foar JavaScript kommunisearje mei jo website direkt
tidens it oanmeldproses. Web browsers blokkearje normaal kommunikaasje tusken skripts fan oarsprong, útsein as it skript it spesifyk tastiet.
Klikje om mear as ien oarsprong ta te foegjen Foegje in oar ta.
b. As dyn webDe side sil HTTPS-oproppen meitsje nei de Oanmelde mei Amazon-autorisaasjetsjinst en in redirect_uri spesifisearje foar antwurden, foegje dy trochferwizings URI's ta oan Tastiene Return URLs, It weromkommen URL omfettet it protokol, domein, paad, en query-string(en) (bygelyksample, https://www.example.com/login.php).
Om mear as ien werom te foegjen URL, klik Foegje in oar ta. - Klikje Rêde
Foegje dan in knop Oanmelde mei Amazon ta oan jo website. Jo kinne kieze út in ferskaat oan knoppen en kieze de ôfbylding dy't it bêste by jo past website. Sjoch de Login mei Amazon Style Guidelines foar bêste praktiken en in list mei ôfbyldings om út te kiezen.
- Foegje de folgjende koade ta oan jo webside wêr't jo wolle dat de knop ferskynt. Foar de doelen fan dizze hantlieding moat dit in HTTPS wêze website:
<img border=”0″ alt=”Login with Amazon”
src="https://images-na.ssl-images-amazon.com/images/G/01/lwa/
btnLWA_gold_156x32.png"
breedte = "156" hichte = "32" />
- Fakultatyf. Foegje de folgjende keppeling ta oan jo webside wêr't jo wolle dat in "Logout" prompt ferskynt:
- Ferfarskje de side om te befêstigjen dat de knop no op jo website.
Útlogge
Foegje de Login ta mei Amazon SDK foar JavaScript
De Login mei Amazon SDK foar JavaScript sil alle lestige dielen fan it yntegrearjen fan Login mei Amazon yn jo omgean website.
- Foegje de folgjende koade ta nei de iepening op jo side om de JavaScript yn jo side te laden:
window.onAmazonLoginReady = function() {
amazon.Login.setClientId('YOUR-CLIENT-ID');
};
(funksje(d) {
var a = d.createElement('script'); a.type = 'text/javascript';
a.async = wier; a.id = 'amazon-login-sdk';
a.src =
'https://assets.loginwithamazon.com/sdk/na/login1.j
s'; d.getElementById('amazon-root').appendChild(a);
})(dokumint);
- Ferfange YOUR-KLIENT-ID mei de Client ID jo ûntfange as jo Registrearje by Login by Amazon.
- Foegje de folgjende JavaScript ta nei de knop Oanmelde mei Amazon op jo side.
document.getElementById('LoginWithAmazon').onclick = function() {
opsjes = { scope: 'profile' };
amazon.Login.authorize(opsjes,
'https://www.example.com/handle_login.php');
falsk weromkomme;
};
- Ferfange www.example.com mei it domein fan jo website.
Noat: Standert sil de SDK foar JavaScript it oanmeldskerm werjaan yn in popup-finster. Jo kinne de popup-eigenskip fan 'e opsjesparameter ynstelle op falsk om yn plak fan klanten te ferwizen nei in nije side om yn te loggen. Popup-finsters wurde net stipe yn native iOS WebView-basearre apps. As jo fan doel binne Login mei Amazon te brûken yn jo iOS-app, riede wy oan om de ios-gsg._TTH [PDF], of it útfieren fan in trochferwizing oanmeldûnderfining. Sjoch de website-sdk-referinsje._TTH [PDF] foar ynformaasje oer it oanpassen fan de opsjesparameter. - Sadree't de brûker hat oanmeld en ynstimd om te dielen de opjûne gegevens, it aktuele finster wurdt omlaat nei de opjûne URI en it autorisaasje antwurd wurdt tafoege oan de query string. De URI moat it https-protokol brûke en op itselde domein wêze as it hjoeddeistige finster.
- Fakultatyf. Neidat brûkers autorisearre binne, moatte jo tagong ta in Ofmelde hyperlink of knop op jo side taheakje, sadat se kinne ôfmelde. Foegje de folgjende JavaSkript ta om brûkers ynskeakelje te kinnen ôfmelde:
document.getElementById('Logout').onclick = function() {
amazon.Login.logout();
};
Jo sille it antwurd fan Amazon behannelje mei /handle_login.php op jo webside yn 'e folgjende seksje. Jo kinne dit paad feroarje nei ien fan jo kar op in letter momint.
Krij Profile Ynformaasje
Jo kinne krije de brûker syn profile ynformaasje fan Amazon mei help fan de Tagong Token weromjûn troch de SDK.
- Behannelje yn jo applikaasje oan 'e tsjinner it oanfraach makke oan /handle_login.php, en krije profile ynformaasje mei it tagongstoken en de Profile REST API. Examples yn PHP, Python, Java, en Ruby binne hjirûnder.
- Starte jo webside en befêstigje dat jo kinne ynlogge mei jo Amazon.com-credentials.
PHP Example
// Ferifiearje dat de tagong token heart by ús // It token moat wêze url-kodearre as trochjûn oan tokeninfo $c = curl_init('https://api.amazon.com/auth/o2/tokeninfo?access_token='. urlencode($_REQUEST['access_token'])); curl_setopt($c, CURLOPT_RETURNTRANSFER, true);$r = curl_exec($c); curl_slute($c); $d = json_decode($r);if ($d->aud != 'YOUR-CLIENT-ID') { // it tagongstoken heart net by ús header('HTTP/1.1 404 net fûn'); echo 'Side net fûn'; útgong;} // Wissel it tagongstoken út foar brûker profile $r = curl_exec($c); curl_slute($c); echo sprintf('%s %s %s', $d->name, $d->email, $d->user_id); |
Python Example
Jo moatte de pycurl bibleteek om dizze sampde koade.
ymportearje pycurl ymport urllib ymportearje json import StringIO…b = StringIO.StringIO()# Ferifiearje dat it tagongstoken fan ús heart # It token moat wêze url-kodearre as trochjûn oan tokeninfo c = pykurl.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(pycurl.WRITEFUNCTION, b.write) c.perform() if d['aud'] != 'YOUR-CLIENT-ID': # Wissel it tagongstoken út foar brûkersprofile c = pykurl.Curl() c.perform() print "%s %s %s"%(d['namme'], d['email'], d['user_id']) |
Java Example
Jo moatte de Jackson en HttpComponents biblioteken om dizze sampde koade.
ymportearje com.fasterxml.jackson.core.type.TypeReference; ymportearje com.fasterxml.jackson.databind.ObjectMapper; ymportearje org.apache.http.client.fluent.Content; ymportearje org.apache.http.client.fluent.Request;ymportearje java.net.URLEncoder; ymportearje java.util.Map;…// Ferifiearje dat it tagongstoken fan ús heart // It token moat wêze url-kodearre as trochjûn oan tokeninfo Map m = new ObjectMapper().readValue(c.toString(), new TypeReference>() if (!"YOUR-CLIENT-ID".equals(m.get("aud"))) { } // Wissel it tagongstoken út foar brûker profile System.out.println(String.format(“%s %s %s”, m.get(“name”), |
Ruby Example
fereasket "rubygems" fereasket "net/https" fereasket "json" fereasket "uri" ... # Ferifiearje dat it tagongstoken fan ús heart # It token moat wêze url-kodearre as trochjûn oan tokeninfo uri = URI.parse(“https://api.amazon.com/auth/o2/tokeninfo?access_token=” + URI.encode(access_token)) req = Net::HTTP::Get.new(uri.request_uri) http = Net::HTTP.new(uri.host, uri.port) http.use_ssl = wier http.verify_mode = OpenSSL::SSL::VERIFY_PEERresponse = http.request(req) decode = JSON.parse(response.body) if decode['aud'] != 'YOUR-CLIENT-ID' ein # Wissel it tagongstoken út foar brûkersprofile antwurd = http.request(req) set sprintf “%s %s %s”, decode['namme'], decode['email'], |
Finish Yntegraasje mei dyn Website
No wite jo hoe't jo Login mei Amazon tafoegje kinne oan jo website. De folgjende stappen binne om Amazon-brûkersakkounts te yntegrearjen yn jo akkountbehearsysteem en dizze te brûken om jo te personalisearjen webside foar Amazon-klanten. Sjoch foar mear ynformaasje:
- De Login mei Amazon Developer syn Guide foar Websites
- https://login.amazon.com/documentation/combining-user-accounts
Mear help nedich? Besjoch ús foarums.
Glossary
tagong omfang In tagong berik definiearret it type brûker profile gegevens de klant is
oanfreegjen. De earste kear dat in brûker oanmeldet, sjogge se in list mei de items yn
de tagong berik en moat akkoard te foarsjen de gegevens oan de klant yn
om fierder te gean.
tagong token In tagongstoken wurdt ferliend troch de autorisaasjetsjinner as in brûker oanmelde
yn in side. In tagongstoken is spesifyk foar in kliïnt, in brûker en in tagong
omfang. Tagongstokens hawwe in maksimale grutte fan 2048 bytes. In klant moat
brûk in tagong token te heljen klant profile data.
tastien JavaScript oarsprong In JavaScript-oarsprong is de kombinaasje fan protokol, domein en poarte wêr't in JavaScript-oprop ûntstiet. Standert, web browsers blokkearje JavaScript-oproppen fan ien oarsprong dy't besykje skript op in oare oarsprong te neamen. De Login mei Amazon SDK foar JavaSkript kinne oproppen fan oare oarsprong as se wurde oantsjutte as ûnderdiel fan in oanfraach.
By it registrearjen fan in website foar Login mei Amazon, Fier it skema, domein, en opsjoneel de haven, fan de webside dy't de Login mei Amazon SDK foar JavaScript omfettet (bygelyksample, http://www.example.com of https://localhost:8080).
tastien werom URL In weromkear URL is in adres op in webside dy't Login mei Amazon brûkt.
De autorisaasje tsjinst ferwiist brûkers nei dit adres as se oanmelde.
Sjoch ek trochferwizing URL.
API kaai In identifier dy't Login mei Amazon SDK's brûke om in mobile app te identifisearjen foar de autorisaasjetsjinst. API-kaaien wurde oanmakke as jo in mobile app registrearje.
oanfraach In applikaasje is de registraasje dy't ynformaasje befettet dy't de autorisaasjetsjinst nedich is om in klant te ferifiearjen foardat dy klant tagong hat ta klantprofiles. It befettet ek basisynformaasje oer jo bedriuw dat wurdt werjûn oan brûkers elke kear as se brûke Login mei Amazon op jo webside of mobile app.
oanfraach In applikaasje is de registraasje dy't befettet ynformaasje de autorisaasje tsjinst moat in klant ferifiearje foardat dy klant tagong hat klant profiles. It befettet ek basisynformaasje oer jo bedriuw dat wurdt werjûn oan brûkers elke kear as se brûke Login mei Amazon op jo webside of mobile app.
appstore ID In AppStore ID identifisearret unyk in mobile app yn 'e Amazon AppStore.
autorisaasje koade In autorisaasje koade is in wearde brûkt troch de Fergunning Code fergunning ta te stean a website te freegjen in tagong token.
autorisaasje koade grant In autorisaasjekoade-subsydzje is in autorisaasje-subsydzje dy't brûkt
tsjinner basearre ferwurking te freegjen in tagong token. Mei help fan de autorisaasje koade subsydzje, de tsjinner krijt in autorisaasje koade as queryparameter neidat de brûker ynlogt. De tsjinner wikselt de autorisaasjekoade út, klant identifier, en klant geheim foar in tagong token en in refresh token.
fergunningferliening In autorisaasje subsydzje is it proses dêr't de autorisaasje tsjinst ferifiearret in klant website syn fersyk foar tagong ta in klant profile. In autorisaasje subsydzje fereasket in client identifier en an tagong omfang, en kin fereaskje a klant geheim. As it proses slagget, de website wurdt ferliend in tagong token.
Der binne twa soarten autorisaasje subsydzjes, an Implisite subsydzje en an Fergunning Code fergunning.
autorisaasje tsjinst De oanmelding mei Amazon-autorisaasjetsjinst is de kolleksje fan einpunten levere troch Amazon wêrtroch in klant in brûker kin oanmelde fia autorisaasje subsydzjes. De autorisaasjetsjinst presintearret it oanmeldskerm en it tagongsskerm oan brûkers. It soarget foar tagong tokens, ferfarskje tokens, en klant profile gegevens om oan te melden by Amazon-kliïnten.
bondel identifier De bondel-identifikaasje is in unike identifier foar in iOS-app. Se nimme normaal de foarm fan com.companyname.appname.
kliïnt In klant is in webside of mobile app dy't Login mei Amazon brûkt.
client identifier De kliïntidentifikaasje is in wearde dy't oan 'e kliïnt wurdt tawiisd as se registrearje by Login by Amazon. It hat in maksimale grutte fan 100 bytes. De klantidentifikaasje wurdt brûkt yn kombinaasje mei it klantgeheim om de identiteit fan 'e klant te ferifiearjen as se in autorisaasjefergunning oanfreegje fan 'e autorisaasje tsjinst. De klant-identifikaasje is net geheim.
klant geheim De klant geheim, lykas de client identifier, is in wearde tawiisd oan de kliïnt as se registrearje by Login by Amazon. It hat in maksimale grutte fan 64 bytes. It klantgeheim wurdt brûkt yn kombinaasje mei de klantidentifikaasje om de identiteit fan de klant te ferifiearjen as se in aautorisaasje subsydzje fan de autorisaasje tsjinst. It klantgeheim moat fertroulik wurde hâlden.
tastimming skerm As in brûker oanmelde by in website of mobile app foar de earste kear, se wurde presintearre mei in tastimming skerm as de app freget profile data.
It tastimmingskerm toant de namme, logo ôfbylding file, en privacy notice URL ferbûn mei app, tegearre mei de tagong omfang de app freget.
klant profile In klant profile befettet ynformaasje oer de Login mei Amazon-klant, ynklusyf har namme, e-mailadres, postkoade en in unike identifier. IN website moat krije in tagong token foardat se in klantpro kinne krijefile. It soarte fan profile gegevens weromjûn wurdt bepaald troch de tagong omfang.
ymplisite subsydzje In ymplisite subsydzje is in fergunningferliening dat kin foltôge wurde mei allinnich de brûker syn web browser. Mei help fan de ymplisite subsydzje, de browser krijt in tagong token as URI-fragmint. In ymplisite subsydzje fereasket in client identifier en an tagong omfang. De ymplisite subsydzje net werom a ferfarskje token.
oanmeldskerm It oanmeldskerm is in HTML-side presintearre oan brûkers as se besykje oan te melden by in webside of mobile app mei Login mei Amazon. Brûkers kinne in besteand Amazon-akkount ynfiere of in nij meitsje fan dizze side.
logo ôfbylding file In PNG file levere troch de klant by it opsetten fan in oanfraach. Dit wurdt werjûn op it tastimmingsskerm as de brûker gjin tagong hat ta de kliïnt website. It logo stiet foar de klant website.
pakket namme In pakketnamme is in unike identifier foar in Android-app. Se hawwe normaal de foarm fan com.companyname.appname.
privacy notice URL A URL levere troch de klant by it opsetten fan in oanfraach. Dit wurdt werjûn op it tastimming skerm as de brûker hat gjin tagong ta de klant website. De URL moatte brûkers rjochtsje op it privacybelied foar de klant website.
trochferwizing URL A URL levere troch de klant oan de autorisaasje tsjinst. Nei't de brûker ynlogt, sil de tsjinst de browser fan de brûker trochferwize nei dit adres. Sjoch ek tastien Return URL.
ferfarskje token In refresh token wurdt ferliend troch de autorisaasje tsjinst wannear de
klant brûkt de Fergunning Code fergunning. In klant kin gebrûk meitsje fan in ferfarsk token te freegjen in nij tagong token doe't de hjoeddeiske tagong token ferrint. Ferfarskje tokens hawwe in maksimale grutte fan 2048 bytes. In hantekening is in SHA-256-hash-wearde ynbêde yn in mobile app dy't de identiteit fan 'e app ferifiearret. Se nimme normaal de foarm fan
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.
brûker In brûker is in persoan dy't in kliïnt besykje website en besiket yn te loggen mei Login mei Amazon.
ferzje In ferzje is in bepaald type Login mei Amazon client registrearre oan in oanfraach. In oanmelde by Amazon-applikaasje kin meardere ferzjes hawwe, elk stipet Android, iOS, of web.
amazon Oanmelde mei Amazon Begjingids foar Websites - Download [optimalisearre]
amazon Oanmelde mei Amazon Begjingids foar Websites - Download