myViewBoard Knowledge Base


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şlemleri
cloud.viewsonic.com
API Sunucusu Quiz teslimi, yanıtlar, sonuçlar, gerçek zamanlı güncellemeler
api-swift.us.classswift.com
Varlık sunucusu Quiz görselleri ve öğretim materyalleri
media.us.classswift.com
media.viewsonic.io
asset.us.classswift.com
asset.viewsonic.io
Hub (öğretmen) Quiz hazırlama ve teslim
classswift.manager.viewsonic.io
hub.myviewboard.com
Katılımcı (öğrenci) Öğrenci yanıtlama
classswift.student.viewsonic.io
Ürün sayfası Ürün bilgileri
www.classswift.viewsonic.io
Uygulama indirme İstemci kurulumu ve güncellemeleri
windows-ota.viewsonic.io
app-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.io
  • cloud.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.

 

  1. 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'
  2. Ağ hızının 1 Mbps minimum değerini karşıladığını doğrulayın.
  3. 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:

  1. 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.
  2. 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.
  3. 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.com ve *.classswift.com joker 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üncellemeler
api-swift-rc.us.classswift.com
Varlık sunucusu Quiz görselleri ve öğretim materyalleri
media-rc.us.classswift.com
Hub (öğretmen) Quiz hazırlama ve teslim
hub.rc.myviewboard.com
Katılımcı (öğrenci) Öğrenci yanıtlama
learn-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.

 

 

 

myViewBoard Knowledge Base

Ek yardıma mı ihtiyacınız var?

Diğer kaynaklarımızı kontrol edin — size yardımcı olmaktan memnuniyet duyarız.