Пријавете се со Водичот за програмери на Амазон за Webсајтови
Најавете се со Амазон: Водич за програмери за Webсајтови
Авторски права © 2017 Amazon Services, LLC или нејзините филијали. Сите права се задржани.
Амазон и логото на Амазон се трговски марки на Amazon.com, Inc. или нејзините филијали. Сите други трговски марки кои не се во сопственост на Амазон се сопственост на нивните сопственици
Добредојдовте
Ова е водич за програмери за најавување со Amazon Webсајтови. Овој водич содржи концептуални информации за најавувањето со Амазон web услуга, како и информации за тоа како да се користи Логирање со Амазон во вашиот webсајт.
Пријавувањето со Амазон е web услуга која им овозможува на клиентите на Амазон да се најават на вашиот webстраница или мобилна апликација користејќи ги нивните ингеренциите на Амазон. Откако ќе се логираат, вашата апликација може да пристапи до некои информации од нивниот Амазон проfile.
Како можам…?
Погледнете ја следнава табела за врски до информации за тоа како да работите со Пријави се со Амазон.
| Како можам… | Релевантни Ресурси |
| Дознајте повеќе за деловниот случај за најавување со Амазон | Разбирање на најавување со Амазон |
| Дознајте како работи најавувањето со Амазон | Пријавете се со Амазон концептуално надview |
| Започнете со најавување со Амазон | Најавете се со Амазон за почеток Водич за Webсајтови |
| Одлучете дали Пријавувањето со Амазон е вистинскиот избор за мојата апликација | Користење најава со Амазон |
| Добијте ги ЧПП | Најавете се со најчесто поставувани прашања во Амазон |
| Добијте помош од заедницата на програмери | Најавете се со форуми за дискусии во Амазон |
Разбирање на најавување со Амазон
Теми
- Пријавете се со Амазон концептуално надview
- Пристапен токен
- Код за авторизација
- Освежи токен
- Customer Profile
- Грантови за овластување
- Апликација за клиент
- Идентификатор на клиент
Најавувањето со Амазон им овозможува на клиентите на Амазон да ја користат нивната доверлива сметка на Амазон за да се најават webсајтови и мобилни апликации.
Овој дел покажува како Најавувањето со Амазон користи токени за пристап за да дозволи webсајтови за најавување клиенти и пристап до нивните професионални клиентиfiles
Пријавете се со Амазон концептуално надview
Концептуалното завршеноview опишува како Логирањето со Амазон му дозволува на корисникот да се најави и да го одобри вашето webсајт или пристап до нивниот клиент проfile податоци. За повеќе детали за искуството на клиентите во домашните мобилни апликации, вклучително и како вашите клиенти можат да го прескокнат екранот за најавување и да искусат еднократно најавување, погледнете ја нашата Искуство на клиентите Во текот наview за апликации за Android/Fire, и нашите Искуството на клиентите завршиview за апликации за iOS.
Процесот на најавување со Амазон започнува кога корисникот ќе го посети вашиот webстраница или апликација (А). Тие кликнуваат на копчето Најави се со Амазон (Б) и се пренасочуваат на екранот за најавување. Амазон обезбедува страници (C) каде што корисникот се најавува, а потоа се согласува да ги дозволи вашите webпристап на страницата до нивниот проfile податоци. Ако веќе се согласиле, ќе треба само да се најават. Амазон потоа го пренасочува корисникот од екранот за најавување на вашиот webсајт или апликација (D). Вашиот webстраницата или апликацијата користи безбедносни акредитиви обезбедени од Логин со Амазон за да пристапи до профи клиентотfile (Д) (вклучувајќи име и адреса на е-пошта).
Ако апликацијата за најавување со Амазон сака да идентификува корисник без да пристапи до неговото име и адреса на е-пошта, тој нема да бара проfile податоци. Во овој случај, на корисникот не му се прикажува екран за согласност откако ќе се најави.
Слика 1: Најавете се со проток на корисници на Амазон
Пријавувањето со Амазон функционира со обезбедување на трета страна webсајтови и мобилни апликации (клиенти) со препознатливо копче за најавување на кое корисниците кликнуваат за да се пријават со нивните акредитации на Amazon. За да се најават, корисниците се упатени на amazon.com и се бара да ја дадат својата лозинка за Амазон. За прampле:
Слика 2: Најавете се со екранот за најавување на Амазон
Ако ова е прв пат корисниците да се логираат од ова webсајт или апликација, Амазон им презентира листа на дозволи што ги бара клиентот. Клиентите можат да ги побараат името и адресата на е-пошта на корисникот и/или да побараат поштенски (ZIP) код на корисникот. За прampле:
Слика 3: Најавете се со екранот за согласност на Амазон
Откако корисниците ќе се најават, клиентот ќе користи едно од грантови за овластување да се добие токен за пристап. Клиентот потоа може да го користи токенот за пристап за пристап до a клиент проfile, специфицирање на обемот на пристап.
Single Sign-On (SSO) за Web
Екранот за најавување за најавување со клиентот на Амазон webсајтовите имаат поле за избор „Задржи ме најавен“. Кога корисникот ќе го штиклира ова поле, најавете се со Амазон ќе ги запомни ингеренциите што корисникот ги доставил како најава (до 14 дена). Кога ќе посетат друга Најава со Амазон webсајт во истиот прелистувач и изберете да се најавите, тие ќе добијат екран за согласност или екран за потврда наместо екран за најавување.
Ако на webстраницата бара проfile податоци за кои е потребна согласност, откако корисникот ќе кликне на копчето Најави се со Амазон, тие се пренасочуваат на екранот за согласност барајќи дозвола за споделување на нивните податоци. Кога корисникот ќе кликне Добро, тие се пренасочуваат назад кон клиентот Најава со Амазон webсајт.
Ако на webстраницата не бара согласност, или корисникот веќе се согласил, му се прикажува екран за потврда откако ќе кликнете на копчето Најави се со Амазон. Екранот за потврда ја покажува адресата на е-пошта што ја запомнува Логин со Амазон и бара од нив да потврдат дека сакаат да се најават со таа сметка. Кога ќе кликнат Продолжи, тие се пренасочуваат на Логин со Амазон webсајт.
Екранот за потврда, исто така, му дава можност на корисникот да се одјави од својата тековна сметка и повторно да се најави со различни ингеренции. Ако корисникот внесе нова сметка и повторно го провери полето за избор „Задржи ме најавен“, следниот пат кога ќе види екран за потврда, ќе ја прикаже новата сметка. Ова не го менува нивното најавување на претходното webсајтови до webстраницата се обидува повторно да го овласти корисникот.
Ако корисникот се одјави од a webсајт, тоа не ги одјавува од други најави се со Amazon webсајтови. Функцијата за единечно најавување е споделена помеѓу Најавете се со трета страна на Amazon webсајтови и сајтот за малопродажба на Amazon.com. Amazon.cn, Amazon.co.jp и локациите специфични за земјата во Европската унија имаат поле за избор „Задржи ме најавен“, но не учествуваат во едно најавување.
Единствено најавување (ДЗС) за мобилни телефони
Пријави се со Амазон спроведе поддршка за единствено најавување на мобилни уреди Kindle Fire, iOS и Android.
Под единечно најавување, кога корисникот се најавува во апликација со бренд Амазон од уред со iOS или Android, таа најава автоматски се памети. Ако корисникот отвори друга апликација Амазон или се најавува со мобилна апликација Амазон, апликацијата автоматски ќе ги најавува со истата сметка, без да бара од нив да внесат ингеренции за најава. На Kindle, Пријави се со Амазон автоматски ја користи сметката регистрирана на уредот.
Кога е вклучена одликата со единечен знак на уредот, најавувањето со апликациите на Амазон со веќе најавена сметка ќе ја користи таа сметка сè додека корисникот не се одјави. За повеќе детали, видете ја нашата Клиент Искуство надview за апликации за Android/Fire, и нашите Искуството на клиентите завршиview за апликации за iOS.
Пристапен токен
Откако корисниците ќе се логираат, тие се враќаат кај вас webстраница или мобилна апликација. Во овој момент, вашиот клиент може да добие токен за пристап со повикување на услугата за овластување Логирање со Амазон. Овој токен им овозможува на клиентите пристап до името на клиентот и адресата на е-пошта од нивните клиент проfile.
Кога ќе добиете токен за пристап, може да добиете и токен за освежување. Токенот за освежување важи подолго од токенот за пристап и ви овозможува да тргувате со токенот за освежување за нов знак за пристап и нов токен за освежување.
За да пристапите до податоците на клиентите, мора да обезбедите токен за пристап до услугата за овластување Логирај се со Амазон. Токенот за пристап е алфанумерички код во должина од 350 знаци или повеќе, со максимална големина од 2048 бајти.
Пристапните токени започнуваат со ликовите Atza|. Токените за пристап важат само шеесет минути и се специфични за корисникот што се најавува и податоците што апликацијата ги барала кога го активирала најавувањето. Кога ќе примите токен за пристап, тој е како структура во JSON формат со три информации: access_token, token_type и expires_in (бројот на секунди пред истекот на токенот). Овие токени за пристап се токени носители, така што token_type секогаш е носител. За прampле:
| { „Пристап_стоен“: „Atza | IQEBLjAsAhRmHjNgHpi0U-Dme37rR6CuUpSR…“, „Тип на знак“: „носител“, „Expires_in“: 3600, „Refresh_token“: „AtzrIIQEBLzAtAhRPpMJxdwVz2Nn6f2y-tpJX2DeX“ } |
Токените за пристап се враќаат и во имплицитните и во кодегрантите за авторизација.
Токенот за пристап е носител на токен и како таков може да го користи друг клиент. Погледнете Рамка за овластување OAuth 2.0: Употреба на токени на носители за повеќе информации.
Освежи токен
Токен за освежување дозволува a webстраницата да побара нов токен за пристап, дури и ако токенот за пристап е истечен. Токените за освежување го следат истиот формат како токени за пристап, освен што почнуваат со низата Atzr|. Токените за освежување важат неодредено време, освен ако корисникот не го отстранил webстраница или мобилна апликација од списокот на дозволени апликации за нивната сметка. Токените за освежување имаат максимална големина од 2048 бајти. Токен за освежување е специјално доделен на еден клиент и не може да се користи од друг клиент.
Освежувачките токени се враќаат само во Грант за код за овластување.
Customer Profile
Клиент проfile ги содржи податоците до кои може да пристапат апликациите за најавување со Амазон во врска со одреден клиент. Ова вклучува: уникатен ID за корисникот; името на корисникот, адресата на е-пошта на корисникот и неговиот поштенски код. Овие податоци се поделени во три опфати: проfile, проfile: user_id и поштенски код.
Кога барате токен за пристап, можете да побарате повеќе опсези за пристап со одвојување со празно место (на пр.) проfile поштенски_код) Кога вашето барање ќе биде одобрено, тоа ќе ги специфицира вратените обеми.
проfile
На проfile опсегот вклучува име на корисник и адреса на е-пошта. Со пристап до професионалецот на клиентотfile, можете уникатно да ги идентификувате кога се најавуваат и можете да комуницирате со нив преку е-пошта. Професионалецотfile податоците се враќаат во JSON формат и се состојат од три дела: на user_id, е-поштата и име.
На user_id е доделен од Амазон и единствено ја идентификува сметката на корисникот. Е-поштата е адресата за е-пошта што тие ја имаат регистрирано во Амазон. Амазон не ја потврдува оваа адреса за е-пошта.
| { „е-пошта“ : „johndoe@gmail.com“, „Име“: „Doон До“, „User_id“: „amznl.account.K2LI23KL2LK2“ } |
Кога а webстраницата или апликацијата бара пристап до проfile опсегот, на корисникот ќе му биде презентиран екран за согласност за прв пат кога се најавува. Екранот за согласност ги прикажува бараните информации и нивните тековни вредности. Корисникот мора да даде согласност да ги сподели овие информации за да може да се заврши најавувањето. Штом корисникот се согласи, таа согласност е заведена и идните обиди за најавување со истиот обем нема да презентираат екран за согласност.
проfile: user_id
Вториот опсег за пристап е проfile:user_id. проfile: user_id го вклучува само полето user_id на проfile. Ова уникатно го идентификува корисникот, но не го дава неговото име, адреса на е-пошта или поштенски код. Бидејќи не се бараат лични податоци, на корисникот нема да му биде претставен екран за согласност при првиот пат кога ќе се најави.
Секоја компанија што создава webсајтовите или апликациите за најавување со Амазон го добиваат истото user_id за клиент. Меѓутоа, кога клиентот се најавува на апликација или страница на друга компанија, тогаш user_id ќе бидат различни. Ова е така user_id не може да се користи за следење на клиентите низ Web.
поштенски_код
Третиот опсег за пристап е поштенски_код опсегот. Ова го вклучува поштенскиот/поштенскиот број на корисникот од неговата примарна адреса за испорака. Поштенскиот код обезбедува вредни податоци за локацијата што ви овозможуваат да ги подесите вашите понуди и подобро да ги разберете вашите клиенти. За прampле:
| { „User_id“: „amznl.account.K2LI23KL2LK2“ „е-пошта“ : „johndoe@gmail.com“, „Име“: „Doон До“, „Поштенски код“: „98л0л“, } |
Кога апликација бара пристап до поштенски_код опсег, сам или во договор со проfile or проfile: user_id опсегот, корисникот ќе мора да даде согласност за споделување на информациите.
Услугата за авторизација на најавување со Амазон нуди два грантови за овластување што ги имате webстраницата или мобилната апликација може да се користи за автентикација на корисниците и пристап до нивните професионални клиентиfile. Овие два грантови се Имплицитен грант и на Грант за код за овластување.
Следните описи на грантови се однесуваат на HTTP барања и одговори. Мобилните SDK ги завиткуваат овие повици во нивните сопствени методи и повратни повици; сепак, целокупниот проток е ист.
Имплицитен грант
Во имплицитниот грант, корисникот кликнува на врска (или притиска копче) (A) што го упатува на страницата за најавување на Amazon. Откако ќе се најават, од нив се бара да ѝ дадат пристап на апликацијата до одреден професионалецfile податоци (Б) и се пренасочуваат назад кон апликацијата. Ако на корисникот му е одобрен пристап, токен за пристап се вградува директно во URI за пренасочување како URI фрагмент (C). (Ова е имплицитна грант). Фрагментите на URI, вклучувајќи го и токен за пристап, се лишени од URI за пренасочување од корисничкиот агент (на web прелистувач) и корисничкиот агент го извршува URI (D). (Во овој момент, корисникот гледа дека е логиран на клиентот и продолжува да ја користи апликацијата нормално.) Клиентот webстраницата го враќа токенот за пристап со користење на скриптирање базирано на прелистувач (на пр. JavaScript) за да побара од корисничкиот агент за фрагментите (E). Таа скрипта потоа може да го испрати токенот за пристап до клиентот (F), или да го користи токенот за пристап директно за да го врати клиент проfile податоци од Амазон (Г).
Во Грантот за код за овластување, корисникот кликнува на врска (или притиска копче) (A) што го упатува на страницата за најавување на Amazon. Откако ќе се најават, од нив се бара да ѝ дадат пристап на апликацијата до одреден професионалецfile податоци (Б) и се пренасочуваат назад кон апликацијата. Ан код за авторизација е вграден директно во URI за пренасочување како параметар за пребарување (C) (ова е доделување код за овластување). Корисникот-агент извршува URI, вклучувајќи ги и параметрите за пребарување (во овој момент, корисникот гледа дека се најавени на апликацијата и продолжува нормално). Параметрите за пребарување се обработуваат директно од апликацијата, а апликацијата го користи кодот за овластување за да побара токен за пристап директно од службата за овластување (Г). Кодот за овластување мора да биде спарен со a идентификатор на клиент и тајна на клиентот, позната само на апликацијата. Ова спречува малициозен софтвер да го пресретнува кодот за овластување и да се имитира како стр.
Откако ќе се потврдат кодот за овластување, идентификаторот на клиентот и тајната на клиентот, на апликацијата и се доделува знак за пристап и a освежи токен од службата за овластување (Е). Тие можат да го користат знакот за пристап за пристап до клиент проfile податоци од Амазон. Кога ќе истече токенот за пристап, тие можат да го користат токенот за освежување за да добијат нов знак за пристап и нов токен за освежување.
Апликација за клиент
Пред да можете да користите Најавување со Амазон на a webсајт или во мобилна апликација, мора да регистрирате апликација со Најавете се со Амазон. Вашата апликација за најавување со Амазон е регистрација што содржи основни информации за вашиот бизнис и информации за секој од нив webстраница или мобилна апликација што ја креирате што поддржува најавување со Amazon. Овие деловни информации им се прикажуваат на корисниците секој пат кога тие користат најавување со Амазон на вашиот webстраница или мобилна апликација. Корисниците ќе го видат името на вашата апликација, вашето лого и врска до вашата политика за приватност. За да креирате апликација, клиентите мора да го обезбедат следново:
- Име. Ова име ќе се прикаже на екранот за согласност кога од корисникот ќе биде побарано да го даде вашето име webдозвола на страницата или мобилната апликација за пристап до нивниот професионалецfile Исто така, се појавува на списокот со активно најавување со клиенти на Амазон во делот Твојата сметка за корисници на Амазон.
- Опис. Описот ви помага да ја разликувате секоја најава со апликациите на Амазон и не им се прикажува на корисниците.
- Известување за приватност URL. Известување за приватност URL е локацијата на политиката за приватност на вашата компанија или апликација (на прample: http://www.example.com/privacy.html). Оваа врска им се прикажува на корисниците на согласноста
Клиентите исто така можат да го обезбедат следново:
- Слика на логото File. Ова лого се прикажува на екранот за најавување и согласност кога корисниците се најавуваат на вашиот webстраница или мобилна апликација. Логото ќе се намали на 50 пиксели во висина ако е повисоко од 50 пиксели; нема ограничување на ширината на Следниве формати се прифатени: PNG, JPEG и GIF.
Откако ќе креирате апликација, можете да ја регистрирате секоја од нив webстраница или мобилна апликација што ќе користи најавување со Амазон.
За повеќе информации, вклучително и регистрација за поединец webсајтови, види Регистрирајте се за најавување со Amazon Апликација.
Идентификатор на клиент
Кога клиентите создаваат а webстраница или мобилна апликација, им се доделува a идентификатор на клиент и а таен клиент. Идентификаторите на клиентите и тајните на клиентите се доделуваат во парови. Апликацијата може да има повеќе идентификатори на клиенти.
Идентификаторот на клиентот се користи за идентификување на вашата апликација, или сам или заедно со тајната на клиентот. И двата гранта за овластување го користат идентификаторот на клиентот, но Грант за код за овластување ја бара и тајната на клиентот.
Идентификаторот на клиентот има максимална големина од 100 бајти. Тајната на клиентот има максимална големина од 64 бајти.
Користење најава со Амазон
Теми
- Регистрирај се со Пријави се со Амазон
- Поставете го вашиот Webсајт
- Изберете овластување Грант
- Имплицитниот грант
- Грант за код за овластување
- Користете Tokетони за пристап за да прочитате a Customer Profile
- Одјавете се од корисниците
Најавувањето со Амазон им овозможува на клиентите на Амазон да ја користат нивната доверлива сметка на Амазон за да се најават webсајтови и мобилни апликации.
Овој дел дискутира за тоа како да користите најавување со Амазон, од создавање на вашата апликација до поставување на вашата webлокација, избор на грант за авторизација и спроведување на тој грант. Откако ќе се имплементира протоколот, корисниците можат да се најават на вашата страница користејќи се најавите со Amazon и да ви дадат пристап до нивните професионални клиентиfile податоци.
Регистрирајте се со најавување со Амазон
Пред да можете да користите Најавување со Амазон на a webсајт или во мобилна апликација, мора да регистрирате апликација со Најавете се со Амазон. Вашата апликација за најавување со Амазон содржи информации за вашиот бизнис и информации за секој од нив webстраница или мобилна апликација што ја креирате што поддржува најавување со Amazon. Деловните информации им се прикажуваат на корисниците секој пат кога тие користат најавување со Амазон на вашиот webстраница или мобилна апликација. Корисниците ќе го видат името на вашата апликација, вашето лого и врска до вашата политика за приватност. Овие чекори покажуваат како да регистрирате најавување со апликацијата Амазон:
Регистрирајте се за најавување со апликацијата Амазон
- Одете на https://login.amazon.com.
- Ако претходно сте се пријавиле за најавување со Амазон, кликнете Конзола за апликации. Во спротивно, кликнете Пријавете се. Е бидете пренасочени кон продавачот Централ, кој се справува со регистрација на апликации за најавување со Амазон. Ако ова е прв пат да го користите Seller Central, од вас ќе биде побарано да поставите Sales Central
- Кликнете Регистрирајте нова апликација. На Регистрирајте ја вашата апликација формата ќе се појави:
a. Во формуларот Регистрирај ја својата апликација, внесете име и опис за вашата апликација.
Името е името што се прикажува на екранот за согласност кога корисниците се согласуваат да споделат информации со вашата апликација. Ова име се однесува на Android, iOS и webверзии на страницата на вашата апликација. Описот ви помага да го разликувате секое ваше најавување со апликациите на Амазон и не се прикажува на корисниците.
b. Внесете приватност URL за вашата апликација сега.
Известување за приватност URL е локацијата на политиката за приватност на вашата компанија или апликација (на прampле:
http://www.example.com/privacy.html). This link is displayed to users on the consent screen.
c. Ако сакате да додадете слика на логото за вашата апликација, кликнете Избери File и лоцирајте ја применливата слика.
Ова лого се прикажува на екранот за најавување и согласност кога корисниците се најавуваат на вашиот webстраница или мобилна апликација. Логото ќе се намали на 50 пиксели во висина ако е повисоко од 50 пиксели; нема ограничување на ширината на логото. Следниве формати се прифатени: PNG, JPEG, GIF. - Кликнете Зачувај. Твојот сampрегистрацијата треба да изгледа слично на ова:
Откако ќе се зачуваат основните поставки на вашата апликација, можете да додадете поставки за одредени webсајтови и мобилни апликации што ќе го користат ова Пријавување со сметка на Амазон.
Додадете Web Поставки на вашата апликација
- Од екранот со апликација, кликнете Web Поставки. Автоматски ќе ви бидат доделени вредности за ID на клиент и Тајната на клиентот. ИД на клиентот го идентификува вашиот webсајт, а клиентската тајна се користи во некои околности за да се потврди вашата webстраницата е автентична. Тајната на клиентот, како лозинка, е доверлива. До view клиентската тајна, кликнете Покажи тајна.
- За да додадете Дозволено потекло од JavaScript or Дозволено враќање URLs на вашата апликација, кликнете Уреди.
Забелешка: За да користите најава со Амазон со а webсајт, мора да наведете или Дозволено потекло од JavaScript or Дозволено враќање URLs. Наведете Дозволено потекло од JavaScript за да обезбедите скокачко искуство за автентикација на вашите корисници, или Дозволено враќање URLs да обезбеди искуство за пренасочување на автентикација. Ако користите Amazon Pay, мора да наведете Дозволено потекло од JavaScript.
a. Ако обезбедувате искуство за автентикација на скокачки прозорец за вашите корисници, додајте го вашиот webпотекло на страницата до
Дозволени JavaScriptOrigins.
Потеклото е комбинација на протокол, име на домен и порта (на прample: https://www.example.com:8443). Дозволеното потекло мора да го користи протоколот HTTPS. Ако користите стандардна порта (порта 80 или порта 443), треба само да го вклучите доменот (на прample: https://www.exampле.com).
Додавањето на вашиот домен овде овозможува SDK за JavaScript да комуницира со вашиот webсајт директно за време на процесот на најавување. Web прелистувачите нормално ја блокираат комуникацијата со вкрстено потекло помеѓу скриптите, освен ако скриптата тоа посебно не го дозволува.
За да додадете повеќе од едно потекло, кликнете Додадете друг.
b. Доколку вашиот webстраницата ќе прави HTTPS повици до услугата за овластување за најавување со Амазон и
специфицирање на a redirect_uri за одговори, додадете ги пренасочувачките УРИ на Дозволено враќање URLs.
Враќањето URL ги вклучува протоколот, доменот, патеката и низата (и) за пребарување (на прample, https://www.example.com/login.php).
Да додадете повеќе од едно враќање URL, кликнете Додадете друг. Ако сакате динамички да ги пренасочите корисниците на различни URLs по автентикацијата (на прample: ако сакате да го пренасочите секој корисник назад на страницата на која бил пред да се најавите) нема да треба да ги наведете сите овде. Наместо тоа, првично пренасочете ги сите корисници на една статика URL (Дозволеното враќање URL) Во вашето барање за овластување, доделете му на државата параметар динамична вредност и користете ја таа вредност за да создадете второ пренасочување кон посакуваното URL. За повеќе информации, видете Динамички пренасочување на корисниците.
Забелешка: Пренасочувањето на корисниците на нова страница за автентикација ги остава ранливи на фалсификување на барање меѓу страници. За да ја обезбедите вашата апликација, силно препорачуваме да го користите државниот параметар за да го потврдите секој одговор за овластување. За повеќе информации, видете Барање за фалсификат преку-страница. - Кликнете Зачувај.
Поставете го вашиот Webсајт
Има неколку чекори што треба да ги преземете пред да одите во живо со Најавете се со Амазон на вашиот webсајт. Ова вклучува вчитување на најавување со Amazon SDK за JavaScript, додавање најавување со графика на Amazon и интегрирање на нови клиенти на Amazon во базата на податоци на вашите сметки.
Вчитајте го најавувањето со Amazon SDK за JavaScript
Пријавете се со Амазон обезбедува JavaScript SDK што можете да го користите за да добиете токени за пристап и да добиете професионален клиентfileс. Пред да можете да остварите повик за доделување пристап или да добиете професионалецfile, SDK мора да се вчита од мрежата за испорака на содржина на Амазон. За да го вчитате SDK, користете го следниов код
прозорец.onAmazonLoginReady = функција () { amazon.Login.setClientId ('ВАШИ-КЛИЕНТ-ИД'); }; (функција (г) { var a = d.createElement ('скрипта'); a.type = 'текст / JavaScript'; a.async = точно; a.id = 'amazon-login-sdk'; a.src = 'https://assets.loginwithamazon.com/sdk/na/login1.j s '; d.getElementById ('amazon-root'). appendChild (а); }) (документ); |
Штом SDK се вчита, тој ќе се јави прозорец.на АмазонЛагинПодготвен за иницијализација. Пред да користите SDK, мора да се јавите amazon.Login.setClientId, донесување на вашиот идентификатор на клиент. Ако не го знаете идентификаторот на вашиот клиент, посетете ја Конзолата за апликации на atlogin.amazon.com.
Забелешка: Стандардно, SDK за JavaScript ќе го прикаже екранот за најавување во прозорецот што се појавува. Можете да го поставите скокачкото својство на параметарот опции на неточно за да ги пренасочите клиентите на нова страница за да се најават. Прозорците што се појавуваат не се поддржани во природните апликации за iOS. Ако имате намера да користите Најавете се со Амазон на вашиот iOS апликација, препорачуваме или да користите најава со SDK на Амазон за iOS или да спроведете искуство пренасочено за најавување. Погледнете го Влезот за најавување со Амазон SDK за JavaScript за информации за прилагодување на опции параметар.
Амазон-корен tag
Најавувањето со Amazon SDK за JavaScript бара елементот amazon-root да биде присутен на страницата. Елементот на коренот на amazon не смее да се крие со помош на екранот: ниту еден или видливоста: скриен, или некои делови од SDK нема да работат правилно во Internet Explorer.
SDK вметнува елементи во корен од амазон кои очекуваат да бидат позиционирани во однос на телото или во однос на елементот близу до горниот дел од страницата. Најдобро е ако корен од амазон елементот не е внатре во елемент со позиција: апсолутна или позиција: релативни поставки. Ако мора да ја поставите amazon корен-елемент внатре во позициониран елемент, треба да му дадете позиција близу до горниот дел од телото или некои делови од SDK може да не работат правилно.
Најавете се со Амазон обезбедува стандардна графика на копчиња за webсајтови и мобилни апликации. Видете го Најавете се со Упатствата за стилот на Амазон за да го видите изборот на достапни копчиња и како да ги користите. Изберете ги копчињата што ќе ги користите и додајте ги на вашите webстраница на која било страница што корисниците би сакале да се логираат.
Откако корисниците ќе се логираат, треба да додадете опција „Одјавување“ (често хиперврска) на вашиот webсајт. Опцијата за одјавување треба да ги избрише сите кеширани токени и да го отстрани профи на корисникотfile информации (како нивното име) од webсајт. Тогаш вашиот webстраницата може повторно да го прикаже копчето за најавување.
Интегрирајте се со вашиот постоечки систем на сметка
Доколку вашиот webстраницата содржи сопствен систем на корисничка сметка, можете да преземете чекори за интегрирање на Логин со клиентите на Амазон со вашата постоечка база на податоци. За повеќе информации, видете Интегрирајте се со вашиот постоечки систем на сметка.
Двата механизми webсајтови може да се користи за да се добие пристап токени се Имплицитен грант и на Код за авторизација Грант. Двата грантови за овластување работат со пренасочување на корисничкиот агент (прелистувачот на корисникот) на Amazon.com за тие да се најават. Откако ќе се логираат, ако webсајтот побара имплицитен грант токен за пристап е вграден како фрагмент во URI што го пренасочува корисничкиот агент назад кон клиентот webстраницата. На webстраницата потоа користи скрипта за да ги добие податоците од корисничкиот агент. Ако на webсајт барања а код за авторизација, корисничкиот агент е пренасочен назад кон webстраницата и кодот за авторизација се пренесува како низа за барање во тој URI. На webстраницата потоа прави безбеден HTTP повик до Амазон зад сцената за да го размени кодот за авторизација за токен за пристап.
Пред да спроведете апликација за најавување со Амазон, мора да изберете кој грант за овластување ќе го користите
Кој тип на грант е соодветен за вашата апликација?
Во принцип, адванотtagЕс од еден грант го отсликува недостатокотtagе од другиот грант.
Напредокотtagд од грантот за код за овластување е дека може да биде побезбеден од имплицитниот грант. Корисникот не е вклучен во барањето за токенот за пристап, бидејќи тоа се одвива директно помеѓу клиентот webстраницата и службата за овластување. Грантот за код за авторизација, исто така, содржи токени за освежување, што му дава на клиентот webсајт речиси неопределен пристап до профи на корисникотfile податоци.
Дизадванотtagд за грантот за код за авторизација е дека може да биде потешко да се имплементира и се потпира на скриптирање од страна на серверот. Грантот за код за овластување исто така користи повеќе кружни патувања отколку имплицитниот грант.
Напредокотtagд од имплицитниот грант е дека е релативно едноставен за спроведување, бидејќи се потпира на web прелистувач за примање и складирање на токенот за пристап. Ако архитектурата на клиентот не поддржува скриптирање од страна на серверот, ова е единствениот грант за овластување што ќе работи со услугата за овластување за најавување со Amazon. Имплицитниот грант исто така прави помалку кружни патувања од Грантот за код за овластување.
Дизадванотtagд од Имплицитниот грант е дека бидејќи корисничкиот прелистувач го прави барањето за токен за пристап, корисникот е изложен на токенот за пристап. Од строга безбедносна перспектива, може да се претпочита да се сокријат овие информации. Исто така, во имплицитниот грант, кога ќе истече токен за пристап, корисникот мора повторно да се автентицира за да продолжи да пристапува до ресурсите. Грантот за код за овластување содржи токени за освежување што може да се користат за да се добие нов токен за пристап без да се вклучи корисникот.
Ако не можете да користите скриптирање од страната на серверот, имплицитниот грант е вашиот единствен избор. Ако можете да користите скриптирање од страната на серверот, препорачуваме да изберете Грант за код за овластување.
Имплицитниот грант
Имплицитен грант му дозволува на клиентот (обично а webсајт) да го насочи корисничкиот агент (прелистувачот на корисникот) до URI во Amazon. Потоа, на корисникот му е претставена страница со која се бара да го одобри webсајт дозвола на нивните клиент проfile. Откако корисникот ќе го одобри барањето, корисничкиот агент се пренасочува назад кон webсајт со користење на a
URI што содржи ан токен за пристап во фрагментот URI. Корисничкиот агент се пренасочува кон клиентот користејќи URI за пренасочување без фрагментот на токен за пристап, но локално го складира фрагментот на токен за пристап. Корисничкиот агент потоа обработува скрипта на webстраница на страницата која пристапува до целосниот URI за пренасочување и ги пренесува информациите за фрагментот назад до клиентот. За повеќе информации, видете Имплицитен грант
За да побара овластување, клиентот (webсајт) мора да го пренасочи корисничкиот агент (прелистувачот) за да оствари безбеден HTTP повик до https://www.amazon.com/ap/oa со следните параметри:
| Параметар | Опис |
| клиент_ид | БАРАЕ. На идентификатор на клиент. Ова е обезбедено кога ќе го регистрирате вашиот webстраница како клиент за најавување со Амазон. Максимална големина од 100 бајти. |
| опсегот | ЗАДОЛЖИТЕЛНО. Обемот на барањето. Мора да биде проfile, проfile:user_id, поштенски_код или некоја комбинација, одделени со празни места (на пр. проfile%20 поштенски_код). За повеќе информации, видете Customer Profile. |
| тип на одговор | БАРАЕ. Вид на побаран одговор. Мора да биде симбол за ова сценарио. |
| redirect_uri | БАРАЕ. HTTPS адресата каде услугата за овластување треба да го пренасочи корисникот. |
| држава | ПРЕПОРАЧУВАНИ. Нетранспарентна вредност што ја користи клиентот за одржување на состојбата помеѓу ова барање и одговорот. На услуга за овластување ќе ја вклучи оваа вредност при пренасочување на корисникот назад кон клиентот. Исто така се користи за да се спречи фалсификување на барање меѓу страници. За повеќе информации, видете Барање за фалсификат преку-страница. |
За прampле:
| https://www.amazon.com/ap/oa?client_id=foodev &опсег=проfile &response_type=token &state=208257577ll0975l93l2l59l895857093449424 &redirect_uri=https://client.example.com/auth_popup/token |
За да направите барање за овластување со користење на Пријавување со Амазон SDK за JavaScript, мора да пополните објект со опции и да повикате amazon.Login.authorize.
document.getElementById ('LoginWithAmazon'). onclick = функција () {setTimeout (прозорец.doLogin, l); врати лажни; }; прозорец.doLogin = функција () {опции = {}; options.scope = 'проfile'; amazon.Login.authorize(опции, функција(одговор) { ако (одговор. грешка) { алармирање ('грешка во оаут' + одговор. грешка); враќање; } amazon.Login.retrieveProfile(response.access_token, function(response) { предупредување (одговор); }); }); }; |
Првиот параметар за amazon.Login.authorize е секогаш опциите објект. Вториот параметар е или функција JavaScript за управување со одговорот за овластување, или пренасочување на URI на друга страница. URI мора да припаѓа на истиот домен како и страницата што ја повикува SDK и таа мора да биде наведена со помош на HTTPS.
За прampле:
| опции = {}; options.scope ='проfile'; amazon.Login.authorize (опции, 'https://mysite.com/redirect_here'); |
Забелешка: Ако сакате да користите најава со Амазон SDK за JavaScript за да побарате имплицитен грант, прво мора да ја натерате вашата страница да го вчита најавувањето со Амазон SDK за JavaScript. Погледнете Вчитајте го најавувањето со Amazon SDK за JavaScript.
Откако корисникот ќе го одобри или одбие барањето, серверот за авторизација ќе го пренасочи корисникот на redirect_uri. Клиентот потоа ќе добие Одговор за овластување.
По клиентот (webсајт) го насочува корисничкиот агент (прелистувачот) да направи Барање за овластување, услугата за овластување ќе го пренасочи корисничкиот агент на URI назначен од клиентот. Ако корисникот го одобри барањето за пристап, тој URI ќе содржи access_token како URI фрагмент. За прampле:
| Пронајден HTTP / ll 302 Локација: https://client.example.com/cb#access_token=Atza| IQEBLjAsAhRmHjNgHpi0U-Dme37rR6CuUpSR… &state=208257577ll0975l93l2l59l895857093449424 & токен_тип = носител & истекува_во = 3600 &опсег=проfile |
Успешниот одговор ги вклучува следниве вредности:
| Параметар | Опис |
| пристап_токен | На токен за пристап за корисничката сметка. Максимална големина од 2048 бајти. |
| тип на знак | Видот на токенот е вратен. Треба да биде носител. |
| истекува_во | Бројот на секунди пред токенот за пристап станува невалиден. |
| држава | Државната вредност донесена во барањето за овластување. Оваа вредност ви овозможува да водите сметка за состојбата на корисникот пред барањето. Исто така се користи за да се спречи фалсификување на барање меѓу страници. За повеќе информации, видете Барање за фалсификат преку-страница. |
| опсегот | Обемот на барањето. Мора да биде проfile, проfile:user_id postal_code, или некоја комбинација. |
Забелешка: Некои кориснички агенти не поддржуваат вклучување на компонента на фрагмент во полето заглавие на одговорот на локацијата HTTP. Тие клиенти не се поддржани.
Ако користите Пријавување со Amazon SDK за JavaScript, горенаведените параметри се достапни во објектот за одговор обезбеден од amazon.Login.authorize. Погледнете Барање за овластување за поранешенampле.
Откако ќе добиете токен за пристап, следниот чекор е да го користите за да прочитате a клиент проfile. За повеќе детали, видете Користење токени за пристап за да прочитате клиент Проfile.
Ако корисникот не го одобри барањето за пристап или се појави грешка, услугата за овластување ќе го пренасочи корисничкиот агент (прелистувачот на корисникот) на URI назначен од клиентот. Тој URI ќе содржи параметри за грешка кои детално ја опишуваат грешката. За прampле:
| Пронајден HTTP / ll 302 Локација: https://client.example.com/cb#error=access_denied &state=208257577ll0975l93l2l59l895857093449424 |
Параметрите за грешка за неуспешно барање за овластување вклучуваат:
| Параметар на грешка | Опис |
| грешка | Код за грешка ASCII со вредност на кодот за грешка. |
| опис на грешка | Низа ASCII читлива за луѓе со информации за грешката; корисно за развивачите на клиенти. |
| грешка_ури | URI до a web страница со информации читливи од човек за грешката; корисни за
развивачи на клиенти. |
| држава | Државата клиент го донесе првичното барање за овластување. |
Ако користите најавување со Amazon SDK за JavaScript, горенаведените параметри се достапни во
одговор на објектот обезбеден од amazon.Пријавете се.овластете. Погледнете Барање за овластување за поранешенampле. Следниве шифри за грешка може да се вратат како вредност за грешка:
| Код за грешка | Опис |
| невалидно_барање | На барањето недостасува потребен параметар, има невалидна вредност или е на друг начин неправилно формиран. |
| неовластен_ клиент | Клиентот не е овластен да бара код за овластување. |
| одбиен пристап | Сопственикот на ресурсот или серверот за овластување го одбија ова барање. |
| тип на неподдржан_одговор | Во барањето беше наведен неподдржан тип на одговор. За ова сценарио,
типот на одговор мора да биде код. |
| невалиден_обем | Клиентот побара погрешен обем. |
| грешка во серверот | Серверот за овластување наиде на неочекувана грешка. Третирајте како грешка на 500 внатрешен сервер HTTP. |
| моментално недостапен | Серверот за овластување во моментов е недостапен поради привремено преоптоварување или закажано одржување. Третирајте како недостапна грешка на HTTP во услугата 503. |
Потврдете ги токените за пристап
Откако ќе добиете токен за пристап користејќи го имплицитниот грант, препорачливо е да ја потврдите автентичноста на токенот за пристап пред да го вратите професионалецот за клиентfile користејќи го тој токен. Ако некоја злонамерна локација може да наведе корисник да се најави, тој може да го земе важечкиот токен за пристап што го добива и да го користи за да имитира одговор за овластување на вашата страница.
За да потврдите токен, остварете безбеден HTTP повик на https://api.amazon.com/auth/O2/tokeninfo, пренесувајќи го токенот за пристап што сакате да го потврдите. Можете да го наведете токенот за пристап како параметар за пребарување.
За прampле:
| https://api.amazon.com/auth/O2/tokeninfo?access_token=Atza| IQEBLjAsAhRmHjNgHpi0U-Dme37rR6CuUpSR… |
Забелешка: Токените за пристап содржат знаци кои не се надвор од дозволениот опсег за URLс Затоа, треба URL кодираат токени за пристап за да спречат грешки. За повеќе информации, видете Дел 2.1 од RFC3986.
Одговор на информации за токени
Ако вашиот токен за пристап е валиден, ќе ги добиете информациите за токенот како одговор на HTTP во JSON.
За прampле:
| HTTP / ll 200 ОК Датум: петок, 3 ми мај 20l3 23: 22: l0 GMT x-amzn-RequestId: eb5be423-ca48-lle2-84ad-5775f45l4b09 Content-Type: application/json Содржина-должина: 247 { „Iss“: „https://www.amazon.com“, „user_id“: „amznl.account.K2LI23KL2LK2“, „aud“: „amznl.oa2-client.ASFWDFBRN“, „app_id“: „amznl.application .436457DFHDH "," истек ": 3597, „Iat“: l3ll280970, } |
Споредете ја вредноста на ревизијата со клиентот_id што го користите за вашата апликација. Ако тие се различни, вашата апликација не ја побара токенот за пристап и не треба да го користите токенот за пристап.
Успешниот одговор ги вклучува следниве вредности:
| Параметар | Опис |
| iss | Идентификатор на издавачот. Ова ќе биде https://www.amazon.com. |
| user_id | Корисничката идентификација на сметката е поврзана со токенот за пристап. Ова е уникатно за секој корисник и има форма на amznl.account.K2LI23KL2LK2. |
| aud | Идентификаторот на клиентот порано го бараше токенот за пристап. Ако ова не одговара на
клиент_ид се користи во вашата барање за овластување, не користете го овој токен. |
| app_id | Идентификатор на апликацијата на апликацијата што го побара токенот. App_id е врзана за клиентот_id што се користи за барање на токенот, но не е со иста вредност. Може да има повеќе идентификатори на клиенти поврзани со еден идентификатор на апликација. |
| експ | Останатиот век на траење на токенот за пристап, во секунди. |
| иат | Времето кога е издаден токенот. Вредноста е број на секунди од
l970-0l-0lT0: 0: 0z како што се мери во UTC. |
Ако има проблем со потврдување на токенот, ќе добиете грешка во HTTP. Кодовите за грешки за информациите за токенот вклучуваат:
| Код за статус | Код за грешка | Опис |
| 200 | успех | Успех |
| 400 | невалидно_барање | На барањето недостасува потребен параметар, има невалидна вредност или е на друг начин неправилно формиран. |
| 400 | Невалиден знак | Обезбедениот токен е неважечки или е истечен. |
| 500 | Грешка во серверот | Серверот наиде на грешка при траење. |
Покрај кодот за грешка, може да добиете JSON товар со повеќе информации. За прampле:
| HTTP / ll 400 Лошо барање Датум: Петок, 3 л 20 мај 3 23 2: 35 XNUMX: XNUMX по Гринич x-amzn-RequestId: d64bbdl4-ca48-lle2-a5dd-ab3bc3c93bae Content-Type: application/json Содржина-должина: 99 { „Грешка“: код за грешка читлива од машината, „опис на грешка“: опис на грешка читлива од човекот, } |
Грантот за код за авторизација му дозволува на клиентот (обично a webсајт) да го насочи корисничкиот агент (прелистувачот на корисникот) до URI во Amazon. Потоа, на корисникот му е претставена страница со која се бара да го одобри webдозвола на страницата до професионалното лице на корисникотfile. Штом корисникот ќе го одобри барањето, клиентот ја добива шифрата за авторизација и може да ја замени таа шифра за токен за пристап и освежи токен. Откако клиентот ќе добие токен за пристап, тој може да го прочита клиент проfile. За повеќе информации, видете Грант за код за овластување.
Ако корисникот го одбие барањето, клиентот добива грешка од услугата за овластување.
За да побара овластување, клиентот (webсајт) мора да го пренасочи корисничкиот агент (прелистувачот) за да оствари безбеден HTTP повик до https://www.amazon.com/ap/oa со следните параметри:
| Параметар | Опис |
| клиент_ид | БАРАЕ. На идентификатор на клиент. Ова е обезбедено кога ќе го регистрирате вашиот webстраница како клиент за најавување со Амазон. Максимална големина од 100 бајти. |
| опсегот | ЗАДОЛЖИТЕЛНО. Обемот на барањето. Мора да биде проfile, проfile:user_id, поштенски_код или некоја комбинација, одделени со празни места (на пр. проfile%20 поштенски_код). За повеќе информации, видете Customer Profile. |
| тип на одговор | БАРАЕ. Вид на побаран одговор. Мора да биде код за ова сценарио. |
| redirect_uri | БАРАЕ. HTTPS адресата каде услугата за овластување треба да го пренасочи корисникот. |
| држава | ПРЕПОРАЧУВАНИ. Нетранспарентна вредност што ја користи клиентот за одржување на состојбата помеѓу ова барање и одговорот. На услуга за овластување ќе ја вклучи оваа вредност при пренасочување на корисникот назад кон клиентот. Исто така се користи за да се спречи фалсификување на барање меѓу страници. За повеќе информации, видете Барање за фалсификат преку-страница. |
За прampле:
| https://www.amazon.com/ap/oa?client_id=foodev &опсег=проfile & одговор_тип = код &state=208257577ll0975l93l2l59l895857093449424 &redirect_uri=https://client.example.com/auth_popup/token |
За да поднесете барање за овластување, користејќи најава со SDK на Амазон за JavaScript, мора да пополните објект со опции и да повикате amazon.Пријавете се.овластете.
| опции = {} ; options.scope = 'проfile'; options.response_type = 'код'; amazon.Login.authorize (опции, функција (одговор) { ако (одговор. грешка) { алармирање ('грешка во оаут' + одговор. грешка); враќање; } }); |
Првиот параметар до amazon.Пријавете се.овластете секогаш е објектот опции. Вториот параметар е или JavaScript функција за управување со одговорот за овластување, или пренасочување на URI на друга страница. URI мора да припаѓа на истиот домен како и страницата што ја повикува SDK, и таа мора да биде наведена со помош на HTTPS.
За прampле:
| опции = {}; options.scope = 'проfile'; options.response_type = 'код'; amazon.Login.authorize (опции, 'https://mysite.com/redirect_here'); |
Забелешка: Ако сакате да го користите најавувањето со Amazon SDK за JavaScript за да побарате доделување на код за овластување, прво мора да ја натерате вашата страница да го вчита најавувањето со Amazon SDK за JavaScript. Погледнете Вчитајте ја најавата со Амазон SDK за JavaScript.
Откако корисникот ќе го одобри или одбие барањето, серверот за овластување ќе го пренасочи корисникот кон пренасочува_ури. Клиентот потоа ќе добие Одговор за овластување.
По клиентот (webсајт) го насочува корисничкиот агент (прелистувачот) да направи Барање за овластување, услугата за овластување ќе го пренасочи корисничкиот агент на URI одреден од клиентот. Ако корисникот го одобри барањето за пристап, тој URI ќе содржи a код параметар што содржи код за авторизација.
За прampле:
| Пронајден HTTP / ll 302 Локација: https://client.example.com/cb?code=SplxlOBezQQYbYS6WxSbIA &state=208257577ll0975l93l2l59l895857093449424 |
Кодот за овластување може да се движи од 18 до 128 карактери. Код за овластување важи 5 минути.
Пренасочувањето исто така ја копира состојбата помината од корисникот-агент во барањето за овластување. Оваа вредност ви овозможува да водите сметка за состојбата на корисникот пред барањето. Исто така се користи за да се спречи фалсификување на барање меѓу страници. За повеќе информации, видете Барање за фалсификат преку-страница.
Ако користите Пријавување со Amazon SDK за JavaScript, горенаведените параметри се достапни во објектот за одговор обезбеден од amazon.Login.authorize. Погледнете Барање за овластување за поранешенampле. Одговорите за грешка за ова барање ги отсликуваат оние што се користат за имплицитна грант. Види Грешки во авторизацијата.
Барање за пристап до токени
Откако клиентот (webсајт) добива ан Одговор за овластување со важечки код за авторизација, може да го користи тој код за да добие токен за пристап. Со токен за пристап, клиентот може да го чита корисникот проfile (види Пристапен токен) За да побара токен за пристап, клиентот прави безбеден HTTP POST на https://api.amazon.com/auth/o2/token со следниве параметри:
| Параметар | Опис |
| тип на грант | БАРАЕ. Вид на баран грант за пристап. Мора да биде код за авторизација. |
| код | БАРАЕ. Кодот вратен од барањето за овластување. |
| redirect_uri | БАРАЕ. Ако дадовте пренасочување_ури за барањето за овластување, тука мора да го поминете истото пренасочување_ури. Ако сте го користеле најавувањето со Амазон SDK за JavaScript за барање за овластување, не треба да поминете пренасочување_ури
овде. |
| клиент_ид | ЗАДОЛЖИТЕЛНО. Идентификатор на клиентот. Ова е поставено кога ќе го регистрирате вашиот webсајт како клиент. |
| клиент_тајна | БАРАЕ. Тајната вредност доделена на клиентот за време на регистрацијата. |
За прampле:
| POST / auth / o2 / token HTTP / ll Домаќин: api.amazon.com Тип на содржина: апликација / x-www-форма-urlкодирани; знаци = UTF-8
grant_type = код за авторизација & код = SplxlOBezQQYbYS6WxSbIA & клиент_ид = foodev & клиентска тајна = Y76SDl2F |
Забелешка: Наместо тоа, клиентот_id и тајната на клиентот може да се пренесат во заглавието за Овластување, користејќи автентикација за основната HTTP. За повеќе информации, видете RFC2617.
За прampле:
| POST / auth / o2 / токен HTTP / ll Домаќин: api.amazon.com Овластување: Основни czzCaGRSa3F0MzpnWDFmQmF0M2JW Тип на содржина: апликација / x-www-форма-urlкодирани; знаци = UTF-8грант_тип = код за авторизација & код = SplxlOBezQQYbYS6WxSbIA |
Најавувањето со Amazon SDK за JavaScript не содржи функција за размена на кодови за авторизација за токени за пристап. Тоа е затоа што таа размена бара тајната на клиентот, која не треба да се чува во скрипта. Како резултат на тоа, вашиот web Наместо тоа, серверот ќе треба да направи размена.
Ако користите amazon.Login.authorize за да побарате код за овластување, треба да го предадете кодот за овластување на вашиот сервер или да користите redirect_uri што ќе се ракува со код од страната на серверот.
Пристап до одговор на токените
Кога клиентот (webсајт) прави безбеден HTTP POST Барање за овластување, серверот за овластување веднаш го враќа токенот за пристап или грешка во одговорот на HTTP. За прampле:
| HTTP / ll 200 ОК Тип на содржина: апликација / json; знак UTF-8 Контрола на меморија: нема продавница Прагма: без кеш { „Пристап_стоен“: „Atza | IQEBLjAsAhRmHjNgHpi0U Dme37rR6CuUpSR…“, „Тип на знак“: „носител“, „Expires_in“: 3600, „Refresh_token“: „Atzr | IQEBLzAtAhRPpMJxdwVz2Nn6f2y-tpJX2DeX…“ } |
Успешниот одговор ги вклучува следниве вредности:
| Параметар | Опис |
| пристап_токен | На токен за пристап за корисничката сметка. Максимална големина од 2048 бајти. |
| тип на знак | Видот на токенот е вратен. Треба да биде носител. |
| истекува_во | Бројот на секунди пред токенот за пристап станува невалиден. |
| Освежи_изговорено | Токен за освежување што може да се користи за барање нов токен за пристап. Максимална големина од 2048 бајти. |
Параметрите за одговор се кодираат со употреба на типот на апликација / json media. За повеќе информации, видете RFC4627.
Пристап до грешки во токенот
За некои грешки, услугата за овластување може да врати код за статус HTTP 401 (неовластено). Ова ги вклучува случаите кога клиентот ги поминал вредностите на клиентот_id и тајната на клиентот во заглавието за Овластување и клиентот не може да се провери.
Неуспешен одговор ги вклучува следниве вредности:
| Параметар на грешка | Опис |
| грешка | Код за грешка ASCII со вредност на кодот за грешка. |
| опис на грешка | Низа ASCII читлива за луѓе со информации за грешката; корисно за развивачите на клиенти. |
| грешка_ури | URI до a web страница со информации читливи од човек за грешката; корисни за развивачите на клиенти. |
Следните кодови за грешки може да се вратат како вредност за грешка:
| Код за грешка | Опис |
| невалидно_барање | На барањето недостасува потребен параметар, има невалидна вредност или е на друг начин неправилно формиран. |
| невалиден_ клиент | Автентикацијата на клиентот не успеа. Ова се користи во случаи кога услугата за овластување не враќа код за статус HTTP 401 (неовластено). |
| невалиден_грант | Кодот за овластување е неважечки, истечен, укинат или е издаден на друг клиент_id. |
| неовластен_ клиент | Клиентот не е овластен да користи кодови за овластување. |
| неподдржан_граден_тип | Клиентот навел погрешен тип на знак во барањето. |
| грешка во серверот | Серверот за овластување наиде на неочекувана грешка. Третирајте како грешка на 500 внатрешен сервер HTTP. |
Користете Освежи токени
Токените за пристап ќе истечат по одреден временски период (нормално вратен во параметарот expires_in). Кога ќе добиете токен за пристап, ќе добиете и токен за освежување. Може да користите токен за освежување за да добиете нов токен за пристап.
За да поднесе токен за освежување, клиентот прави безбеден HTTP POST на https://api.amazon.com/auth/ o2 / токен со следниве параметри:
| Параметар | Опис |
| тип на грант | БАРАЕ. Вид на баран грант за пристап. Мора да биде освежено_изговорено. |
| освежи_изговорено | БАРАЕ. Токенот за освежување го врати оригиналниот Одговор на пристапот. |
За прampле:
| POST / auth / o2 / токен HTTP / ll Домаќин: api.amazon.com Овластување: Основни czzCaGRSa3F0MzpnWDFmQmF0M2JW Тип на содржина: апликација / x-www-форма-urlencoded;charset=UTF-8grant_type=refresh_token &refresh_token=Atzr|IQEBLzAtAhRPpMJxdwVz2Nn6f2y-tpJX2DeX… |
Забелешка: Наместо тоа, клиентот_id и тајната на клиентот може да се пренесат во заглавието за Овластување, користејќи автентикација за основната HTTP. За повеќе информации, видетеRFC2617.
За прampле:
| POST / auth / o2 / токен HTTP / ll Домаќин: api.amazon.com-Тип на содржина: апликација / x-www-форма-urlencoded;charset=UTF-8grant_type=refresh_token &refresh_token=Atzr|IQEBLzAtAhRPpMJxdwVz2Nn6f2y-tpJX2DeX… &client_id=foodev & тајна на клиентот = Y76SDl2F |
Одговорот на поднесувањето на токенот за освежување е Пристап до одговор на токените.
Динамички пренасочување на корисниците
Откако корисниците ќе се најават со Амазон, тие можат да бидат пренасочени само на статичките страници што ги наведовте како Дозволено пренасочување URLs кога вие ја регистриравте вашата апликација. Наместо тоа, да ги пренасочите корисниците динамично кон разни различни URLПо автентикација, кога ќе го направите барањето за овластување, пополнете го параметарот на државата со вредност што може да се користи за генерирање на посакуваното пренасочување URL. За прampле, ако на крајот сакате корисниците да се пренасочат назад на страницата Опис на ставката што биле viewпред автентикацијата, пополнете го параметарот на состојбата во вашето барање со единствениот дел од страницата Опис на ставката URL. По автентикацијата, најавувањето со Амазон испраќа одговор на овластување до клиентот што ја вклучува истата параметарска вредност на државата што ја наведовте во барањето.
Корисникот е испратен до Дозволено пренасочување URL. Користете ја вредноста на параметарот на состојбата за динамично генерирање на URL поврзана со страницата на која сакате корисникот да слета на крајот, а потоа веднаш пренасочете ги таму од статичката страница.
Ако динамичката URL содржи чувствителни информации, препорачуваме да криптирате, а потоа да ги кодирате со base64, пред да ги доделите на параметарот состојба. Кога информациите се враќаат во одговорот за овластување, дешифрирајте ги и декодирајте ги за да генерирате динамика URL.
Покрај тоа, ние силно препорачуваме на секој што користи пренасочување на автентикацијата за да ги заштити корисниците од вкрстено место барање фалсификат (ООП) напади. Направете го тоа со доделување на единствена вредност (токен CSRF) на параметарот на состојбата во секое барање за проверка, а подоцна потврдете ја во одговорот за автентикација. Размислете за доделување на овој уникатен csrf токен и пренасочување URL до параметарот на состојбата со употреба на спојување.
За прampле:
| + „“ +url> |
За повеќе информации за креирање на токен CSRF, видете Барање за фалсификат преку-страница.
Забелешка: Оваа информација може да се занемари ако вашата апликација не ги пренасочува корисниците на посебна страница за проверка.
Користете токени за пристап за да прочитате професионален клиентfile
Откако корисникот ќе го даде вашиот webпристап до веб-локацијата до нивниот професионалец за клиент на Амазонfile, ќе добиете ан токен за пристап. За пристап до овластените податоци за клиенти, го доставувате тој токен за пристап до најавување со Амазон користејќи HTTPS. Како одговор, најавувањето со Амазон ќе го врати соодветното клиент проfile податоци. Професионалецотfile податоците што ги добивате се одредуваат според обемот што го наведовте кога баравте пристап. Токенот за пристап ја одразува дозволата за пристап за тој опсег.
Ако користите најавување со Amazon SDK за JavaScript, користете amazon.Login.retrieveProfile да размени токен за пристап за професионалецfile.
За прampле:
| document.getElementById(‘LoginWithAmazon’).onclick = function() { setTimeout (прозорец.doLogin, l); врати лажно; }; прозорец.doLogin = функција () {опции = {}; options.scope = 'проfile'; amazon.Login.authorize(опции, функција(одговор) { ако (одговор. грешка) { алармирање ('грешка во оаут' + одговор. грешка); враќање; } amazon.Login.retrieveProfile(response.access_token, function(response) { alert('Здраво, ' + answer.profile.Име); alert('Вашата адреса на е-пошта е ' + answer.profile.Примарна е-пошта); alert('Вашиот единствен ID е ' + answer.profile.CustomerId); ако (прозорец.конзола иamp;& window.console.log ) window.console.log(response); }); }); }; |
На amazon.Login.retrieveProfile функцијата враќа три параметри: успех, грешка и проfile. успехот покажува дали повикот бил успешен. грешката содржи порака за грешка доколку се појави грешка. Ако немаше грешка, проfile содржи профи на корисникотfile.
Забелешка: Ако сакате да го користите најавувањето со Amazon SDK за JavaScript за да побарате клиент професионалецfile, прво мора да ја вчитате вашата страница најава со Amazon SDK за JavaScript. Види Вчитајте го најавувањето со Amazon SDK за JavaScript.
Ако ја повикувате крајната точка директно, можете да го наведете токенот за пристап на еден од трите начини: како параметар за пребарување, како токен за носител или да користите x-amz-пристап-токен во заглавието HTTP.
За прampле:
| https://api.amazon.com/user/profile?access_token AtzaIIQEBLjAsAhRmHjNgHpi0U- Dme37rR6CuUpSR… |
| ДОБИЈ / корисник / проfile HTTP/ll Домаќин: api.amazon.com Датум: Сре, 0 л 20 јуни јуни 2 часот: 00 часот по Гринич Овластување: Носител Atza | IQEBLjAsAhRmHjNgHpi0U-Dme37rR6CuUpSR |
| ДОБИЈ / корисник / проfile HTTP/ll Домаќин: api.amazon.com Датум: Сре, 0 л 20 јуни јуни 2 часот: 00 часот по Гринич x-amz-пристап-токен: Atza | IQEBLjAsAhRmHjNgHpi0U-Dme37rR6CuUpSR |
Забелешка: Токените за пристап содржат знаци кои не се надвор од дозволениот опсег за URLс Затоа, треба URL кодираат токени за пристап за да спречат грешки. За повеќе информации, видете Дел 2.1 од RFC3986.
Пријавувањето со Амазон поддржува само апликација / json како тип на содржина и en-us како јазик на содржина. Најавувањето со Амазон го користи овој тип на јазик и јазик по дифолт, дури и ако не се наведени
| ДОБИЈ / корисник / проfile HTTP/ll Домаќин: api.amazon.com Датум: Сре, 0 л 20 јуни јуни 2 часот: 00 часот по Гринич x-amz-пристап-токен: Atza | IQEBLjAsAhRmHjNgHpi0U-Dme37rR6CuUpSR… Прифати: апликација / json Прифати-јазик: en-US |
Customer Profile Одговор
Ако вашиот токен за пристап е валиден, ќе добиете профи на клиентотfile податоци како HTTP одговор во JSON.
За прampле:
| HTTP / ll 200 ОК x-amzn-RequestId: 0f6bef6d-705c-lle2-aacb-93e6bf26930l Тип на содржина: апликација/json Содржина-јазик: en-US Содржина-должина: 85 { „User_id“: „amznl.account.K2LI23KL2LK2“, „е-пошта“: „mhashimoto-04@plaxo.com“, „Име“: „Морк Хашимото“, „Поштенски број“: „98052“ } |
Re-ID е за најавување и може да се игнорира. Доколку решавате проблем со тимот за најавување со Амазон, може да ве замолат да го доставите ID-барање.
Ако има проблем да го исполните вашиот професионалецfile барање, ќе добиете HTTP грешка. Кодовите за грешка за барање за пристап вклучуваат:
| Код за статус | Код за грешка | Опис |
| 200 | успех | Успех |
| 400 | невалидно_барање | На барањето недостасува потребен параметар, има невалидна вредност или е на друг начин неправилно формиран. |
| 400 | Невалиден знак | Обезбедениот токен е неважечки или е истечен. |
| 401 | Недоволен_обем | Обезбедениот токен за пристап нема пристап до потребниот обем. |
| 500 | Грешка во серверот | Серверот наиде на грешка при траење. |
Покрај кодот за грешка, може да добиете JSON товар со повеќе информации. За прampле:
| HTTP / ll 400 Лошо барање Тип на содржина: апликација / json; шарсет = UTF-8 Должина на содржина: 74 { „Грешка“: „код за грешка читлива од машината“, „опис на грешка“: „опис на грешка читлива од човекот“, „барања_ид“: „bef0c2f8-e292-4l96-8c95-8833fbd559df“ } |
Одјавете се од корисниците
Вашиот webстраницата треба да обезбеди начин за корисниците да се одјават откако ќе се логираат. Откако ќе ја изберат опцијата за одјавување, треба да ги избришете сите токени за пристап и да ги освежите токените поврзани со тој корисник и да ги отстраните нивните професионалниfile информации од webсајт. Вашиот webстраницата потоа треба да прикаже опција за најавување.
Ако користите најавување со Amazon SDK за JavaScript, можете да го повикате методот amazon.Login.logout за да ги избришете сите кеширани токени. За прampле:
| document.getElementById(‘Logout’).onclick function() } {amazon.Login.logout (); }; |
Последователните повици кон amazon.Login.authorize стандардно ќе го претстави екранот за најавување
Безбедносни размислувања
Теми
- Барање за фалсификат преку-страница
- Сопственик на имитација на сопственик на ресурси во имплицитен проток
- Отворете ги пренасочувачите
- Код инјекција
Информациите за клиентите Пријавувањето со Амазон им ги дава на учесниците webсајтовите се вредни и мора да се преземат мерки на претпазливост за да се осигури дека остануваат доверливи. Протоколот за најавување со Амазон широко го користи HTTPS за да ги заштити комуникациите помеѓу корисникот и Амазон и помеѓу вашите webсајт и Амазон. Овој дел ги објаснува сите безбедносни закани што го надминуваат користењето на HTTPS и објаснува како можете да ги спречите напаѓачите да добијат вредни информации за клиентите.
Барање за фалсификат преку-страница
Барање за фалсификување преку-страница се случува кога напаѓач ќе измами корисник да кликне на злонамерен линк, каде што врската оди на страница каде што корисникот во моментов е автентициран. Кои било команди вметнати во таа злонамерна врска може да се извршат автоматски бидејќи корисникот е веќе автентициран на страницата, така што корисникот не гледа екран за најавување или кој било друг доказ за злонамерна активност. Во случај на најавување со Амазон, Cross-site Request Forgery може да се користи за имитирање клиент или сервер за автентикација.
Пријавување со Амазон препорачува користење на параметарот на државата за да се спречи фалсификување на барање меѓу страници. Клиентот треба да ја постави вредноста на параметарот на состојбата кога иницира барање за овластување и да го зачува на безбедна сесија на корисникот. За разлика од вредностите на клиентот_id и клиентската тајна, со цел параметарот на состојбата да биде корисен во спречувањето напади, тој треба да биде единствен и не може да се претпостави, за секое барање за овластување. Серверот за овластување ја враќа истата состојба кога комуницира со клиентот за да испорача кодови за овластување и токени за пристап. За да ги заштити корисниците од напади, клиентот мора да ја игнорира комуникацијата ако параметарот вратена состојба не одговара на вредноста од првичниот повик.
Пресметај го параметарот на државата
Клиентите можат да ја пресметаат вредноста на параметарот на државата на кој било начин што ќе го изберат, сепак, вредноста треба да биде безбедна од фалсификат. Пријавување со Амазон препорачува употреба на безбедно генерирана случајна низа со најмалку 256 бита ентропија. За да пресметате државна вредност користејќи го овој метод, користете генератор на случаен број погоден за криптографски операции.
Еве еден поранешенample во Пајтон:
| def generate_state_parameter (): случајно = os.urandom (256) состојба = база64.b64енкод (случајно) враќање (држава) |
Откако ќе ја генерирате вредноста на параметарот на состојбата, зачувајте ја во информациите за сесијата на корисникот, осигурувајќи дека информациите се соопштуваат безбедно и се зачувуваат на безбедна сесија. Кога државата е вратена со одговор за овластување, проверете ја легитимноста на корисникот споредувајќи ја со зачуваната вредност на државата на нивната сесија. Ако вредностите не се совпаѓаат, треба да го игнорирате одговорот за овластување.
Ако ја користите вредноста на параметарот на државата за динамично пренасочување на корисниците по автентикација, размислете за спојување на безбедно генерираната случајна низа со динамичката URL, одделени со празно место (на пр. состојба = состојба + „” + динамикаURL) Кога серверот за овластување ја враќа состојбата, анализирајте ја и поделете ја на две вредности засновани на просторот. Втората вредност ќе ја содржи динамиката URL потребно е да се насочи корисникот на соодветната страница по автентикацијата.
Лажно претставување на сопственикот на ресурси во имплицитен проток
Webсајтови со користење на Имплицитен грант добиваат токен за пристап од услугата за овластување Логирај се со Амазон пасивно преку А. пренасочување URL. Ако напаѓачот може да примами корисник да се најавува на злонамерна страница, страницата на напаѓачот ќе добие легитимен токен за пристап. Потоа, напаѓачот може да го пренесе тој токен за пристап до пренасочување URL на друга страница за да се појави дека корисникот се обидува да се најави на страницата.
Клиентите кои користат имплицитен проток можат да се заштитат од овој напад со потврда дека токенот за пристап е легитимен порано
користејќи го за да добие професионален клиентfile и целосно најавување. Најавувањето со Амазон обезбедува крајна точка специјално за проверка на токени за пристап. Клиентите треба да ја користат таа крајна точка за да ги споредат нивните идентификатор на клиент до идентификаторот на клиентот што првично го побара токенот за пристап. Ако идентификаторите на клиентите не се совпаѓаат, барањето за најава треба да биде одбиено.
За повеќе информации, видете Потврдување на пристапните знаци.
Отворете ги пренасочувачите
Отворен пренасочувач е крајна точка конфигурирана да пренасочува кориснички агент врз основа на вредноста на параметарот, без каков било вид валидација. Отворените пренасочувачи може да се експлоатираат при најавување со Амазон од напаѓачи кои ги измамуваат корисниците да овластат пристап до легитимните webсајт, но кога серверот за овластување се пренасочува кон клиентот, отворениот пренасочувач го испраќа назад до напаѓачот.
Најавете се со клиентот на Амазон webсајтовите треба да осигураат дека целта на URI за пренасочување што ја користат за автентикација не е конфигурирана како отворен пренасочувач.
Некои вообичаени обрасци за отворени пренасочувања се:
example.com/go.php?url=
example.com/search?q=корисник+пребарување+клучни зборови&url= прample.com/coupon.jsp?code=ABCDEF&url=
example.com/login?url=
Код инјекција
Нападот за вбризгување код се случува кога напаѓачот ја менува вредноста на влезот или параметарот на начин што предизвикува неочекувано однесување во webстраница (како што е најавување со клиент на Амазон). Напад со вбризгување на код е можен кога a webстраницата не ги потврдува дојдовните податоци пред да дејствува на неа.
Најавете се со клиентот на Амазон webсајтовите треба да ги валидираат податоците што доаѓаат од услугата за овластување, особено параметарот на состојбата, пред да дејствуваат по него. Пријавувањето со клиентите на Амазон, исто така, треба да го потврди профи клиентотfile податоци доколку ги користат програмски.
Речник
обем на пристап: Опсегот на пристап го дефинира типот на корисник проfile податоци што ги бара клиентот. Првиот пат кога корисникот ќе се најави, тој гледа список на ставки во опсегот на пристап и мора да се согласи да ги обезбеди податоците на клиентот за да продолжи.
токен за пристап: Токенот за пристап го дава серверот за овластување кога корисникот се најавува на некоја страница. Токенот за пристап е специфичен за клиент, корисник и ан пристап опсегот.
Токените за пристап имаат максимална големина од 2048 бајти. Клиентот мора да користи знак за пристап за да добие клиент проfile податоци.
дозволено потекло од JavaScript: Потеклото JavaScript е комбинација од протокол, домен и порта од каде што потекнува JavaScript повик. Стандардно, web прелистувачите ги блокираат JavaScript повиците од едно потекло кои се обидуваат да повикаат скрипта од друго потекло. Пријавувањето со SDK на Амазон за JavaScript овозможува повици од друго потекло ако се наведени како дел од апликација.
При регистрирање на А webвеб -страница за најава со Амазон, внесете ја шемата, доменот и по избор портата на webстраница што вклучува Влези со Amazon SDK за JavaScript (на прampле, http://www.example.com или https: // localhost: 8080).
дозволено враќање URL: Враќање URL е адреса на а webсајт кој користи најава со Амазон.
На услуга за овластување ги пренасочува корисниците на оваа адреса кога ќе завршат со најавувањето.
Видете исто така пренасочување URL.
API клуч: Ова е идентификатор што се најавува со SDK на Амазон за да ја идентификува мобилната апликација на услуга за овластување. АПИ-клучевите се генерираат кога регистрирате мобилна апликација.
апликација: Апликација е регистрација што содржи информации за овластување услуга треба да потврди клиент пред тој клиент да има пристап клиент проfiles. Исто така, содржи основни информации за вашиот бизнис што им се прикажуваат на корисниците секој пат кога тие користат најавување со Амазон на вашиот webстраница или мобилна апликација.
ID на продавница: ID на AppStore уникатно идентификува мобилна апликација во Amazon AppStore.
Код за овластување: Код за овластување е вредност што ја користи Грант за код за овластување да се дозволи а webсајт за барање на токен за пристап.
грант за код за овластување: Грант за Кодекс за овластување е грант за овластување што користи обработка базирана на сервер за да побара токен за пристап. Користејќи го грантот за код за овластување, серверот добива код за авторизација како параметар за пребарување откако корисникот ќе се најави. Серверот го разменува кодот за овластување, клиент идентификатор, и таен клиент за токен за пристап и А. освежи токен
грант за овластување: Грант за овластување е процес каде што услуга за овластување потврдува клиент webбарање на страницата за пристап до а клиент проfile. За грант за овластување потребно е А. идентификатор на клиент и ан опсег на пристап, и може да бара А. тајна на клиентот. Ако процесот успее, на webстраницата е доделена на токен за пристап.
Постојат два вида на грантови за овластување, т.е. Имплицитен грант и ан Грант за код за овластување.
услуга за овластување: Услугата за авторизација „Логирање со Амазон“ е збирка на крајни точки обезбедени од „Амазон“ што му овозможува на клиентот да се најавува преку корисник грантови за овластување. Услугата за овластување го претставува екранот за најавување и екранот за дозволи на корисниците. Обезбедува пристап до токени, освежи токени, и клиент проfile податоци за најавување со клиенти на Амазон.
идентификатор на пакет: Идентификаторот на пакетот е единствен идентификатор за апликација за iOS. Тие вообичаено имаат форма на com.companyname.appname.
клиент: Клиент е а webвеб -страница или мобилна апликација што користи Пријавување со Амазон.
идентификатор на клиент: Идентификаторот на клиентот е вредност што му е доделена на клиентот кога се регистрираат со Логирање со Амазон. Има максимална големина од 100 бајти. Идентификаторот на клиентот се користи заедно со тајната на клиентот за да се потврди идентитетот на клиентот кога тие бараат грант за овластување од овластување услуга. Идентификаторот на клиентот не е таен.
тајна на клиентот: Тајната на клиентот, како идентификатор на клиент, е вредност што му е доделена на клиентот кога се регистрираат со Логирање со Амазон. Има максимална големина од 64 бајти. Тајната на клиентот се користи заедно со идентификаторот на клиентот за да се потврди идентитетот на клиентот кога тие бараат грант за овластување од услуга за овластување. Тајната на клиентот мора да се чува во тајност.
екран за согласност: Кога корисникот се најавува во webвеб -страница или мобилна апликација за прв пат, тие се претставени со екран за согласност ако апликацијата бара проfile податоци. Екранот за согласност го прикажува името, слика на логото file, и известување за приватност URL поврзани со апликација, заедно со обем на пристап апликацијата бара.
клиент проfile: Професионален клиентfile содржи информации за клиентот за најава со Амазон, вклучувајќи го и нивното име, адреса за е -пошта, поштенски код и единствен идентификатор. А webстраницата мора да добие токен за пристап пред да можат да добијат клиент проfileНа Видот на проfile вратените податоци се одредуваат со обем на пристап.
имплицитен грант: Имплицитен грант е грант за овластување што може да се заврши со користење само на корисникот web прелистувач. Користејќи го имплицитниот грант, прелистувачот добива а токен за пристап како фрагмент на URI. За имплицитен грант е потребно А. клиент идентификатор и ан обем на пристап. Имплицитниот грант не враќа a освежи токен.
екран за најава: Екранот за најава е HTML страница што им се прикажува на корисниците кога се обидуваат да се најават на webстраница или мобилна апликација користејќи Најавете се со Амазон. Корисниците можат да внесат постоечка сметка на Амазон или да креираат нова од оваа страница.
слика на логото file: PNG file обезбедени од клиентот при поставување на апликација. Ова се прикажува на екранот со дозволи доколку корисникот не му дал пристап на клиентот webсајт. Логото го претставува клиентот webсајт.
име на пакет: Името на пакетот е единствен идентификатор за апликација за Android. Тие вообичаено имаат форма на com.companyname.appname.
известување за приватност URL: A URL обезбедени од клиентот при поставување на апликација. Ова се прикажува на екранот за согласност доколку корисникот не му дал пристап на клиентот webстраницата. На URL треба да ги насочи корисниците кон политиката за приватност за клиентот webсајт.
пренасочување URL: A URL обезбедени од клиентот до услуга за овластување. После најавување на корисникот, услугата ќе го пренасочи прелистувачот на корисникот на оваа адреса. Исто така види Дозволено враќање URL.
освежи токен: Токенот за освежување го доделува услуга за овластување додека клиентот го користи Грант за код за овластување. Клиентот може да користи токен за освежување за да побара нов токен за пристап кога се активира моменталниот пристап. Освежителните токени имаат максимална големина од 2048 бајти.
потпис: Потпис е хаш-вредност SHA-256 вградена во мобилна апликација што го потврдува идентитетот на апликацијата. Тие вообичаено имаат форма на 01: 23: 45: 67: 89: ab: cd: ef: 0l: 23: 45: 67: 89: ab: cd: ef: 0l: 2 3: 45: 67: 89: ab : cd: ef: 0l: 23: 45: 67: 89: ab: cd: ef.
корисник: Корисник е лице кое посетува клиент webсајт и се обидува да се најавите користејќи Најавете се со Амазон.
верзија: Верзијата е одреден вид на најавување со клиент на Амазон регистриран на апликација. Пријавување со апликацијата Амазон може да има повеќе верзии,
Пријавете се со Водичот за програмери на Амазон за Webсајтови - Преземи [оптимизиран]
Пријавете се со Водичот за програмери на Амазон за Webсајтови - Преземи
