Log ind med Amazon: Integrer med dit eksisterende kontosystem
Ophavsret © 2017 Amazon.com, Inc. eller dets tilknyttede selskaber. Alle rettigheder forbeholdes.
Amazon og Amazon-logoet er varemærker tilhørende Amazon.com, Inc. eller dets tilknyttede selskaber. Alle andre varemærker, der ikke ejes af Amazon, tilhører deres respektive ejere.
Indledning
Dette er en guide til integration af kundeprofffile data fra Login med Amazon-brugerkonti med en webwebsted eller mobilapp, der allerede har et kontoadministrationssystem.
Du lærer, hvordan du kan aktivere dit websted eller din app til at lade brugere logge ind med deres Amazon-konti, samt hvordan du kan lade eksisterende brugere af din webwebsted vedhæfte deres Amazon-identitet, så de logger ind med deres Amazon-legitimationsoplysninger.
Hvad du skal have
Denne vejledning antager, at du tidligere har tilmeldt dig Login med Amazon, registreret din webwebsted eller mobilapp som et Login med Amazon-applikation, og har de passende SDK- eller server-side-metoder til at kommunikere med Login med Amazon-tjenesten.
Denne vejledning antager også, at dit websted eller din app i øjeblikket har disse funktioner:
- En kontodatabase, hvor du registrerer oplysninger om hver brugerkonto:
en. Brugere har en form for unik identifikator
b. Brugere logger i øjeblikket på med deres brugernavn/adgangskode - En login-side for registrerede brugere.
- En registreringsside til registrering af nye brugere ved at tage i profile oplysninger (navn, e-mail osv.).
- En eller anden mekanisme til styring af godkendelsestilstand, efter at brugeren er logget ind, så den næste side ved, at brugeren i øjeblikket er logget ind (f.eks.ample, gemmer disse oplysninger i cookies eller en back-end-database).
Hvad du skal gøre
Dette er de ændringer på højt niveau, du skal foretage for at integrere Amazon-kunder i dit kontoadministrationssystem:
- Databaseændringer: Du skal kortlægge Amazon-kundeidentifikatorer til dine egne interne identifikatorer. Dette kan have form af et ekstra felt i brugertabellen i din database.
- Ændringer i login-brugergrænsefladen: Du skal ændre din login-side, registreringsside og betalingsside (hvis relevant). Din login-side skal have en mulighed for, at brugere kan vælge knappen "Login med Amazon" for at godkende ved hjælp af deres Amazon-legitimationsoplysninger. Trinene til at implementere dette er dækket i Log ind med Amazon-stilretningslinjer.
- Opret en Response Handler: Dette er en ny side på dit websted eller en funktion i din app til at håndtere autentificeringssvar fra Amazon.
Foretag databaseændringer
Du bliver nødt til at ændre din kontodatabase for at registrere en kortlægning mellem Amazon-konto-id'er og dine lokale konti. Dette kan have form af et nyt felt i din kontotabel eller en tabel, der kortlægger mellem Amazon-konto-id'er og dine lokale konto-id'er.
Amazon-konto-id'er returneres som user_ID-egenskaben i formen amzn1.accountVALUE.
F.eksample: amzn1.account.K2LI23KL2LK2.
Konfigurer login med Amazon
Brug af de relevante SDK eller server-side metoder til din webwebsted eller app, giver brugeren en metode til at logge på med deres Amazon-legitimationsoplysninger. Dette omfatter ændringer i brugergrænsefladen på dine login- og registreringssider. Din login-side skal have en mulighed for, at brugere kan vælge knappen "Login med Amazon" for at godkende ved hjælp af deres Amazon-legitimationsoplysninger. For flere detaljer om, hvordan man godkender brugere ved hjælp af Login med Amazon, se venligst vores udviklervejledninger for iOS, android-gsg._TTH [PDF], og website-gsg._TTH.
Få og sikre Amazon Customer Profile Data
Når brugeren har interageret med Login med Amazon-tjenesten for at godkende (og ved første besøg godkende datadeling), vil du modtage et autentificeringssvar.
Når du modtager et godkendelsessvar, skal du:
- Send adgangstokenet i dit godkendelsessvar til din server ved hjælp af HTTPS.
- Ring til proffen fra serversidenfile slutpunkt ved hjælp af adgangstoken. Se afsnittet med titlen Brug af adgangstokener til at læse en kundeprofile af login med Amazon website-developer-guide._TTH [PDF] for detaljer om at ringe til pro'enfile endpoint server-side, inklusive kode samples på flere sprog. Login med Amazon vil returnere en kundeprofffile svar med værdier (såsom user_id, email, name og/eller postal_code), du kan beholde på din server. At tage dette trin vil sikre profile data, du gemmer på din server, tilhører den kunde, der er logget ind på din klient.
- Søg 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.
- Søg 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.
- Opret cookies i brugerens browser eller optag dem på anden måde som godkendt med dit websted eller din app.
Find eller opret en lokal konto
Brugerproffile svar vil altid indeholde en parameter med navnet bruger_id. Værdien af denne parameter er en streng, der permanent og unikt identificerer den Amazon-konto, som brugeren har logget ind på. Amazon vil altid returnere den samme identifikator for hver bruger.
Du bør søge i din brugerdatabase for at se, om denne Amazon-konto tidligere har logget ind på dit websted eller din app. Hvis du ikke har set Amazon-kontoen før, skal du oprette en ny post i din lokale kontodatabase og knytte den til Amazon-konto-id'et til næste gang, de logger ind. Hvis Amazon-kontoen ikke matcher en eksisterende lokal konto, bede brugeren om deres lokale adgangskode for at forbinde de to konti.
Godkendelsessvaret kan indeholde yderligere brugerdata, f.eksample, brugerens navn og e-mailadresse. Du kan kopiere disse oplysninger til din lokale kontodatabase, når du opretter nye konti eller for at opdatere eksisterende konti (f.eksample, brugeren kunne have ændret deres e-mailadresse på Amazon siden sidste gang, de loggede ind).
Hvis du har brug for at indsamle yderligere oplysninger fra brugeren, før du opretter en konto, er det her, du vil vise en registreringsside. Du kan forududfylde den med de oplysninger, du modtog i godkendelsessvaret, eller du kan kun vise de yderligere felter, du har brug for.
Note: Hvis din webwebstedets eller appens lokale kontoadministration omfatter nulstilling af adgangskoder. Du vil måske sikre dig, at Login med Amazon-brugere ikke bliver forvirrede over, hvordan det påvirker deres Amazon-konto. Det kan betyde at skjule et "Nulstil adgangskode"-link, hvis brugere er logget ind via Login med Amazon, eller en note på siden til nulstilling af adgangskode, der leder dem til https://www.amazon.com hvis de vil ændre deres adgangskode.
Marker brugeren som godkendt
Når du har modtaget et gyldigt autentificeringssvar og fundet eller oprettet en tilsvarende konto i din egen kontodatabase, skal du markere, at brugeren har godkendt. Dette trin kan fungere nøjagtigt det samme som i dit nuværende godkendelsessystem.
Log ind med Amazon Integrate med dit eksisterende kontosystem – Download [optimeret]
Log ind med Amazon Integrate med dit eksisterende kontosystem – Download