Uygulama Bağlayıcısı hatalarını giderme

Bu makalede API Uygulaması bağlayıcısı hata iletilerinin listesi ve her hata için çözüm önerileri sağlanır.

Yaygın hata iletileri ve çözümleri

Uygulama bağlayıcısı hataları, API Uygulaması bağlayıcısını kullanarak bir bulut uygulaması bağlanmaya çalışıldıktan sonra uygulama bağlayıcısı iletişim kutusunda görülebilir.

Not

Bağlayıcı bir hata veya bağlantı kesilmesiyle karşılaşırsa bir sistem uyarısı oluşturulur. Normal işlemleri sürdürmek ve bağlantıyı sürdürmek için bağlayıcı sayfasında bağlayıcıyı yeniden bağlayın.

Hata iletisi İlgili uygulama Açıklama Çözüm
HttpRequestFailure: Sunucu şu hatayı döndürdü: 500 İç Sunucu Hatası Tüm uygulamalar Uygulamada bir hata oluştu. Uygulamanın durumunu denetleme
Hizmet zaman aşımı Tüm uygulamalar Defender for Cloud Apps ile uygulama arasındaki bağlantıda zaman aşımı algılandı. Bunun nedeni uygulamayla ilgili bir sorun olabilir. Daha sonra yeniden deneyin.
Olayları alma: İstek 402 durum koduyla başarısız oldu. Ödeme Gerekli. Denetim Günlüğü Yetkilendirme doğrulaması başarısız oldu Atlassian Atlassian aboneliğinde olayları izlemek için gereken 'Atlassian Access' planı yoktur. Lütfen Atlassian aboneliğinizde 'Atlassian Access' planını etkinleştirin.
NullPointerException AWS İç hata Destek ekibine başvurun
AuthFatalFailureException: com.box.boxjavalibv2.exceptions.BoxServerException: {"error":"invalid_grant","error_description":"Geçersiz yenileme jetonu"} Kutusu Box yenileme belirteci geçerli değil Box'ı Defender for Cloud Apps'a yeniden bağlamak için işlemi izleyin.
BoxRestException: Yanıt ayrıştırılamadı. Kutusu İç hata Box bağlantısını test etmek için Şimdi test et bağlantısına yeniden tıklayın.
ContextManagerServiceException: com.adallom.adalib.httputils.exceptions.TokenRefreshException: {"error":"invalid_grant","error_description":"Geçersiz yenileme belirteci"}' Kutusu Box yenileme belirteci geçerli değil Box'ı Defender for Cloud Apps'a yeniden bağlamak için işlemi izleyin.
BoxServerException: Kullanıcı, kurumsal bir hesaba sahip değilse bu özelliğe erişemez Kutusu Box hesabı bir Kurumsal hesap değildir. Box lisansınızı Box'ın Kurumsal sürümüne yükseltin ve ardından Box'ı yeniden Defender for Cloud Apps'a bağlama işlemini izleyin.
BoxServerException: Yetkisiz - Bu hizmetle yetkilendirilemiyor Kutusu Box yöneticisi Box'ta Defender for Cloud Apps uygulamasını sildi. Box'ı Defender for Cloud Apps'a yeniden bağlamak için işlemi izleyin.
HttpRequestFailure: Sunucu şu yanıtı döndürdü: 401 Yetkilendirilmemiş Exchange Online Kullanıcı veya parola yanlış Kullanıcı adı ve parolanın doğru olduğundan emin olun ve Exchange Online yeniden Defender for Cloud Apps bağlamak için işlemi izleyin.
HttpRequestFailure: Sunucu şu yanıtı döndürdü: 404 Bulunamadı Exchange Online Exchange Online’da oturum açmak için kullandığınız hesabın, Exchange Online’da birincil posta kutusu yoktur (örneğin, Microsoft Entra ID’de bulunmayan bir kullanıcı ya da Microsoft Entra ID’de bulunan ancak Exchange Online lisansı olmayan bir kullanıcı). yeni bir yönetici hesabı kullanarak Exchange Online yeniden Defender for Cloud Apps bağlamak için işlemi izleyin.
GoogleJsonResponseException: 401 Yetkisiz Google Çalışma Alanı Erişim reddedildi. Etkinlik kayıtlarını okuma yetkiniz yok. Google Workspace'de oturum açtığınız kullanıcının yönetici kullanıcı olması gerekir. Google Workspace'i bir yönetici hesabı kullanarak yeniden Defender for Cloud Apps bağlamak için işlemi izleyin.
GoogleJsonResponseException: 403 Erişim Yasak Google Çalışma Alanı
Google Workspace API'sini çalıştırma sorunu. Google Workspace için Defender for Cloud Apps Uygulama Bağlayıcısı'nı yeni dağıttıysanız aşağıdakileri denetleyin: Sınırsız'a tıkladıysanız Google Workspace hesabınızın gerçekten sınırsız olduğundan emin olun. Değilse, Uygulama Bağlayıcısı'nı yeniden çalıştırın ve sınırsız hesap seçeneğinin işaretini kaldırın. Kurulum sırasında tanımladığınız kapsamların doğru olup olmadığını denetleyin. Bu yeni bir dağıtım değilse ve bu hatayı görüyorsanız, bugün için API sınırına ulaşmış olabilirsiniz ve Google Workspace etkinlikleri yarın yenilenecektir.
TokenResponseException: 400 Hatalı İstek Google Çalışma Alanı Google Workspace bağlantısı tamamlanmadı veya süresi doldu. Google Workspace'i yeniden Defender for Cloud Apps bağlamak için işlemi izleyin.
HttpRequestFailure: Sunucu şu yanıtı döndürdü: 401 Yetkilendirilmemiş Okta Okta belirteci geçerli değil. Okta'yı yeniden Defender for Cloud Apps bağlamak için işlemi izleyin.
Ioexception: Okta İç hata Destek ekibine başvurun
HttpRequestFailure: Sunucu şu yanıtı döndürdü: 404 Bulunamadı Okta İç hata Destek ekibine başvurun
HttpRequestFailure: Sunucu döndürüldü: 400 Hatalı İstek: {"error":{"code":"AF20012","message":"Belirtilen kiracı kimliği (Tenant_ID buraya gider) sistemde yanlış yapılandırılmış." Microsoft 365 Atanmış Microsoft 365 lisansı bulunamadı. Kiracınıza en az bir Microsoft 365 lisansı atayın.
Microsoft.Office.Compliance.Audit.DataServiceException: Kiracı 998cea7e-35cd-46a5-ab3c-8ec88a45d7d5 yok veya {"error":"code":"AF20023","message":"Abonelik devre dışı bırakıldı." Microsoft 365 Microsoft 365'te denetim günlüğü etkinleştirilmedi Microsoft 365'te denetim günlüğünü etkinleştirin. Daha fazla bilgi edinin
HttpRequestFailure: Sunucu şu yanıtı döndürdü: 401 Yetkilendirilmemiş Microsoft 365 İç sorun Şimdi test et bağlantısına yeniden tıklayın
TokenRefreshException: {"error":"invalid_grant","error_description":"AADSTS70002: Kimlik bilgileri doğrulanırken hata oluştu. AADSTS70008: Sağlanan yetkilendirme kodunun veya yenileme belirtecinin süresi doldu. Bu kullanıcı ve kaynak için yeni bir etkileşimli yetkilendirme isteği gönderin. Microsoft 365 Belirtecin süresi doldu Microsoft 365'i yeniden Defender for Cloud Apps bağlamak için işlemi izleyin.
SocketTimeoutException: Okuma işlemi zaman aşımına uğradı Microsoft 365 İç hata Şimdi test et bağlantısına yeniden tıklayın
NullPointerException Microsoft 365 İç hata Destek ekibine başvurun
IgniteException Microsoft 365 Etki alanı veya kullanıcı geçerli değil Ayarlarınızı sıfırlayın ve Microsoft 365'i yeniden Defender for Cloud Apps bağlamak için işlemi izleyin.
ContextManagerServiceException: com.adallom.adalib.httputils.exceptions.TokenRefreshException: {"error":"invalid_grant","error_description":"AADSTS70002: Kimlik bilgileri doğrulanırken hata oluştu. AADSTS70008: Sağlanan yetkilendirme kodunun veya yenileme belirtecinin süresi doldu. Bu kullanıcı ve kaynak için yeni bir etkileşimli yetkilendirme isteği gönderin. Microsoft 365 Etki alanı veya kullanıcı geçerli değil Ayarlarınızı sıfırlayın ve Microsoft 365'i yeniden Defender for Cloud Apps bağlamak için işlemi izleyin.
HttpRequestFailure: Sunucu şunu döndürdü: 400 Hatalı İstek Microsoft 365 İç hata Birkaç dakika içinde Şimdi test et bağlantısına yeniden tıklayın, işe yaramazsa Microsoft 365'i yeniden Defender for Cloud Apps bağlama işlemini izleyin.
SocketTimeoutException: Okuma işlemi zaman aşımına uğradı Salesforce İç hata Salesforce bağlantısını test etmek için Şimdi test et bağlantısına yeniden tıklayın.
HttpRequestFailure: Sunucu şunu döndürdü: 400 Hatalı İstek Salesforce Salesforce bağlantısı tamamlanmadı veya süresi doldu. Salesforce'u yeniden Defender for Cloud Apps bağlamak için işlemi izleyin.
İzinleri Al: HayırHttpResponseException: *******.salesforce.com:443 yanıt veremedi Salesforce Müşteri ENV'sinde IP kısıtlaması. Salesforce portalında,Oturum Ayarlarını> altında Oturumları kaynaklandıkları IP adresine kilitle onay kutusunu temizleyin.
team_not_authorized Slack Slack Bulma API'si etkinleştirilmedi. Slack desteğine başvurun ve Bulma API'sini etkinleştirmeyi isteyin.
RuntimeException: com.adallom.adalib.httputils.exceptions.HttpRequestFailure: Sunucu şu yanıtı verdi: 403 Erişim Yasak ServiceNow İzinler yanlış ServiceNow'u bir yönetici hesabı kullanarak Defender for Cloud Apps'e yeniden bağlamak için aşağıdaki işlemi izleyin.
Gerçekleştirmeye çalıştığınız işlem planınız tarafından desteklenmiyor Smartsheet Smartsheet Planı doğru değil, platin paketine sahip bir kurumsal lisans gereklidir Smartsheet lisansını yükseltin.
Olayları al: {"code":403,"serverResponse"
Kullanıcıları getir: {"code":403,"serverResponse"

"body":"{"error":"izin reddedildi"}"
Işgünü Denetim günlüklerine ve/veya kullanıcı uç noktalarına erişmek için yeterli izin yok Tüm izinlerin yerinde olduğunu doğrulayın. Daha fazla bilgi edinin
"code":400,"serverResponse"

body":"{"error":"invalid_grant"}
Işgünü Kimlik doğrulama sorunu Örneği ayarlamak için kullanılan hesap kilitli veya devre dışı bırakılmış olabilir. Doğrulamak için Workday hesabını görüntüleyin ve Oturum Açma Geçmişini Görüntüle'yi seçin. Raporda Sistem Hesabının devre dışı bırakıldığını belirten bir kimlik doğrulama hatası iletisi görebilirsiniz. Daha fazla bilgi edinin
"code":401,"serverResponse":

body":"{"error":"invalid_client"}"
Işgünü İstemci belirteci geçerlilik sorunu OAuth 2.0 REST API İstemci belirteci geçerli değil. Belirtecin süresi dolmuş veya yanlış olabilir. Başka bir belirteç oluşturun ve bağlı örneğe atayın. Daha fazla bilgi edinin
Kullanıcıyı getir: Başarılı Olayları getir: İstek 403 durum koduyla başarısız oldu Zendesk Tümleştirmeyi yapılandıran Zendesk kullanıcısı artık bir Zendesk yöneticisi değil veya Zendesk lisansınız desteklenmiyor. Bağlayıcıyı yapılandıran Zendesk kullanıcısını yöneticiye yükseltin (Zendesk yönetici portalından) veya Zendesk lisansınızın desteklenip desteklenmediğini görmek için buraya bakın.

Bir uygulamayı bağladıktan sonra eksik etkinliklerle ilgili sorunları giderme

Bir uygulamayı bağladıktan sonra beklenen etkinlikler gösterilmiyorsa, verilerin nerede kullanılabilir olacağını ve ek yapılandırma gerekip gerekmediğini belirlemek için aşağıdaki denetimleri kullanın.

1. Bağlayıcının iyi durumda olduğunu onaylayın Uygulama bağlayıcısının başarıyla bağlandığını ve yapılandırma uyarısı veya izin sorunu olmadığını doğrulayın.

2. Veri alımı gecikmesi beklentilerini kontrol edin Bazı bağlayıcılarda, etkinlikler görünmeden önce beklenen bir gecikme olabilir. Eksik etkinliği sorun olarak ele almadan önce bağlayıcının belgelenmiş bir alım gecikmesi olup olmadığını doğrulayın.

3. Bağlayıcının etkinlik alımını desteklediğini onaylayın Bağlayıcının etkinlik toplamayı destekleyip desteklemediğini denetleyin. Bağlayıcı başına desteklenen etkinliklerin listesi için bkz. Görünürlük ve denetim elde etmek için uygulamaları bağlama.

4. Bağlayıcıya özgü etkinlik seçeneklerini gözden geçirin Seçilebilir etkinlik türlerini destekleyen bağlayıcılar için gerekli seçeneklerin etkinleştirildiğini onaylayın. Örneğin, oturum açma etkinliğini araştırıyorsanız bağlayıcının ilgili oturum açma verilerini toplayacak şekilde yapılandırıldığını doğrulayın.

5. Kapsamlı dağıtım ayarlarını doğrulayın Kapsamlı dağıtım etkinleştirildiyse, etkinliği gerçekleştiren hesabın geçerli kapsamlı dağıtım kurallarına dahil olduğunu doğrulayın. Dışlanan kullanıcılar, gruplar veya uygulamalar tarafından oluşturulan etkinlikler içeri alınmaz. Ayrıca, özellikle farklı tanımlayıcı biçimleri kullanıldığında bağlı uygulamalarda hesap tanımlayıcılarının doğru eşleştirilip eşleştirilmediğini doğrulayın.

6. Beklenen günlük yüzeyini doğrulayın Etkinlik türüne bağlı olarak, olayın aşağıdaki tabloda listelenen uygun kaynakta görünüp görünmediğini denetleyin.

Olay Kaynak
Defender for Cloud Apps ilke yönetimi değişiklikleri Microsoft Defender for Cloud Apps Etkinlik günlüğü
Microsoft Entra oturum açma olayları Microsoft Entra oturum açma günlükleri
Kimlikle ilgili araştırma verileri Advanced Hunting kimlik tabloları

7. Verilerin eksik olduğu sonucuna varmadan önce filtreleri uygulayın Aşağıdaki gibi filtreleri kullanın:

  • Zaman aralığı
  • Kullanıcı veya yönetici
  • Etkinlik türü
  • Uygulama veya iş yükü

8. Bilinen kapsam sınırlamalarını kontrol edin Bazı etkinlikler her günlüğe kaydetme yüzeyinde tam olarak temsil edilmeyebilir. Bir kaynakta bir olay eksikse, etkinliğin başka bir kaynakta kullanılabilir olarak belgelenip belgelenmediğini onaylayın.

Önemli

Etkinliğin eksik olduğu her zaman bağlayıcı hatasına işaret etmez. İlk olarak etkinliğin Defender for Cloud Apps, Microsoft Entra günlüklerinde, Microsoft 365 denetim günlüklerinde veya Gelişmiş Tehdit Avcılığı'nda beklendiğini onaylayın.

Daha fazla araştırma

Şu durumlarda daha fazla inceleme yapın:

  • Bağlayıcı sağlıklı görünüyor, ancak desteklenen hiçbir günlükleme yüzeyinde beklenen veriler görünmüyor.
  • Gerekli etkinlik seçenekleri etkinleştirilmiş, ancak makul bir doğrulama süresi geçmesine rağmen olay hâlâ görünmüyor.
  • Aynı etkinlik türü birden çok denetimde tutarlı olarak kullanılamaz.

Sonraki adımlar

Herhangi bir sorunla karşılaşırsanız size yardımcı olmak için buradayız. Ürün sorununuzla ilgili yardım veya destek almak için lütfen bir destek bileti açın.