Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Langkah 3: Bagikan Token Peserta

Sekarang setelah Anda memiliki panggung, Anda perlu membuat token dan mendistribusikannya kepada peserta, untuk memungkinkan peserta bergabung dengan panggung dan mulai mengirim dan menerima video. Ada dua pendekatan untuk menghasilkan token:

Kedua pendekatan ini dijelaskan di bawah ini.

Membuat Token dengan Pasangan Kunci

Anda dapat membuat token di aplikasi server Anda dan mendistribusikannya kepada peserta untuk bergabung dengan panggung. Anda perlu membuat pasangan public/private kunci ECDSA untuk menandatangani JWT dan mengimpor kunci publik ke IVS. Kemudian IVS dapat memverifikasi token pada saat stage join.

IVS tidak menawarkan kedaluwarsa kunci. Jika kunci pribadi Anda dikompromikan, Anda harus menghapus kunci publik lama.

Buat Pasangan Kunci Baru

Ada berbagai cara untuk membuat pasangan kunci. Di bawah ini, kami memberikan dua contoh.

Untuk membuat pasangan kunci baru di konsol, ikuti langkah-langkah ini:

Untuk membuat pasangan kunci P384 EC baru dengan OpenSSL (Anda mungkin harus menginstal OpenSSL terlebih dahulu), ikuti langkah-langkah ini. Proses ini memungkinkan Anda untuk mengakses kunci pribadi dan publik. Anda memerlukan kunci publik hanya jika Anda ingin menguji verifikasi token Anda.

openssl ecparam -name secp384r1 -genkey -noout -out priv.pem
openssl ec -in priv.pem -pubout -out public.pem

Sekarang impor kunci publik baru Anda, menggunakan instruksi di bawah ini.

Impor Kunci Publik

Setelah Anda memiliki pasangan kunci, Anda dapat mengimpor kunci publik ke IVS. Kunci pribadi tidak diperlukan oleh sistem kami tetapi digunakan oleh Anda untuk menandatangani token.

Untuk mengimpor kunci publik yang ada dengan konsol:

Untuk mengimpor kunci publik yang ada dengan CLI:

aws ivs-realtime import-public-key --public-key-material "`cat public.pem`" --region <aws-region>

Anda dapat menghilangkan --region <aws-region> jika wilayah tersebut ada di file konfigurasi AWS lokal Anda.

Berikut adalah contoh respons :

{
    "publicKey": {
        "arn": "arn:aws:ivs:us-west-2:123456789012:public-key/f99cde61-c2b0-4df3-8941-ca7d38acca1a",
        "fingerprint": "98:0d:1a:a0:19:96:1e:ea:0a:0a:2c:9a:42:19:2b:e7",
        "publicKeyMaterial": "-----BEGIN PUBLIC KEY-----\nMHYwEAYHKoZIzj0CAQYFK4EEACIDYgAEVjYMV+P4ML6xemanCrtse/FDwsNnpYmS\nS6vRV9Wx37mjwi02hObKuCJqpj7x0lpz0bHm5v1JBvdZYAd/r2LR5aChK+/GM2Wj\nl8MG9NJIVFaw1u3bvjEjzTASSfS1BDX1\n-----END PUBLIC KEY-----\n",
        "tags": {}
    }
}

Permintaan API

POST /ImportPublicKey HTTP/1.1
{
  "publicKeyMaterial": "<pem file contents>"
}

Hasilkan dan Tanda Tanda Tanda Tanda Token

Untuk detail tentang bekerja dengan JWT dan pustaka yang didukung untuk menandatangani token, kunjungi jwt.io. Pada antarmuka jwt.io, Anda harus memasukkan kunci pribadi Anda untuk menandatangani token. Kunci publik hanya diperlukan jika Anda ingin memverifikasi token.

Semua JWT memiliki tiga bidang: header, payload, dan signature.

Skema JSON untuk header dan payload JWT dijelaskan di bawah ini. Atau Anda dapat menyalin contoh JSON dari konsol IVS. Untuk mendapatkan header dan payload JSON dari konsol IVS:

Skema Token: Header

Header menentukan:

{
  "alg": "ES384",
  "typ": "JWT"
  “kid”: “arn:aws:ivs:123456789012:us-east-1:public-key/abcdefg12345”
}

Skema Token: Payload

Payload berisi data khusus untuk IVS. Semua bidang kecuali user_id wajib.

Skema Token: Tanda Tangan

Untuk membuat tanda tangan, gunakan kunci pribadi dengan algoritma yang ditentukan dalam header (ES384) untuk menandatangani header yang dikodekan dan payload yang dikodekan.

ECDSASHA384(
  base64UrlEncode(header) + "." +
  base64UrlEncode(payload),
  <private-key>
)

Petunjuk

Membuat Token dengan IVS Real-Time Streaming API

Seperti yang ditunjukkan di atas, aplikasi klien meminta aplikasi server Anda untuk token, dan aplikasi server memanggil CreateParticipantToken menggunakan permintaan yang ditandatangani AWS SDK atau SIGv4. Karena AWS kredenSIAL digunakan untuk memanggil API, token harus dibuat dalam aplikasi sisi server yang aman, bukan aplikasi sisi klien.

Saat membuat token peserta, Anda dapat secara opsional menentukan and/or kemampuan atribut:

Lihat perinciannya di CreateParticipantToken.

Anda dapat membuat token peserta melalui konsol atau CLI untuk pengujian dan pengembangan, tetapi kemungkinan besar Anda ingin membuatnya dengan AWS SDK di lingkungan produksi Anda.

Anda akan memerlukan cara untuk mendistribusikan token dari server Anda ke setiap klien (misalnya, melalui permintaan API). Kami tidak menyediakan fungsi ini. Untuk panduan ini, Anda cukup menyalin dan menempelkan token ke kode klien dalam langkah-langkah berikut.

Penting: Perlakukan token sebagai buram; yaitu, jangan membangun fungsionalitas berdasarkan konten token. Format token bisa berubah di masa depan.

Instruksi Konsol

Instruksi CLI

Membuat token dengan AWS CLI mengharuskan Anda mengunduh dan mengonfigurasi CLI terlebih dahulu di mesin Anda. Untuk detail, lihat Panduan Pengguna AWS Command Line Interface. Perhatikan bahwa menghasilkan token dengan AWS CLI bagus untuk tujuan pengujian, tetapi untuk penggunaan produksi, kami menyarankan Anda membuat token di sisi server dengan AWS SDK (lihat petunjuk di bawah).

AWS Petunjuk SDK

Anda dapat menggunakan AWS SDK untuk membuat token. Di bawah ini adalah petunjuk AWS penggunaan SDK JavaScript.

Penting: Kode ini harus dijalankan di sisi server dan output-nya diberikan kepada klien.

Prasyarat: Untuk menggunakan contoh kode di bawah ini, Anda perlu menginstal paket aws- sdk/client -ivs-realtime. Untuk detailnya, lihat Mem ulai dengan AWS SDK untuk JavaScript.

import { IVSRealTimeClient, CreateParticipantTokenCommand } from "@aws-sdk/client-ivs-realtime";

const ivsRealtimeClient = new IVSRealTimeClient({ region: 'us-west-2' });
const stageArn = 'arn:aws:ivs:us-west-2:123456789012:stage/L210UYabcdef';
const createStageTokenRequest = new CreateParticipantTokenCommand({
  stageArn,
});
const response = await ivsRealtimeClient.send(createStageTokenRequest);
console.log('token', response.participantToken.token);