مصادقة الطلبات في AMP للبريد الإلكتروني

غالبًا ما يتطلب محتوى الرسائل الإلكترونية المخصّصة الديناميكي مصادقة المستخدم. مع ذلك، لحماية بيانات المستخدمين، يتم إرسال جميع طلبات HTTP من داخل الرسائل الإلكترونية بتنسيق AMP. داخل Gmail عبر خادم وكيل وملفات تعريف الارتباط.

لمصادقة الطلبات المقدمة من رسائل البريد الإلكتروني التي تستخدم تكنولوجيا AMP، يمكنك استخدام رموز الدخول.

رموز الدخول

يمكنك استخدام رموز الدخول لمصادقة المستخدم. رموز الدخول هي التي تم تقديمها وفحصها من قبل مرسل البريد الإلكتروني. يستخدم المرسِل الرموز المميّزة للتأكّد من لا يمكن لأحد سوى المستخدمين الذين لديهم إذن الوصول إلى عنوان البريد الإلكتروني لصفحات AMP تنفيذ الطلبات داخل رسالة البريد الإلكتروني هذه. يجب أن تكون رموز الدخول آمنة من ناحية التشفير وأن تكون متوافقة مع الوقت محدودة النطاق. ويتم تضمينها في عنوان URL للطلب.

يوضح هذا المثال استخدام <amp-list> لعرض البيانات التي تمت مصادقتها:

<amp-list src="https://example.com/endpoint?token=REPLACE_WITH_YOUR_ACCESS_TOKEN"
  height="300">
  <template type="amp-mustache">
    ...
  </template>
</amp-list>

وبالمثل عند استخدام <amp-form>، ضَع رمز الدخول في action-xhr. عنوان URL.

<form action-xhr="https://example.com/endpoint?token=REPLACE_WITH_YOUR_ACCESS_TOKEN" method="post">
  <input type="text" name="data">
  <input type="submit" value="Send">
</form>

ملاحظة: عادةً ما تزيل برامج البريد الإلكتروني جزء MIME في AMP عند الرد / إلى الأمام.

إضافةً إلى ذلك، يعتبر Gmail أن جزء AMP قابلاً للاستخدام لمدة 30 يومًا فقط بعد أن يصبح جزءًا من صفحات AMP. تلقّيتها، لذا يجب ضبط فترة صلاحية رمز الدخول على 31 يومًا.

مثال

يأخذ المثال التالي في الاعتبار خدمة تدوين ملاحظات افتراضية تتيح تسجيل دخول المستخدمين لإضافة ملاحظات إلى حساباتهم وعرضها لاحقًا. الخدمة يريد إرسال رسالة إلكترونية إلى مستخدم، [e-mail]، تتضمن قائمة الملاحظات التي دوّنها سابقًا. تتوفر قائمة بملاحظات المستخدم الحالي في نقطة النهاية https://example.com/personal-notes بتنسيق JSON.

قبل إرسال الرسالة الإلكترونية، تنشئ الخدمة أداة تشفير آمن رمز دخول محدود الاستخدام إلى [e-mail]: A3a4roX9x. رمز الدخول هو في اسم الحقل exampletoken داخل استعلام عنوان URL:

<amp-list src="https://example.com/personal-notes?exampletoken=A3a4roX9x" height="300">
  <template type="amp-mustache">
    <p>{{note}}</p>
  </template>
</amp-list>

نقطة النهاية https://example.com/personal-notes مسؤولة عن التحقّق من الصحة المَعلمة exampletoken والعثور على المستخدم المرتبط بالرمز المميّز

لمزيد من المعلومات، يُرجى مراجعة رموز الدخول المحدودة الاستخدام:

ملاحظة: يمكن لتطبيق الويب التقليدي إرسال طلب بحث إلى نقطة نهاية ملاحظات المستخدم باستخدام XMLHttpRequest (XHR)، ويمكن أن يوفر ملف تعريف الارتباط نقطة النهاية وهوية المستخدم. في المقابل، لا تعمل هذه الطريقة في صفحات AMP للبريد الإلكتروني يتم إخفاء هوية كل طلبات HTTP في الرسائل الإلكترونية لصفحات AMP في Gmail. بدلاً من ذلك، يجب أن تحديد هوية المستخدم في عنوان URL نفسه.