amazono Ensalutu kun Amazon Komenci
Ensalutu kun Amazon: Komenca Gvidilo por Webretejoj Kopirajto © 2017 Amazon Services, LLC aŭ ĝiaj filioj. Ĉiuj rajtoj rezervitaj.
Amazon kaj la Amazon-emblemo estas varmarkoj de Amazon.com, Inc. aŭ ĝiaj filioj. Ĉiuj aliaj
varmarkoj ne posedataj de Amazon estas posedaĵo de iliaj respektivaj posedantoj.
Registriĝu kun Ensalutu kun Amazon
Antaŭ ol vi povas uzi Ensalutu kun Amazon sur a webretejo aŭ en poŝtelefono, vi devas registri aplikaĵon kun Ensalutu kun Amazon. Via Ensalutu kun Amazon-aplikaĵo estas la registriĝo, kiu enhavas bazajn informojn pri via komerco kaj informojn pri ĉiu webretejo aŭ poŝtelefono, kiun vi kreas, kiu subtenas Ensalutu kun Amazon. Ĉi tiu komerca informo estas montrata al uzantoj ĉiufoje kiam ili uzas Ensalutu kun Amazon ĉe via webretejo aŭ poŝtelefona programo. Uzantoj vidos la nomon de via kandidatiĝo, vian emblemon kaj ligon al via privateca politiko. Ĉi tiuj paŝoj montras kiel registri vian Android-programon por uzi kun Ensaluto kun Amazon.
Registru vian Ensaluton per Amazon-Apliko
- Iru al https://login.amazon.com.
- Se vi antaŭe registriĝis por Ensaluti kun Amazon, alklaku Programkonzolon. Alie, alklaku Registriĝi. Vi estos redirektita al Seller Central, kiu pritraktas la registradon de aplikaĵoj por Ensaluti kun Amazon. Se ĉi tiu estas via
unuafoje uzante Seller Central, vi petos starigi konton de Seller Central. - Alklaku Registri novan programon. La Registru Via Aliĝilo aperos:
a. En la Registru Via Aliĝilo, vi devas enigi Nomon kaj Priskribon por via kandidatiĝo.
La Nomo estas la nomo montrita sur la konsenta ekrano kiam uzantoj konsentas kunhavigi informojn kun via aplikaĵo. Ĉi tiu nomo validas por Android, iOS kaj webretejaj versioj de via kandidatiĝo. La Priskribo helpas vin diferencigi ĉiun el via Ensaluto per Amazon-programoj, kaj ne estas montrata al uzantoj.
b. Enigu a Privateco URL por via kandidatiĝo.
La Privateca Avizo URL estas la loko de privateca politiko de via kompanio aŭ aplikaĵo (ekzample, http: //www.example.com/privacy.html). Ĉi tiu ligo montriĝas al uzantoj sur la konsenta ekrano.
c. Se vi volas aldoni a Logo Bildo por via aplikaĵo, alklaku Elektu File kaj lokalizu la aplikeblan bildon.
Ĉi tiu logoo montriĝas sur la ensaluta kaj konsenta ekrano por reprezenti vian kompanion aŭ webretejo. La logoo estos ŝrumpita ĝis 50 rastrumeroj alta se ĝi estas pli alta ol 50 rastrumeroj; ne estas limigo pri la larĝo de la logoo. - Klaku Konservu. Via sampla registriĝo devus aspekti simila al ĉi tio:
Post kiam viaj bazaj aplikaj agordoj estas konservitaj, vi povas aldoni agordojn por specifaj webretejoj kaj poŝtelefonaj programoj, kiuj uzos ĉi tiun Ensaluton per Amazon-konto
Aldoni Webretejaj Agordoj al via Apliko
- De la Aplika ekrano, alklaku Web Agordoj. Vi aŭtomate ricevos valorojn por Klienta ID kaj Klienta Sekreto. La klienta identigilo identigas vian webretejo, kaj la klienta sekreto estas uzata en iuj cirkonstancoj por kontroli vian webretejo estas aŭtentika. La klienta sekreto, kiel pasvorto, estas konfidenca. Al view la klienta sekreto, alklaku Montru Sekreton.
- Por aldoni Permesitaj Ĝavoskriptaj Originoj or Permesita Reveno URLs al via kandidatiĝo, alklaku Redakti.
Notu: Por uzi Ensaluton kun Amazon kun webretejo, vi devas specifi aŭ permesitan Ĝavaskriptan originon (por la Implicita subvencio) aŭ permesitan redonon URL (por la subvencio pri Rajtiga Kodo). Se vi uzas Amazon Pay, vi devas specifi permesitan JavaScript-originon.
a. Se via webretejo uzos la Ensaluton kun Amazon SDK por JavaScript, aldonu vian webejo origino al Permesitaj Ĝavoskriptaj Originoj.
Origino estas la kombinaĵo de protokolo, domajna nomo kaj haveno (ekzample, https: // www.example.com:8443). Permesitaj originoj devas uzi la HTTPS-protokolon. Se vi uzas norman havenon (haveno 80 aŭ haveno 443) vi bezonas nur inkluzivi la domajnan nomon (ekzample, https: // www.example.com).
Aldonado de via domajno ĉi tie permesas al SDK por JavaScript komuniki kun via webretejo rekte
dum la ensaluta procezo. Web retumiloj kutime blokas transdevan komunikadon inter skriptoj krom se la skripto specife permesas ĝin.
Por aldoni pli ol unu originon, alklaku Aldonu alian.
b. Se via webretejo faros HTTPS-alvokojn al la Ensaluta Servo kun Amazon-rajtiga servo kaj specifos redirekt_uri por respondoj, aldonu tiujn alidirektajn URI-ojn al Permesita Reveno URLs. La reveno URL inkluzivas la protokolon, domajnon, vojon kaj demandajn ĉenojn (ekzample, https: // www.example.com/login.php).
Por aldoni pli ol unu reveno URL, klaku Aldonu alian. - Klaku Konservu
Poste aldonu Ensaluton kun Amazon-butono al via webretejo. Vi povas elekti el diversaj butonoj kaj elekti la bildon plej taŭgan por vi webretejo. Vidu la Ensaluton kun Amazon-Stilaj Gvidlinioj por plej bonaj praktikoj kaj listo de bildoj por elekti.
- Aldonu la sekvan kodon al via webretejo kie vi ŝatus aperi la butonon. Por la celoj de ĉi tiu gvidilo, ĉi tio devas esti HTTPS webretejo:
<img border="0″ alt="Ensalutu kun Amazon"
src = ”https://images-na.ssl-images-amazon.com/images/G/01/lwa/
btnLWA_gold_156x32.png ”
larĝo = "156" alteco = "32" />
- Laŭvola. Aldonu la jenan ligon al via webretejo, kie vi ŝatus aperi "Ellasi" prompton:
- Refreŝigu la paĝon por konfirmi, ke la butono nun aperas sur via webretejo.
Elsaluti
Aldonu la Ensaluton per Amazon SDK por Ĝavoskripto
La Ensaluto kun Amazon SDK por JavaScript traktos ĉiujn malfacilajn partojn de integri Ensaluton kun Amazon en vian webretejo.
- Aldonu la jenan kodon post la malfermo en via paĝo por ŝarĝi la JavaScript en vian paĝon:
window.onAmazonLoginReady = funkcio () {
amazon.Login.setClientId ('VIA-KLIENTO-ID');
};
(funkcio (d) {
var a = d.createElement ('skripto'); a.type = 'teksto / ĝavaskripto';
a.async = vera; a.id = 'amazon-login-sdk';
a.src =
'https://assets.loginwithamazon.com/sdk/na/login1.j
s '; d.getElementById ('amazon-radiko'). appendChild (a);
}) (dokumento);
- Anstataŭigi VIA-KLIENTO-ID kun la Klienta ID, kiun vi ricevas kiam vi Registriĝu kun Ensalutu kun Amazon.
- Aldonu la jenan Ĝavaskripton post la butono Ensaluti per Amazon en via retejo.
document.getElementById ('SalutnomoKunAmazono'). onclick = function () {
ebloj = {scope: 'profile'};
amazon.Login.authorize (ebloj,
'https: //www.example.com/handle_login.php ');
return false;
};
- Anstataŭigu www.example.com kun la regado de via webretejo.
Notu: Defaŭlte, la SDK por JavaScript montros la ensalutan ekranon en ŝprucfenestro. Vi povas agordi la ŝprucfenestran posedaĵon de la opcia parametro al falsa por anstataŭ redirekti klientojn al nova paĝo por ensaluti. Ŝprucfenestroj ne estas subtenataj en denaska iOS WebView-bazitaj programoj. Se vi intencas uzi Ensaluton kun Amazon en via iOS-programo, ni rekomendas aŭ uzi la ios-gsg._TTH [PDF], aŭ efektivigante redirektitan ensalutan sperton. Vidu la webretejo-sdk-referenco._TTH [PDF] por informoj pri agordo de la parametro opcioj. - Post kiam la uzanto ensalutis kaj konsentis dividi la specifajn datumojn, la aktuala fenestro estos redirektita al la donita URI kaj la rajtiga respondo aldoniĝos al la demanda ĉeno. La URI devas uzi la protokolon https kaj esti sur la sama domajno kiel la nuna fenestro.
- Laŭvola. Post kiam rajtigitaj uzantoj, vi devas aldoni aliron al elsaluta hiperligo aŭ butono en via retejo por ke ili povu elsaluti. Aldonu la jenan Ĝavoskripton por ebligi al uzantoj elsaluti:
document.getElementById ('Elsaluti'). onclick = function () {
amazon.Login.logout ();
};
Vi traktos la respondon de Amazon per /handle_login.php sur via webretejo en la sekva sekcio. Vi povas ŝanĝi ĉi tiun vojon al unu el viaj elektoj poste.
Akiru Profesiulonfile Informoj
Vi povas akiri la avantaĝon de la uzantofile informoj de Amazon per la Aliro Token resendita de la SDK.
- En via servila flanka aplikaĵo, pritraktu la peton faritan al /handle_login.php, kaj akiru profesiulonfile informoj per la alira signo kaj la Profile REST API. Ekzampen PHP, Python, Java kaj Ruby estas sube.
- Lanĉu vian webretejo kaj konfirmu, ke vi povas ensaluti per viaj Amazon.com-atestiloj.
PHP Eksample
// Kontrolu, ke la alira signo apartenas al ni // La signo devas esti url-ĉifrita kiam pasita al tokeninfo $ c = curl_init ('https://api.amazon.com/auth/o2/tokeninfo?access_token='. urlkodi ($ _ DEMANDI ['access_token'])); curl_setopt ($ c, CURLOPT_RETURNTRANSFER, vera); $ r = curl_ekzektoro ($ c); ĉurl_fermi ($ c); $ d = json_decode ($ r); if ($ d-> aud! = 'VIA-KLIENTO-ID') {// la alira signo ne apartenas al ni kaplinio ('HTTP / 1.1 404 Ne Trovita'); eoo 'Paĝo ne trovita'; eliro;} // Interŝanĝu la aliran ĵetonon por uzantofile $ r = curl_ekzektoro ($ c); ĉurl_fermi ($ c); echo sprintf ('% s% s% s', $ d-> nomo, $ d-> retpoŝto, $ d-> uzanto_id); |
Python Eksample
Vi devas elŝuti la pycurl biblioteko por uzi ĉi tionample kodo.
importi pycurl importi urllib importi json importi StringIO ... b = StringIO.StringIO () # Konfirmu, ke la alira signo apartenas al ni # La signo devas esti url-ĉifrita kiam pasita al 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 (pycurl.WRITEFUNCTION, b.skribi) c. plenumi () if d ['aud']! = 'VIA-KLIENTO-ID': # Interŝanĝu la alirĵetonon por uzantofile c = pycurl.Curl() c. plenumi () presi "% s% s% s"% (d ['nomo'], d ['retpoŝto'], d ['uzanto_id']) |
Ĝava Eksample
Vi devas elŝuti la Jackson kaj HttpKomponantoj bibliotekoj por uzi ĉi tionample kodo.
importi com.fasterxml.jackson.core.type.TypeReference; importi com.fasterxml.jackson.databind.ObjectMapper; importi org.apache.http.client.fluent.Content; importi org.apache.http.client.fluent.Request; importi java.net.URLKodigilo; importi java.util.Map; ... // Kontrolu, ke la alira signo apartenas al ni // La signo devas esti url-ĉifrita kiam pasita al tokeninfo Mapo m = nova ObjectMapper (). ReadValue (c.toString (), nova TypeReference> () if (! "VIA-KLIENTO-ID" .equals (m.get ("aud"))) { } // Interŝanĝu la aliran ĵetonon por uzantofile System.out.println (String.format ("% s% s% s", m.get ("nomo"), |
Ruby Eksample
postulas "rubygems" postuli "net / https" postuli "json" postulu "uri" ... # Kontrolu, ke la alira signo apartenas al ni # La signo devas esti url-ĉifrita kiam pasita al 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 = vera http.verify_mode = OpenSSL :: SSL :: VERIFY_PEERresponse = http.request (req) deĉifri = JSON.parse (response.body) if decode ['aud']! = 'VIA-KLIENTO-ID' fino # Interŝanĝu la alirĵetonon por uzantofile respondo = http.request (req) metas sprintf "% s% s% s", deĉifras ['nomo'], deĉifras ['retpoŝton'], |
Finu Integriĝon kun via Webretejo
Nun vi scias kiel aldoni Ensaluton kun Amazon al via webretejo. La sekvaj paŝoj estas integri Amazon-uzantajn kontojn en vian administradan sistemon kaj uzi ĉi tiujn por personecigi viajn webretejo por klientoj de Amazon. Por pliaj informoj, vidu:
- La Ensaluto kun Amazon Gvidilo por Programistoj por Webretejoj
- https://login.amazon.com/documentation/combining-user-accounts
Ĉu vi bezonas pli da helpo? Rigardu nian forumoj.
Terminaro
alira amplekso Alira amplekso difinas la specon de uzanto profesiulofile datumoj, kiujn la kliento estas
petante. La unuan fojon, kiam uzanto ensalutas, ili vidas liston de la eroj
la alira amplekso kaj devas konsenti provizi la datumojn al la kliento en
ordo daŭrigi.
alirĵetono Alira signo estas donita de la rajtiga servilo kiam uzanto registras
en al retejo. Alira signo estas specifa por kliento, uzanto kaj aliro
amplekso. Alirĵetonoj havas maksimuman grandecon de 2048 bajtoj. Kliento devas
uzu aliran signon por rekuperi klientonfile datumoj.
permesitaj JavaScript-originoj Ĝavoskripta origino estas la kombinaĵo de protokolo, domajno kaj haveno, de kie estiĝas Ĝavoskripta alvoko. Defaŭlte, web retumiloj blokas JavaScript-vokojn de unu origino, kiuj provas nomi skripton al alia origino. La Ensaluto kun Amazon SDK por Ĝavoskripto permesas alvokojn de aliaj originoj se ili estas specifitaj kiel parto de aplikaĵo.
Aliĝinte webretejo por Ensaluti kun Amazon, eniru la skemon, domajnon kaj laŭvole la havenon de la webpaĝo kiu inkluzivas la Ensaluton kun Amazon SDK por Ĝavoskripto (ekzample, http: //www.example.com aŭ https: // localhost: 8080).
permesita reveno URL Reveno URL estas adreso sur webretejo, kiu uzas Ensaluton kun Amazon.
La rajtiga servo redirektas uzantojn al ĉi tiu adreso kiam ili finas ensaluton.
Vidu ankaŭ alidirekti URL.
API-ŝlosilo Identigilo, kiun Ensaluti per Amazon-SDKoj uzas por identigi poŝtelefonan programon al la rajtiga servo. API-ŝlosiloj estas generitaj kiam vi registras poŝtelefonon.
aplikaĵo Aplikaĵo estas la registrado, kiu enhavas informojn, kiujn la rajtiga servo bezonas por kontroli klienton antaŭ ol tiu kliento povas aliri klienton profesianfiles. Ĝi ankaŭ enhavas bazajn informojn pri via kompanio, kiuj estas montrataj al uzantoj ĉiufoje kiam ili uzas Ensaluton kun Amazon ĉe via webretejo aŭ poŝtelefona programo.
aplikaĵo Apliko estas la registriĝo, kiu enhavas informojn rajtiga servo bezonas kontroli klienton antaŭ ol tiu kliento povas aliri kliento porfiles. Ĝi ankaŭ enhavas bazajn informojn pri via kompanio, kiuj estas montrataj al uzantoj ĉiufoje kiam ili uzas Ensaluton kun Amazon ĉe via webretejo aŭ poŝtelefona programo.
ID-vendejo AppStore ID unike identigas poŝtelefonan programon en Amazon AppStore.
rajtigokodo Rajtiga kodo estas valoro uzata de la Rajtigo pri Rajtiga Kodo permesi a webretejo por peti alirĵetono.
rajtiga kodo-donado Stipendio pri Rajtiga Kodo estas rajtiga subvencio uzata
servilo bazita prilaborado por peti alirĵetono. Uzante la rajtigokodan donadon, la servilo ricevas rajtigokodo kiel petparametro post kiam la uzanto ensalutas. La servilo interŝanĝas la rajtigokodon, klienta identigilo, kaj klienta sekreto por alira signo kaj refreŝiga signo.
rajtiga subvencio Rajtiga subvencio estas la procezo, kie la rajtiga servo konfirmas klienton webla peto de retejo por aliro al kliento porfile. Rajtiga subvencio postulas klienta identigilo kaj an alira amplekso, kaj eble postulos klienta sekreto. Se la procezo sukcesos, la webretejo ricevas alirĵetono.
Estas du specoj de rajtigaj subvencioj, an Implicita subvencio kaj an Rajtigo pri Rajtiga Kodo.
rajtiga servo La rajtiga servo Ensaluti kun Amazon estas la kolekto de finpunktoj provizitaj de Amazon, kiu permesas al kliento ensaluti uzanton rajtigaj subvencioj. La rajtiga servo prezentas la ensalutan ekranon kaj la permesilan ekranon al uzantoj. Ĝi provizas aliraj signoj, refreŝigi ĵetonojn, kaj kliento porfile datumoj por Ensaluti kun Amazon-klientoj.
faska identigilo La paka identigilo estas unika identigilo por iOS-programo. Ili kutime prenas la formon de com.kompania nomo.app nomo.
kliento Kliento estas webretejo aŭ poŝtelefona programo, kiu uzas Ensaluton kun Amazon.
klienta identigilo La klienta identigilo estas valoro atribuita al la kliento, kiam ili registras ĉe Ensaluto ĉe Amazon. Ĝi havas maksimuman grandecon de 100 bajtoj. La klienta identigilo estas uzata kune kun la klienta sekreto por kontroli la identecon de la kliento, kiam ili petas rajtigan subvencion de la rajtiga servo. La klienta identigilo ne estas sekreta.
klienta sekreto La klienta sekreto, kiel la klienta identigilo, estas valoro atribuita al la kliento kiam ili registras ĉe Ensaluto ĉe Amazon. Ĝi havas maksimuman grandecon de 64 bajtoj. La klienta sekreto estas uzata kune kun la klienta identigilo por kontroli la identecon de la kliento, kiam ili petas asubvencia donado de la rajtiga servo. La klienta sekreto devas esti konfidenca.
konsenta ekrano Kiam uzanto ensalutas webretejo aŭ poŝtelefona programo por la unua fojo, ili prezentas konsentan ekranon se la programo petas profesianfile datumoj.
La konsenta ekrano montras la nomon, logobildo file, kaj privateca avizo URL asociita kun programo, kune kun la alira amplekso la programo petas.
kliento porfile Klienta profesiulofile enhavas informojn pri la Ensaluto kun Amazon-kliento, inkluzive de ilia nomo, retpoŝta adreso, poŝtkodo, kaj unika identigilo. A webretejo devas akiri alirĵetono antaŭ ol ili povas akiri klientan profesiulonfile. La speco de profesiulofile datumoj resenditaj estas determinitaj de la alira amplekso.
implicita subvencio Implicita Stipendio estas rajtiga subvencio tio povas esti kompletigita uzante nur la uzanton web retumilo. Uzante la implican subvencion, la retumilo ricevas alirĵetono kiel URI-fragmento. Implicita subvencio postulas klienta identigilo kaj an alira amplekso. La implica subvencio ne redonas a refreŝigi ĵetonon.
ensaluta ekrano La ensaluta ekrano estas HTML-paĝo prezentita al uzantoj kiam ili provas ensaluti al webretejo aŭ poŝtelefona programo uzante Ensaluton kun Amazon. Uzantoj povas eniri ekzistantan Amazon-konton aŭ krei novan de ĉi tiu paĝo.
logobildo file PNG file provizita de la kliento dum instalado de aplikaĵo. Ĉi tio montriĝas sur la ekrano de permesoj, se la uzanto ne donis aliron al la kliento webretejo. La emblemo reprezentas la klienton webretejo.
nomo de pakaĵo Paka nomo estas unika identigilo por Android-programo. Ili kutime prenas la formon de com.companyname.appname.
privateca avizo URL A URL provizita de la kliento dum instalado de aplikaĵo. Ĉi tio montriĝas sur la konsenta ekrano se la uzanto ne donis aliron al la kliento webretejo. La URL devas direkti uzantojn al la privateca politiko por la kliento webretejo.
alidirekti URL A URL provizita de la kliento al la rajtiga servo. Post kiam la uzanto ensalutis, la servo redirektos la retumilon de la uzanto al ĉi tiu adreso. Vidu ankaŭ permesitan Revenon URL.
refreŝigi ĵetonon Aktualiga signo estas donita de la rajtiga servo kiam la
kliento uzas la Rajtigo pri Rajtiga Kodo. Kliento povas uzi refreŝigan ĵetonon por peti novan aliran ĵetonon kiam la aktuala alirĵetono eksvalidiĝas. Refreŝigi ĵetonojn havas maksimuman grandecon de 2048 bajtoj. Subskribo estas SHA-256-haŝa valoro enigita en poŝtelefona programo, kiu kontrolas la identecon de la programo. Ili kutime prenas la formon de
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.
uzanto Uzanto estas persono, kiu vizitas klienton webretejo kaj provas ensaluti per Ensaluto kun Amazon.
versio Versio estas aparta speco de Ensaluto kun Amazon-kliento registrita al aplikaĵo. Ensalutado kun Amazon-aplikaĵo povas havi plurajn versiojn, ĉiu subtenanta aŭ Android, iOS aŭ web.
amazono Ensalutu kun Amazon Komenca Gvidilo por Webretejoj - Elŝuti [optimumigita]
amazono Ensalutu kun Amazon Komenca Gvidilo por Webretejoj - Elŝutu