Ağ gereksinimleri
Quiz Tools'un düzgün çalışması için aşağıdaki bağlantı noktaları, alan adları, e-posta adresleri ve URL'ler gereklidir.
Bağlantı noktaları
Hizmet bağlantısı için aşağıdaki bağlantı noktalarının açık olması gerekir.
Gerekli
Hem myViewBoard hem de Quiz Tools için: TLS/SSL şifrelemesi etkin olarak 443 numaralı bağlantı noktasını açın.
| Protokol | Bağlantı noktası | Yön + Amaç |
|---|---|---|
| TCP | 443 (HTTPS) |
Giden Genel işleyiş, etkinleştirme ve tüm Quiz Tools trafiği |
Kablosuz ekran paylaşımı
Yalnızca myViewBoard için: (İsteğe bağlı) myViewBoard kablosuz ekran paylaşımını etkinleştirmek için aşağıdaki bağlantı noktalarını açın.
| Protokol | Bağlantı noktaları | Yön + Amaç |
|---|---|---|
| UDP/TCP | 3478 |
Çift yönlü WebRTC sunucuları |
| UDP | 50,000–65,535 |
Çift yönlü RTP/sRTP/RTCP akışları |
Bir güvenlik duvarı 3478 numaralı bağlantı noktasını veya UDP bağlantı noktası aralığını engellerse, TURN medyayı 3478 numaralı bağlantı noktası üzerinden proxy'ler.
WebSocket desteği
Quiz Tools, gerçek zamanlı sınıf güncellemeleri için WebSocket'leri (socket.io) kullanır. WebSocket trafiği, aşağıda listelenen alan adlarına ulaşmak için 443 numaralı bağlantı noktasındaki aynı HTTPS bağlantısı üzerinden çalışır.
Kuruluş açık bir HTTP proxy'si veya TLS denetimi yapan bir filtre kullanıyorsa, proxy'yi WebSocket yükseltme isteklerine izin verecek şekilde yapılandırın. Bazı cihazlar standart HTTPS trafiğine izin verirken aynı alan adındaki WebSocket yükseltmesini engeller. WebSocket yükseltmesinin engellenmesinin, sınıf güncellemelerinde gecikmeye ve öğrenci cihazlarında tekrarlanan yeniden bağlanma bildirimlerine yol açacağını unutmayın.
Bant genişliği gereksinimleri
En iyi performansı desteklemek için en az 1 Mbps öneririz. 1 Mbps'nin altında kullanıcılar gecikme veya düşük hizmet kalitesi yaşayabilir.
Beyaz liste
Quiz Tools hizmetinin düzgün bağlanabilmesi için aşağıdaki girişleri ağ beyaz listenize ekleyin.
E-posta adresleri
Kuruluşunuzun önemli myViewBoard e-posta bildirimlerini alabilmesi için aşağıdaki adresleri beyaz listeye ekleyin.
| Adres | Amaç |
|---|---|
| service@myviewboard.com | Bildirimler, güvenlik |
| letstalk@service.myviewboard.com | Destek |
| myviewboard@news.myviewboard.com | Haberler |
myViewBoard
Ağınızda myViewBoard trafiğine izin vermek için aşağıdaki alan adlarını beyaz listeye ekleyin.
*.myviewboard.com*.myviewboard.cloud*.firebaseio.com*.amazonaws.com
Quiz Tools
Ağınızda ClassSwift platformundan ve Quiz Tools alan adlarından gelen trafiğe izin vermek için aşağıdaki alan adlarını beyaz listeye ekleyin.
| Hizmet | Amaç + Alan adları |
|---|---|
| Hesap ve oturum açma | Tüm oturum açma işlemlericloud.viewsonic.com
|
| API Sunucusu | Quiz teslimi, yanıtlar, sonuçlar, gerçek zamanlı güncellemelerapi-swift.us.classswift.com
|
| Varlık sunucusu | Quiz görselleri ve öğretim materyallerimedia.us.classswift.commedia.viewsonic.ioasset.us.classswift.comasset.viewsonic.io
|
| Hub (öğretmen) | Quiz hazırlama ve teslimclassswift.manager.viewsonic.iohub.myviewboard.com
|
| Katılımcı (öğrenci) | Öğrenci yanıtlamaclassswift.student.viewsonic.io
|
| Ürün sayfası | Ürün bilgileriwww.classswift.viewsonic.io
|
| Uygulama indirme | İstemci kurulumu ve güncellemeleriwindows-ota.viewsonic.ioapp-ota.viewsonic.io
|
Joker karakterler
Güvenlik duvarı joker karakterleri destekliyorsa, aşağıdaki girişler yukarıda listelenen tüm alan adlarını kapsar.
*.us.classswift.com*.*.viewsonic.iocloud.viewsonic.com
IP adresleri
ViewSonic hizmetleri AWS yük dengeleyicilerinin arkasında çalıştığından, şu anda sabit bir IP adresi listesi sağlayamıyoruz. Önceden haber verilmeden değişen adreslere güvenmekten kaçınmak için IP tabanlı kurallar yerine FQDN tabanlı kurallar kullanmanızı önemle tavsiye ederiz.
Güvenlik duvarı ilkesi yalnızca IP tabanlı kuralları kabul ediyorsa, aşağıdaki hizmetlerin güncel aralıklarını bulmak için https://ip-ranges.amazonaws.com/ip-ranges.json adresinde listelenen AWS IP adresi aralıklarına bakın:
- AWS S3 ve S3 Accelerator
- AWS CloudFront
- AWS Global Accelerator
Quiz Tools API Sunucusu ağırlıklı olarak AWS Global Accelerator'a dayanır. AWS Global Accelerator adresleri (yukarıda) sabit olmadığından, dinamik AWS güncellemelerini takip etmek için aralıkları düzenli olarak yeniden kontrol etmeniz gerekir.
Yapılandırma adımları
Yapılandırma adımları güvenlik duvarı markasına ve modeline göre değişir. Kesin ayarları doğrulamak için güvenlik duvarınızın belgelerine başvurun.
- Yukarıda listelenen alan adlarını beyaz listeye ekleyin veya kuruluşun ilkesi IP tabanlı kurallar gerektiriyorsa bunun yerine AWS IP aralıklarını beyaz listeye ekleyin:
aws_ranges=$(curl -s https://ip-ranges.amazonaws.com/ip-ranges.json) echo "$aws_ranges" | jq -r '.prefixes[] | select(.service=="S3") | .ip_prefix' echo "$aws_ranges" | jq -r '.prefixes[] | select(.service=="CLOUDFRONT") | .ip_prefix' echo "$aws_ranges" | jq -r '.prefixes[] | select(.service=="GLOBAL_ACCELERATOR") | .ip_prefix' - Ağ hızının 1 Mbps minimum değerini karşıladığını doğrulayın.
- Giden HTTPS için 443 numaralı bağlantı noktasını (TCP) açın.
Bağlantıyı doğrulama
Yukarıdaki ayarları uyguladıktan sonra, ağın gerekli tüm hizmetlere ulaşabildiğini doğrulamak için ağ öz test sayfasını kullanın.
https://myviewboard.com/inspect/index.html
Testi çalıştırmak için aşağıdaki adımları uygulayın:
- Bağlantıyı, sınıfta fiilen kullanılacak cihazda açın. Örneğin, bir BT iş istasyonunu değil, etkilenen sınıftaki etkileşimli düz paneli kullanın.
- Cihazın, öğretmenlerin ve öğrencilerin kullandığı ağ segmentinde olduğunu doğrulayın. Ağ ilkeleri çoğunlukla personel ağları, öğrenci ağları ve misafir ağları arasında farklılık gösterir.
- Start test öğesini seçin. Test her hizmeti sırayla kontrol eder ve her kontrol tamamlandıkça her hizmetin durumunu görüntüler.

Ağın gerekli tüm hizmetlere ulaşabildiğini doğrulamak için ağ öz test sayfasını kullanın.
Test tamamlandıktan sonra sonuçları inceleyin:
| Sonuç | Anlamı | Yapılacak işlem |
|---|---|---|
| Pass | Adrese giden TCP 443 üzerinden ulaşılabildi. | İşlem gerekmez. |
| Cannot connect | Yanıt alınamadı. Bir güvenlik duvarı veya filtre isteği engelledi ya da alan adı çözümlenemedi. | Alan adını yukarıdaki Beyaz liste bölümüne göre beyaz listeye ekleyin veya alan adını TLS denetiminden hariç tutun. |
Sonuçları incelerken aşağıdakileri göz önünde bulundurun:
- Başarısız bir WebSocket satırı kesinti değil, performans düşüşü olduğunu gösterir. İstemci uzun yoklamaya (long polling) geri döndüğü için, uzun yoklama sırasında sınıflar çalışmaya devam eder. Ancak uzun yoklama sırasında canlı güncellemelerde gecikme yaşanabilir.
- Her sonuç, test edilen alan adını gösterir. Belirli özelliklerde sorun giderirken, alan adının amacını görmek ve beyaz listeye eklenip eklenmediğini doğrulamak için alan adını yukarıdaki Beyaz liste bölümünde bulun.
- Test, cihazdaki tarayıcının nelere ulaşabildiğini doğrular. Aynı cihazdaki yerel uygulamaların bağlanabileceğini garanti etmez. Sistem proxy ayarları, sertifika depoları ve DNS yolları tarayıcı ile yerel uygulamalar arasında farklılık gösterebilir.
- Bir filtrenin engelleme sayfası da geçerli bir HTTP yanıtı olduğundan, geçen bir test yanıtın ViewSonic hizmetinden geldiğinin kanıtı değildir. Tüm kontroller geçtiği halde ürün hâlâ hatalı davranıyorsa, TLS denetiminin yukarıda listelenen alan adlarına uygulanıp uygulanmadığını doğrulayın.
- Sonuçlar yalnızca test edilen cihaz, test edilen ağ ve test anı için geçerlidir. Ağ segmentlerini veya güvenlik duvarı ayarlarını değiştirdikten sonra yeniden test edin.
Beta programı (RC) alan adları
Aşağıdaki bilgiler yalnızca sürüm adayı (RC) ortamında çalışan myViewBoard beta programına kayıtlı kuruluşlar için geçerlidir.
- Kuruluş yukarıda önerilen joker karakter girişlerini zaten kullanıyorsa, ek yapılandırmayı atlayabilirsiniz.
*.myviewboard.comve*.classswift.comjoker karakterleri, RC alan adlarını alt alan adı olarak zaten kapsar. - Kuruluşun güvenlik duvarı ilkesi alan adı bazında açık kurallar gerektiriyorsa, ilgili alan adlarını aşağıdaki RC alan adlarıyla değiştirin. Aşağıda listelenmeyen hizmetler, yukarıda zaten listelenen alan adlarını kullanır.
| Hizmet | Amaç + Alan adları |
|---|---|
| API Sunucusu | Quiz teslimi, yanıtlar, sonuçlar, gerçek zamanlı güncellemelerapi-swift-rc.us.classswift.com
|
| Varlık sunucusu | Quiz görselleri ve öğretim materyallerimedia-rc.us.classswift.com
|
| Hub (öğretmen) | Quiz hazırlama ve teslimhub.rc.myviewboard.com
|
| Katılımcı (öğrenci) | Öğrenci yanıtlamalearn-swift-rc.us.classswift.com
|
Bağlantı noktaları, protokoller, ağ hızı ve WebSocket için RC gereksinimleri, beta olmayan sürüm için yukarıda verilenlerle aynıdır.