Logga in med Amazon: Integrera med ditt befintliga kontosystem
Copyright © 2017 Amazon.com, Inc. eller dess dotterbolag. Alla rättigheter förbehållna.
Amazon och Amazon-logotypen är varumärken som tillhör Amazon.com, Inc. eller dess dotterbolag. Alla andra varumärken som inte ägs av Amazon tillhör respektive ägare.
Introduktion
Detta är en guide för att integrera kundproffsfile data från Logga in med Amazon -användarkonton med en webwebbplats eller mobilapp som redan har ett kontohanteringssystem.
Du kommer att lära dig hur du kan aktivera din webbplats eller app för att låta användare logga in med sina Amazon -konton, samt hur du kan låta befintliga användare av dina webwebbplats bifoga sin Amazon -identitet så att de loggar in med sina Amazon -uppgifter.
Vad du behöver ha
Den här guiden förutsätter att du tidigare har registrerat dig för inloggning med Amazon, registrerat din webwebbplats eller mobilapp som inloggning med Amazon-applikation och ha lämpliga SDK- eller serversidan för att kommunicera med tjänsten Logga in med Amazon.
Denna guide antar också att din webbplats eller app för närvarande har följande funktioner:
- En kontodatabas där du registrerar information om varje användarkonto:
a. Användare har någon form av unik identifierare
b. Användare loggar in för närvarande med sitt användarnamn / lösenord - En inloggningssida för registrerade användare.
- En registreringssida för registrering av nya användare genom att ta in profile information (namn, e -post, etc.).
- Någon mekanism för att hantera autentiseringsstatus efter att användaren har loggat in så att nästa sida vet att användaren för närvarande är inloggad (t.ex.ample, lagra den informationen i cookies eller en backenddatabas).
Vad du behöver göra
Det här är de höga ändringar du behöver göra för att integrera Amazon-kunder i ditt kontohanteringssystem:
- Databasändringar: Du måste kartlägga Amazon-kundidentifierare till dina egna interna identifierare. Detta kan ha formen av ett ytterligare fält i användartabellen i din databas.
- Ändringar av inloggningsgränssnitt: Du måste ändra din inloggningssida, registreringssida och kassasida (om tillämpligt). Din inloggningssida måste ha ett alternativ för användare att välja knappen "Logga in med Amazon" för att autentisera med hjälp av deras Amazon-referenser. Stegen för att genomföra detta behandlas i Logga in med Amazon Style-riktlinjer.
- Skapa en svarshanterare: Det här är en ny sida på din webbplats eller funktion i din app för att hantera autentiseringssvar från Amazon.
Gör databasändringar
Du måste ändra din kontodatabas för att spela in en mappning mellan Amazon-kontoidentifierare och dina lokala konton. Detta kan ha formen av ett nytt fält i din kontotabell eller en tabell som kartlägger mellan Amazon-kontoidentifierare och dina lokala kontoidentifierare.
Amazon-kontoidentifierare returneras som egenskapen user_ID, i formen amzn1.accountVALUE.
Till exempelample: amzn1.account.K2LI23KL2LK2.
Ställ in inloggning med Amazon
Använda relevanta SDK eller metoder på serversidan för din webwebbplats eller app, tillhandahåll en metod för användaren att logga in med sina Amazon -uppgifter. Detta inkluderar ändringar i användargränssnittet för dina inloggnings- och registreringssidor. Din inloggningssida måste ha ett alternativ för användare att välja knappen "Logga in med Amazon" för att autentisera med sina Amazon-uppgifter. Mer information om hur du autentiserar användare med inloggning med Amazon finns i våra utvecklarguider för iOS, android-gsg._TTH [PDF] och website-gsg._TTH.
Skaffa och säkra Amazon Customer Profile Data
När användaren har interagerat med inloggningen med Amazon-tjänsten för att autentisera (och vid det första besöket, auktorisera datadelning) får du ett autentiseringssvar.
När du får ett autentiseringssvar bör du:
- Skicka åtkomsttoken i ditt auktoriseringssvar till din server med HTTPS.
- Från proffssidan, ring proffsenfile slutpunkt med åtkomsttoken. Se avsnittet med rubriken Använda åtkomstpoken för att läsa ett kundproffsfile av inloggningen med Amazon website-developer-guide._TTH [PDF] för information om hur du ringer proffsenfile slutpunkt serversidan, inklusive koderamples på flera språk. Logga in med Amazon kommer att returnera ett kundproffsfile svar med värden (t.ex. user_id, email, namn och/eller postnummer) kan du behålla på din server. Att ta detta steg kommer att säkerställa att proffsenfile data du sparar på din server tillhör kunden som är inloggad på din klient.
- Leta efter the user’s Amazon account identifier within your user database to see if they have signed in before. If they have not then you will need to create a new account for them.
- Leta efter the user’s email address in your account system. If they have a local account with that email address, prompt them to enter their local credentials to allow Login with Amazon to log in that account.
- Skapa cookies i användarens webbläsare eller på annat sätt registrera dem som autentiserade med din webbplats eller app.
Hitta eller skapa ett lokalt konto
Användarens proffsfile svaret kommer alltid att innehålla en parameter som heter user_id. Värdet på denna parameter är en sträng som permanent och unikt identifierar Amazon -kontot som användaren har loggat in på. Amazon returnerar alltid samma identifierare för varje användare.
Du bör söka i din användardatabas för att se om detta Amazon-konto tidigare har loggat in på din webbplats eller app. Om du inte har sett Amazon-kontot förut måste du skapa en ny post i din lokala kontodatabas och koppla den till Amazon-kontoidentifieraren för nästa gång de loggar in. Om Amazon-kontot inte matchar ett befintligt lokalt konto, be användaren om sitt lokala lösenord att länka de två kontona.
Autentiseringssvaret kan innehålla ytterligare användardata, t.ex.ample, användarens namn och e -postadress. Du kan kopiera denna information till din lokala kontodatabas när du skapar nya konton eller uppdaterar befintliga konton (t.ex.ample, kunde användaren ha ändrat sin e -postadress på Amazon sedan förra gången han loggade in).
Om du behöver samla in ytterligare information från användaren innan du skapar ett konto är det här du vill visa en registreringssida. Du kan fylla i den med informationen du fick i autentiseringssvaret eller så kan du bara visa de ytterligare fält du behöver.
Notera: Om din webwebbplatsens eller appens lokala kontohantering inkluderar återställning av lösenord. Du kanske vill se till att inloggning med Amazon -användare inte blir förvirrade över hur det påverkar deras Amazon -konto. Det kan innebära att dölja en "Återställ lösenord" -länk om användare är inloggade via inloggning med Amazon, eller en anteckning på sidan för återställning av lösenord som leder dem till https://www.amazon.com om de vill ändra sitt lösenord.
Markera användaren som autentiserad
När du har fått ett giltigt autentiseringssvar och hittat eller skapat ett motsvarande konto i din egen kontodatabas bör du markera att användaren har autentiserat. Detta steg kan fungera exakt på samma sätt som i ditt nuvarande autentiseringssystem.
Logga in med Amazon Integrera med ditt befintliga kontosystem - Ladda ner [optimerad]
Logga in med Amazon Integrera med ditt befintliga kontosystem - Ladda ner