InteractiveBrowserCredentialInBrowserOptions interface
يحدد الخيارات الشائعة لفئة InteractiveBrowserCredential.
- Extends
الخصائص
client |
معرف العميل (التطبيق) لتسجيل التطبيق في المستأجر. هذه المعلمة مطلوبة على المستعرض. |
login |
يسمح loginHint بتحديد اسم المستخدم مسبقا لتسجيلات الدخول التفاعلية. يؤدي تعيين هذا الخيار إلى تخطي مطالبة تحديد الحساب ومحاولة تسجيل الدخول على الفور باستخدام الحساب المحدد. |
login |
يحدد ما إذا كان يجب استخدام إعادة توجيه أو نافذة منبثقة لبدء تدفق مصادقة المستخدم. القيم المحتملة هي "إعادة توجيه" أو "منبثقة" (افتراضي) للمستعرض و"منبثقة" (افتراضي) للعقدة. |
redirect |
يحصل على عنوان URI لإعادة التوجيه للتطبيق. يجب أن يكون هذا هو نفس القيمة في مدخل تسجيل التطبيق. الإعدادات الافتراضية لـ |
tenant |
معرف المستأجر (الدليل) Microsoft Entra. |
الخصائص الموروثة
additionally |
بالنسبة للتطبيقات متعددة المستأجرين، يحدد المستأجرين الإضافيين الذين قد تحصل بيانات الاعتماد على رموز مميزة لها. أضف قيمة حرف البدل "*" للسماح لبيانات الاعتماد بالحصول على رموز مميزة لأي مستأجر تم تثبيت التطبيق عليه. |
additional |
نهج إضافية لتضمينها في البنية الأساسية لبرنامج ربط العمليات التجارية HTTP. |
allow |
تعيين إلى صحيح إذا تم إرسال الطلب عبر HTTP بدلا من HTTPS |
authentication |
نتيجة مصادقة سابقة يمكن استخدامها لاسترداد بيانات الاعتماد المخزنة مؤقتا لكل حساب فردي. هذا ضروري لتوفير في حالة أراد التطبيق العمل مع أكثر من حساب واحد لكل زوج معرف العميل ومعرف المستأجر. يمكن استرداد هذا السجل عن طريق استدعاء أسلوب بيانات الاعتماد
|
authority |
مضيف المرجع لاستخدامه لطلبات المصادقة. تتوفر القيم المحتملة من خلال AzureAuthorityHosts. الافتراضي هو "https://login.microsoftonline.com". |
disable |
يجعل getToken يطرح إذا كانت المصادقة اليدوية ضرورية.
سيحتاج المطورون إلى الاتصال بالتحكم |
disable |
يحدد الحقل ما إذا كان يتم تنفيذ اكتشاف المثيل عند محاولة المصادقة.
سيؤدي تعيين هذا إلى إلى |
http |
HttpClient الذي سيتم استخدامه لإرسال طلبات HTTP. |
logging |
يسمح للمستخدمين بتكوين إعدادات خيارات نهج التسجيل، والسماح بمعلومات حساب التسجيل ومعلومات التعريف الشخصية لدعم العملاء. |
proxy |
خيارات لتكوين وكيل للطلبات الصادرة. |
redirect |
خيارات لكيفية معالجة استجابات إعادة التوجيه. |
retry |
الخيارات التي تتحكم في كيفية إعادة محاولة الطلبات الفاشلة. |
telemetry |
خيارات لتعيين معلومات القياس عن بعد والتتبع الشائعة للطلبات الصادرة. |
tls |
خيارات لتكوين مصادقة TLS |
user |
خيارات لإضافة تفاصيل عامل المستخدم إلى الطلبات الصادرة. |
تفاصيل الخاصية
clientId
معرف العميل (التطبيق) لتسجيل التطبيق في المستأجر. هذه المعلمة مطلوبة على المستعرض.
clientId: string
قيمة الخاصية
string
loginHint
يسمح loginHint بتحديد اسم المستخدم مسبقا لتسجيلات الدخول التفاعلية. يؤدي تعيين هذا الخيار إلى تخطي مطالبة تحديد الحساب ومحاولة تسجيل الدخول على الفور باستخدام الحساب المحدد.
loginHint?: string
قيمة الخاصية
string
loginStyle
يحدد ما إذا كان يجب استخدام إعادة توجيه أو نافذة منبثقة لبدء تدفق مصادقة المستخدم. القيم المحتملة هي "إعادة توجيه" أو "منبثقة" (افتراضي) للمستعرض و"منبثقة" (افتراضي) للعقدة.
loginStyle?: BrowserLoginStyle
قيمة الخاصية
redirectUri
يحصل على عنوان URI لإعادة التوجيه للتطبيق. يجب أن يكون هذا هو نفس القيمة في مدخل تسجيل التطبيق. الإعدادات الافتراضية لـ window.location.href
.
لم يعد هذا الحقل مطلوبا Node.js.
redirectUri?: string | () => string
قيمة الخاصية
string | () => string
tenantId
معرف المستأجر (الدليل) Microsoft Entra.
tenantId?: string
قيمة الخاصية
string
تفاصيل الخاصية الموروثة
additionallyAllowedTenants
بالنسبة للتطبيقات متعددة المستأجرين، يحدد المستأجرين الإضافيين الذين قد تحصل بيانات الاعتماد على رموز مميزة لها. أضف قيمة حرف البدل "*" للسماح لبيانات الاعتماد بالحصول على رموز مميزة لأي مستأجر تم تثبيت التطبيق عليه.
additionallyAllowedTenants?: string[]
قيمة الخاصية
string[]
موروث منInteractiveCredentialOptions.additionallyAllowedTenants
additionalPolicies
نهج إضافية لتضمينها في البنية الأساسية لبرنامج ربط العمليات التجارية HTTP.
additionalPolicies?: AdditionalPolicyConfig[]
قيمة الخاصية
allowInsecureConnection
تعيين إلى صحيح إذا تم إرسال الطلب عبر HTTP بدلا من HTTPS
allowInsecureConnection?: boolean
قيمة الخاصية
boolean
موروث منInteractiveCredentialOptions.allowInsecureConnection
authenticationRecord
نتيجة مصادقة سابقة يمكن استخدامها لاسترداد بيانات الاعتماد المخزنة مؤقتا لكل حساب فردي. هذا ضروري لتوفير في حالة أراد التطبيق العمل مع أكثر من حساب واحد لكل زوج معرف العميل ومعرف المستأجر.
يمكن استرداد هذا السجل عن طريق استدعاء أسلوب بيانات الاعتماد authenticate()
، كما يلي:
const authenticationRecord = await credential.authenticate();
authenticationRecord?: AuthenticationRecord
قيمة الخاصية
authorityHost
مضيف المرجع لاستخدامه لطلبات المصادقة. تتوفر القيم المحتملة من خلال AzureAuthorityHosts. الافتراضي هو "https://login.microsoftonline.com".
authorityHost?: string
قيمة الخاصية
string
disableAutomaticAuthentication
يجعل getToken يطرح إذا كانت المصادقة اليدوية ضرورية.
سيحتاج المطورون إلى الاتصال بالتحكم authenticate()
في وقت المصادقة يدويا.
disableAutomaticAuthentication?: boolean
قيمة الخاصية
boolean
موروث منInteractiveCredentialOptions.disableAutomaticAuthentication
disableInstanceDiscovery
يحدد الحقل ما إذا كان يتم تنفيذ اكتشاف المثيل عند محاولة المصادقة.
سيؤدي تعيين هذا إلى إلى true
تعطيل كل من اكتشاف المثيل والتحقق من صحة المرجع تماما.
ونتيجة لذلك، من الضروري التأكد من أن مضيف المرجع المكون صالح وجدير بالثقة.
هذه الوظيفة مخصصة للاستخدام في السيناريوهات التي لا يمكن فيها الوصول إلى نقطة نهاية بيانات التعريف، كما هو الحال في السحب الخاصة أو Azure Stack.
تتطلب عملية اكتشاف المثيل استرداد بيانات تعريف المرجع من https://login.microsoft.com/ للتحقق من صحة السلطة.
disableInstanceDiscovery?: boolean
قيمة الخاصية
boolean
موروث منInteractiveCredentialOptions.disableInstanceDiscovery
httpClient
HttpClient الذي سيتم استخدامه لإرسال طلبات HTTP.
httpClient?: HttpClient
قيمة الخاصية
loggingOptions
يسمح للمستخدمين بتكوين إعدادات خيارات نهج التسجيل، والسماح بمعلومات حساب التسجيل ومعلومات التعريف الشخصية لدعم العملاء.
loggingOptions?: LogPolicyOptions & { allowLoggingAccountIdentifiers?: boolean, enableUnsafeSupportLogging?: boolean }
قيمة الخاصية
LogPolicyOptions & { allowLoggingAccountIdentifiers?: boolean, enableUnsafeSupportLogging?: boolean }
proxyOptions
خيارات لتكوين وكيل للطلبات الصادرة.
proxyOptions?: ProxySettings
قيمة الخاصية
redirectOptions
خيارات لكيفية معالجة استجابات إعادة التوجيه.
redirectOptions?: RedirectPolicyOptions
قيمة الخاصية
retryOptions
الخيارات التي تتحكم في كيفية إعادة محاولة الطلبات الفاشلة.
retryOptions?: PipelineRetryOptions
قيمة الخاصية
telemetryOptions
خيارات لتعيين معلومات القياس عن بعد والتتبع الشائعة للطلبات الصادرة.
telemetryOptions?: TelemetryOptions
قيمة الخاصية
tlsOptions
خيارات لتكوين مصادقة TLS
tlsOptions?: TlsSettings
قيمة الخاصية
userAgentOptions
خيارات لإضافة تفاصيل عامل المستخدم إلى الطلبات الصادرة.
userAgentOptions?: UserAgentPolicyOptions