InteractiveBrowserCredential class

الحزمة:

@azure/identity

تمكين المصادقة إلى معرف Microsoft Entra داخل مستعرض الويب باستخدام تدفق تسجيل الدخول التفاعلي.

المنشئون

InteractiveBrowserCredential(InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)

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

الأساليب

authenticate(string | string[], GetTokenOptions)	المصادقة باستخدام معرف Microsoft Entra وإرجاع رمز مميز للوصول إذا كان ناجحا. إذا فشلت المصادقة، طرح CredentialUnavailableError مع تفاصيل الفشل. إذا تعذر استرداد الرمز المميز بصمت، فإن هذه الطريقة ستنشئ دائما تحديا للمستخدم. في Node.js، تحتوي بيانات الاعتماد هذه على مفتاح إثبات تمكين تبادل التعليمات البرمجية (PKCE) بشكل افتراضي. PKCE هي ميزة أمان تخفف من هجمات اعتراض التعليمات البرمجية للمصادقة.
getToken(string | string[], GetTokenOptions)	المصادقة باستخدام معرف Microsoft Entra وإرجاع رمز مميز للوصول إذا كان ناجحا. إذا فشلت المصادقة، طرح CredentialUnavailableError مع تفاصيل الفشل. إذا قدم المستخدم الخيار disableAutomaticAuthentication، بمجرد تعذر استرداد الرمز المميز بصمت، فلن يحاول هذا الأسلوب طلب تفاعل المستخدم لاسترداد الرمز المميز.

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

InteractiveBrowserCredential(InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)

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

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

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

TypeScript

new InteractiveBrowserCredential(options: InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions)

المعلمات

options

InteractiveBrowserCredentialNodeOptions | InteractiveBrowserCredentialInBrowserOptions

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

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

authenticate(string | string[], GetTokenOptions)

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

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

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

TypeScript

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 وإرجاع رمز مميز للوصول إذا كان ناجحا. إذا فشلت المصادقة، طرح CredentialUnavailableError مع تفاصيل الفشل.

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

TypeScript

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

المعلمات

scopes

string | string[]

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

options

GetTokenOptions

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

المرتجعات

Promise<AccessToken>