Uç nokta ajanı ve tarayıcı eklentisi sorunları
Kaydolmayan ya da sinyal göndermeyi bırakan ajanlar, doğrulama yapamayan eklentiler ve güvenlik duvarının almayı kestiği bir EDL akışı.
- Sürüm: 0.4
- Rol: admin_user
- Tür: sorun giderme
Her iki yüzey de bir kişiyi değil bir makineyi doğrular; bu yüzden arızaları parolalarla değil, kimlik malzemesiyle ilgilidir — bir kayıt belirteci, cihaza bağlı bir anahtar, imzalı bir politika paketi.
Belirtinizi bulun
| Gördüğünüz | Çalışma kitabı |
|---|---|
| Bir ajan kaydolmuyor | Bir ajan kaydolmuyor |
| Bir ajan bir kez kaydoldu ve bir daha hiç sinyal göndermedi | Bir ajan kaydolmuyor |
| Bir politika değişikliği filoya hiç ulaşmadı | Politika değişikliği filoya ulaşmıyor |
| Eklenti, doğrulamanın reddedildiğini ya da cihazın kayıtlı olmadığını söylüyor | Eklenti doğrulama yapamıyor |
| Eklenti oturum açıyor ve bu rolde eklenti görünümü olmadığını söylüyor | Eklenti doğrulama yapamıyor |
| Güvenlik duvarı EDL akışını almayı kesti | EDL akışı güncellenmiyor |
| Eklenti cihaza hiç erişemiyor | Sertifika ve 443 sorunları |
Uç nokta ajanı
Bir ajan kaydolmuyor
Kayıt, belirtecin özetini bir filoyla eşleştirir ve o filonun aktif olmasını gerektirir; bu nedenle bir filoyu pasife almak, içindeki cihazları iptal etmeden yeni kayıtları durdurur — ve her ikisi de geçersiz belirteç gibi okunur.
Kayıttan sonra ajan sıradan bir ağ geçidi API anahtarıyla kimlik doğrular; dolayısıyla anahtarın kendi yaşam döngüsü geçerlidir: anahtarı iptal edin ya da süresinin dolmasına izin verin, ajan uç nokta tarafında hiçbir değişiklik olmadan susar.
Note
Bir anahtar tek bir cihaz kimliğine bağlıdır. Bir makine imajını kayıttan sonra çoğaltmak, iki makineye farklı cihaz kimlikleriyle aynı anahtarı verir ve ikisi de reddedilir. Ajanın durumunu altın imajın dışında tutun.
Uç nokta ajanı kaydolmuyor ya da politika almayı bırakıyor
Şunları görebilirsiniz: Invalid enrollment token (kayıt belirteci geçersiz) · Missing agent API key (ajan API anahtarı gönderilmemiş) · Invalid agent API key (ajan API anahtarı geçersiz) · Agent key does not match device (ajan anahtarı cihazla eşleşmiyor)
Başlamadan önce
Denetimler
- 1
Kayıt belirtecini filoyla karşılaştırın
beklenen · Belirteç, durumu aktif olan bir filoya ait.
- 2
Ajanın politika ve sinyal çağrılarında gönderdiği Authorization başlığını okuyun
beklenen · Ajan, ağ geçidinin tanıdığı bir anahtar gönderiyor.
- 3
Anahtar ile cihaz kimliğinin birbiriyle uyuştuğunu denetleyin
beklenen · Anahtar, ajanın bildirdiği cihaz kimliğine çözümleniyor.
- 4
Filonun politikasında, paketin onlarsız imzalanamadığı iki alanı okuyun
beklenen · İkisi de var.
- 5
Filonun benimsemediği bir politika değişikliği için paket sürümünün ilerlediğini denetleyin
beklenen · Sürüm, ajanın bildirdiğinden büyük.
Nedenler ve düzeltmeler
| Ne zaman ulaşılır | Neden | Açıklama, düzeltme ve doğrulama |
|---|---|---|
| denetim 1 başarısız olduğunda | token-or-fleet-inactive (uyarı) | Kayıt, belirtecin özetini bir filoyla eşleştirir ve o filonun aktif olmasını gerektirir; bu nedenle bir filoyu pasife almak, içindeki cihazları iptal etmeden yeni kayıtları durdurur ve iki hata da geçersiz belirteç gibi okunur. Düzeltme: Filoyu yeniden etkinleştirin ya da ajana aktif bir filonun belirtecini verin. Doğrulama: beklenen · Cihaz filoda görünüyor. |
| denetim 2 başarısız olduğunda | agent-key-missing-or-invalid (kritik) | Kayıttan sonra ajan, diğer her API istemcisi gibi bir ağ geçidi API anahtarıyla kimlik doğrular; dolayısıyla anahtarın kendi yaşam döngüsü geçerlidir: anahtarı iptal edin ya da süresinin dolmasına izin verin, ajan uç nokta tarafında hiçbir değişiklik olmadan susar. Düzeltme: Anahtarı Erişim Anahtarları altında denetleyin ve Ağ geçidi API anahtarı reddediliyor yolunu izleyin. Anahtar geri getirilemiyorsa cihazı yeniden kaydedin. Doğrulama: beklenen · Sinyal yakın zamanlı. |
| denetim 3 başarısız olduğunda | key-device-mismatch (uyarı) | Bir anahtar tek bir cihaz kimliğine bağlıdır. Olağan neden, bir makine imajının kayıttan sonra çoğaltılmasıdır: iki makine o zaman aynı anahtarı farklı cihaz kimlikleriyle sunar ve ikisi de reddedilir. Düzeltme: Etkilenen makineleri yeniden kaydedin ki her biri kendi anahtarını alsın, ve ajanın durumunu altın imajın dışında tutun. Doğrulama: beklenen · Her makine bir kez görünüyor ve sinyali yakın zamanlı. |
| denetim 4 başarısız olduğunda | policy-incomplete (uyarı) | İmzalı paket, ajanın ne kadar seçici olacağını ve cihaza erişemediğinde ne yapacağını belirtmek zorundadır. İkisinden biri eksik olan bir paket, işletmecinin hiç seçmediği bir varsayılanla gönderilmek yerine imzalama sırasında reddedilir. Düzeltme: Filo politikasında selectivity ve failMode alanlarını ayarlayıp politikayı yeniden kaydedin.Doğrulama: beklenen · İmzalı bir paket dönüyor. |
| denetim 5 başarısız olduğunda | version-did-not-move (bilgi) | Ajanlar yalnızca kesin olarak artan paket sürümlerini benimser; dolayısıyla numarayı ilerletmeyen bir değişiklik, filonun hiç duymadığı bir değişikliktir. Kilitleme ve kilit açma geçişlerinin numarayı bir kuşak farkı kadar ileri taşımasının nedeni tam olarak budur. Düzeltme: Sürümün ilerlemesi için politikayı yeniden kaydedin, ardından bir yoklama aralığı bekleyin. Doğrulama: beklenen · Filonun geçerli sürümüyle eşleşiyor. Bu geçerli değilse: Destek paketini, filo kimliğini, cihaz kimliğini ve ajanın kendi günlüğünü ekleyin. |
Politika değişikliği filoya ulaşmıyor
Bir ajan, bir paketi yalnızca sürümü uyguladığından kesin olarak büyükse benimser. Numarayı ilerletmeyen bir değişiklik, filonun hiç duymadığı bir değişikliktir — kilitleme ve kilit açma geçişlerinin paketi bir kuşak farkı kadar ileri taşımasının nedeni budur.
Politikada selectivity ya da failMode eksikse paket, kimsenin seçmediği bir varsayılanla
gönderilmek yerine imzalama sırasında reddedilir. Aynı çalışma kitabı her ikisini de kapsar.
Tarayıcı eklentisi
Eklenti doğrulama yapamıyor
Dört ret bilinçli olarak birbirinden ayrıdır: hiç kaydolmamış bir cihaz, başka bir kiracıya kayıtlı bir cihaz, yanlış biçimde anahtar malzemesi ve döngüye girip sürekli yeniden doğrulama yaptığı için sıklık nedeniyle reddedilen bir cihaz. Eklenti görünümü olmayan bir role bu durum, boş bir açılır pencere gösterilmek yerine oturum açarken söylenir — denetim rolleri için sohbet reddiyle aynı tasarımdır.
Tarayıcı eklentisi doğrulama yapamıyor, oturum açamıyor ya da politikasını alamıyor
Şunları görebilirsiniz: Attestation rejected (cihaz doğrulaması reddedildi) · Device is not enrolled (cihaz kayıtlı değil) · Device is enrolled to another tenant (cihaz başka bir kiracıya kayıtlı) · Device not found (cihaz bulunamadı)
Başlamadan önce
Denetimler
- 1
Cihazın kaydını okuyun
beklenen · Cihaz, kullanıcının ait olduğu kiracıya kayıtlı.
- 2
Reddedilen bir kayıt için eklentinin hangi anahtar malzemesini gönderdiğini okuyun
beklenen · Eklenti P-256 açık JWK gönderiyor.
- 3
Cihazın kimlik yüzünden mi yoksa sıklık yüzünden mi reddedildiğini denetleyin
beklenen · Cihaz olağan aralığıyla doğrulama yapıyor.
- 4
Oturum açan hesabın rolünü okuyun
beklenen · Rol, eklentiyi kullanan rollerden biri.
- 5
Güvenlik duvarı EDL akışı için güvenlik duvarının sunduğu token'ı okuyun
beklenen · Güvenlik duvarı güncel bir EDL token'ı sunuyor.
Nedenler ve düzeltmeler
| Ne zaman ulaşılır | Neden | Açıklama, düzeltme ve doğrulama |
|---|---|---|
| denetim 1 başarısız olduğunda | device-enrolment-wrong (uyarı) | Bir cihaz tam olarak tek bir kiracıya aittir. Bir makinenin yeniden imajlanması ya da bir kullanıcının yeniden kayıt yapılmadan kiracılar arasında taşınması, cihazı artık oturum açan kullanıcıyla eşleşmeyen bir kiracıya karşı doğrulama yapar durumda bırakır. Düzeltme: Eskimiş cihaz kaydını silin ve makineyi geçerli kullanıcı olarak yeniden kaydedin. Bkz. Tarayıcı eklentisi. Doğrulama: beklenen · Cihaz kayıtlı ve sağlıklı bildiriyor. |
| denetim 2 başarısız olduğunda | bad-key-material (bilgi) | Doğrulama bir imza denetimidir. Yanlış eğriye ait bir anahtar ya da özel skaler taşıyan bir anahtar bunun için kullanılamaz; saklanmak yerine reddedilir. Düzeltme: Eklentiyi yeniden kurun ya da sıfırlayın; böylece yeni bir anahtar çifti üretir, ardından yeniden kaydedin. Anahtar malzemesini makineler arasında kopyalamayın. Doğrulama: beklenen · Kayıt başarılı oluyor. |
| denetim 3 başarısız olduğunda | attestation-throttled (bilgi) | Doğrulama uç noktası cihaz başına hız sınırlıdır. Çöküp döngü içinde yeniden doğrulama yapan bir cihaz sıklık nedeniyle reddedilir; bu da onu asıl çökerten şeyi gizler. Düzeltme: Önce döngüyü durdurun — eklentinin kendi hatasını okuyun — sonra hız sınırı penceresinin geçmesini bekleyin. Bkz. Bir istek çok sık olduğu için reddediliyor. Doğrulama: beklenen · Doğrulama kabul ediliyor. |
| denetim 4 başarısız olduğunda | role-has-no-extension-view (bilgi) | Ret bilinçlidir ve bir arıza değildir: hesap kimlik doğrulamasını başarıyla geçmiştir, rolünün ise eklenti yüzeyi yoktur. Denetim rolleri için sohbet reddiyle aynı tasarımdır. Düzeltme: O hesapla panoyu kullanın ya da kullanıcıya, rolü eklentiyi kullanan bir hesap verin. Doğrulama: beklenen · Eklenti açılıyor. |
| denetim 5 başarısız olduğunda | edl-token-missing-or-expired (uyarı) | EDL akışını, etkileşimli olarak oturum açamayan bir güvenlik duvarı tüketir; bu nedenle akış kendi token'ını taşır. Süresi dolmuş bir token akışın güncellenmesini durdurur, güvenlik duvarı ise çektiği son listeyi uygulamayı sürdürür — arızayı sessiz kılan da budur. Düzeltme: Panoda yeni bir EDL token'ı üretin ve güvenlik duvarının akış adresini güncelleyin. Değişiklikten sonra akışı, kendiliğinden düzeldiğini varsaymak yerine denetleyin. Doğrulama: beklenen · Akış güncel listeyi döndürüyor. Bu geçerli değilse: Destek paketini, cihaz kimliğini ve eklentinin kendi günlüğünü ekleyin. |
EDL akışı güncellenmiyor
Güvenlik duvarı etkileşimli olarak oturum açamaz, bu yüzden akış kendi belirtecini taşır. Süresi dolmuş bir belirteç akışın güncellenmesini durdururken güvenlik duvarı çektiği son listeyi uygulamaya devam eder — arızayı sessiz kılan da budur. Belirteci döndürdükten sonra akışı güvenlik duvarında denetleyin; kendiliğinden düzeldiğini varsaymayın.
Belgelerin size söyleyemeyeceği
- Bir uç nokta ajanının neden tamamen çalışmayı bıraktığı. Ağ geçidi yalnızca sinyalin yokluğunu görür. Ajanın makinedeki kendi günlüğünü okuyun.
- Bir tarayıcı politikasının eklentiyi engelleyip engellemediği. Yönetilen tarayıcı politikası CID'nin görüş alanı dışındadır; cihaz hiçbir istek görmez.
İlgili
- Uç Nokta Ajanı — filolar, politikalar ve cihaz durumu.
- Uç nokta ajanının dağıtımı.
- Tarayıcı Eklentisi — cihazlar, kapsamlar ve EDL akışı.
- Tarayıcı eklentisinin dağıtımı.
Son güncelleme