Web ve Direct Line kanalı güvenliğini yapılandırma

Web ve Direct Line kanal güvenliği, istemcilerin Copilot Studio agent'ınıza bağlanmak için bir Direct Line gizli anahtarı veya belirteci sağlaması gerekip gerekmediğini kontrol eder. Güvenli erişim olmadan, temsilci kimliğini bilen herkes Demo web sitesi ve Özel web sitesi kanalları üzerinden bağlantı kurabilir.

Note

Yalnızca Teams'den oluşan deneyimde gizli anahtar oluşturamazsınız. Güvenli erişim tokenları otomatik olarak oluşturulur ve güvenli erişim varsayılan olarak açıktır. Lisans gereksinimleri için Microsoft Ürün Şartları'na bakınız.

İstemcilerin bir gizli anahtar veya belirteç sunmasını zorunlu kılmak için Güvenli erişim zorunlu olsun seçeneğini açın. Bu kimlik bilgileri, Direct Line kanalına erişimi onaylar; son kullanıcıyı doğrulamaz veya belirli bir web sitesine erişimi tek başına sınırlamazlar. Kullanıcıların giriş yapması gerektiğinde kullanıcı kimlik doğrulamasını ayrı olarak yapılandırın.

Artık gerekmediğinde secret’ları değiştirebilir ve yeniden oluşturabilir, tokenları yenileyebilir veya güvenli erişimi kapatabilirsiniz.

Copilot Studio, web sayfanızı veya uygulamanızı aracıya bağlamak için Bot Framework Direct Line kanalını kullanır.

Web kanalı güvenliğini açın veya kapatın

Her bir bireysel temsilci için gizli anahtarların ve belirteçlerin kullanımını zorunlu kılabilirsiniz.

Bu seçeneği açtığınızda, kanallar istemcinin isteklerinin kimliğini doğrulamak için gizli diziyi veya çalışma zamanında elde edilen gizli dizi kullanılarak oluşturulan bir belirteci kullanmasını gerektirir.

Bu güvenlik önlemini sağlamayan aracıya erişim girişimleri işe yaramaz.

  1. Aracınızın Ayarlar sayfasına gidin, Güvenlik'i ve ardından Web kanalı güvenliği'ni seçin.

    Ayarlar açılır öğesinde vurgulanan Web kanalı güvenliğinin ekran görüntüsü.

  2. Güvenli erişim gerektir'i açın.

Warning

Güvenli erişim gerektir seçeneğini açtığınızda veya kapattığınızda yeni sistem ayarlarının geçerli olması iki saate kadar sürebilir. O zamana kadar, önceki ayar etkindir. Bu değişikliğin etkili olması için aracıyı yayımlamanız gerekmez.

Ajanınızı istemeden ortaya çıkarmaktan kaçınmak için önceden plan yapın.

Web kanal güvenliğini kapatmak için, Güvenli erişim gerektiriyor seçeneğini kapatın ve değişikliği onaylayın. Değişikliğin etkili olması iki saate kadar sürebilir.

Güvenli erişimi kapatmanın demo web sitesi ve güvensiz Direct Line kanallarını kullanıma sunduğunu doğrulayan onayın ekran görüntüsü.

Gizli anahtar veya belirteç kullanma

Hizmetten hizmete bir uygulama için, servisinizden gelen isteklerin Authorization üstbilgisinde gizli anahtarı belirtin.

İstemcinin web tarayıcısında veya mobil uygulamada çalıştığı bir uygulama yazıyorsanız veya aksi takdirde kod müşteriler tarafından görülebilir hale gelirse, gizli anahtarınızı bir belirteçle değiştirmelisiniz. Belirteç kullanmıyorsanız, gizli anahtarınızın güvenliği tehlikeye girebilir. Hizmetinizin belirtecini almak için istek yaparken, yetkilendirme üstbilgisinde gizli anahtarı belirtin.

Belirteçler yalnızca tek bir konuşma için çalışır ve yenilenmediği sürece zaman aşımına uğrar.

Durumunuza en uygun güvenlik modelini seçin.

Warning

Tarayıcıda çalışan, bir ağ çağrısıyla aktarılan veya sabit kodlanmış bir kodda gizli anahtarı ortaya çıkarmayın.

Hizmet kodunuzda gizli anahtarı kullanarak token almak, Copilot Studio ajanınızı korumanın en güvenli yoludur.

Sırları elde etme

Uygulamanızın yetkilendirme üstbilgisi isteklerinde veya benzeri bir yerde belirtebilmeniz için gizli anahtar gerekir.

  1. Gezinti menüsünde, Ayarlar altında Güvenlik'i seçin. Ardından Web kanalı güvenliği kutucuğunu seçin.

  2. Panoya kopyalamak için Gizli anahtar 1 veya Gizli anahtar 2 için Kopyala seçeneğini belirleyin. Sırrı ortaya çıkarmak için görünürlük simgesini seçin ve uyarı istemini gözden geçirin.

Gizli bilgi değişimi

Aracınızın kullandığı bir gizli anahtarı değiştirmeniz gerekirse, bunu aksama veya kesinti olmadan yapabilirsiniz.

Copilot Studio size aynı anda çalışan iki gizli anahtar sağlar. Aracınızın kullandığı gizli anahtarı diğeriyle değiştirebilirsiniz. Gizli anahtarlar değiştirildikten ve kullanıcılarınızın tümü yeni gizli anahtarı kullanarak bağlandıktan sonra gizli anahtarı yeniden üretebilirsiniz.

Gizli bilgiyi yeniden oluştur

Gizli anahtarı yeniden oluşturmak için, gizli anahtarın yanındaki Yeniden üret'i seçin.

Warning

Orijinal gizli anahtarı veya bu gizli anahtardan alınan belirteci kullanarak bağlanan kullanıcı profilinin bağlantısı kesilir.

Belirteç oluştur

Tek bir ajan konuşması başlatmak için bir token oluşturabilirsiniz. Bu yordam, hizmet kodunuzda bir Direct Line gizli anahtarını konuşma belirteciyle değiştirir. Copilot Studio token endpoint seçeneği için Direct Line belirtecini alma bölümünde daha fazla bilgi edinin.

  1. Gizli anahtar alın.

  2. Hizmet kodunuzda, örnek token oluşturma isteğini gönderin. <DirectLineSecret> değerini kopyaladığınız gizli anahtarla değiştirin.

Belirteç oluşturma isteği örneği

POST https://directline.botframework.com/v3/directline/tokens/generate
Authorization: Bearer <DirectLineSecret>

Belirteç oluşturma yanıtı örneği

HTTP/1.1 200 OK
[other headers]

{
  "conversationId": "abc123",
  "token": "<DirectLineToken>",
  "expires_in": 1800
}

İstek başarılı olursa yanıtta bir konuşma için geçerli olan bir belirteç ve belirtecin süresi doluncaya kadar olan saniye sayısını belirten bir expires_in değeri bulunur.

Belirteci yararlı tutmak için, süresi dolmadan önce belirteci yenilemeniz gerekir.

Belirteci yenile

Süresi dolmamış olduğu sürece belirteci sınırsız sayıda yenileyebilirsiniz.

Süresi dolmuş belirteçleri yenileyemezsiniz.

Örnek yenileme talebini gönderin. <DirectLineToken> yerine yenilemek istediğiniz süresi dolmamış tokenı koyun. Konuşma tokenını kullanın, Direct Line sırrını değil.

Örnek yenileme isteği

POST https://directline.botframework.com/v3/directline/tokens/refresh
Authorization: Bearer <DirectLineToken>

Örnek yenileme yanıtı

İstek başarılı olursa yanıtta önceki belirteçle aynı konuşma için geçerli olan yeni bir belirteç ve belirtecin süresi doluncaya kadar olan saniye sayısını belirten bir expires_in değeri bulunur.

Yeni belirteci yararlı tutmak için, süresi dolmadan önce belirteci yeniden yenileyin.

HTTP/1.1 200 OK
[other headers]

{
  "conversationId": "abc123",
  "token": "<DirectLineToken>",
  "expires_in": 1800
}

Daha fazla bilgi edinin: Refresh a Direct Line token.

  • Son güncelleştirme: