إدارة دورة حياة اشتراك SaaS
يدير السوق التجاري دورة الحياة الكاملة لاشتراك SaaS بعد شرائه من قبل المستخدم النهائي. يستخدم الصفحة المقصودة وواجهات برمجة تطبيقات التنفيذ وواجهات برمجة تطبيقات العمليات وخطاف الويب كآلية لدفع تنشيط اشتراك SaaS الفعلي واستخدامه وتحديثاته وإلغائه. تستند فاتورة المستخدم النهائي إلى حالة اشتراك SaaS الذي تحتفظ به Microsoft.
حالات اشتراك SaaS
يوضح الرسم التخطيطي التالي حالات اشتراك SaaS والإجراءات القابلة للتطبيق.
تم شراؤها ولكن لم يتم تفعيلها بعد (معلقةFulfillmentStart)
بعد أن يشتري المستخدم النهائي أو موفر الحلول السحابية (CSP) عرض SaaS في السوق التجارية، يتم إخطار الناشر بعملية الشراء. يمكن للناشر بعد ذلك إنشاء حساب SaaS جديد وتكوينه على جانب الناشر للمستخدم النهائي.
لإنشاء الحساب:
- يحدد العميل الزر تكوين الحساب الآن المتوفر لعرض SaaS بعد شرائه بنجاح في Microsoft AppSource أو مدخل Azure. بدلا من ذلك ، يمكن للعميل استخدام الزر تكوين الآن في البريد الإلكتروني الذي سيتلقاه بعد فترة وجيزة من الشراء.
- ثم تقوم Microsoft بإعلام الشريك بعملية الشراء عن طريق فتح عنوان URL للصفحة المقصودة باستخدام معلمة الرمز المميز (الرمز المميز لتعريف الشراء من السوق التجارية) في علامة تبويب المستعرض الجديد.
مثال على هذه المكالمة هو https://contoso.com/signup?token=<blob>، ولكن يتم تكوين عنوان URL للصفحة المقصودة لعرض SaaS هذا في مركز الشركاء على أنه https://contoso.com/signup. يوفر هذا الرمز المميز للناشر معرفا يحدد بشكل فريد عملية شراء SaaS والعميل.
تلميح
لا تقم بتضمين حرف علامة الجنيه (#) في عنوان URL للصفحة المقصودة. خلاف ذلك ، لن يتمكن العملاء من الوصول إلى صفحتك المقصودة.
هام
يجب أن يكون عنوان URL للصفحة المقصودة جاهزا للعمل طوال اليوم وكل يوم وجاهزا لتلقي مكالمات جديدة من Microsoft في جميع الأوقات. إذا أصبحت الصفحة المقصودة غير متوفرة ، فلن يتمكن العملاء من الاشتراك في خدمة SaaS والبدء في استخدامها.
بعد ذلك ، يجب على الناشر تمرير الرمز المميز مرة أخرى إلى Microsoft عن طريق استدعاء واجهة برمجة تطبيقات SaaS Resolve ، وإدخال الرمز المميز كقيمة للمعلمةx-ms-marketplace-token header. نتيجة لاستدعاء واجهة برمجة تطبيقات Resolve ، يتم استبدال الرمز المميز بتفاصيل شراء SaaS مثل المعرف الفريد لعملية الشراء ومعرف العرض الذي تم شراؤه ومعرف الخطة الذي تم شراؤه.
في الصفحة المقصودة، يجب تسجيل دخول العميل إلى حساب SaaS الجديد أو الحالي عبر Azure Active Directory (Azure AD) تسجيل الدخول الأحادي (SSO).
ملاحظة
لن يتم إعلام الناشر بشراء SaaS حتى يبدأ العميل عملية التكوين من جانب Microsoft.
يجب على الناشر تنفيذ الدخول الموحد (SSO) لتوفير تجربة المستخدم التي تتطلبها Microsoft لهذا التدفق. تأكد من استخدام تطبيق Azure AD متعدد المستأجرين والسماح بكل من حسابات العمل والمؤسسة التعليمية أو حسابات Microsoft الشخصية عند تكوين الدخول الموحد (SSO). ينطبق هذا المطلب فقط على الصفحة المقصودة، للمستخدمين الذين تتم إعادة توجيههم إلى خدمة SaaS عند تسجيل الدخول بالفعل باستخدام بيانات اعتماد Microsoft. الدخول الموحد (SSO) غير مطلوب لجميع عمليات تسجيل الدخول إلى خدمة SaaS.
ملاحظة
إذا تطلب الدخول الموحد (SSO) أن يمنح المسؤول إذنا لأحد التطبيقات، فيجب أن يكشف وصف العرض في "مركز الشركاء" عن ضرورة الوصول على مستوى المسؤول. ويهدف هذا الإفصاح إلى الامتثال لسياسات إصدار الشهادات في السوق التجارية.
بعد تسجيل الدخول، يجب على العميل إكمال تكوين SaaS على جانب الناشر. ثم يجب على الناشر الاتصال ب تنشيط واجهة برمجة تطبيقات الاشتراك لإرسال إشارة إلى Azure Marketplace اكتمال توفير حساب SaaS. سيؤدي هذا الإجراء إلى بدء دورة الفوترة الخاصة بالعميل. إذا لم تنجح مكالمة تنشيط واجهة برمجة تطبيقات الاشتراك، فلن تتم فوترة العميل مقابل عملية الشراء.
نشط (مشترك)
نشط (مشترك) هو الحالة الثابتة لاشتراك SaaS المقدم. بعد أن يقوم جانب Microsoft بمعالجة استدعاء تنشيط واجهة برمجة تطبيقات الاشتراك ، يتم وضع علامة على اشتراك SaaS على أنه مشترك. يمكن للعميل الآن استخدام خدمة SaaS من جانب الناشر وسيتم إصدار فاتورة له.
عندما يكون اشتراك SaaS نشطا بالفعل، يمكن للعميل تحديد إدارة تجربة SaaS من مدخل Azure أو مركز مسؤول Microsoft 365. يؤدي هذا الإجراء أيضا إلى قيام Microsoft باستدعاء عنوان URL للصفحة المقصودة باستخدام معلمة الرمز المميز ، كما يحدث في تدفق التنشيط. يجب على الناشر التمييز بين عمليات الشراء الجديدة وإدارة حسابات SaaS الحالية ، والتعامل مع مكالمة عنوان URL للصفحة المقصودة هذه وفقا لذلك.
يجري تحديثه (مشترك)
يعني هذا الإجراء أنه تتم معالجة تحديث لاشتراك SaaS نشط موجود بواسطة كل من Microsoft والناشر. ويمكن الشروع في هذا التحديث من خلال:
- العميل من السوق التجارية.
- الطاقة الشمسية المركزة من السوق التجارية.
- العميل من موقع SaaS الخاص بالناشر (ولكن ليس لعمليات الشراء التي تتم بواسطة CSP).
يتوفر نوعان من التحديثات لاشتراك SaaS:
- قم بتحديث الخطة عندما يختار العميل خطة أخرى للاشتراك.
- تحديث الكمية عندما يقوم العميل بتغيير عدد المقاعد المشتراة للاشتراك.
يمكن تحديث الاشتراك النشط فقط. أثناء تحديث الاشتراك ، تظل حالته نشطة على جانب Microsoft.
التحديث الذي بدأ من السوق التجارية
في هذا التدفق، يغير العميل خطة الاشتراك أو كمية المقاعد من مدخل Azure أو مركز مسؤول Microsoft 365.
- بعد إدخال تحديث، ستقوم Microsoft باستدعاء عنوان URL لخطاف الويب الخاص بالناشر، والذي تم تكوينه في حقل خطاف ويب الاتصال في صفحة التكوين الفني في "مركز الشركاء"، مع قيمة مناسبة للإجراء والمعلمات الأخرى ذات الصلة.
- يجب على جانب الناشر إجراء التغييرات المطلوبة على خدمة SaaS، وإخطار Microsoft عند الانتهاء عن طريق استدعاء تحديث حالة واجهة برمجة تطبيقات التشغيل.
- إذا تم إرسال التصحيح بحالة فشل ، فلن تنتهي عملية التحديث على جانب Microsoft. سيحافظ اشتراك SaaS على الخطة الحالية وكمية المقاعد.
ملاحظة
يجب على الناشر استدعاء PATCH لتحديث واجهة برمجة تطبيقات حالة التشغيل باستجابة فشل/نجاح خلال فترة زمنية مدتها 10 ثوان بعد تلقي إشعار webhook. إذا لم يتم استلام PATCH لحالة العملية خلال 10 ثوان ، تصحيح خطة التغيير تلقائيا كنجاح.
يتم عرض تسلسل استدعاء واجهة برمجة التطبيقات لسيناريو تحديث تم إطلاقه من السوق التجاري في الرسم التخطيطي التالي.
التحديث الذي تم إطلاقه من الناشر
في هذا التدفق ، يغير العميل خطة الاشتراك أو كمية المقاعد المشتراة من خدمة SaaS نفسها.
قبل إجراء التغيير المطلوب على جانب الناشر، يجب أن تستدعي شفرة الناشر واجهة برمجة تطبيقات خطة التغيير أو واجهة برمجة تطبيقاتتغيير الكمية أو كليهما.
ستقوم Microsoft بتطبيق التغيير على الاشتراك، ثم إعلام الناشر عبر Connection webhook لتطبيق نفس التغيير.
عندها فقط يجب على الناشر إجراء التغيير المطلوب على اشتراك SaaS ، وإخطار Microsoft عند إجراء التغيير عن طريق استدعاء تحديث حالة واجهة برمجة تطبيقات التشغيل.
يتم عرض تسلسل استدعاء واجهة برمجة التطبيقات لسيناريو تحديث تم إطلاقه من جانب الناشر في الرسم التخطيطي التالي.
معلق (معلق)
تشير هذه الحالة إلى أنه لم يتم استلام دفعة العميل مقابل خدمة SaaS. ستقوم Microsoft بإخطار الناشر بهذا التغيير في حالة اشتراك SaaS. يتم الإشعار عبر مكالمة إلى webhook مع تعيين معلمة الإجراء إلى معلقة.
قد يقوم الناشر أو لا يقوم بإجراء تغييرات على خدمة SaaS على جانب الناشر. نوصي بأن يتيح الناشر هذه المعلومات للعميل المعلق ويحد من وصول العميل إلى خدمة SaaS أو يحظره. هناك احتمال ألا يتم استلام الدفعة أبدا.
ملاحظة
تمنح Microsoft العميل فترة سماح مدتها 30 يوما قبل إلغاء الاشتراك تلقائيا. بعد انتهاء فترة السماح لمدة 30 يوما ، سيتلقى webhook إجراء Unsubscribe .
عندما يكون الاشتراك في حالة تعليق التشغيل :
- يجب على الشريك أو مورد البرامج المستقل الاحتفاظ بحساب SaaS في حالة قابلة للاسترداد ، بحيث يمكن استعادة الوظائف الكاملة دون أي فقدان للبيانات أو الإعدادات.
- يجب أن يتوقع الشريك أو مورد البرامج المستقل (ISV) طلبا لإعادة الاشتراك، إذا تم استلام الدفعة خلال فترة السماح، أو طلبا لإلغاء تقديم الاشتراك في نهاية فترة السماح. سيتم إرسال كلا الطلبين عبر آلية webhook.
يتم تغيير حالة الاشتراك إلى معلق على جانب Microsoft قبل أن يتخذ الناشر أي إجراء. يمكن تعليق الاشتراكات النشطة فقط.
أعيد العمل (مع وقف التنفيذ)
يشير هذا الإجراء إلى أن أداة الدفع الخاصة بالعميل أصبحت صالحة مرة أخرى ، وتم إجراء دفعة مقابل اشتراك SaaS ، ويتم إعادة الاشتراك. في هذه الحالة:
- تستدعي Microsoft webhook مع تعيين معلمة إجراء إلى قيمة إعادة التشغيل.
- يتأكد الناشر من أن الاشتراك يعمل بكامل طاقته مرة أخرى على جانب الناشر.
- يستدعي الناشر واجهة برمجة تطبيقات عملية التصحيح بحالة النجاح.
- عملية الإعادة ناجحة ويتم فوترة العميل مرة أخرى لاشتراك SaaS.
إذا تم إرسال التصحيح بحالة فشل ، فلن تنتهي عملية الإعادة على جانب Microsoft وسيظل الاشتراك معلقا.
يمكن إعادة الاشتراك المعلق فقط. يظل اشتراك SaaS المعلق في حالة معلقة أثناء إعادته. بعد انتهاء هذه العملية، ستصبح حالة الاشتراك نشطة.
متجدد (مشترك)
يتم تجديد اشتراك SaaS تلقائيا بواسطة Microsoft في نهاية مدة الاشتراك البالغة شهرا أو سنة. ينطبق الإعداد الافتراضي لإعداد التجديد التلقائي على جميع اشتراكات SaaS. سيستمر تجديد اشتراكات SaaS النشطة بإيقاع منتظم. توفر Microsoft إعلامات webhook للإعلام فقط لتجديد الأحداث. يمكن للعميل إيقاف تشغيل التجديد التلقائي لاشتراك SaaS عبر بوابة مسؤول Microsoft 365. في هذه الحالة ، سيتم إلغاء اشتراك SaaS تلقائيا في نهاية مدة الفوترة الحالية. يمكن للعملاء أيضا إلغاء اشتراك SaaS في أي وقت.
يتم تجديد الاشتراكات النشطة فقط تلقائيا. تظل الاشتراكات نشطة أثناء عملية التجديد، وإذا نجح التجديد التلقائي. بعد التجديد، يتم تحديث تاريخي البدء والانتهاء من مدة الاشتراك إلى تواريخ المدة الجديدة.
إذا فشل التجديد التلقائي بسبب مشكلة في الدفع، تعليق الاشتراك وسيتم إخطار الناشر.
ملغى (غير مشترك)
تصل الاشتراكات إلى هذه الحالة استجابة لإجراء صريح من العميل أو CSP عن طريق إلغاء اشتراك من موقع الناشر أو مدخل Azure أو مركز مسؤول Microsoft 365. يمكن أيضا إلغاء الاشتراك ضمنيا ، نتيجة لعدم دفع المستحقات ، بعد أن يكون في حالة التعليق لمدة 30 يوما.
بعد أن يتلقى الناشر مكالمة ويب هوك للإلغاء، يجب عليه الاحتفاظ ببيانات العميل لاستردادها عند الطلب لمدة سبعة أيام على الأقل. عندها فقط يمكن حذف بيانات العملاء.
يمكن إلغاء اشتراك SaaS في أي وقت من دورة حياته. بعد إلغاء الاشتراك، لا يمكن إعادة تنشيطه.