Meet eCDN Kuruluş İçi API ile çalışma

Bu sayfada, Google Meet Canlı Yayın özelliği için Google Meet Enterprise Content Delivery Network (eCDN) Yerleşik API'nin nasıl kullanılacağı açıklanmaktadır.

Burada açıklanan API çözümü, müşterilerin gizli IP bilgilerini Google'a göstermeden Meet eCDN'nin tüm özellik grubunu kullanmasına olanak tanır. Kendi ağınızda, özel IP adresi bilgileri yerine kimlik gönderen yeni bir şirket içi web hizmeti tanımlayabilirsiniz.

Meet eCDN'ye genel bakış

eCDN, Meet'te yerleşik olarak bulunur ve bir Google Workspace yöneticisi tarafından kurulduktan sonra canlı yayınlar sırasında otomatik olarak başlatılır. Meet eCDN etkinleştirildiğinde, yerel bir ağdaki canlı yayın izleyicileri, canlı yayınlanan medyayı ağdaki diğer kullanıcılarla eşler arası (P2P) paylaşım üzerinden paylaşabilir. Çoğu cihaz canlı yayınlanan medyayı, Google'ın sunucularından getirmesine gerek duymadan yakındaki kullanıcılardan alır. Bu, izleyicilerin kullandığı toplam bant genişliğini azaltır. Meet eCDN'yi ayarlama ve kullanma hakkında daha fazla bilgi için Büyük canlı yayınlar düzenleme başlıklı makaleyi inceleyin.

eCDN, Meet canlı yayını izleyicilerinin eşleme gruplarına ayrılmasını gerektirir. Eşleme grubu, birbiriyle medya paylaşmasına izin verilen düğümler koleksiyonudur. Bir eşleme grubundaki cihazların eşleme yapmasına izin verilir ya da cihazların eşleme yapması engellenir. İzin verilen cihazlar, yalnızca aynı eşleme grubundaki diğer cihazlara bağlanabilir. Eşleme grupları hakkında daha fazla bilgi için Büyük ölçekli canlı yayınlar düzenlemeye başlamadan önce başlıklı makaleyi inceleyin.

API ne zaman kullanılır?

eCDN, random, subnet veya custom rules gibi çeşitli eşleme politikaları kullanarak eşleme grupları oluşturabilir. İkincisi, her eş düğümün özel IP adreslerini bir eşleme grubuyla eşlemek için Google'ın eCDN izleyici sunucusuyla özel ağ aralıkları tablosunu paylaşır. custom rules politikası tercih edilen çözümdür ve çoğu üretim ortamında uygundur.

Ancak custom rules politikası, özel ağ yapınızın büyük bölümlerini Google ile paylaşmanızı gerektirir. Ayrıca, bireysel kullanıcılar eCDN'yi kullanırken yerel olarak algılanan özel IP adreslerini Google'a gösterir. Bazı kuruluşların güvenlik yönergeleri, özel IP bilgilerinin paylaşılmasına izin vermeyebilir.

Meet eCDN Yerleşik API ile geliştirme yapma

Meet eCDN Yerleşik API'si, kuruluşunuzun ağında yerel olarak uygulayıp barındırabileceğiniz bir web sunucusu spesifikasyonu sağlar. Özel IP bilgilerine bağlı tüm görevleri gerçekleştirmek için API ile uyumlu bir özel web hizmeti oluşturarak bilgilerin Google ile paylaşılmasını önleyebilirsiniz.

API, genellikle eCDN izleyici sunucusu tarafından işlenen özel IP adreslerini eşleştirmeyle ilgili iki önemli adımı kapsar: Özel IP adreslerini bir eşleme grubuyla eşleme ve WebRTC sinyali sırasında Oturum Açıklaması Protokolü (SDP) teklif-cevap veri alışverişi.

Web hizmeti tamamlandıktan sonra On-premises service eşleme politikası kullanacak ve özel web hizmetinizin URL'sini ekleyecektir. Yönetici Konsolu'nu yapılandırmanız gerekir.

Şartlar

Kuruluşunuzda bu şartlardan herhangi birinin etkinleştirilmesi gerekiyorsa Google Workspace yöneticinizden yardım isteyin:

  • HTTPS kullanan tüm web sunucuları bu API'yi uygulayabilir.

  • Karma içerik hatalarını önlemek için HTTPS'yi kullanın.

  • JSON verilerini kabul edip döndürme Tarayıcınız tarafından desteklenen herhangi bir içerik kodlamasını kullanın.

  • Uç noktaları, n'ın seçili API sürümü olduğu bir /vn rotası altında sunun. Örneğin, /v1/get-peering-group.

  • Meet canlı yayını izleyicileri, web hizmetinizin URL'si hakkında bilgi edinmek için Google Yönetici Konsolu'nu kullanabilir. URL, genel olarak, kuruluş birimi başına veya grup başına ayarlanabilir. İzleyicilerin, kendilerine atanan hizmet örneğine bağlanabildiğinden emin olun. Daha fazla bilgi için Yönetici Konsolu'nu yapılandırma başlıklı makaleyi inceleyin.

  • Hizmetiniz iki saniye içinde yanıt döndürmelidir. Aksi takdirde eCDN istemcisi kapanır ve izleyici canlı etkinliği eCDN kullanmayan normal bir kullanıcı olarak izlemeye devam eder. Bu durumda, bant genişliğinden tasarruf edemez.

  • Hizmetiniz aşağıdaki merkezler arası kaynak paylaşımı (CORS) üstbilgilerini ayarlamalıdır:

    • Access-Control-Allow-Origin: meet.google.com
    • Access-Control-Allow-Headers: GET, POST, OPTIONS
    • Access-Control-Allow-Credentials: true

Özel IP adreslerini bir eşleme grubuyla eşleme

eCDN istemcisi, eCDN izleyici sunucusuna tekrar bağlanmaya çalıştığı her seferinde bir çağrı yapar. Cihaz özel bir IP adresi algıladıktan sonra adres, uygun eşleme grubuyla eşlenmelidir. Özel IP adresini ağınızdaki bir sunucuya göndermeniz ve get-peering-group() yöntemini kullanarak bir eşleme grubuna manuel olarak çözmeniz gerekir. Yanıtta bir eşleme grubu kimliği döndürülür. Google ile iletişim kurarken özel IP adresleri yerine, eşleme grubu kimliği iletilir.

Özel IP adreslerinin bir eşleme grubuyla eşlenmesi.
Şekil 1. Özel IP adreslerini bir eşleme grubuyla eşleme.

Aşağıdaki kod örneğinde, olası hata yanıtı ve beklenen yanıt gövdesiyle birlikte get-peering-group() yönteminin nasıl çağrılacağı gösterilmektedir:

POST /v1/get-peering-group
Content-Type: application/json

Request body:
{
  "availableIPs": []{
    "format": "ipv4"|"ipv6",
    "address": "DETECTED_ADDRESS"
  }
}

Error response:
{
  "result": null,
  "error": "ERROR_MESSAGE",
}

Response body:
{
  "result": "PEERING_GROUP_ID",
  "error": null,
}

Beklenen yanıt biçimleri aşağıdaki tabloda gösterilmektedir:

HTTP durumu Hata Eşleme grubu kimliği Müşterinin tepkisi
200 null Boş olmayan dize İstemci bir eşleme grubuna ayrılır ve eCDN izleyici sunucusuna bağlanmaya devam eder.
200 NOT_FOUND null İstemci, eCDN oturumunu sonlandırır.
200 BLOCKED null İstemci, eCDN oturumunu sonlandırır.
200 Boş olmayan diğer dize null İstemci, eCDN oturumunu sonlandırır.
302 (Bulundu) Müşteri, yönlendirmeyi takip ederek yanıt gövdesinin Location başlığında belirtilen yeni URL'ye gider.
Diğer durum kodları Herhangi bir dize Herhangi bir dize İstemci, eCDN oturumunu sonlandırır.

SDP teklif-yanıt veri alışverişi

Cihazların WebRTC bağlantısı başlatması için özel IP bilgilerini içeren etkileşimli bağlantı oluşturma (ICE) adayları da dahil olmak üzere SDP tekliflerini ve yanıtlarını paylaşması gerekir. Bunu WebRTC sinyalleme sürecinin bir parçası olarak yaparlar.

İstemciler, encrypt-sdp() yöntemini kullanarak Meet eCDN Yerleşik API üzerinden ağlarında ICE adaylarını şifrelemelidir. Yöntem, Google'a hiçbir zaman gösterilmeyen bir anahtar kullanır. Ardından şifrelenmiş SDP teklifi, eCDN izleyici sunucusu kullanılarak eş tarafa gönderilir. Ardından istemci eş, decrypt-sdp() yöntemini kullanarak alınan bilgilerin şifresini kendi ağında çözer. Ardından Google, teklifleri ve yanıtları bağlı eşler arasında iletir.

Meet eCDN Kuruluş İçi API'si kullanılarak bağlantı kurulduktan sonra eCDN normal şekilde çalışır. Eşler, medyayı normal eşleme ağı üzerinden yönlendirir ve medya trafiği API'den geçmez veya API'yi kullanmaz.

SDP teklifi ve yanıt verilerinin şifrelenmesi ve şifrelerinin çözülmesi.
Şekil 2. SDP teklifi ve yanıt verilerini şifreleme ve şifre çözme.

Aşağıdaki kod örneğinde, olası hata yanıtı ve beklenen yanıt gövdesiyle birlikte encrypt-sdp() yönteminin nasıl çağrılacağı gösterilmektedir:

POST /v1/encrypt-sdp
Content-Type: application/json

Request body:
{
  "data": "SDP_DATA" // raw SDP data
},

Error response:
{
  "result": null,
  "error": "ERROR_MESSAGE", // error message
}

Response body:
{
  "result": "ENCRYPTED_DATA_STRING", // encrypted data as string
  "error": null,
}

Aşağıdaki kod örneğinde, olası hata yanıtı ve beklenen yanıt gövdesiyle birlikte decrypt-sdp() yönteminin nasıl çağrılacağı gösterilmektedir:

POST /v1/decrypt-sdp
Content-Type: application/json

Request body:
{
  "data": "ENCRYPTED_DATA_STRING", // encrypted data as string (size limit: 1 MB)
},

Error response:
{
  "result": null,
  "error": "ERROR_MESSAGE", // error message
}

Response body:
{
  "result": "SDP_DATA" // raw SDP data
  "error": null,
}

Beklenen yanıt biçimleri aşağıdaki tabloda gösterilmektedir:

HTTP durumu Hata Eşleme grubu kimliği Müşterinin tepkisi
200 null Boş olmayan dize İstemci, düzgün şekilde kodlanmış veya kodu çözülmüş SDP verilerinin kullanılmasını bekler.
200 Boş olmayan herhangi bir dize null İstemci, eCDN oturumunu sonlandırır.
302 (Bulundu) Müşteri, yönlendirmeyi takip ederek yanıt gövdesinin Location başlığında belirtilen yeni URL'ye gider.
Diğer durum kodları Herhangi bir değer Herhangi bir değer İstemci, eCDN oturumunu sonlandırır.

Yönetici Konsolu'nu yapılandırma

Meet eCDN Yerleşik API'yi kullanmak için Yönetici Konsolu'nda eCDN'yi özel web hizmetinizin URL'sini içerecek şekilde yapılandırmanız gerekir.

eCDN'yi ayarlamak için IP bilgilerini eşleme gruplarıyla manuel olarak eşleştirmek üzere On-premises service kullanarak bir eşleme politikası oluşturun. Varsayılan 443 bağlantı noktasını kullanmıyorsanız bağlantı noktası numarası da ekleyebilirsiniz. URL şu biçimle eşleşmelidir: WEB_SERVICE.example.com:8080. Burada WEB_SERVICE, web hizmetinizin adıdır.

Eşleme politikası belirleme hakkında daha fazla bilgi için Ağ gruplandırmasını yapılandırma başlıklı makaleyi inceleyin.