كيفية إنشاء عنوان URL للوصول إلى العميل للعملاء

يستخدم العميل، أو مستعرضا 💻أو تطبيقا 📱للأجهزة المحمولة أو جهاز 💡IoT، عنوان URL لوصول العميل للاتصال بموردك والمصادقة عليه. يتبع عنوان URL هذا نمطا من wss://<service_name>.webpubsub.azure.com/client/hubs/<hub_name>?access_token=<token>. توضح لك هذه المقالة عدة طرق للحصول على عنوان URL الخاص بوصول العميل.

• للبدء السريع، انسخ واحدا من مدخل Microsoft Azure
• للتطوير، قم بإنشاء القيمة باستخدام SDK خادم Web PubSub
• إذا كنت تستخدم معرف Microsoft Entra، يمكنك أيضا استدعاء واجهة برمجة تطبيقات Generate Client Token REST

نسخ من مدخل Microsoft Azure

في علامة التبويب Keys في مدخل Microsoft Azure، توجد أداة Client URL Generator لإنشاء عنوان URL ل Client Access بسرعة، كما هو موضح في الرسم التخطيطي التالي. لا يتم تخزين إدخال القيم هنا.

إنشاء من خدمة SDK

يمكن إنشاء عنوان URL نفسه لوصول العميل باستخدام خادم Web PubSub SDK.

جافا سكريبت

1. متابعة بدء استخدام خادم SDK لإنشاء كائن WebPubSubServiceClientservice

2. إنشاء عنوان URL لوصول العميل عن طريق استدعاء WebPubSubServiceClient.getClientAccessToken:

   • تكوين معرف المستخدم

     let token = await serviceClient.getClientAccessToken({ userId: "user1" });
     

   • تكوين مدة بقاء الرمز المميز

     let token = await serviceClient.getClientAccessToken({
       expirationTimeInMinutes: 5,
     });
     

   • تكوين دور يمكنه الانضمام إلى المجموعة group1 مباشرة عند الاتصال باستخدام عنوان URL الخاص ب Client Access

     let token = await serviceClient.getClientAccessToken({
       roles: ["webpubsub.joinLeaveGroup.group1"],
     });
     

   • تكوين دور يمكن للعميل إرسال رسائل إلى تجميعه group1 مباشرة عند الاتصال باستخدام عنوان URL الخاص ب Client Access

     let token = await serviceClient.getClientAccessToken({
       roles: ["webpubsub.sendToGroup.group1"],
     });
     

   • تكوين مجموعة group1 ينضم إليها العميل بمجرد اتصاله باستخدام عنوان URL الخاص ب Client Access

     let token = await serviceClient.getClientAccessToken({
       groups: ["group1"],
     });
     

C#‎

1. متابعة بدء استخدام خادم SDK لإنشاء كائن WebPubSubServiceClientservice

2. إنشاء عنوان URL لوصول العميل عن طريق استدعاء WebPubSubServiceClient.GetClientAccessUri:

   • تكوين معرف المستخدم

     var url = service.GetClientAccessUri(userId: "user1");
     

   • تكوين مدة بقاء الرمز المميز

     var url = service.GetClientAccessUri(expiresAfter: TimeSpan.FromMinutes(5));
     

   • تكوين دور يمكنه الانضمام إلى المجموعة group1 مباشرة عند الاتصال باستخدام عنوان URL الخاص ب Client Access

     var url = service.GetClientAccessUri(roles: new string[] { "webpubsub.joinLeaveGroup.group1" });
     

   • تكوين دور يمكن للعميل إرسال رسائل إلى تجميعه group1 مباشرة عند الاتصال باستخدام عنوان URL الخاص ب Client Access

     var url = service.GetClientAccessUri(roles: new string[] { "webpubsub.sendToGroup.group1" });
     

   • تكوين مجموعة group1 ينضم إليها العميل بمجرد اتصاله باستخدام عنوان URL الخاص ب Client Access

     var url = service.GetClientAccessUri(groups: new string[] { "group1" });
     

Python

1. متابعة بدء استخدام خادم SDK لإنشاء كائن WebPubSubServiceClientservice

2. إنشاء عنوان URL لوصول العميل عن طريق استدعاء WebPubSubServiceClient.get_client_access_token:

   • تكوين معرف المستخدم

     token = service.get_client_access_token(user_id="user1")
     

   • تكوين مدة بقاء الرمز المميز

     token = service.get_client_access_token(minutes_to_expire=5)
     

   • تكوين دور يمكنه الانضمام إلى المجموعة group1 مباشرة عند الاتصال باستخدام عنوان URL الخاص ب Client Access

     token = service.get_client_access_token(roles=["webpubsub.joinLeaveGroup.group1"])
     

   • تكوين دور يمكن للعميل إرسال رسائل إلى تجميعه group1 مباشرة عند الاتصال باستخدام عنوان URL الخاص ب Client Access

     token = service.get_client_access_token(roles=["webpubsub.sendToGroup.group1"])
     

   • تكوين مجموعة group1 ينضم إليها العميل بمجرد اتصاله باستخدام عنوان URL الخاص ب Client Access

     token = service.get_client_access_token(groups=["group1"])
     

Java

1. متابعة بدء استخدام خادم SDK لإنشاء كائن WebPubSubServiceClientservice

2. إنشاء عنوان URL لوصول العميل عن طريق استدعاء WebPubSubServiceClient.getClientAccessToken:

   • تكوين معرف المستخدم

     GetClientAccessTokenOptions option = new GetClientAccessTokenOptions();
     option.setUserId(id);
     WebPubSubClientAccessToken token = service.getClientAccessToken(option);
     

   • تكوين مدة بقاء الرمز المميز

     GetClientAccessTokenOptions option = new GetClientAccessTokenOptions();
     option.setExpiresAfter(Duration.ofDays(1));
     WebPubSubClientAccessToken token = service.getClientAccessToken(option);
     

   • تكوين دور يمكنه الانضمام إلى المجموعة group1 مباشرة عند الاتصال باستخدام عنوان URL الخاص ب Client Access

     GetClientAccessTokenOptions option = new GetClientAccessTokenOptions();
     option.addRole("webpubsub.joinLeaveGroup.group1");
     WebPubSubClientAccessToken token = service.getClientAccessToken(option);
     

   • تكوين دور يمكن للعميل إرسال رسائل إلى تجميعه group1 مباشرة عند الاتصال باستخدام عنوان URL الخاص ب Client Access

     GetClientAccessTokenOptions option = new GetClientAccessTokenOptions();
     option.addRole("webpubsub.sendToGroup.group1");
     WebPubSubClientAccessToken token = service.getClientAccessToken(option);
     

   • تكوين مجموعة group1 ينضم إليها العميل بمجرد اتصاله باستخدام عنوان URL الخاص ب Client Access

     GetClientAccessTokenOptions option = new GetClientAccessTokenOptions();
     option.setGroups(Arrays.asList("group1")),
     WebPubSubClientAccessToken token = service.getClientAccessToken(option);
     

في التعليمات البرمجية في العالم الحقيقي، عادة ما يكون لدينا جانب خادم لاستضافة المنطق الذي ينشئ عنوان URL لوصول العميل. عندما يأتي طلب عميل، يمكن لجانب الخادم استخدام سير عمل المصادقة/التخويل العام للتحقق من صحة طلب العميل. يمكن فقط لطلبات العميل الصالحة الحصول على عنوان URL الخاص بوصول العميل مرة أخرى.

استدعاء إنشاء واجهة برمجة تطبيقات REST للرمز المميز للعميل

يمكنك تمكين معرف Microsoft Entra في خدمتك واستخدام رمز Microsoft Entra المميز لاستدعاء Generate Client Token rest API للحصول على الرمز المميز للعميل لاستخدامه.

1. اتبع التخويل من التطبيق لتمكين معرف Microsoft Entra.

2. اتبع الحصول على رمز Microsoft Entra المميز للحصول على رمز Microsoft Entra المميز مع Postman.

3. استخدم رمز Microsoft Entra المميز لاستدعاء :generateToken مع Postman:

   إشعار

   يرجى استخدام أحدث إصدار من Postman. الإصدارات القديمة من Postman لديها بعض المشاكل التي تدعم النقطتين : في المسار.

   1. بالنسبة إلى URI، أدخل https://{Endpoint}/api/hubs/{hub}/:generateToken?api-version=2022-11-01

   2. في علامة التبويب Auth ، حدد Bearer Token والصق رمز Microsoft Entra المميز الذي تم إحضاره في الخطوة السابقة

   3. حدد إرسال وترى الرمز المميز لوصول العميل في الاستجابة:

      {
        "token": "ABCDEFG.ABC.ABC"
      }
      

4. عنوان URI الخاص ب Client Access بتنسيق wss://<endpoint>/client/hubs/<hub_name>?access_token=<token>