Вход с Amazon: Интегрирайте се със съществуващата си система за акаунти
Авторско право © 2017 Amazon.com, Inc., или неговите филиали. Всички права запазени.
Amazon и логото на Amazon са търговски марки на Amazon.com, Inc. или нейните филиали. Всички други търговски марки, които не са собственост на Amazon, са собственост на съответните им собственици.
Въведение
Това е ръководство за интегриране на client profile данни от вход с потребителски акаунти на Amazon с webсайт или мобилно приложение, което вече има система за управление на акаунт.
Ще научите как можете да активирате вашия сайт или приложение, за да позволите на потребителите да влизат в профила си в Amazon, както и как можете да разрешите на съществуващите потребители на вашия webсайт прикрепят своята самоличност на Amazon, така че да влизат с идентификационните си данни за Amazon.
Какво трябва да имате
Това ръководство предполага, че преди това сте се регистрирали за вход с Amazon, регистрирали сте своя webсайт или мобилно приложение като вход с приложение Amazon и имат подходящи SDK или сървърни методи за комуникация с услугата за вход с Amazon.
Това ръководство също така приема, че вашият сайт или приложение в момента има следните функции:
- База данни на акаунти, в която записвате информация за всеки потребителски акаунт:
а. Потребителите имат някакъв уникален идентификатор
б. Понастоящем потребителите влизат, използвайки потребителското си име / парола - Страница за вход за регистрирани потребители.
- Страница за регистрация за регистриране на нови потребители, като вземете profile информация (име, имейл и др.).
- Някои механизми за управление на състоянието на удостоверяване, след като потребителят успешно влезе, така че следващата страница да знае, че потребителят в момента е влязъл (напр.ample, съхраняване на тази информация в бисквитки или в базисна база данни).
Какво трябва да направите
Това са промените на високо ниво, които трябва да направите, за да интегрирате клиентите на Amazon в системата за управление на вашия акаунт:
- Промени в базата данни: Ще трябва да съпоставите идентификаторите на клиентите на Amazon със собствените си вътрешни идентификатори. Това може да бъде под формата на допълнително поле в таблицата за потребители във вашата база данни.
- Промени в потребителския интерфейс за влизане: Трябва да промените страницата си за вход, страница за регистрация и страница за плащане (ако е приложимо). Страницата ви за вход ще трябва да има опция за потребителите да изберат бутона „Вход с Amazon“, за да се удостоверят, използвайки своите идентификационни данни на Amazon. Стъпките за изпълнение на това са описани в Влезте с насоки за стил на Amazon.
- Създайте манипулатор на отговори: Това е нова страница на вашия сайт или функция във вашето приложение за обработка на отговорите за удостоверяване от Amazon.
Направете промени в базата данни
Ще трябва да промените базата данни на акаунта си, за да запишете съпоставяне между идентификаторите на акаунта на Amazon и вашите локални акаунти. Това може да бъде под формата на ново поле в таблицата на вашия акаунт или таблица, която съответства между идентификаторите на акаунта на Amazon и идентификаторите на вашия локален акаунт.
Идентификаторите на акаунта в Amazon се връщат като свойство user_ID под формата amzn1.accountVALUE.
Напримерample: amzn1.account.K2LI23KL2LK2.
Настройте Login с Amazon
Използвайки съответните SDK или сървърни методи за вашия webсайт или приложение, предоставете на потребителя метод да влезе с идентификационните си данни за Amazon. Това включва извършване на промени в потребителския интерфейс на страниците ви за вход и регистрация. Страницата ви за вход ще трябва да има опция за потребителите да изберат бутона „Вход с Amazon“, за да удостоверят автентичността си, използвайки своите идентификационни данни за Amazon. За повече подробности как да удостоверявате потребителите, използвайки Login с Amazon, моля, вижте нашите ръководства за програмисти за iOS, android-gsg._TTH [PDF] и webсайт-gsg._TTH.
Вземете и защитете Amazon Customer Profile данни
След като потребителят взаимодейства с услугата Login with Amazon за удостоверяване (и при първото посещение, разрешаване на споделянето на данни), ще получите отговор за удостоверяване.
Когато получите отговор за удостоверяване, трябва:
- Изпратете маркера за достъп във вашия отговор на упълномощаване до вашия сървър, използвайки HTTPS.
- От страна на сървъра се обадете на професионалистаfile крайна точка, използваща маркера за достъп. Вижте раздела, озаглавен Използване на жетони за достъп за четене на клиентски професионалистfile на Login с Amazon webсайт-разработчик-ръководство._TTH [PDF] за подробности относно обаждането на професионалистаfile от страна на сървъра на крайна точка, включително код sampна няколко езика. Влизането с Amazon ще върне клиентски професионалистfile отговор със стойности (като потребителски идентификатор, имейл, име и/или пощенски код), които можете да запазите на вашия сървър. Предприемането на тази стъпка ще гарантира професионалистаfile данните, които запазвате на вашия сървър, принадлежат на клиента, който е влязъл в него.
- Търсене на 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.
- Търсене на 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.
- Създавайте бисквитки в браузъра на потребителя или ги записвайте по друг начин като удостоверени с вашия сайт или приложение.
Намерете или създайте локален акаунт
Потребителят profile отговорът винаги ще съдържа параметър с име user_id. Стойността на този параметър е низ, който трайно и уникално идентифицира акаунта на Amazon, в който потребителят е влязъл. Amazon винаги ще връща един и същ идентификатор за всеки потребител.
Трябва да претърсите вашата потребителска база данни, за да видите дали този акаунт на Amazon вече е влизал във вашия сайт или приложение. Ако не сте виждали акаунта на Amazon преди, ще трябва да създадете нов запис в базата данни на вашия локален акаунт и да го свържете с идентификатора на акаунта на Amazon за следващия път, когато влязат. Ако акаунтът в Amazon не съответства на съществуващ локален акаунт, подканете потребителя за неговата локална парола, за да свърже двата акаунта.
Отговорът за удостоверяване може да съдържа допълнителни потребителски данни, напрample, името на потребителя и имейл адреса. Можете да копирате тази информация в базата данни на вашия локален акаунт, когато създавате нови акаунти или да актуализирате съществуващи акаунти (напрampПотребителят може да е променил своя имейл адрес в Amazon от последния път, когато е влизал).
Ако трябва да съберете допълнителна информация от потребителя, преди да създадете акаунт, тогава тук ще искате да покажете страница за регистрация. Можете да го попълните предварително с информацията, която сте получили в отговора за удостоверяване, или можете да покажете само допълнителните полета, които ви трябват.
Забележка: Ако вашият webлокалното управление на акаунта на сайта или приложението включва нулиране на пароли, може да искате да се уверите, че влизането с потребителите на Amazon няма да се обърка относно това как това се отразява на техния акаунт в Amazon. Това може да означава скриване на връзка „Нулиране на парола“, ако потребителите са влезли чрез Вход с Amazon, или бележка на страницата за нулиране на паролата, която ги насочва към https://www.amazon.com ако искат да сменят паролата си.
Маркирайте Потребителя като Удостоверен
След като получите валиден отговор за удостоверяване и намерите или създадете съответния акаунт в собствената си база данни, трябва да отбележите, че потребителят е удостоверил. Тази стъпка може да работи точно по същия начин, както в текущата ви система за удостоверяване.
Влезте с Amazon Интегрирайте се със съществуващата си система за акаунти - Изтегляне [оптимизирано]
Влезте с Amazon Интегрирайте се със съществуващата си система за акаунти - Изтегляне