amazon Login cù Amazon Getting Started

Cunnette vi cù Amazon: Guida introduttiva per Websiti Copyright © 2017 Amazon Services, LLC o i so affiliati. Tutti i diritti riservati.
Amazon è u logu Amazon sò marche di Amazon.com, Inc. o di i so affiliati. Tutti l'altri
marche ùn sò pruprietà di Amazon sò pruprietà di i so rispettivi pruprietarii.

Registrazione cù Login cù Amazon

Prima di pudè aduprà Login cù Amazon nantu à a websitu o in una app mobile, duvete registrà una applicazione cù Login cù Amazon. U vostru login cù l'applicazione Amazon hè a registrazione chì cuntene infurmazioni basi nantu à a vostra attività, è infurmazioni nantu à ognunu websitu o app mobile chì create chì supporta u login cù Amazon. Questa infurmazione cummerciale hè visualizata à l'utilizatori ogni volta chì utilizanu Login cù Amazon in u vostru websitu o app mobile. L'utilizatori vedenu u nome di a vostra applicazione, u vostru logu, è un ligame per a vostra pulitica di privacy. Queste tappe dimostranu cumu registrà a vostra app Android per aduprà cun Login cù Amazon.

Registrate u vostru Login cù l'Applicazione Amazon

1. Andà à https://login.amazon.com.
2. Se avete firmatu per Login cù Amazon prima, cliccate App Console. Altrimenti, cliccate Iscriviti. Sarete redirigitu à Seller Central, chì gestisce a registrazione di l'applicazione per Accedi cù Amazon. Sì questu hè u vostru
   prima volta aduprendu Seller Central, vi sarà dumandatu di creà un account Seller Central.
3. Cliccate Registra nova applicazione. U Registru U vostru modulu di candidatura apparirà:
   
   a. In u Registru U vostru modulu di candidatura, duvete inserisce un Nome è una Descrizione per a vostra applicazione.
   U Nome hè u nome affissatu nantu à a pantalla di accunsentu quandu l'utilizatori accettanu di sparte infurmazioni cù a vostra applicazione. Stu nome hè appiicatu à Android, iOS è webversioni di u situ di a vostra dumanda. A Descrizzione vi aiuta à distingue ognuna di e vostre Connessione cù l'applicazioni Amazon, è ùn hè micca visualizata à l'utilizatori.
   b. Entre a Privacy URL per a vostra applicazione.
   L'Informazioni di Privacità URL hè a situazione di a vostra cumpagnia o pulitica di privacy di l'applicazione (per esample, http: //www.example.com/privacy.html). Stu ligame hè visualizatu à l'utilizatori nantu à a pantalla di accunsentu.
   c. Se vulete aghjunghje a Logo Image per a vostra applicazione, cliccate Sceglite File è localizza l'imaghjini applicabili.
   Stu logò hè visualizatu nantu à u screnu di cunnessione è d'accunsentu per raprisentà a vostra impresa o websitu. U logò serà riduttu à 50 pixel di altezza s'ellu hè più altu di 50 pixel; ùn ci hè limitazione per a larghezza di u logò.
4. Cliccate Salvà. U vostru sampa registrazione deve esse simile à questu:
   
   Dopu chì i vostri paràmetri di l'applicazione di basa sò salvati, pudete aghjunghje paràmetri per specifichi websiti è app mobile chì utilizeranu questu Login cun account Amazon

Add WebImpostazioni di u situ per a vostra Applicazione

1. Da u screnu Applicazioni, cliccate Web Settings. Vi sarà automaticamente assignatu valori per ID di Cliente è Secret di Cliente. L'ID cliente identifica u vostru websitu, è u secretu di u cliente hè adupratu in certe circustanze per verificà u vostru websitu hè autenticu. U secretu di u cliente, cum'è una password, hè cunfidenziale. À view u secretu di u cliente, cliccate Mostra Secretu.
   
2. Per aghjunghje Autorizati JavaScript Origini or Ritornu Ammessu URLs à a vostra dumanda, cliccate Edit.
   Nota: Per utilizà Login cù Amazon cù un websitu, duvete specificà sia una origine JavaScript permessa (per a cuncessione Implicita) sia un ritornu permessu URL (per a cuncessione di u Codice d'Autorizazione). Se utilizate Amazon Pay, duvete specificà una origine JavaScript permessa.
   
   a. Se u vostru webU situ utilizarà l'Accessu cù Amazon SDK per JavaScript, aghjunghje u vostru weborigine di u situ à Autorizati JavaScript Origini.
   Un urigine hè a cumbinazione di protocolu, nome di duminiu è portu (per esample, https: // www.example.com:8443). L'urigine permessa deve aduprà u protocolu HTTPS. Sè vo aduprate un portu standard (portu 80 o portu 443) avete bisognu di cumprende solu u nome di duminiu (per esample, https: // www.example.com).
   Aghjunghje u vostru duminiu quì permette à u SDK per JavaScript di cumunicà cù u vostru websitu direttamente
   durante u prucessu di cunnessione. Web i navigatori bluccanu nurmalmente a cumunicazione trà l'urigine trà i script à menu chì u script permessi specificamente.
   Per aghjunghje più di una origine, cliccate Aghjunghjite un altru.
   b. Se u vostru webu situ hà da fà chjamate HTTPS à l'Accessu cù u serviziu d'autorizazione Amazon è specificendu un redirect_uri per e risposte, aghjunghje quelli URI di redirect à Ritornu Ammessu URLs. U ritornu URL include u protocolu, u duminiu, u percorsu è e stringhe di query (per esample, https: // www.example.com/login.php).
   Per aghjunghje più di un ritornu URL, cliccate Aghjunghje un altru.
3. Cliccate Salvà

Aghjunghjite un Connessione cù u Buttone Amazon à u vostru Websitu

Dopu, aghjunghje un Login cù u buttone Amazon à u vostru websitu. Pudete sceglie da una varietà di buttoni è sceglie l'imagine chì si adatta megliu à u vostru websitu. Vede u Login cun Guidelines di Stile Amazon per e pratichi meglii è un elencu di maghjine da sceglie.

1. Aghjunghjite u codice seguente à u vostru websitu induve vulete chì apparisci u buttone. Per i scopi di sta guida, questu deve esse un HTTPS websitu:
   

   <img border="0″ alt="Login with Amazon" src = "https://images-na.ssl-images-amazon.com/images/G/01/lwa/ btnLWA_gold_156x32.png " width = ”156 ″ height =” 32 ″ />

2. Opcional. Aghjunghjite u ligame seguente à u vostru websitu induve vulete un prompt di "Esci" per cumparisce:
3. Rinfresca a pagina per cunfirmà chì u buttone apparisce avà nantu à u vostru websitu.
   

   Scunnettà si

Aghjunghjite u login cun Amazon SDK per JavaScript

U login cun Amazon SDK per JavaScript gestirà tutte e parti difficiuli di l'integrazione di Login cun Amazon in u vostru websitu.

1. Aghjunghjite u codice seguente dopu l'apertura in a vostra pagina per carica u JavaScript in a vostra pagina:
   

   window.onAmazonLoginReady = funzione () { amazon.Login.setClientId ('U VOSTRE-CLIENT-ID'); }; (funzione (d) { var a = d.createElement ('script'); a.type = 'testu / javascript'; a.async = veru; a.id = 'amazon-login-sdk'; a.src = 'https://assets.loginwithamazon.com/sdk/na/login1.j s '; d.getElementById ('amazon-root'). appendChild (a); }) (document);

2. Sustituisce U vostru ID-CLIENTE cù l'ID di Cliente chì ricevi quandu Registrazione cù Login cù Amazon.
3. Aghjunghjite u seguente JavaScript dopu u login cù u buttone Amazon in u vostru situ.
   

   document.getElementById ('LoginWithAmazon'). onclick = function () { ozzione = {scope: 'profile'}; amazon.Login.authorize (opzioni, 'https: //www.example.com/handle_login.php '); vultà falsu; };

4. Rimpiazzà www.example.com cù u duminiu di u vostru websitu.
   Nota: Per automaticamente, u SDK per JavaScript mostrarà a schermata di login in una finestra popup. Pudete definisce a pruprietà popup di u paràmetru d'opzioni in falsu per redirige invece i clienti à una nova pagina per accede. A finestra popup ùn sò micca supportate in iOS nativu WebViewapplicazioni basate. Se avete intenzione di utilizà Login cù Amazon in a vostra app iOS, ricumandemu sia cù u ios-gsg._TTH [PDF], o implementendu una sperienza di cunnessione reindirizzata. Vede u website-sdk-reference._TTH [PDF] per infurmazione nantu à persunalizà u parametru d'opzioni.
5. Una volta chì l'utilizatore hà loguatu è accunsentitu à sparte i dati specificati, a finestra attuale serà redirigata versu l'URI datu è a risposta d'autorizazione serà aghjuntu à a stringa di quistione. L'URI deve aduprà u protocolu https è esse in u listessu duminiu cum'è a finestra attuale.
6. Opcional. Dopu chì l'utilizatori sò autorizati, duvete aghjunghje l'accessu à un hyperlink o un buttone di Cunniscenza in u vostru situ in modo da pudè disconnettesi. Aghjunghjite u JavaScript seguente per permette à l'utilizatori di disconnettesi:
   

   document.getElementById ('Logout'). onclick = function () { amazon.Login.logout (); };

   Puderete gestisce a risposta da Amazon cù /handle_login.php nantu à u vostru websitu in a sizzioni prossima. Pudete cambià sta strada per una di e vostre scelte in un mumentu dopu.

Uttene Profile infurmazione

Pudete uttene u pro di l'utentefile infurmazione da Amazon cù u Token d'accessu vultatu da u SDK.

1. In a vostra applicazione di u latu di u servitore, gestite a richiesta fatta à /handle_login.php, è uttene profile infurmazione aduprendu u gettone d'accessu è u Profile API REST. Esamples in PHP, Python, Java è Ruby sò quì sottu.
2.  Lanciate u vostru websitu è ​​cunfirmate chì pudete accede cù e vostre credenziali Amazon.com.

PHP Esample

// Verificate chì u gettone d'accessu appartene à noi // U token deve esse url-codificatu quandu hè passatu à tokeninfo $ c = curl_init ('https://api.amazon.com/auth/o2/tokeninfo?access_token='. urlencode ($ _ DUMANDA ['access_token'])); curl_setopt ($ c, CURLOPT_RETURNTRANSFER, veru); $ r = curl_exec ($ c); curl_close ($ c); $ d = json_decode ($ r); se ($ d-> aud! = 'U TU-CLIENT-ID') {// u gettone d'accessu ùn ci appartene micca l'intestazione ('HTTP / 1.1 404 Micca Trovatu'); echo 'Pagina micca truvata'; sorte;} // Scambià u gettone d'accessu per l'utilizatore profile // U token ùn deve esse url-codificatu quandu hè passatu à profile $ c = curl_init ('https://api.amazon.com/user/profile'); curl_setopt ($ c, CURLOPT_HTTPHEADER, array ('Autorizazione: portatore'. $ _REQUEST ['access_token'])); curl_setopt ($ c, CURLOPT_RETURNTRANSFER, veru); $ r = curl_exec ($ c); curl_close ($ c); $ d = codice_json ($ r); echo sprintf ('% s% s% s', $ d-> nome, $ d-> email, $ d-> user_id);

Python Example

You deve scaricà lu pycurl biblioteca per aduprà questu sampu codice.

impurtà pycurl impurtà urllib impurtà json impurtà StringIO ... b = StringIO.StringIO () # Verificate chì u gettone d'accessu appartene à noi # U token deve esse url-codificatu quandu hè passatu à 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. Scrive) c.perform () d = json.loads (b.getvalue ()) if d ['aud']! = 'ID-VOSTRA CLIENTE': # u gettone d'accessu ùn ci appartene micca rilancià BaseException ("Gettone invalidu") # Scambià u gettone d'accessu per l'utilizatore profile # U token NON deve esse url-codificatu quandu hè passatu à profile b = StringIO.StringIO () c = pycurl.Curl() c. setopt (pycurl.URL, "Https://api.amazon.com/user/profile") C. Setopt (pycurl.HTTPHEADER, ["Autorizazione: portatore" + access_token]) c.setopt (pycurl.SSL_VERIFYPEER, 1) c. setopt (pycurl.WRITEFUNCTION, b. Scrive) c.perform () d = json.loads (b.getvalue ()) stampa "% s% s% s"% (d ['nome'], d ['email'], d ['user_id'])

Java Example

You deve scaricà lu Jackson è HttpComponents librerie per aduprà questu sampu codice.

impurtà com.fasterxml.jackson.core.type.TypeReference; impurtà com.fasterxml.jackson.databind.ObjectMapper; impurtazione org.apache.http.client.fluent.Content; impurtà org.apache.http.client.fluent.Request; impurtà java.net.URLCodificatore; impurtà java.util.Map; ... // Verificate chì u gettone d'accessu appartene à noi // U token deve esse url-codificatu quandu hè passatu à tokeninfo Cuntenutu c = Request.Get ("https://api.amazon.com/auth/o2/tokeninfo?access_token=" + URLEncoder.encode (access_token, "UTF-8")) .execute () .returnContent (); Mappa m = novu ObjectMapper (). ReadValue (c.toString (), novu TypeReference> () {}); if (! "ID-TU CLIENT-ID" .equals (m.get ("aud"))) { // u gettone d'accessu ùn ci appartene micca lanciatu novu RuntimeException ("Simbulu invalidu"); } // Scambià u gettone d'accessu per l'utilizatore profile // U token ùn deve esse url-codificatu quandu hè passatu à profile c = Request.Get ("https://api.amazon.com/user/profile" .addHeader ("Autorizazione", "portatore" + access_token) .execute () .returnContent (); m = novu ObjectMapper (). readValue (c.toString (), nova TypeReference> () {}); System.out.println (String.format ("% s% s% s", m.get ("nome"), m.get ("email"), m.get ("user_id")));

Ruby Example

bisognu di "rubygems" richiede "net / https" bisognu di "json" richiede "uri" ... # Verificate chì u gettone d'accessu appartene à noi # U token deve esse url-codificatu quandu hè passatu à 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 = veru http.verify_mode = OpenSSL :: SSL :: VERIFY_PEERresponse = http.request (richiesta) decode = JSON.parse (response.body) if decode ['aud']! = 'U TU CLIENT-ID' # u gettone d'accessu ùn appartene micca us alzà "Simone invalidu" fine # Scambià u gettone d'accessu per l'utilizatore profile # U token NON deve esse url-codificatu quandu hè passatu à profile uri = URI.parse ("https://api.amazon.com/user/profile" req = Net :: HTTP :: Get.new (uri.request_uri) req ['Autorizazione'] = "portatore" + access_token http = Net :: HTTP.new (uri.host, uri.port) http.use_ssl = veru http.verify_mode = OpenSSL :: SSL :: VERIFY_PEER risposta = http.request (req) decode = JSON.parse (response.body) mette sprintf "% s% s% s", decodifica ['nome'], decode ['email'], decode ['user_id']

 

Finisci Integrazione cù u vostru Websitu

Avà sapete cumu aghjunghje Login cù Amazon à u vostru websitu. I prossimi passi sò di integrà i conti d'utilizatori di Amazon in u vostru sistema di gestione di i conti è aduprà questi per persunalizà u vostru websitu per i clienti Amazon. Per più infurmazione, vedi:

• U login cun Amazon Guida di u Sviluppatore per Websiti
• https://login.amazon.com/documentation/combining-user-accounts

Bisognu di più aiutu? Scuprite u nostru fori.

Glossariu

accessu à u scopu Un scopu di accessu definisce u tipu d'utilizatore profile dati chì u cliente hè
dumandendu. A prima volta chì un utilizatore accede, vedenu una lista di l'articuli in
u scopu di accessu è deve accettà di furnisce i dati à u cliente in
ordine per prucede.

token di accessu Un gettone d'accessu hè cuncessu da u servitore d'auturizazione quandu un utilizatore accede
in un situ. Un gettone d'accessu hè specificu per un cliente, un utilizatore è un accessu
portata. I gettoni d'accessu anu una dimensione massima di 2048 bytes. Un cliente deve
aduprà un gettone d'accessu per recuperà u cliente profile dati.

urigine JavaScript permessu Un urigine JavaScript hè a cumminazione di protokollu, duminiu è portu duve urigine una chjamata JavaScript. Per difettu, web i navigatori bluccanu e chjamate JavaScript da una urigine chì provanu à chjamà script in un'altra origine. L'accessu cù Amazon SDK per JavaScript permette chjamate da altre urighjini s'elli sò specificati cum'è parte di un applicazione.
Quandu si registra un websitu per Login cù Amazon, entre in u schema, duminiu, è facoltativamente u portu, di u webpagina chì include l'Accessu cù Amazon SDK per JavaScript (per esample, http: //www.example.com o https: // localhost: 8080).

ritornu permessu URL Un ritornu URL hè un indirizzu nantu à a websitu chì utilizeghja u login cù Amazon.
U serviziu d’auturizazione redirige l'utilizatori à questu indirizzu quandu cumpletanu u login.

Vede ancu redirezzione URL.

chjave API Un identificatore chì Accedi cù Amazon SDK utilizanu per identificà una app mobile per u serviziu di autorizazione. E chjave API sò generate quandu registrate una app mobile.

applicazione Una applicazione hè a registrazione chì cuntene informazioni chì u serviziu di autorizazione hà bisognu per verificà un cliente prima chì u cliente possa accede à u cliente profiles. Contene ancu informazioni di basa nantu à a vostra impresa chì hè visualizata à l'utenti ogni volta chì utilizanu Login cù Amazon nantu à u vostru websitu o app mobile.

applicazione Una applicazione hè a registrazione chì cuntene informazioni serviziu d’auturizazione hà bisognu di verificà un cliente prima chì quellu cliente possa accede cliente profiles. Contene ancu informazioni di basa nantu à a vostra impresa chì hè visualizata à l'utenti ogni volta chì utilizanu Login cù Amazon nantu à u vostru websitu o app mobile.

ID appstore Un ID AppStore identifica in modu unicu una app mobile in Amazon AppStore.

codice d'autorizazione Un codice d'auturizazione hè un valore adupratu da u Cunvenzione di u Codice d'Autorizazione parmette a websitu per dumandà un token di accessu.

cuncessione di u codice d’auturizazione Una cuncessione di u Codice d'Autorizazione hè una cuncessione d'autorizazione chì usa
servitore trasfurmazioni basati per dumandà un token di accessu. Utilizendu a cuncessione di u codice d'autorizazione, u servitore riceve un codice d'autorizazione cum'è paràmetru di quistione dopu chì l'utilizatore accede. U servitore scambia u codice d'auturizazione, identificatore client, è secretu di u cliente per un gettone d'accessu è un gettone d'aghjurnamentu.

cuncessione d'auturizazione Una cuncessione d'autorizazione hè u prucessu induve serviziu d’auturizazione verifica un cliente webdumanda di u situ per accede à a cliente profile. Una cuncessione d'auturizazione richiede un identificatore client è an accessu à u scopu, è pò richiede un secretu di u cliente. Se u prucessu riesce, u websitu hè cuncessu un token di accessu.
Ci hè dui tippi di sovvenzioni di autorizazione, un Subvenzione implicita è an Cunvenzione di u Codice d'Autorizazione.

serviziu d’auturizazione U serviziu di auturizazione Connessione cù Amazon hè a raccolta di punti finali furniti da Amazon chì permette à un cliente di accede à un utilizatore attraversu cuncessione d'auturizazione. U serviziu d'auturizazione presenta a schermata di cunnessione è a schermata di permessi à l'utilizatori. Fornisce gettoni d'accessu, rinfriscà i gettoni, è cliente profile dati per Login cù i clienti Amazon.

identificatore di fasciu L'identificatore di bundle hè un identificatore unicu per una app iOS. Normalmente piglianu a forma di com.companyname.appname.

cliente Un cliente hè un websitu o app mobile chì usa Login cù Amazon.

identificatore client  L'identificatore di u cliente hè un valore assignatu à u cliente quandu si registra cù Login cù Amazon. Hà una dimensione massima di 100 bytes. L'identificatore di u cliente hè adupratu in cungiunzione cù u secretu di u cliente per verificà l'identità di u cliente quandu dumandanu una concessione di autorizazione da u serviziu d’auturizazione. L'identificatore di u cliente ùn hè micca secretu.

secretu di u cliente U secretu di u cliente, cum'è u identificatore client, hè un valore assignatu à u cliente quandu si registra cù Login cun Amazon. Hà una dimensione massima di 64 bytes. U secretu di u cliente hè adupratu in cunjunzione cù l'identificatore di u cliente per verificà l'identità di u cliente quandu dumandanu un asubvenzione di uttorizazione da u serviziu d’auturizazione. U secretu di u cliente deve esse riservatu.

schermu di accunsentu Quandu un utilizatore accede à un websitu o app mobile per a prima volta, sò presentati cun un schermu di accunsentu se l'app richiede profile dati.
A schermata di accunsentu mostra u nome, immagine di logu file, è avvisu di privacy URL assuciatu cù l'app, cù u accessu à u scopu l'applicazione dumanda.

cliente profile Un cliente profile cuntene informazioni nantu à l'Accessu cù u cliente Amazon, cumpresu u so nome, indirizzu email, codice postale, è un identificatore unicu. A webu situ deve ottene un token di accessu prima ch'elli ponu uttene un cliente profile. U tipu di profile i dati restituiti sò determinati da u accessu à u scopu.

cuncessione implicita Una Grant Implicita hè una cuncessione d'auturizazione chì pò esse cumpletatu aduprendu solu quelli di l'utente web navigatore. Utilizendu a cuncessione implicita, u navigatore riceve un token di accessu cum'è un frammentu URI. Una cunvenzione implicita richiede un identificatore client è an accessu à u scopu. A cuncessione implicita ùn restituisce micca a rinfriscà u gettone.

schermu di login U screnu di cunnizzione hè una pagina HTML prisentata à l'utilizatori quand'elli provanu à accede à un websitu o app mobile cù Login cù Amazon. L'utilizatori ponu entre in un contu Amazon esistente o creà un novu da sta pagina.

immagine di logu file Un PNG file furnitu da u cliente quandu crea una applicazione. Questu hè visualizatu nantu à u schermu di permessi se l'utente ùn hà micca permessu l'accessu à u cliente websitu. U logò rapprisenta u cliente websitu.

nome di u pacchettu Un nome di pacchettu hè un identificatore unicu per una app Android. Normalmente piglianu a forma di com.companyname.appname.

avvisu di privacy URL A URL furnitu da u cliente quandu crea una applicazione. Questu hè visualizatu nantu à u schermu di accunsentu se l'utente ùn hà micca permessu l'accessu à u cliente websitu. U URL duverebbe indirizzà l'utilizatori à a pulitica di privacy per u cliente websitu.

redirezzione URL A URL furnitu da u cliente à u serviziu d’auturizazione. Dopu chì l'utente accede, u serviziu redirigerà u navigatore di l'utente à questu indirizzu. Vede ancu Ritornu permessu URL.

rinfriscà u gettone Un token di rinfrescamentu hè cuncessu da u serviziu d’auturizazione quandu u
u cliente usa u Cunvenzione di u Codice d'Autorizazione. Un cliente pò aduprà un gettone d'aghjurnamentu per dumandà un novu gettone d'accessu quandu u currente token di accessu scade. I gettoni d'aghjurnamentu anu una dimensione massima di 2048 bytes. Una firma hè un valore hash SHA-256 incrustatu in una app mobile chì verifica l'identità di l'app. Normalmente piglianu a forma di
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.

utilizatore Un utilizatore hè una persona chì visita un cliente websitu è ​​prova à accede à l'usu Accedi cù Amazon.

versione Una versione hè un tipu particulare di Login cù u cliente Amazon registratu in un applicazione. Una dumanda di cunnessione cù Amazon pò avè parechje versioni, ognuna supportendu sia Android, iOS, sia web.

 

amazon Cunnette vi cù Amazon Guida introduttiva per Websiti - Scaricate [ottimizatu]
amazon Cunnette vi cù Amazon Guida introduttiva per Websiti - Scaricate

Referenze

• Manuale d'usu