Cara membuat URL akses klien untuk klien

Klien, baik itu browser 💻, aplikasi 📱seluler, atau perangkat 💡IoT, menggunakan URL Akses Klien untuk menyambungkan dan mengautentikasi dengan sumber daya Anda. URL ini mengikuti pola wss://<service_name>.webpubsub.azure.com/client/hubs/<hub_name>?access_token=<token>. Artikel ini memperlihatkan kepada Anda beberapa cara untuk mendapatkan URL Akses Klien.

• Untuk mulai cepat, salin dari portal Azure
• Untuk pengembangan, hasilkan nilai menggunakan SDK server Web PubSub
• Jika Anda menggunakan ID Microsoft Entra, Anda juga dapat memanggil Generate Client Token REST API

Salin dari portal Azure

Di tab Kunci di portal Azure, ada alat Generator URL Klien untuk membuat URL Akses Klien dengan cepat untuk Anda, seperti yang ditunjukkan pada diagram berikut. Input nilai di sini tidak disimpan.

Hasilkan dari SDK layanan

URL Akses Klien yang sama dapat dihasilkan dengan menggunakan SDK server Web PubSub.

JavaScript

1. Ikuti Memulai SDK server untuk membuat WebPubSubServiceClient objek service

2. Hasilkan URL Akses Klien dengan memanggil WebPubSubServiceClient.getClientAccessToken:

   • Mengonfigurasi ID pengguna

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

   • Mengonfigurasi masa pakai token

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

   • Mengonfigurasi peran yang dapat bergabung dengan grup group1 secara langsung saat tersambung menggunakan URL Akses Klien ini

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

   • Mengonfigurasi peran yang dapat dikirim klien ke grup group1 secara langsung saat tersambung menggunakan URL Akses Klien ini

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

   • Mengonfigurasi grup group1 yang bergabung dengan klien setelah tersambung menggunakan URL Akses Klien ini

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

C#

1. Ikuti Memulai SDK server untuk membuat WebPubSubServiceClient objek service

2. Hasilkan URL Akses Klien dengan memanggil WebPubSubServiceClient.GetClientAccessUri:

   • Mengonfigurasi ID pengguna

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

   • Mengonfigurasi masa pakai token

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

   • Mengonfigurasi peran yang dapat bergabung dengan grup group1 secara langsung saat tersambung menggunakan URL Akses Klien ini

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

   • Mengonfigurasi peran yang dapat dikirim klien ke grup group1 secara langsung saat tersambung menggunakan URL Akses Klien ini

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

   • Mengonfigurasi grup group1 yang bergabung dengan klien setelah tersambung menggunakan URL Akses Klien ini

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

Python

1. Ikuti Memulai SDK server untuk membuat WebPubSubServiceClient objek service

2. Hasilkan URL Akses Klien dengan memanggil WebPubSubServiceClient.get_client_access_token:

   • Mengonfigurasi ID pengguna

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

   • Mengonfigurasi masa pakai token

     token = service.get_client_access_token(minutes_to_expire=5)
     

   • Mengonfigurasi peran yang dapat bergabung dengan grup group1 secara langsung saat tersambung menggunakan URL Akses Klien ini

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

   • Mengonfigurasi peran yang dapat dikirim klien ke grup group1 secara langsung saat tersambung menggunakan URL Akses Klien ini

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

   • Mengonfigurasi grup group1 yang bergabung dengan klien setelah tersambung menggunakan URL Akses Klien ini

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

Java

1. Ikuti Memulai SDK server untuk membuat WebPubSubServiceClient objek service

2. Hasilkan URL Akses Klien dengan memanggil WebPubSubServiceClient.getClientAccessToken:

   • Mengonfigurasi ID pengguna

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

   • Mengonfigurasi masa pakai token

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

   • Mengonfigurasi peran yang dapat bergabung dengan grup group1 secara langsung saat tersambung menggunakan URL Akses Klien ini

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

   • Mengonfigurasi peran yang dapat dikirim klien ke grup group1 secara langsung saat tersambung menggunakan URL Akses Klien ini

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

   • Mengonfigurasi grup group1 yang bergabung dengan klien setelah tersambung menggunakan URL Akses Klien ini

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

Dalam kode dunia nyata, kita biasanya memiliki sisi server untuk menghosting logika yang menghasilkan URL Akses Klien. Ketika permintaan klien masuk, sisi server dapat menggunakan alur kerja autentikasi/otorisasi umum untuk memvalidasi permintaan klien. Hanya permintaan klien yang valid yang bisa mendapatkan URL Akses Klien kembali.

Memanggil Rest API Hasilkan Token Klien

Anda dapat mengaktifkan ID Microsoft Entra di layanan Anda dan menggunakan token Microsoft Entra untuk memanggil Generate Client Token rest API untuk mendapatkan token untuk digunakan klien.

1. Ikuti Otorisasi dari aplikasi untuk mengaktifkan ID Microsoft Entra.

2. Ikuti Dapatkan token Microsoft Entra untuk mendapatkan token Microsoft Entra dengan Postman.

3. Gunakan token Microsoft Entra untuk memanggil :generateToken dengan Postman:

   Catatan

   Silakan gunakan postman versi terbaru. Versi lama Postman memiliki beberapa masalah yang mendukung titik dua : di jalur.

   1. Untuk URI, masukkan https://{Endpoint}/api/hubs/{hub}/:generateToken?api-version=2022-11-01

   2. Pada tab Autentikasi , pilih Token Pembawa dan tempelkan token Microsoft Entra yang diambil di langkah sebelumnya

   3. Pilih Kirim dan Anda melihat Token Akses Klien dalam respons:

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

4. URI Akses Klien dalam format wss://<endpoint>/client/hubs/<hub_name>?access_token=<token>