InteractiveBrowserCredential class

يتيح المصادقة إلى Microsoft Entra ID داخل متصفح الويب باستخدام تدفق تسجيل الدخول التفاعلي.

المنشئون

InteractiveBrowserCredential(InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)

إنشاء مثيل InteractiveBrowserCredential مع التفاصيل المطلوبة.

تستخدم بيانات الاعتماد هذهتدفق رمز التخويل . في Node.js، سيفتح نافذة مستعرض أثناء الاستماع إلى استجابة إعادة توجيه من خدمة المصادقة. في المتصفحات، يصادق عبر النوافذ المنبثقة. يمكن تعيين معامل loginStyle الاختياري إلى redirect للمصادقة عن طريق إعادة توجيه المستخدم إلى صفحة تسجيل دخول آمنة Azure، والتي ستعيد توجيه المستخدم إلى تطبيق الويب حيث بدأ المصادقة.

بالنسبة Node.js، إذا تم توفير clientId، فسيحتاج التطبيق Microsoft Entra إلى تكوين ليكون لديه نقطة نهاية لإعادة توجيه "تطبيقات الجوال وسطح المكتب". اتبع دليلنا حول إعداد عناوين URL لإعادة التوجيه لتطبيقات سطح المكتب التي تستدعي واجهات برمجة تطبيقات الويب.

الأساليب

authenticate(string | string[], GetTokenOptions)

يتم التحقق من المصادقة باستخدام معرف Microsoft Entra ID ويعيد رمز الوصول إذا نجحت. إذا فشلت المصادقة، طرح CredentialUnavailableError مع تفاصيل الفشل.

إذا تعذر استرداد الرمز المميز بصمت، فإن هذه الطريقة ستنشئ دائما تحديا للمستخدم.

على Node.js، يكون لدى هذه البيانات <>مفتاح إثبات لكود Exchange (PKCE) مفعل افتراضيا. PKCE هي ميزة أمان تخفف من هجمات اعتراض التعليمات البرمجية للمصادقة.

getToken(string | string[], GetTokenOptions)

يتم التحقق من المصادقة باستخدام معرف Microsoft Entra ID ويعيد رمز الوصول إذا نجحت. إذا فشلت المصادقة، طرح CredentialUnavailableError مع تفاصيل الفشل.

إذا قدم المستخدم الخيار disableAutomaticAuthentication، بمجرد تعذر استرداد الرمز المميز بصمت، فلن يحاول هذا الأسلوب طلب تفاعل المستخدم لاسترداد الرمز المميز.

تفاصيل المنشئ

InteractiveBrowserCredential(InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)

إنشاء مثيل InteractiveBrowserCredential مع التفاصيل المطلوبة.

تستخدم بيانات الاعتماد هذهتدفق رمز التخويل . في Node.js، سيفتح نافذة مستعرض أثناء الاستماع إلى استجابة إعادة توجيه من خدمة المصادقة. في المتصفحات، يصادق عبر النوافذ المنبثقة. يمكن تعيين معامل loginStyle الاختياري إلى redirect للمصادقة عن طريق إعادة توجيه المستخدم إلى صفحة تسجيل دخول آمنة Azure، والتي ستعيد توجيه المستخدم إلى تطبيق الويب حيث بدأ المصادقة.

بالنسبة Node.js، إذا تم توفير clientId، فسيحتاج التطبيق Microsoft Entra إلى تكوين ليكون لديه نقطة نهاية لإعادة توجيه "تطبيقات الجوال وسطح المكتب". اتبع دليلنا حول إعداد عناوين URL لإعادة التوجيه لتطبيقات سطح المكتب التي تستدعي واجهات برمجة تطبيقات الويب.

new InteractiveBrowserCredential(options: InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)

المعلمات

options

InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions

خيارات لتكوين العميل الذي يقوم بطلبات المصادقة.

تفاصيل الأسلوب

authenticate(string | string[], GetTokenOptions)

يتم التحقق من المصادقة باستخدام معرف Microsoft Entra ID ويعيد رمز الوصول إذا نجحت. إذا فشلت المصادقة، طرح CredentialUnavailableError مع تفاصيل الفشل.

إذا تعذر استرداد الرمز المميز بصمت، فإن هذه الطريقة ستنشئ دائما تحديا للمستخدم.

على Node.js، يكون لدى هذه البيانات <>مفتاح إثبات لكود Exchange (PKCE) مفعل افتراضيا. PKCE هي ميزة أمان تخفف من هجمات اعتراض التعليمات البرمجية للمصادقة.

function authenticate(scopes: string | string[], options?: GetTokenOptions): Promise<undefined | AuthenticationRecord>

المعلمات

scopes

string | string[]

قائمة النطاقات التي سيكون للرمز المميز حق الوصول إليها.

options
GetTokenOptions

الخيارات المستخدمة لتكوين أي طلبات قد يقدمها تطبيق TokenCredential هذا.

المرتجعات

Promise<undefined | AuthenticationRecord>

getToken(string | string[], GetTokenOptions)

يتم التحقق من المصادقة باستخدام معرف Microsoft Entra ID ويعيد رمز الوصول إذا نجحت. إذا فشلت المصادقة، طرح CredentialUnavailableError مع تفاصيل الفشل.

إذا قدم المستخدم الخيار disableAutomaticAuthentication، بمجرد تعذر استرداد الرمز المميز بصمت، فلن يحاول هذا الأسلوب طلب تفاعل المستخدم لاسترداد الرمز المميز.

function getToken(scopes: string | string[], options?: GetTokenOptions): Promise<AccessToken>

المعلمات

scopes

string | string[]

قائمة النطاقات التي سيكون للرمز المميز حق الوصول إليها.

options
GetTokenOptions

الخيارات المستخدمة لتكوين أي طلبات قد يقدمها تطبيق TokenCredential هذا.

المرتجعات

Promise<AccessToken>