התחבר עם אמזון תחילת העבודה
התחברות עם אמזון: מדריך לתחילת העבודה עבור Webאתרים זכויות יוצרים © 2017 שירותי אמזון, LLC או שלוחותיה. כל הזכויות שמורות.
אמזון והלוגו של אמזון הם סימנים מסחריים של Amazon.com, Inc. או שלוחותיה. כל שאר
סימני מסחר שאינם בבעלות אמזון הם רכושם של בעליהם בהתאמה.
הירשם באמצעות התחברות באמצעות אמזון
לפני שתוכל להשתמש בהתחברות עם אמזון ב-a webבאתר או באפליקציה לנייד, עליך לרשום אפליקציה עם Login with Amazon. אפליקציית ההתחברות שלך עם אמזון היא הרישום שמכיל מידע בסיסי על העסק שלך ומידע על כל אחד מהם webאתר או אפליקציה לנייד שאתה יוצר התומך בהתחברות עם אמזון. מידע עסקי זה מוצג למשתמשים בכל פעם שהם משתמשים בהתחברות עם אמזון במכשיר שלך webאתר או אפליקציה לנייד. משתמשים יראו את שם האפליקציה שלך, הלוגו שלך וקישור למדיניות הפרטיות שלך. שלבים אלה מדגימים כיצד לרשום את אפליקציית Android שלך לשימוש עם כניסה עם אמזון.
רשום את הכניסה שלך באמצעות יישום אמזון
- עבור אל https://login.amazon.com.
- אם נרשמת בעבר להתחברות עם אמזון, לחץ על מסוף האפליקציות. אחרת, לחץ על הירשם. תועבר ל - Seller Central, המטפל ברישום יישומים להתחברות באמזון. אם זה שלך
בפעם הראשונה שתשתמש בסלר סנטרל, תתבקש להקים חשבון סלקר סנטר. - לחץ על רשום יישום חדש. טופס הרשמת בקשתך יופיע:
a. בטופס רישום בקשתך, עליך להזין שם ותיאור לבקשתך.
ה שֵׁם הוא השם המוצג על מסך ההסכמה כאשר משתמשים מסכימים לשתף מידע עם האפליקציה שלך. שם זה חל על אנדרואיד, iOS ו webגירסאות האתר של היישום שלך. התיאור מסייע לך להבדיל כל אחד מהכניסות שלך באמצעות יישומי אמזון, ואינו מוצג למשתמשים.
b. הזן א פְּרָטִיוּת URL עבור הבקשה שלך.
הודעת הפרטיות URL הוא המיקום של מדיניות הפרטיות של החברה או האפליקציה שלך (למשלample, http: //www.example.com/privacy.html). קישור זה מוצג למשתמשים במסך ההסכמה.
c. אם אתה רוצה להוסיף א תמונת לוגו עבור היישום שלך, לחץ לִבחוֹר File ואתר את התמונה הרלוונטית.
לוגו זה מוצג במסך הכניסה וההסכמה לייצוג העסק שלך או webאֲתַר. הלוגו יצטמק לגובה של 50 פיקסלים אם הוא גבוה מ -50 פיקסלים; אין הגבלה על רוחב הלוגו. - נְקִישָׁה לְהַצִיל. ה-s שלךampהרישום צריך להיראות דומה לזה:
לאחר שמירת הגדרות היישום הבסיסיות שלך, תוכל להוסיף הגדרות ספציפיות webאתרים ואפליקציות מובייל שישתמשו בכניסה זו באמצעות חשבון אמזון
לְהוֹסִיף Webהגדרות האתר ליישום שלך
- ממסך היישום, לחץ Web הגדרות. יוקצו לך באופן אוטומטי ערכים עבור מזהה לקוח וסוד לקוח. מזהה הלקוח מזהה את שלך webהאתר, וכן קונה סוד משמש בנסיבות מסוימות כדי לאמת את שלך webהאתר אותנטי. סוד הלקוח, כמו סיסמה, הוא חסוי. ל view סוד הלקוח, לחץ הצג סוד.
- כדי להוסיף מקורות JavaScript מורשים or מותר להחזיר URLs ליישום שלך, לחץ לַעֲרוֹך.
פֶּתֶק: לשימוש בכניסה עם אמזון עם webאתר, עליך לציין מקור מקור מותר ל- JavaScript (למענק המשתמע) או החזרה מותרת URL (למענק קוד ההרשאה). אם אתה משתמש ב- Amazon Pay, עליך לציין מקור JavaScript מותר.
a. אם שלך webהאתר ישתמש ב- Login with Amazon SDK עבור JavaScript, הוסף את שלך webמקור האתר ל מקורות JavaScript מורשים.
מקור הוא שילוב של פרוטוקול, שם דומיין ויציאה (למשלample, https: // www.example.com:8443). מקורות מותרים חייבים להשתמש בפרוטוקול HTTPS. אם אתה משתמש ביציאה רגילה (יציאה 80 או יציאה 443) עליך לכלול רק את שם הדומיין (למשלample, https: // www.example.com).
הוספת הדומיין שלך כאן מאפשרת ל- SDK ל- JavaScript לתקשר עם שלך webהאתר ישירות
במהלך תהליך ההתחברות. Web בדפדפנים בדרך כלל חוסמים תקשורת בין מוצא בין סקריפטים אלא אם התסריט מאפשר זאת באופן ספציפי.
כדי להוסיף יותר ממקור אחד, לחץ הוסף עוד אחד.
b. אם שלך webהאתר יבצע שיחות HTTPS לכניסה עם שירות ההרשאה של אמזון ויציין redirect_uri לתשובות, הוסף את כתובות ה- URI לאלה מותר להחזיר URLs. השיבה URL כולל את הפרוטוקול, התחום, הנתיב ומחרוזת השאילתה (למשלample, https: // www.example.com/login.php).
כדי להוסיף יותר מתמורה אחת URL, לחץ להוסיף עוד. - נְקִישָׁה לְהַצִיל
לאחר מכן, הוסף כפתור התחברות עם אמזון ל- webאֲתַר. אתה יכול לבחור מתוך מגוון כפתורים ולבחור את התמונה המתאימה לך ביותר webאֲתַר. ראה את ההתחברות עם הנחיות בסגנון אמזון לשיטות עבודה מומלצות ולרשימת תמונות לבחירה.
- הוסף את הקוד הבא שלך webהאתר שבו תרצה שהכפתור יופיע. למטרות מדריך זה, זה חייב להיות HTTPS webאֲתַר:
<img border="0″ alt="התחבר עם אמזון"
src = ”https://images-na.ssl-images-amazon.com/images/G/01/lwa/
btnLWA_gold_156x32.png ”
רוחב = "156" גובה = "32" />
- אופציונלי. הוסף את הקישור הבא לאתר שלך webאתר שבו תרצה שתופיע הודעת "יציאה":
- רענן את הדף כדי לוודא שהכפתור מופיע כעת ב- webאֲתַר.
להתנתק
הוסף את הכניסה באמצעות אמזון SDK עבור JavaScript
הכניסה עם אמזון SDK ל- JavaScript תטפל בכל החלקים הקשים של שילוב הכניסה עם אמזון ב- שלך webאֲתַר.
- הוסף את הקוד הבא לאחר הפתיחה בדף שלך כדי לטעון את JavaScript לדף שלך:
window.onAmazonLoginReady = פונקציה () {
amazon.Login.setClientId ('מזהה הלקוח שלך');
};
(פונקציה (ד) {
var a = d.createElement ('סקריפט'); a.type = 'text / javascript';
a.async = נכון; a.id = 'amazon-login-sdk';
a.src =
'https://assets.loginwithamazon.com/sdk/na/login1.j
s '; d.getElementById ('אמזון-שורש'). appendChild (א);
})(מסמך);
- לְהַחלִיף מזהה הלקוח שלך עם זיהוי הלקוח שתקבל כאשר אתה הירשם באמצעות התחברות באמצעות אמזון.
- הוסף את JavaScript הבא לאחר כפתור ההתחברות באמצעות אמזון באתר שלך.
document.getElementById ('LoginWithAmazon'). onclick = פונקציה () {
options = {scope: 'profile'};
amazon.Login.authorize (אפשרויות,
'https: //www.example.com/handle_login.php ');
החזר שקר;
};
- החלף את www.example.com עם הדומיין שלך webאֲתַר.
פֶּתֶק: כברירת מחדל, ה- SDK עבור JavaScript יציג את מסך הכניסה בחלון מוקפץ. אתה יכול להגדיר את המאפיין הקופץ של פרמטר האפשרויות כ- false כדי להפנות את הלקוחות לדף חדש להתחברות. אין תמיכה בחלונות קופצים ב- iOS מקורי WebViewאפליקציות מבוססות. אם אתה מתכוון להשתמש בכניסה עם אמזון באפליקציית iOS שלך, אנו ממליצים להשתמש ב ios-gsg._TTH [PDF], או יישום חווית התחברות מחדש. ראה את website-sdk-reference._TTH [PDF] למידע על התאמה אישית של פרמטר האפשרויות. - לאחר שהמשתמש התחבר והסכים לשתף את הנתונים שצוינו, החלון הנוכחי ינותב אל ה- URI הנתון ותגובת ההרשאה תתווסף למחרוזת השאילתה. ה- URI חייב להשתמש בפרוטוקול https ולהיות באותו תחום כמו החלון הנוכחי.
- אופציונלי. לאחר אישור המשתמשים, עליך להוסיף גישה להיפר-קישור או כפתור התנתקות באתר שלך כדי שיוכלו להתנתק. הוסף את JavaScript הבא כדי לאפשר למשתמשים להתנתק:
document.getElementById ('התנתק'). onclick = פונקציה () {
amazon.Login.logout ();
};
אתה תטפל בתגובת אמזון עם /handle_login.php שלך webהאתר בחלק הבא. תוכל לשנות נתיב זה לאחד שבחרת במועד מאוחר יותר.
להשיג את Profile מֵידָע
אתה יכול להשיג את המקצוענים של המשתמשfile מידע מאמזון באמצעות אסימון גישה הוחזר על ידי ה- SDK.
- ביישום בצד השרת שלך, טפל בבקשה בבקשה /handle_login.php וקבל מקצועןfile מידע באמצעות אסימון הגישה ו- Profile REST API. לְשֶׁעָבַרampלהלן PHP, Python, Java ורובי נמצאים להלן.
- הפעל את שלך webאתר ולאשר שאתה יכול להיכנס באמצעות אישורי Amazon.com שלך.
PHP דוגמהample
// ודא שאסימון הגישה שייך לנו // האסימון חייב להיות urlמקודד כאשר הועבר ל- tokeninfo $ c = curl_init ('https://api.amazon.com/auth/o2/tokeninfo?access_token='. urlקידוד ($ _ REQUEST ['access_token'])); curl_setopt ($ c, CURLOPT_RETURNTRANSFER, true); $ r = curl_exec ($ c); גurl_close ($ c); $ d = json_decode ($ r); if ($ d-> aud! = 'YOUR-CLIENT-ID') {// אסימון הגישה אינו שייך לנו בכותרת ('HTTP/1.1 404 לא נמצא'); הד 'הדף לא נמצא'; יְצִיאָה;} // החלף את אסימון הגישה למשתמש profile $ r = curl_exec ($ c); גurl_close ($ c); הד sprintf ('% s% s% s', $ d-> שם, $ d-> דוא"ל, $ d-> user_id); |
Python Example
עליך להוריד את ה- pycurl ספרייה לשימוש ב- sampאת הקוד.
ייבוא pycurl יְבוּא urllib יבוא ג'סון יבוא StringIO… b = StringIO.StringIO ()# ודא שאסימון הגישה שייך לנו # האסימון חייב להיות urlמקודד כאשר הועבר ל- tokeninfo c = pycurl.Curl() c.setopt (pycurl.URL, “Https://api.amazon.com/auth/o2/tokeninfo?access_token=” + urllib.quote_plus (access_token)) c.setopt (pycurl.SSL_VERIFYPEER, 1) c.setopt (pycurl. SCHRIFFUNCTION, b.write) c.perform () אם d ['aud']! = 'מזהה הלקוח שלך': # החלף את אסימון הגישה למשתמש profile c = pycurl.Curl() c.perform () הדפס “% s% s% s”% (d ['name'], d ['email'], d ['user_id']) |
Java Example
עליך להוריד את ה- ג'קסון ו Http רכיבים ספריות לשימוש זהampאת הקוד.
ייבא com.fasterxml.jackson.core.type.TypeReference; ייבא com.fasterxml.jackson.databind.ObjectMapper; יבוא org.apache.http.client.fluent.Content; יבוא org.apache.http.client.fluent.Request; יבוא java.net.URLקוֹדַאִי; יבוא java.util.Map;… // ודא שאסימון הגישה שייך לנו // האסימון חייב להיות urlמקודד כאשר הועבר ל- tokeninfo מפה m = ObjectMapper חדש (). ReadValue (c.toString (), TypeReference חדש> () אם (! "מזהה הלקוח שלך". שווה (m.get ("aud"))) { } // החלף את אסימון הגישה למשתמש profile System.out.println (String.format ("% s% s% s", m.get ("שם"), |
רובי אקסample
דורשים "rubygems" דורש "net / https" דורש "json" דורשים "uri" ...# ודא שאסימון הגישה שייך לנו # האסימון חייב להיות urlמקודד כאשר הועבר ל- tokeninfo אורי = URI.parse (“https://api.amazon.com/auth/o2/tokeninfo?access_token=” + URI.encode (access_token)) req = Net :: HTTP :: Get.new (uri.request_uri) http = Net :: HTTP.new (uri.host, uri.port) http.use_ssl = נכון http.verify_mode = OpenSSL :: SSL :: VERIFY_PEERresponse = http.request (דרישה) פענוח = JSON.parse (response.body) אם לפענח ['aud']! = 'מזהה הלקוח שלך' סוֹף # החלף את אסימון הגישה למשתמש profile תגובה = http.quest (req) מכניס את sprintf "% s% s% s", לפענח ['שם'], לפענח ['דוא"ל'], |
סיים אינטגרציה עם שלך Webאֲתַר
כעת אתה יודע כיצד להוסיף כניסה עם אמזון לאתר שלך webאֲתַר. השלבים הבאים הם שילוב חשבונות משתמשים של אמזון במערכת ניהול החשבונות שלך והשתמש בהם בכדי להתאים אישית את חשבונך webאתר ללקוחות אמזון. למידע נוסף ראו:
- הכניסה עם אמזון מדריך למפתחים עבור Webאתרים
- https://login.amazon.com/documentation/combining-user-accounts
צריך עוד עזרה? בדוק את שלנו פורומים.
אַגְרוֹן
היקף גישה היקף גישה מגדיר את סוג מקצוען המשתמשיםfile נתונים שהלקוח הוא
מבקש. בפעם הראשונה שמשתמש נכנס, הוא רואה רשימה של הפריטים ב-
היקף הגישה ועליו להסכים לספק את הנתונים ללקוח ב
כדי להמשיך.
אסימון גישה אסימון גישה מוענק על ידי שרת ההרשאה כאשר משתמש נכנס
להיכנס לאתר. אסימון גישה ספציפי ללקוח, למשתמש ולגישה
תְחוּם. הגודל המרבי של אסימוני גישה הוא 2048 בתים. לקוח חייב
השתמש באסימון גישה כדי לאחזר את הלקוח המקצועיfile נְתוּנִים.
מקורות JavaScript מותרים מקור JavaScript הוא השילוב של פרוטוקול, דומיין ויציאה שממנה מקור קריאת JavaScript. כברירת מחדל, web הדפדפנים חוסמים שיחות JavaScript ממקור אחד שמנסים לקרוא לסקריפט ממקור אחר. ההתחברות עם אמזון SDK ל- JavaScript מאפשרת שיחות ממקורות אחרים אם הם מצוינים כחלק מ- בַּקָשָׁה.
בעת רישום א webאתר להתחברות עם אמזון, הזן את התוכנית, התחום, ואופציונלי את היציאה של webדף הכולל את התחברות עם אמזון SDK ל- JavaScript (למשלample, http: //www.example.com או https: // localhost: 8080).
מותר להחזיר URL תמורה URL היא כתובת על א webאתר שמשתמש בכניסה עם אמזון.
ה שירות הרשאות מפנה משתמשים לכתובת זו לאחר השלמת הכניסה.
ראה גם הפניה מחדש URL.
מפתח API מזהה שמשתמשים בו באמצעות כניסה עם אמזון SDK כדי לזהות אפליקציה ניידת לשירות ההרשאה. מפתחות API נוצרים בעת רישום אפליקציה לנייד.
בַּקָשָׁה יישום הוא הרישום המכיל מידע ששירות ההרשאה צריך כדי לאמת לקוח לפני שהלקוח הזה יוכל לגשת ללקוח המקצועיfileש. הוא מכיל גם מידע בסיסי על העסק שלך המוצג למשתמשים בכל פעם שהם משתמשים בכניסה עם אמזון באתר שלך webאתר או אפליקציה לנייד.
בַּקָשָׁה יישום הוא הרישום המכיל מידע על שירות הרשאות צריך לאמת לקוח לפני שהלקוח יוכל לגשת אליו מקצוען של לקוחותfiles. הוא מכיל גם מידע בסיסי על העסק שלך המוצג למשתמשים בכל פעם שהם משתמשים בכניסה עם אמזון באתר שלך webאתר או אפליקציה לנייד.
מזהה Appstore מזהה AppStore מזהה באופן ייחודי אפליקציה לנייד ב- AppStore של אמזון.
קוד הרשאה קוד הרשאה הוא ערך המשמש את ה- מתן קוד הרשאה לאפשר א webאתר לבקש אסימון גישה.
הענקת קוד אישור מענק קוד הרשאה הוא מענק הרשאה שמשתמש בו
שרת עיבוד מבוסס לבקשת אסימון גישה. באמצעות הענקת קוד ההרשאה, השרת מקבל קוד הרשאה כפרמטר שאילתה לאחר שהמשתמש נכנס. השרת מחליף את קוד ההרשאה, מזהה לקוח, ו קונה סוד לאסימון גישה ואסימון רענון.
הענקת אישור מענק אישור הוא התהליך בו שירות הרשאות מאמת לקוח webבקשת האתר לגישה אל מקצוען של לקוחותfile. מענק אישור מחייב מזהה לקוח ו- היקף גישה, ועשוי לדרוש קונה סוד. אם התהליך מצליח, webלאתר ניתן א אסימון גישה.
ישנם שני סוגים של מענקי אישור, מענק מרומז ו- מתן קוד הרשאה.
שירות הרשאות שירות ההרשאה התחברות עם אמזון הוא אוסף נקודות הקצה שמספקת אמזון המאפשר ללקוח להתחבר למשתמש דרכו מענקי אישור. שירות ההרשאות מציג את מסך הכניסה ואת מסך ההרשאות בפני המשתמשים. זה מספק אסימוני גישה, רענן אסימונים, ו מקצוען של לקוחותfile נתונים להתחברות עם לקוחות אמזון.
מזהה צרור מזהה החבילה הוא מזהה ייחודי לאפליקציית iOS. הם בדרך כלל לובשים צורה של com.companyname.appname.
לָקוּחַ לקוח הוא א webאתר או אפליקציה לנייד שמשתמשים בכניסה באמצעות אמזון.
מזהה לקוח מזהה הלקוח הוא ערך שהוקצה ללקוח כאשר הם נרשמים בכניסה לאמזון. יש לו גודל מרבי של 100 בתים. מזהה הלקוח משמש בשילוב עם סוד הלקוח כדי לאמת את זהות הלקוח כאשר הם מבקשים מתן הרשאה שירות הרשאות. מזהה הלקוח אינו סודי.
קונה סוד סוד הלקוח, כמו מזהה לקוח, הוא ערך המוקצה ללקוח כאשר הם נרשמים בכניסה לאמזון. הגודל המרבי שלו הוא 64 בתים. סוד הלקוח משמש בשילוב עם מזהה הלקוח כדי לאמת את זהות הלקוח כאשר הם מבקשים aמענק אישור מה שירות הרשאות. יש לשמור על סודיות הלקוח.
מסך הסכמה כאשר משתמש נכנס לא webהאתר או האפליקציה לנייד בפעם הראשונה, יוצג בפניהם מסך הסכמה אם האפליקציה מבקשת מקצועניםfile נְתוּנִים.
מסך ההסכמה מראה את השם, תמונת לוגו file, ו הודעת פרטיות URL הקשורים לאפליקציה, יחד עם היקף גישה האפליקציה מבקשת.
מקצוען של לקוחותfile מקצוען ללקוחfile מכיל מידע על הכניסה עם הלקוח של אמזון, כולל שמו, כתובת הדוא"ל, מיקוד ומזהה ייחודי. א webהאתר חייב להשיג אסימון גישה לפני שהם יכולים להשיג מקצוען של לקוחותfile. סוג של מקצועןfile הנתונים המוחזרים נקבעים על ידי היקף גישה.
מענק מרומז מענק מרומז הוא הענקת אישור שניתן להשלים באמצעות המשתמש בלבד web דפדפן. באמצעות המענק הגלום, הדפדפן מקבל אסימון גישה כקטע URI. מענק משתמע מחייב מזהה לקוח ו- היקף גישה. המענק הגלום אינו מחזיר א אסימון רענון.
מסך הכניסה מסך הכניסה הוא דף HTML המוצג למשתמשים כאשר הם מנסים להיכנס ל- webאתר או אפליקציה לנייד באמצעות התחברות עם אמזון. משתמשים יכולים להיכנס לחשבון אמזון קיים או ליצור חשבון חדש מדף זה.
תמונת לוגו file PNG file המסופק על ידי הלקוח בעת הגדרת בַּקָשָׁה. זה מוצג במסך ההרשאות אם המשתמש לא העניק גישה ללקוח webאֲתַר. הלוגו מייצג את הלקוח webאֲתַר.
שם החבילה שם חבילה הוא מזהה ייחודי לאפליקציית Android. בדרך כלל הם לובשים צורה של com.companyname.appname.
הודעת פרטיות URL A URL המסופק על ידי הלקוח בעת הגדרת בַּקָשָׁה. זה מוצג במסך ההסכמה אם המשתמש לא העניק גישה ללקוח webאֲתַר. ה URL צריך להפנות את המשתמשים למדיניות הפרטיות של הלקוח webאֲתַר.
הפניה מחדש URL A URL המסופק על ידי הלקוח למשרד שירות הרשאות. לאחר שהמשתמש יתחבר, השירות ינתב מחדש את דפדפן המשתמש לכתובת זו. ראה גם מותר להחזיר URL.
אסימון רענון אסימון רענון מוענק על ידי ה- שירות הרשאות כאשר ה
הלקוח משתמש ב- מתן קוד הרשאה. לקוח יכול להשתמש באסימון רענון כדי לבקש אסימון גישה חדש כאשר הנוכחי אסימון גישה יפוג. הגודל המרבי של אסימונים לרענון הוא 2048 בתים. חתימה היא ערך hash של SHA-256 המוטמע באפליקציה לנייד המאמת את זהות האפליקציה. הם בדרך כלל לובשים צורה של
01:23:45:67:89:ab:cd:ef:01:23:45:67:89:ab:cd:
ef:01:23:45:67:89:ab:cd:ef:01:23:45:67:89:ab:cd:ef.
מִשׁתַמֵשׁ משתמש הוא אדם שמבקר אצל לקוח webהאתר ומנסה להיכנס באמצעות התחברות עם אמזון.
גִרְסָה גרסה היא סוג מסוים של כניסה עם לקוח אמזון הרשום ל- בַּקָשָׁה. יישום התחברות עם אמזון יכול להיות בעל מספר גרסאות, כל אחת תומכת באנדרואיד, iOS או web.
amazon התחברות עם מדריך תחילת העבודה של אמזון עבור Webאתרים - הורד [מותאם]
amazon התחברות עם מדריך תחילת העבודה של אמזון עבור Webאתרים - הורד