Utility class
Aracı çalışma zamanı işlemleri için yardımcı yöntemler sağlayan yardımcı program sınıfı.
Yöntemler
| get |
UYARI: İmza DOĞRULAMASI YOK - Bu yöntem, belirteç imzasını doğrulamayan jwt.decode() kullanır. Belirteç talepleri kötü amaçlı aktörler tarafından sahte olabilir. Bu yöntem YALNIZCA günlüğe kaydetme, analiz ve tanılama amacıyla uygundur. Yetkilendirme, erişim denetimi veya güvenlik kararları için döndürülen değeri KULLANMAYIN. Belirtecin kodunu çözer ve kullanılabilir en iyi aracı tanımlayıcısını alır. Talepleri öncelik sırasına göre denetler: xms_par_app_azp (aracı şema kimliği) > appid > azp. Not: Boş/eksik belirteçler için boş dize döndürür (varsayılan GUID döndüren GetAppIdFromToken'den farklı olarak). Bu, kullanılabilir tanımlayıcı olmadığında çağıranların üst bilgileri atlayabilmesini sağlar. |
| Get |
UYARI: İmza DOĞRULAMASI YOK - Bu yöntem, belirteç imzasını doğrulamayan jwt.decode() kullanır. Belirteç talepleri kötü amaçlı aktörler tarafından sahte olabilir. Bu yöntem YALNIZCA günlüğe kaydetme, analiz ve tanılama amacıyla uygundur. Yetkilendirme, erişim denetimi veya güvenlik kararları için döndürülen değeri KULLANMAYIN. Geçerli belirtecin kodunu çözer ve Uygulama Kimliğini (appid veya azp talebi) alır. Not: Geçerli görünümlü guid bekleyen çağıranlarla geriye dönük uyumluluk için boş belirteçler için varsayılan GUID ('00000000-0000-0000-0000-000000000000') döndürür. Boş dizenin tercih edildiği aracı belirlemesi için getAgentIdFromToken kullanın. |
| get |
npm_package_name ortam değişkeninden veya package.jsonuygulama adını alır. İstekler sırasında eşitleme G/Ç'sini önlemek için package.json sonucu modül yükleme zamanında önbelleğe alınır. |
| Get |
SDK sürümü, işletim sistemi türü, Node.js sürümü ve düzenleyici içeren bir User-Agent üst bilgi dizesi oluşturur. |
| Resolve |
Dönüş bağlamından veya kimlik doğrulama belirtecinden aracı kimliğini çözümler. |
Yöntem Ayrıntıları
getAgentIdFromToken(string)
UYARI: İmza DOĞRULAMASI YOK - Bu yöntem, belirteç imzasını doğrulamayan jwt.decode() kullanır. Belirteç talepleri kötü amaçlı aktörler tarafından sahte olabilir. Bu yöntem YALNIZCA günlüğe kaydetme, analiz ve tanılama amacıyla uygundur. Yetkilendirme, erişim denetimi veya güvenlik kararları için döndürülen değeri KULLANMAYIN.
Belirtecin kodunu çözer ve kullanılabilir en iyi aracı tanımlayıcısını alır. Talepleri öncelik sırasına göre denetler: xms_par_app_azp (aracı şema kimliği) > appid > azp.
Not: Boş/eksik belirteçler için boş dize döndürür (varsayılan GUID döndüren GetAppIdFromToken'den farklı olarak). Bu, kullanılabilir tanımlayıcı olmadığında çağıranların üst bilgileri atlayabilmesini sağlar.
static function getAgentIdFromToken(token: string): stringParametreler
- token
-
string
Kodunu çözmek için JWT belirteci
Döndürülenler
string
Aracı Kimliği (GUID) veya bulunamazsa veya belirteç boşsa boş dize
GetAppIdFromToken(string)
UYARI: İmza DOĞRULAMASI YOK - Bu yöntem, belirteç imzasını doğrulamayan jwt.decode() kullanır. Belirteç talepleri kötü amaçlı aktörler tarafından sahte olabilir. Bu yöntem YALNIZCA günlüğe kaydetme, analiz ve tanılama amacıyla uygundur. Yetkilendirme, erişim denetimi veya güvenlik kararları için döndürülen değeri KULLANMAYIN.
Geçerli belirtecin kodunu çözer ve Uygulama Kimliğini (appid veya azp talebi) alır.
Not: Geçerli görünümlü guid bekleyen çağıranlarla geriye dönük uyumluluk için boş belirteçler için varsayılan GUID ('00000000-0000-0000-0000-000000000000') döndürür. Boş dizenin tercih edildiği aracı belirlemesi için getAgentIdFromToken kullanın.
static function GetAppIdFromToken(token: string): stringParametreler
- token
-
string
Kod Çözme Belirteci
Döndürülenler
string
AppId veya boş belirteç için varsayılan GUID veya kod çözme başarısız olursa boş dize
getApplicationName()
npm_package_name ortam değişkeninden veya package.jsonuygulama adını alır. İstekler sırasında eşitleme G/Ç'sini önlemek için package.json sonucu modül yükleme zamanında önbelleğe alınır.
static function getApplicationName(): undefined | stringDöndürülenler
undefined | string
Uygulama adı veya kullanılamıyorsa tanımsız.
GetUserAgentHeader(string)
SDK sürümü, işletim sistemi türü, Node.js sürümü ve düzenleyici içeren bir User-Agent üst bilgi dizesi oluşturur.
static function GetUserAgentHeader(orchestrator?: string): stringParametreler
- orchestrator
-
string
User-Agent dizesine eklenecek isteğe bağlı düzenleyici tanımlayıcısı.
Döndürülenler
string
Biçimlendirilmiş User-Agent üst bilgi dizesi.
ResolveAgentIdentity(TurnContext, string)
Dönüş bağlamından veya kimlik doğrulama belirtecinden aracı kimliğini çözümler.
static function ResolveAgentIdentity(context: TurnContext, authToken: string): stringParametreler
- context
- TurnContext
Sıranın bağlamını döndürün.
- authToken
-
string
Varsa kimlik doğrulama belirteci.
Döndürülenler
string
Aracı kimliği (Uygulama Kimliği)