Inloggen met Amazon: integreer met uw bestaande accountsysteem
Copyright © 2017 Amazon.com, Inc., of haar dochterondernemingen. Alle rechten voorbehouden.
Amazon en het Amazon-logo zijn handelsmerken van Amazon.com, Inc. of haar dochterondernemingen. Alle andere handelsmerken die geen eigendom zijn van Amazon, zijn het eigendom van hun respectieve eigenaren.
Invoering
Dit is een handleiding voor het integreren van klantprofile gegevens van Inloggen met Amazon-gebruikersaccounts met a website of mobiele app die al een accountbeheersysteem heeft.
U leert hoe u uw site of app kunt inschakelen om gebruikers te laten inloggen met hun Amazon-accounts, en hoe u bestaande gebruikers van uw website hun Amazon-identiteit toevoegen zodat ze inloggen met hun Amazon-inloggegevens.
Wat je nodig hebt
In deze handleiding wordt ervan uitgegaan dat u zich eerder hebt aangemeld voor Inloggen bij Amazon, uw geregistreerde website of mobiele app als een Login met Amazon-toepassing, en beschikken over de juiste SDK- of server-side-methoden om te communiceren met de Login met Amazon-service.
In deze handleiding wordt er ook van uitgegaan dat uw site of app momenteel de volgende functies heeft:
- Een accountdatabase waarin u informatie over elk gebruikersaccount vastlegt:
een. Gebruikers hebben een soort unieke identificatie
b. Gebruikers loggen momenteel in met hun gebruikersnaam / wachtwoord - Een aanmeldingspagina voor geregistreerde gebruikers.
- Een registratiepagina voor het registreren van nieuwe gebruikers door profile gegevens (naam, e-mail, enz.).
- Een mechanisme voor het beheren van de authenticatiestatus nadat de gebruiker zich heeft aangemeld, zodat de volgende pagina weet dat de gebruiker momenteel is aangemeld (bijvoorbeeldample, die informatie opslaat in cookies of een back-enddatabase).
Wat je moet doen
Dit zijn de belangrijkste wijzigingen die u moet aanbrengen om Amazon-klanten te integreren in uw accountbeheersysteem:
- Database wijzigingen: U moet klant-ID's van Amazon toewijzen aan uw eigen interne ID's. Dit kan de vorm aannemen van een extra veld in de gebruikerstabel in uw database.
- Wijzigingen in gebruikersinterface voor inloggen: U moet uw aanmeldingspagina, registratiepagina en afrekenpagina (indien van toepassing) wijzigen. Uw inlogpagina moet een optie hebben voor gebruikers om de knop "Inloggen met Amazon" te selecteren om zich te verifiëren met hun Amazon-inloggegevens. De stappen om dit te implementeren worden behandeld in het Log in met Amazon Style Guidelines.
- Maak een Response Handler: Dit is een nieuwe pagina op uw site of functie in uw app om authenticatiereacties van Amazon af te handelen.
Breng wijzigingen in de database aan
U moet uw accountdatabase aanpassen om een koppeling tussen Amazon-account-ID's en uw lokale accounts vast te leggen. Dit kan de vorm aannemen van een nieuw veld in je accounttabel of een tabel die een koppeling maakt tussen Amazon-account-ID's en je lokale account-ID's.
Amazon-account-ID's worden geretourneerd als de eigenschap user_ID, in de vorm amzn1.accountVALUE.
Bijvoorbeeldample: amzn1.account.K2LI23KL2LK2.
Stel Inloggen met Amazon in
Met behulp van de relevante SDK of server-side methoden voor uw website of app, bieden de gebruiker een methode om in te loggen met zijn Amazon-inloggegevens. Dit omvat het aanbrengen van wijzigingen in de gebruikersinterface van uw aanmeldings- en registratiepagina's. Uw aanmeldingspagina moet een optie hebben voor gebruikers om de knop "Inloggen met Amazon" te selecteren om te verifiëren met hun Amazon-inloggegevens. Raadpleeg onze handleidingen voor ontwikkelaars voor meer informatie over het authenticeren van gebruikers met behulp van Inloggen met Amazon iOS, android-gsg._TTH [PDF], en website-gsg._TTH.
Verkrijg en beveilig Amazon Customer Profile Gegevens
Zodra de gebruiker interactie heeft gehad met de Login met Amazon-service om te authenticeren (en, bij het eerste bezoek, het delen van gegevens autoriseert), ontvangt u een authenticatiereactie.
Als u een authenticatiereactie ontvangt, moet u:
- Verzend het toegangstoken in uw autorisatiereactie naar uw server via HTTPS.
- Bel vanaf de server de profile eindpunt met behulp van het toegangstoken. Zie de sectie met de titel Toegangstokens gebruiken om een klantpro te lezenfile van de login met Amazon website-ontwikkelaar-gids._TTH [PDF] voor details over het bellen met de profile endpoint server-side, inclusief code samples in meerdere talen. Inloggen met Amazon levert een klant pro . opfile antwoord met waarden (zoals user_id, e-mail, naam en/of postcode) die u op uw server kunt bewaren. Het nemen van deze stap zorgt ervoor dat de profile gegevens die u op uw server opslaat, behoren toe aan de klant die is aangemeld bij uw client.
- Zoeken naar 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.
- Zoeken naar 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.
- Creëer cookies in de browser van de gebruiker of leg ze anderszins vast als geauthenticeerd met uw site of app.
Zoek of maak een lokaal account
De gebruiker profile response bevat altijd een parameter met de naam user_id. De waarde van deze parameter is een tekenreeks die permanent en op unieke wijze het Amazon-account identificeert waarop de gebruiker zich heeft aangemeld. Amazon retourneert altijd dezelfde identifier voor elke gebruiker.
U moet in uw gebruikersdatabase zoeken om te zien of dit Amazon-account zich eerder heeft aangemeld bij uw site of app. Als je het Amazon-account nog niet eerder hebt gezien, moet je een nieuw item in je lokale accountdatabase maken en dit koppelen aan de Amazon-account-ID voor de volgende keer dat ze inloggen. Als het Amazon-account niet overeenkomt met een bestaand lokaal account, vraag de gebruiker om hun lokale wachtwoord om de twee accounts te koppelen.
Het authenticatieantwoord kan aanvullende gebruikersgegevens bevatten, bijvample, de gebruikersnaam en het e-mailadres. U kunt deze informatie naar uw lokale accountdatabase kopiëren wanneer u nieuwe accounts aanmaakt of bestaande accounts bijwerkt (bijvample, kan de gebruiker zijn e-mailadres op Amazon hebben gewijzigd sinds de laatste keer dat hij zich aanmeldde).
Als u aanvullende informatie van de gebruiker moet verzamelen voordat u een account aanmaakt, dan wilt u hier een registratiepagina weergeven. U kunt het vooraf invullen met de informatie die u in het authenticatierespons hebt ontvangen, of u kunt alleen de extra velden weergeven die u nodig heeft.
Opmerking: Als je webhet lokale accountbeheer van de site of app omvat het opnieuw instellen van wachtwoorden, wilt u er misschien voor zorgen dat Login met Amazon-gebruikers niet in de war raken over hoe dat van invloed is op hun Amazon-account. Dat kan betekenen dat een link "Wachtwoord opnieuw instellen" wordt verborgen als gebruikers zijn ingelogd via Inloggen met Amazon, of een notitie op de pagina voor het opnieuw instellen van het wachtwoord die hen doorverwijst naar https://www.amazon.com als ze hun wachtwoord willen wijzigen.
Markeer de gebruiker als geverifieerd
Zodra u een geldig authenticatiereactie heeft ontvangen en een overeenkomstig account in uw eigen accountdatabase hebt gevonden of aangemaakt, moet u markeren dat de gebruiker zich heeft geauthenticeerd. Deze stap kan precies hetzelfde werken als in uw huidige authenticatiesysteem.
Inloggen met Amazon Integreer met uw bestaande accountsysteem - Download [geoptimaliseerd]
Inloggen met Amazon Integreer met uw bestaande accountsysteem - Download
