Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Artikel ini menyediakan daftar pesan kesalahan konektor Aplikasi API dan rekomendasi resolusi untuk setiap kesalahan.
Pesan dan resolusi kesalahan umum
Kesalahan konektor aplikasi dapat dilihat dalam dialog konektor aplikasi setelah mencoba menyambungkan aplikasi cloud menggunakan konektor Aplikasi API.
Note
Jika konektor mengalami kegagalan atau pemutusan sambungan, pemberitahuan sistem akan dihasilkan. Untuk melanjutkan operasi normal dan mempertahankan konektivitas, sambungkan kembali konektor di halaman konektor.
| Pesan kesalahan | Aplikasi yang relevan | Deskripsi | Resolution |
|---|---|---|---|
| HttpRequestFailure: Server dikembalikan: Kesalahan server internal 500 | Semua aplikasi | Ada kesalahan dalam aplikasi. | Memeriksa status aplikasi |
| Batas waktu layanan | Semua aplikasi | Batas waktu terdeteksi dalam koneksi antara Defender for Cloud Apps dan aplikasi. Ini bisa disebabkan oleh masalah dengan aplikasi. | Coba lagi nanti. |
| Dapatkan peristiwa: Permintaan gagal dengan kode status 402. Pembayaran Diperlukan. Validasi otorisasi Audit Log gagal | Atlassian | Langganan Atlassian tidak memiliki paket 'Atlassian Access' yang diperlukan untuk memantau peristiwa. | Harap aktifkan paket 'Atlassian Access' pada langganan Atlassian Anda. |
| NullPointerException | AWS | Kesalahan internal | Hubungi dukungan |
| AuthFatalFailureException: com.box.boxjavalibv2.exceptions.BoxServerException: {"error":"invalid_grant","error_description":"Token penyegaran tidak valid"} | Kotak | Token refresh Kotak tidak valid | Ikuti proses untuk menyambungkan Box ke Defender for Cloud Apps lagi. |
| BoxRestException: Gagal mengurai respons. | Kotak | Kesalahan internal | Klik tautan Uji sekarang lagi untuk menguji koneksi ke Box. |
| ContextManagerServiceException: com.adallom.adalib.httputils.exceptions.TokenRefreshException: {"error":"invalid_grant","error_description":"Token penyegaran tidak valid"}' | Kotak | Token refresh Kotak tidak valid | Ikuti proses untuk menyambungkan Box ke Defender for Cloud Apps lagi. |
| BoxServerException: Pengguna tidak dapat mengakses fitur ini tanpa memiliki perusahaan | Kotak | Akun Box bukan akun Enterprise. | Tingkatkan lisensi Box Anda ke Box versi Enterprise lalu ikuti proses untuk menyambungkan Box ke Defender for Cloud Apps lagi. |
| BoxServerException: Tidak sah - Tidak dapat mengotorisasi dengan layanan ini | Kotak | Admin Box menghapus aplikasi Defender for Cloud Apps di Box. | Ikuti proses untuk menyambungkan Box ke Defender for Cloud Apps lagi. |
| HttpRequestFailure: Server mengembalikan: 401 Tidak Diotorisasi | Pertukaran Online | Pengguna atau kata sandi salah | Pastikan nama pengguna dan kata sandi sudah benar dan Ikuti proses untuk menyambungkan Exchange Online ke Defender for Cloud Apps lagi. |
| HttpRequestFailure: Server dikembalikan: 404 Tidak Ditemukan | Pertukaran Online | Pengguna yang Anda gunakan untuk masuk ke Exchange Online tidak memiliki kotak surat utama di Exchange Online (misalnya, pengguna yang tidak ada di Microsoft Entra ID atau pengguna ada di Microsoft Entra ID, tetapi tidak memiliki Exchange Online lisensi). | Ikuti proses untuk menyambungkan Exchange Online ke Defender for Cloud Apps lagi menggunakan akun admin baru. |
| GoogleJsonResponseException: 401 Tidak Sah | Google Workspace | Akses ditolak. Anda tidak berwenang untuk membaca rekaman aktivitas. Pengguna yang Anda gunakan untuk masuk ke Google Workspace harus merupakan pengguna admin. | Ikuti proses untuk menghubungkan Google Workspace ke Defender for Cloud Apps lagi menggunakan akun admin. |
| GoogleJsonResponseException: 403 Dilarang | Google Workspace | ||
| Masalah saat menjalankan Google Workspace API. | Jika Anda baru saja menyebarkan konektor aplikasi Defender for Cloud Apps untuk Google Workspace, periksa hal berikut: Jika Anda mengklik Tidak Terbatas, pastikan akun Google Workspace Anda benar-benar tidak terbatas. Jika tidak, jalankan Konektor Aplikasi lagi dan batalkan pilih opsi untuk akun tak terbatas. Periksa apakah cakupan yang Anda tentukan selama penyiapan sudah benar. Jika ini bukan deployment baru dan Anda melihat error ini, kemungkinan Anda telah mencapai batas API untuk hari ini dan event Google Workspace akan diperpanjang besok. | ||
| TokenResponseException: 400 Permintaan Buruk | Google Workspace | Koneksi ke Google Workspace tidak selesai atau kedaluwarsa. | Ikuti proses untuk menghubungkan Google Workspace ke Defender for Cloud Apps lagi. |
| HttpRequestFailure: Server mengembalikan: 401 Tidak Diotorisasi | Okta | Token Okta tidak valid. | Ikuti proses untuk menyambungkan Okta ke Defender for Cloud Apps lagi. |
| IOException: | Okta | Kesalahan internal | Hubungi dukungan |
| HttpRequestFailure: Server dikembalikan: 404 Tidak Ditemukan | Okta | Kesalahan internal | Hubungi dukungan |
| HttpRequestFailure: Server mengembalikan: 400 Bad Request: {"error":{"code":"AF20012","message":"ID tenant yang ditentukan (Tenant_ID di sini) dikonfigurasi secara tidak benar di sistem." | Microsoft 365 | Tidak ditemukan lisensi Microsoft 365 yang ditetapkan. | Tetapkan setidaknya satu lisensi Microsoft 365 ke penyewa Anda. |
| Microsoft. Office.Compliance.Audit.DataServiceException: Penyewa 998cea7e-35cd-46a5-ab3c-8ec88a45d7d5 tidak ada atau {"error":"code":"AF20023","message":"Langganan dinonaktifkan." | Microsoft 365 | Pengelogan audit tidak diaktifkan di Microsoft 365 | Aktifkan pengelogan audit di Microsoft 365. Pelajari lebih lanjut |
| HttpRequestFailure: Server mengembalikan: 401 Tidak Diotorisasi | Microsoft 365 | Masalah internal | Klik tautan Uji sekarang lagi |
| TokenRefreshException: {"error":"invalid_grant","error_description":"AADSTS70002: Kesalahan saat memvalidasi kredensial. AADSTS70008: Kode otorisasi yang disediakan atau token refresh kedaluwarsa. Kirim permintaan otorisasi interaktif baru untuk pengguna dan sumber daya ini. | Microsoft 365 | Token telah kedaluwarsa | Ikuti proses untuk menyambungkan Microsoft 365 ke Defender for Cloud Apps lagi. |
| SocketTimeoutException: Waktu tunggu pembacaan habis | Microsoft 365 | Kesalahan internal | Klik tautan Uji sekarang lagi |
| NullPointerException | Microsoft 365 | Kesalahan internal | Hubungi dukungan |
| IgniteException | Microsoft 365 | Domain atau pengguna tidak valid | Reset pengaturan Anda dan ikuti proses untuk menyambungkan Microsoft 365 ke Defender for Cloud Apps lagi. |
| ContextManagerServiceException: com.adallom.adalib.httputils.exceptions.TokenRefreshException: {"error":"invalid_grant","error_description":"AADSTS70002: Kesalahan saat memvalidasi kredensial. AADSTS70008: Kode otorisasi yang disediakan atau token refresh kedaluwarsa. Kirim permintaan otorisasi interaktif baru untuk pengguna dan sumber daya ini. | Microsoft 365 | Domain atau pengguna tidak valid | Reset pengaturan Anda dan ikuti proses untuk menyambungkan Microsoft 365 ke Defender for Cloud Apps lagi. |
| HttpRequestFailure: Server dikembalikan: 400 Permintaan Buruk | Microsoft 365 | Kesalahan internal | Klik tautan Uji sekarang lagi dalam beberapa menit, jika tidak berfungsi, ikuti proses untuk menyambungkan Microsoft 365 ke Defender for Cloud Apps lagi. |
| SocketTimeoutException: Waktu tunggu pembacaan habis | Salesforce | Kesalahan internal | Klik tautan Uji sekarang lagi untuk menguji koneksi ke Salesforce. |
| HttpRequestFailure: Server dikembalikan: 400 Permintaan Buruk | Salesforce | Koneksi ke Salesforce tidak selesai atau kedaluwarsa. | Ikuti proses untuk menghubungkan Salesforce ke Defender for Cloud Apps lagi. |
Dapatkan Izin Akses: NoHttpResponseException: *******.salesforce.com:443 gagal memberikan respons |
Salesforce | Pembatasan IP pada ENV milik pelanggan. | Di portal Salesforce, di bawahPengaturan Sesi>, kosongkan kotak centang Kunci sesi ke alamat IP asalnya. |
| Tim tidak diotorisasi | Slack | Slack Discovery API tidak diaktifkan. | Hubungi dukungan Slack dan minta untuk mengaktifkan Discovery API. |
| RuntimeException: com.adallom.adalib.httputils.exceptions.HttpRequestFailure: Server dikembalikan: 403 Terlarang | ServiceNow | Izin salah | Ikuti proses untuk menyambungkan ServiceNow ke Defender for Cloud Apps lagi menggunakan akun admin. |
| Operasi yang sedang Anda coba lakukan tidak didukung oleh paket Anda | Smartsheet | Paket Smartsheet tidak benar, lisensi perusahaan dengan paket platinum diperlukan | Tingkatkan lisensi Smartsheet. |
| Dapatkan peristiwa: {"code":403,"serverResponse" Dapatkan pengguna: {"code":403,"serverResponse" … "body":"{"error":"izin ditolak"}" |
Workday | Anda tidak memiliki izin yang memadai untuk mengakses log audit dan/atau endpoint pengguna | Verifikasi bahwa semua izin sudah ada. Pelajari lebih lanjut |
| "code":400,"serverResponse" … body":"{"error":"invalid_grant"} |
Workday | Masalah autentikasi | Akun yang digunakan untuk menyiapkan instans dapat dikunci atau dinonaktifkan. Untuk memverifikasi, lihat akun Workday dan pilih Lihat Riwayat Masuk. Anda mungkin melihat pesan kegagalan autentikasi dalam laporan yang menentukan bahwa Akun Sistem dinonaktifkan. Pelajari lebih lanjut |
| "code":401,"serverResponse": … body":"{"error":"invalid_client"}" |
Workday | Masalah validitas token klien | Token Klien REST API OAuth 2.0 tidak valid. Token mungkin telah kedaluwarsa, atau mungkin salah. Buat token lain dan tetapkan ke instans yang terhubung. Pelajari lebih lanjut |
| Ambil pengguna: Berhasil Ambil peristiwa: Permintaan gagal dengan kode status 403 | Zendesk | Pengguna Zendesk yang mengonfigurasi integrasi bukan lagi admin Zendesk, atau lisensi Zendesk Anda tidak didukung. | Tingkatkan pengguna Zendesk yang mengonfigurasi konektor ke admin (dari portal admin Zendesk), atau periksa di sini untuk melihat apakah lisensi Zendesk Anda didukung. |
Memecahkan masalah aktivitas yang hilang setelah Anda menyambungkan aplikasi
Jika aktivitas yang diharapkan tidak ditampilkan setelah Anda menyambungkan aplikasi, gunakan pemeriksaan berikut untuk menentukan di mana data harus tersedia dan apakah konfigurasi tambahan diperlukan.
1. Pastikan konektor sehat Verifikasi bahwa konektor aplikasi berhasil tersambung dan tidak ada peringatan konfigurasi atau masalah izin.
2. Periksa ekspektasi penundaan penyerapan Beberapa konektor memiliki latensi yang diharapkan sebelum aktivitas muncul. Periksa apakah konektor memiliki penundaan ingesti yang terdokumentasi sebelum menganggap aktivitas yang hilang sebagai masalah.
3. Konfirmasikan bahwa konektor mendukung penyerapan aktivitas Periksa apakah konektor mendukung pengumpulan aktivitas. Untuk daftar aktivitas yang didukung per konektor, lihat Menyambungkan aplikasi untuk mendapatkan visibilitas dan kontrol.
4. Tinjau opsi aktivitas khusus konektor Untuk konektor yang mendukung jenis aktivitas yang dapat dipilih, konfirmasikan bahwa opsi yang diperlukan diaktifkan. Misalnya, jika Anda menyelidiki aktivitas masuk, verifikasi bahwa konektor dikonfigurasi untuk mengumpulkan data masuk yang relevan.
5. Verifikasi pengaturan penyebaran terlingkup Jika penyebaran terlingkup diaktifkan, konfirmasikan bahwa akun yang melakukan aktivitas disertakan dalam aturan penyebaran terlingkup saat ini. Aktivitas yang dihasilkan oleh pengguna, grup, atau aplikasi yang dikecualikan tidak diserap. Verifikasi juga apakah pengidentifikasi akun dicocokkan dengan benar dalam aplikasi yang terhubung, terutama ketika format pengidentifikasi yang berbeda digunakan.
6. Validasi permukaan pengelogan yang diharapkan Tergantung pada jenis aktivitas, periksa apakah peristiwa muncul di sumber yang sesuai yang tercantum dalam tabel berikut.
| Event | Source |
|---|---|
| Perubahan pada administrasi kebijakan Defender for Cloud Apps | Log aktivitas Microsoft Defender for Cloud Apps |
| Aktivitas masuk Microsoft Entra | catatan log masuk Microsoft Entra |
| Data investigasi terkait identitas | Tabel identitas Advanced Hunting |
7. Terapkan filter sebelum menyimpulkan bahwa data hilang Gunakan filter seperti:
- Rentang waktu
- Pengguna atau administrator
- Jenis aktivitas
- Aplikasi atau beban kerja
8. Periksa keterbatasan cakupan yang diketahui Beberapa aktivitas mungkin tidak tercatat sepenuhnya di setiap sarana pencatatan log. Jika peristiwa hilang dari satu sumber, konfirmasikan apakah aktivitas tersebut didokumenkan sebagai tersedia di sumber lain.
Penting
Aktivitas yang hilang tidak selalu menunjukkan kegagalan konektor. Pertama, konfirmasikan apakah aktivitas tersebut memang diharapkan muncul di Defender for Cloud Apps, log Microsoft Entra, log audit Microsoft 365, atau Advanced Hunting.
Selidiki lebih lanjut
Selidiki lebih lanjut jika:
- Konektor berstatus sehat, tetapi tidak ada data yang seharusnya muncul di sarana logging yang didukung.
- Opsi aktivitas yang diperlukan diaktifkan, tetapi event masih belum muncul setelah periode validasi yang wajar.
- Jenis aktivitas yang sama secara konsisten tidak tersedia dalam beberapa pemeriksaan.
Langkah berikutnya
Jika Anda mengalami masalah, kami di sini untuk membantu. Untuk mendapatkan bantuan atau dukungan untuk masalah produk Anda, buka tiket dukungan.