עכשיו WebOTP API יכול לקבל סיסמאות חד-פעמיות מתוך מסגרות iframe.
סיסמאות חד-פעמיות (OTP) ב-SMS משמשות בדרך כלל לאימות מספרי טלפון, למשל כשלב שני באימות או לאימות תשלומים באינטרנט. עם זאת, המעבר בין הדפדפן לאפליקציית סמס כדי להעתיק ולהדביק או להזין ידנית את ה-OTP, עלול לגרום לטעויות ולהפריע לחוויית שימוש.
WebOTP API מאפשר לאתרים לקבל באופן פרוגרמטי את הסיסמה החד-פעמית מהודעת SMS ולהזין אותה באופן אוטומטי בטופס למשתמשים בלחיצה אחת, בלי להחליף אפליקציה. הודעת ה-SMS בפורמט מיוחד וקשורה למקור, כך שהיא גם מפחיתה את הסיכויים שאתרי פישינג יגנבו את הסיסמה החד-פעמית.
תרחיש שימוש אחד שעדיין לא נתמך ב-WebOTP היה טירגוט מקור בתוך iframe. בדרך כלל, משתמשים בזה לאישור תשלום, במיוחד עם 3D Secure. בזכות הפורמט הנפוץ לתמיכה ב-iframes ממקורות שונים, WebOTP API מספק עכשיו סיסמאות חד-פעמיות שקשורות למקורות בתצוגת עץ, החל מגרסה 91 של Chrome.
איך WebOTP API פועל
WebOTP API עצמו פשוט מספיק:
…
const otp = await navigator.credentials.get({
otp: { transport:['sms'] }
});
…
הודעת ה-SMS חייבת להיות בפורמט של קודים חד-פעמיים שקשורים למקור.
Your OTP is: 123456.
@web-otp.example.com #12345
שימו לב שבשורה האחרונה מופיע מקור הקישור, ולפניו @, ואחריו מופיעה הסיסמה החד-פעמית, ולפניה #.
כשהודעת ה-SMS מגיעה, מופיע סרגל מידע שמבקש מהמשתמש לאמת את מספר הטלפון שלו. אחרי שהמשתמש לוחץ על הכפתור Verify, הדפדפן מעביר באופן אוטומטי את הסיסמה החד-פעמית לאתר ופותר את ה-navigator.credentials.get(). לאחר מכן, האתר יכול לחלץ את ה-OTP ולהשלים את תהליך האימות.
במאמר אימות מספרי טלפון באינטרנט באמצעות WebOTP API מוסבר איך להשתמש ב-WebOTP.
תרחישים לדוגמה של רכיבי iframe ממקורות שונים
הזנת סיסמה חד-פעמית בטופס ב-iframe ממקורות שונים היא פעולה נפוצה בתרחישי תשלום. חלק ממנפיקי כרטיסי האשראי דורשים שלב אימות נוסף כדי לבדוק את האותנטיות של המשלם. התהליך הזה נקרא 3D Secure, והטופס בדרך כלל מוצג ב-iframe באותו דף, כאילו הוא חלק מתהליך התשלום.
לדוגמה:
- משתמש נכנס לאתר
shop.exampleכדי לקנות זוג נעליים באמצעות כרטיס אשראי. - אחרי שמזינים את מספר כרטיס האשראי, ספק התשלומים המשולב מציג טופס של
bank.exampleב-iframe, שבו המשתמש מתבקש לאמת את מספר הטלפון שלו כדי לשלם במהירות. -
bank.exampleשולחת למשתמש הודעת SMS עם סיסמה חד-פעמית (OTP) כדי שהוא יוכל להזין אותה ולאמת את הזהות שלו.
איך משתמשים ב-WebOTP API מ-iframe ממקורות שונים
כדי להשתמש ב-WebOTP API מתוך iframe ממקורות שונים, צריך לבצע שתי פעולות:
- מוסיפים הערה גם למקור של המסגרת העליונה וגם למקור של ה-iframe בהודעת ה-SMS.
- מגדירים מדיניות הרשאות שמאפשרת ל-iframe ממקורות שונים לקבל את הסיסמה החד-פעמית ישירות מהמשתמש.
אתם יכולים לנסות את ההדגמה בעצמכם בכתובת https://web-otp-iframe-demo.stackblitz.io.
הוספת הערות לגבי מקורות קשורים להודעת ה-SMS
כשמתבצעת קריאה ל-WebOTP API מתוך iframe, הודעת ה-SMS חייבת לכלול את המקור של המסגרת העליונה, לפניו @ ואחריו ה-OTP, לפניו # ואחריו המקור של ה-iframe, לפניו @.
@shop.example #123456 @bank.exmple
הגדרת מדיניות ההרשאות
כדי להשתמש ב-WebOTP ב-iframe ממקורות שונים, המטמיע צריך לתת גישה ל-API הזה דרך מדיניות ההרשאות של otp-credentials כדי למנוע התנהגות לא מכוונת. באופן כללי, יש שתי דרכים להשיג את המטרה הזו:
- באמצעות כותרת HTTP:
Permissions-Policy: otp-credentials=(self "https://bank.example")
- באמצעות המאפיין
allowשל iframe:
<iframe src="https://bank.example/…" allow="otp-credentials"></iframe>
דוגמאות נוספות להגדרת מדיניות הרשאות
נקודות שצריך לשים לב אליהן:
רמות הסידור הפנימי
נכון לעכשיו, Chrome תומך רק בקריאות ל-WebOTP API מ-iframes ממקורות שונים שיש להם לא יותר ממקור ייחודי אחד בשרשרת האבות הקדמונים שלהם. בתרחישים הבאים:
- a.com -> b.com
- a.com -> b.com -> b.com
- a.com -> a.com -> b.com
- a.com -> b.com -> c.com
אפשר להשתמש ב-WebOTP ב-b.com אבל לא ב-c.com.
חשוב לדעת: התרחיש הבא גם לא נתמך בגלל חוסר ביקוש ומורכבות של חוויית המשתמש.
- a.com -> b.com -> a.com (מבצע קריאה ל-WebOTP API)
יכולת פעולה הדדית
מנועי דפדפן אחרים, מלבד Chromium, לא מטמיעים את WebOTP API, אבל Safari משתף את אותו פורמט SMS עם התמיכה שלו ב-input[autocomplete="one-time-code"]. ב-Safari, ברגע שמגיעה הודעת SMS שמכילה קוד חד-פעמי בפורמט שקשור למקור, עם המקור התואם, המקלדת מציעה להזין את ה-OTP בשדה להזנת קלט.
החל מאפריל 2021, דפדפן Safari תומך ב-iframe עם פורמט SMS ייחודי באמצעות %.
עם זאת, מכיוון שבדיון על המפרט הוחלט להשתמש במקום זאת ב-@, אנחנו מקווים שההטמעה של פורמט ה-SMS הנתמך תתכנס.
משוב
המשוב שלכם חשוב מאוד לשיפור WebOTP API, אז נסו אותו וספרו לנו מה דעתכם.