InteractiveBrowserCredential class
تمكين المصادقة من Microsoft Entra ID داخل مستعرض الويب باستخدام تدفق تسجيل الدخول التفاعلي.
المنشئون
Interactive |
إنشاء مثيل InteractiveBrowserCredential مع التفاصيل المطلوبة. تستخدم بيانات الاعتماد هذه تدفق رمز التخويل.
في Node.js، سيفتح نافذة مستعرض أثناء الاستماع إلى استجابة إعادة توجيه من خدمة المصادقة.
في المستعرضات، يصادق عبر النوافذ المنبثقة. بالنسبة إلى Node.js، إذا |
الأساليب
authenticate(string | string[], Get |
المصادقة باستخدام Microsoft Entra ID وإرجاع رمز مميز للوصول إذا كان ناجحا. إذا فشلت المصادقة، فسيتم طرح CredentialUnavailableError مع تفاصيل الفشل. إذا تعذر استرداد الرمز المميز بصمت، فسيتطلب هذا الأسلوب تفاعل المستخدم لاسترداد الرمز المميز. في Node.js، تحتوي بيانات الاعتماد هذه على مفتاح إثبات ل Exchange التعليمات البرمجية (PKCE) ممكن افتراضيا. PKCE هي ميزة أمان تخفف من هجمات اعتراض رمز المصادقة. |
get |
المصادقة باستخدام Microsoft Entra ID وإرجاع رمز مميز للوصول إذا كان ناجحا. إذا فشلت المصادقة، فسيتم طرح CredentialUnavailableError مع تفاصيل الفشل. إذا قدم المستخدم الخيار |
تفاصيل المنشئ
InteractiveBrowserCredential(InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)
إنشاء مثيل InteractiveBrowserCredential مع التفاصيل المطلوبة.
تستخدم بيانات الاعتماد هذه تدفق رمز التخويل.
في Node.js، سيفتح نافذة مستعرض أثناء الاستماع إلى استجابة إعادة توجيه من خدمة المصادقة.
في المستعرضات، يصادق عبر النوافذ المنبثقة. loginStyle
يمكن تعيين المعلمة الاختيارية إلى redirect
للمصادقة عن طريق إعادة توجيه المستخدم إلى صفحة تسجيل دخول آمنة في Azure، والتي ستقوم بعد ذلك بإعادة توجيه المستخدم مرة أخرى إلى تطبيق الويب حيث بدأت المصادقة.
بالنسبة إلى Node.js، إذا clientId
تم توفير، فسيلزم تكوين تطبيق Microsoft Entra للحصول على نقطة نهاية إعادة توجيه "تطبيقات الأجهزة المحمولة وسطح المكتب".
اتبع دليلنا حول إعداد عناوين URL لإعادة التوجيه لتطبيقات سطح المكتب التي تستدعي واجهات برمجة تطبيقات الويب.
new InteractiveBrowserCredential(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>