Pemecahan masalah error runtime JSON Threat Protection

Anda sedang melihat dokumentasi Apigee dan Apigee Hybrid.
Lihat dokumentasi Apigee Edge.

ExecutionFailed

Kode Error

steps.jsonthreatprotection.ExecutionFailed

Isi respons error

{
    "fault": {
        "faultstring": "JSONThreatProtection[policy_name]:
          Execution failed. reason: JSONThreatProtection[policy_name]: error_description
          at line line_num",
        "detail": {
            "errorcode": "steps.jsonthreatprotection.ExecutionFailed"
        }
    }
}

Jenis Error dan kemungkinan penyebabnya

Kebijakan JSONThreatProtection dapat memunculkan berbagai jenis error ExecutionFailed. Tabel di bawah mencantumkan berbagai jenis error dan kemungkinan penyebabnya:

Jenis error Penyebab
Panjang nama entri objek melebihi batas Panjang string maksimum yang diizinkan dalam nama entri objek terlampaui.
Melebihi jumlah entri objek Jumlah maksimum entri yang diizinkan dalam objek terlampaui.
Jumlah elemen array terlampaui Jumlah maksimum elemen yang diizinkan dalam array terlampaui.
Melebihi kedalaman penampung Kedalaman bertingkat maksimum yang diizinkan terlampaui.
Melebihi panjang nilai string Panjang maksimum yang diizinkan untuk nilai string terlampaui.
Objek JSON tidak valid Payload JSON input tidak valid.

Melebihi panjang nama entri objek

Isi respons error

{
    "fault": {
        "faultstring": "JSONThreatProtection[policy_name]:
          Execution failed. reason: JSONThreatProtection[policy_name]:
          Exceeded object entry name length at line line_num",
        "detail": {
            "errorcode": "steps.jsonthreatprotection.ExecutionFailed"
        }
    }
}

Contoh isi respons Error

{
    "fault": {
        "faultstring": "JSONThreatProtection[JSON-Threat-Protection-1]:
          Execution failed. reason: JSONThreatProtection[JSON-Threat-Protection-1]:
          Exceeded object entry name length at line 2",
        "detail": {
            "errorcode": "steps.jsonthreatprotection.ExecutionFailed"
        }
    }
}

Penyebab

Error ini terjadi jika payload pesan input yang ditentukan oleh elemen <Source> berisi objek JSON dengan nama properti yang melebihi panjang maksimum yang ditentukan dalam elemen <ObjectEntryNameLength>.

Misalnya, jika elemen <ObjectEntryNameLength> ditentukan sebagai 5 dalam kebijakan, tetapi payload pesan input memiliki properti JSON yang namanya melebihi 5 karakter, maka error ini akan ditampilkan.

Diagnosis

  1. Periksa pesan error untuk mengidentifikasi nama kebijakan JSONThreatProtection dan nomor baris tempat nama entri panjang terjadi. Misalnya, dalam pesan error berikut, nama kebijakan JSONThreatProtection adalah JSON-Threat-Protection-1 dan nomor baris dalam payload adalah 2.

    JSONThreatProtection[JSON-Threat-Protection-1]: Execution failed. reason:
    JSONThreatProtection[JSON-Threat-Protection-1]: Exceeded object entry name
    length at line 2
    
  2. Periksa kebijakan yang Anda identifikasi di Langkah 1, dan catat nilai yang ditentukan dalam elemen <ObjectEntryNameLength>.

    Misalnya, dalam kebijakan JSONThreatProtection berikut, <ObjectEntryNameLength> disetel ke 5:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <JSONThreatProtection async="false" continueOnError="false" enabled="true" name="JSON-Threat-Protection-1">
        <DisplayName>JSON Threat Protection-1</DisplayName>
        <Properties/>
        <ArrayElementCount>3</ArrayElementCount>
        <ContainerDepth>12</ContainerDepth>
        <ObjectEntryCount>5</ObjectEntryCount>
        <ObjectEntryNameLength>5</ObjectEntryNameLength>
        <Source>request</Source>
        <StringValueLength>50</StringValueLength>
    </JSONThreatProtection>
    
  3. Periksa nomor baris tertentu (diidentifikasi di Langkah 1) payload input dan periksa apakah panjang nama objek lebih besar daripada nilai yang ditentukan dalam elemen <ObjectEntryNameLength> (diidentifikasi di Langkah 2). Jika panjang nama objek melebihi angka tersebut, maka itulah penyebab errornya.

    Berikut adalah contoh payload input:

    {
       "number" : 500,
       "string" : "text"
    }
    

    Payload JSON yang ditampilkan di atas memiliki properti bernama number di baris 2 yang memiliki 6 karakter (panjang nama adalah 6). Karena panjang nama objek lebih besar dari 5 (nilai yang ditentukan untuk elemen <ObjectEntryNameLength>), Anda akan mendapatkan error berikut:

    JSONThreatProtection[JSON-Threat-Protection-1]: Execution failed. reason:
    JSONThreatProtection[JSON-Threat-Protection-1]: Exceeded object entry name
    length at line 2
    

Resolusi

Jika kebijakan JSONThreatProtection dimaksudkan untuk melindungi dari payload dengan nama entri objek yang melebihi nilai yang ditentukan, pesan error akan muncul. Dalam hal ini, Anda tidak perlu melakukan tindakan tambahan apa pun.

Namun, jika Anda menentukan bahwa nama entri objek yang lebih panjang dapat ditentukan dalam payload tanpa konsekuensi apa pun, ubah <ObjectEntryNameLength> ke nilai yang sesuai berdasarkan persyaratan Anda.

Misalnya, jika Anda merasa dapat mengizinkan nama objek hingga panjang 10 karakter, ubah kebijakan JSONThreatProtection sebagai berikut:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<JSONThreatProtection async="false" continueOnError="false" enabled="true" name="JSON-Threat-Protection-1">
    <DisplayName>JSON Threat Protection-1</DisplayName>
    <Properties/>
    <ArrayElementCount>3</ArrayElementCount>
    <ContainerDepth>12</ContainerDepth>
    <ObjectEntryCount>5</ObjectEntryCount>
    <ObjectEntryNameLength>10</ObjectEntryNameLength>
    <Source>request</Source>
    <StringValueLength>50</StringValueLength>
</JSONThreatProtection>

Melebihi jumlah entri objek

Isi respons error

{
    "fault": {
        "faultstring": "JSONThreatProtection[policy_name]:
          Execution failed. reason: JSONThreatProtection[policy_name]:
          Exceeded object entry count at line line_num",
        "detail": {
            "errorcode": "steps.jsonthreatprotection.ExecutionFailed"
        }
    }
}

Contoh isi respons Error

{
    "fault": {
        "faultstring": "JSONThreatProtection[JSON-Threat-Protection-1]:
          Execution failed. reason: JSONThreatProtection[JSON-Threat-Protection-1]:
          Exceeded object entry count at line 7",
        "detail": {
            "errorcode": "steps.jsonthreatprotection.ExecutionFailed"
        }
    }
}

Penyebab

Error ini terjadi jika payload pesan input yang ditentukan oleh elemen <Source> berisi objek JSON yang berisi lebih banyak entri (properti) daripada nilai yang ditentukan dalam elemen <ObjectEntryCount> kebijakan.

Misalnya, jika elemen <ObjectEntryCount> adalah 5, tetapi payload JSON input memiliki lebih dari 5 entri, maka error ini akan ditampilkan.

Diagnosis

  1. Periksa pesan error untuk mengidentifikasi nama kebijakan JSONThreatProtection dan nomor baris tempat jumlah entri terlampaui. Misalnya, dalam pesan error berikut, nama kebijakan adalah JSON-Threat-Protection-1 dan nomor baris dalam payload adalah 7:

    JSONThreatProtection[JSON-Threat-Protection-1]: Execution failed. reason:
    JSONThreatProtection[JSON-Threat-Protection-1]: Exceeded object entry count
    at line 7
    
  2. Catat nilai yang ditentukan dalam elemen <ObjectEntryCount> kebijakan (diidentifikasi di Langkah 1).

    Dalam contoh kebijakan berikut, <ObjectEntryCount> disetel ke 5:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <JSONThreatProtection async="false" continueOnError="false" enabled="true" name="JSON-Threat-Protection-1">
        <DisplayName>JSON Threat Protection-1</DisplayName>
        <Properties/>
        <ArrayElementCount>3</ArrayElementCount>
        <ContainerDepth>12</ContainerDepth>
        <ObjectEntryCount>5</ObjectEntryCount>
        <ObjectEntryNameLength>6</ObjectEntryNameLength>
        <Source>request</Source>
        <StringValueLength>50</StringValueLength>
    </JSONThreatProtection>
    
  3. Periksa nomor baris tertentu (diidentifikasi di Langkah 1) dari payload input dan periksa apakah jumlah entitas dalam payload lebih besar daripada nilai yang ditentukan untuk elemen <ObjectEntryCount> (diidentifikasi di Langkah 2). Jika jumlah objek melebihi jumlah entri objek, maka itulah penyebab error.

    Berikut adalah contoh payload input:

    {
    "name" : "John",
    "id" : 234687,
    "age" : 31,
    "city" : "New York",
    "country" : "USA",
    "company" : "Google"
    }
    

    Dalam payload JSON yang ditampilkan di atas, entri ke-6 terjadi di baris #7 (perusahaan). Karena jumlah entri objek dalam payload JSON input lebih besar dari 5 (nilai yang ditentukan untuk elemen <ObjectEntryCount>), Anda akan mendapatkan error berikut:

    JSONThreatProtection[JSON-Threat-Protection-1]: Execution failed. reason:
    JSONThreatProtection[JSON-Threat-Protection-1]: Exceeded object entry count at
    line 7
    

Resolusi

Jika kebijakan JSONThreatProtection dimaksudkan untuk melindungi dari payload dengan sejumlah entri objek yang melebihi batas tertentu, pesan error ini akan muncul. Dalam hal ini, Anda tidak perlu melakukan tindakan tambahan apa pun.

Namun, jika Anda menentukan bahwa lebih banyak entri objek dapat disertakan dalam payload tanpa konsekuensi apa pun, ubah <ObjectEntryCount> ke nilai yang sesuai berdasarkan persyaratan Anda.

Misalnya, jika Anda merasa dapat mengizinkan hingga 10 entri objek, ubah kebijakan JSONThreatProtection sebagai berikut:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<JSONThreatProtection async="false" continueOnError="false" enabled="true" name="JSON-Threat-Protection-1">
    <DisplayName>JSON Threat Protection-1</DisplayName>
    <Properties/>
    <ArrayElementCount>3</ArrayElementCount>
    <ContainerDepth>12</ContainerDepth>
    <ObjectEntryCount>10</ObjectEntryCount>
    <ObjectEntryNameLength>6</ObjectEntryNameLength>
    <Source>request</Source>
    <StringValueLength>50</StringValueLength>
</JSONThreatProtection>

Melebihi jumlah elemen array

Isi respons error

{
    "fault": {
        "faultstring": "JSONThreatProtection[policy_name]:
          Execution failed. reason: JSONThreatProtection[policy_name]:
          Exceeded array element count at line line-num",
        "detail": {
            "errorcode": "steps.jsonthreatprotection.ExecutionFailed"
        }
    }
}

Contoh isi respons Error

{
    "fault": {
        "faultstring": "JSONThreatProtection[JSON-Threat-Protection-1]:
          Execution failed. reason: JSONThreatProtection[JSON-Threat-Protection-1]:
          Exceeded array element count at line 3",
        "detail": {
            "errorcode": "steps.jsonthreatprotection.ExecutionFailed"
        }
    }
}

Penyebab

Error ini terjadi jika payload pesan input yang ditentukan oleh elemen <Source> berisi array JSON dengan jumlah elemen yang lebih banyak daripada jumlah yang ditentukan dalam elemen <ArrayElementCount> kebijakan.

Misalnya, jika elemen <ArrayElementCount> ditentukan sebagai 3, tetapi payload input memiliki array JSON dengan lebih dari 3 elemen, maka error ini akan ditampilkan.

Diagnosis

  1. Periksa pesan error untuk mengidentifikasi nama kebijakan dan nomor baris tempat panjang array terlampaui. Misalnya, dalam pesan error berikut, nama kebijakan adalah JSON-Threat-Protection-1 dan nomor baris dalam payload adalah 3:

    JSONThreatProtection[JSON-Threat-Protection-1]: Execution failed. reason:
    JSONThreatProtection[JSON-Threat-Protection-1]: Exceeded array element count at line 3
    
  2. Catat nilai yang ditentukan untuk elemen <ArrayElementCount> kebijakan (diidentifikasi di Langkah 1).

    Dalam contoh kebijakan JSONThreatProtection berikut, <ArrayElementCount> disetel ke 3:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <JSONThreatProtection async="false" continueOnError="false" enabled="true" name="JSON-Threat-Protection-1">
        <DisplayName>JSON Threat Protection-1</DisplayName>
        <Properties/>
        <ArrayElementCount>3</ArrayElementCount>
        <ContainerDepth>12</ContainerDepth>
        <ObjectEntryCount>5</ObjectEntryCount>
        <ObjectEntryNameLength>6</ObjectEntryNameLength>
        <Source>request</Source>
        <StringValueLength>50</StringValueLength>
    </JSONThreatProtection>
    
  3. Periksa nomor baris tertentu (yang diidentifikasi pada Langkah 1) dari payload input dan periksa apakah array yang ditentukan di sana memiliki jumlah yang lebih tinggi daripada jumlah yang ditentukan dalam elemen <ArrayElementCount> (yang diidentifikasi pada Langkah 2). Jika jumlah elemen array melebihi jumlah, maka itulah penyebab error.

    Berikut adalah contoh payload input:

    {
     "name":"Ford",
     "models":[
        "Mustang",
        "Endeavour",
        "Fiesta",
        "EcoSport",
        "Focus"
     ]
    }
    

    Payload JSON yang ditampilkan di atas memiliki 5 elemen dalam array bernama models di baris 3. Karena jumlah elemen array lebih besar dari 3 (nilai yang ditentukan untuk elemen <ArrayElementCount>), Anda akan mendapatkan error berikut:

    JSONThreatProtection[JSON-Threat-Protection-1]: Execution failed. reason:
    JSONThreatProtection[JSON-Threat-Protection-1]: Exceeded array element count
    at line 3
    

Resolusi

Jika kebijakan JSONThreatProtection dimaksudkan untuk melindungi dari payload dengan batas jumlah array tertentu, pesan error ini akan muncul. Dalam hal ini, tidak ada tindakan tambahan yang diperlukan.

Namun, jika Anda menentukan bahwa jumlah elemen yang lebih tinggi dalam array dapat diizinkan, ubah <ArrayElementCount> ke nilai yang sesuai berdasarkan persyaratan Anda.

Misalnya, jika Anda merasa dapat mengizinkan hingga 5 elemen array, ubah kebijakan sebagai berikut:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<JSONThreatProtection async="false" continueOnError="false" enabled="true" name="JSON-Threat-Protection-1">
    <DisplayName>JSON Threat Protection-1</DisplayName>
    <Properties/>
    <ArrayElementCount>5</ArrayElementCount>
    <ContainerDepth>12</ContainerDepth>
    <ObjectEntryCount>5</ObjectEntryCount>
    <ObjectEntryNameLength>6</ObjectEntryNameLength>
    <Source>request</Source>
    <StringValueLength>50</StringValueLength>
</JSONThreatProtection>

Melebihi kedalaman penampung

Isi respons error

Traffic runtime menampilkan kode respons 500 dengan error berikut:

{
    "fault": {
        "faultstring": "JSONThreatProtection[policy_name]:
          Execution failed. reason: JSONThreatProtection[policy_name]:
          Exceeded container depth at line line-num",
        "detail": {
            "errorcode": "steps.jsonthreatprotection.ExecutionFailed"
        }
    }
}

Contoh isi respons Error

{
    "fault": {
        "faultstring": "JSONThreatProtection[JSON-Threat-Protection-1]:
          Execution failed. reason: JSONThreatProtection[JSON-Threat-Protection-1]:
          Exceeded container depth at line 5",
        "detail": {
            "errorcode": "steps.jsonthreatprotection.ExecutionFailed"
        }
    }
}

Penyebab

Error ini terjadi jika payload pesan input yang ditentukan oleh elemen <Source> berisi objek JSON yang berisi elemen JSON dengan kedalaman penampung yang melebihi kedalaman penampung maksimum yang ditentukan dalam elemen <ContainerDepth> kebijakan. Kedalaman penampung adalah kedalaman bertingkat maksimum yang diizinkan untuk elemen JSON. Misalnya, array yang berisi objek yang berisi objek akan menghasilkan kedalaman penampungan 3.

Misalnya, jika elemen <ContainerDepth> adalah 3, tetapi payload input memiliki kedalaman penampung yang melebihi batas ini, maka error ini akan ditampilkan.

Diagnosis

  1. Periksa pesan error untuk mengidentifikasi nama kebijakan JSONThreatProtection dan nomor baris tempat kedalaman penampung terlampaui. Misalnya, dalam pesan error berikut, nama kebijakan adalah JSON-Threat-Protection-1 dan nomor baris dalam payload adalah 5.

    JSONThreatProtection[JSON-Threat-Protection-1]: Execution failed. reason:
    JSONThreatProtection[JSON-Threat-Protection-1]: Exceeded container depth at
    line 5
    
  2. Catat nilai yang ditentukan untuk elemen <ContainerDepth> (diidentifikasi di Langkah 1).

    Dalam contoh kebijakan JSONThreatProtection berikut, <ContainerDepth> disetel ke 5:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <JSONThreatProtection async="false" continueOnError="false" enabled="true" name="JSON-Threat-Protection-1">
        <DisplayName>JSON Threat Protection-1</DisplayName>
        <Properties/>
        <ArrayElementCount>3</ArrayElementCount>
        <ContainerDepth>5</ContainerDepth>
        <ObjectEntryCount>5</ObjectEntryCount>
        <ObjectEntryNameLength>20</ObjectEntryNameLength>
        <Source>request</Source>
        <StringValueLength>50</StringValueLength>
    </JSONThreatProtection>
    
  3. Periksa nomor baris tertentu (diidentifikasi di Langkah 1) dari payload input dan periksa apakah kedalaman penampung dalam payload lebih tinggi daripada nilai yang ditentukan dalam elemen <ContainerDepth> (diidentifikasi di Langkah 2). Jika kedalaman penampung melebihi jumlah, maka itulah penyebab error.

    Berikut adalah contoh payload input:

    {
     "ContainerDepth2":[ {
           "ContainerDepth4":[
              {
                 "ContainerDepth6":[
                    "1",
                    "2"
                 ]
              }
           ]
        }
     ]
    }
    

    Payload JSON yang ditampilkan di atas memiliki kedalaman penampung 6 di baris 5. Karena kedalaman lebih besar dari 5, nilai yang ditentukan untuk elemen <ContainerDepth> kebijakan JSONThreatProtection akan menampilkan error berikut:

    JSONThreatProtection[JSON-Threat-Protection-1]: Execution failed. reason:
    JSONThreatProtection[JSON-Threat-Protection-1]: Exceeded container depth at
    line 5
    

Resolusi

Jika kebijakan JSONThreatProtection dimaksudkan untuk melindungi dari payload dengan kedalaman penampung yang melebihi nilai yang ditentukan, pesan error ini akan muncul. Dalam hal ini, tidak ada tindakan tambahan yang diperlukan.

Namun, jika Anda menentukan bahwa kedalaman penampung yang lebih tinggi dapat diterima, ubah <ContainerDepth> ke nilai yang sesuai berdasarkan persyaratan Anda.

Misalnya, jika Anda merasa dapat mengizinkan kedalaman penampung hingga 10, ubah kebijakan sebagai berikut:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<JSONThreatProtection async="false" continueOnError="false" enabled="true" name="JSON-Threat-Protection-1">
    <DisplayName>JSON Threat Protection-1</DisplayName>
    <Properties/>
    <ArrayElementCount>3</ArrayElementCount>
    <ContainerDepth>10</ContainerDepth>
    <ObjectEntryCount>5</ObjectEntryCount>
    <ObjectEntryNameLength>20</ObjectEntryNameLength>
    <Source>request</Source>
    <StringValueLength>50</StringValueLength>
</JSONThreatProtection>

Panjang nilai string terlampaui

Isi respons error

{
    "fault": {
        "faultstring": "JSONThreatProtection[policy_name]:
          Execution failed. reason: JSONThreatProtection[policy_name]:
          Exceeded string value length at line line-num",
        "detail": {
            "errorcode": "steps.jsonthreatprotection.ExecutionFailed"
        }
    }
}

Contoh isi respons Error

{
    "fault": {
        "faultstring": "JSONThreatProtection[JSON-Threat-Protection-1]:
          Execution failed. reason: JSONThreatProtection[JSON-Threat-Protection-1]:
          Exceeded string value length at line 3",
        "detail": {
            "errorcode": "steps.jsonthreatprotection.ExecutionFailed"
        }
    }
}

Penyebab

Error ini terjadi jika payload pesan input yang ditentukan oleh elemen <Source> berisi elemen JSON yang memiliki nilai dengan lebih banyak karakter daripada yang diizinkan oleh elemen <StringValueLength>.

Misalnya, jika elemen <StringValueLength> ditetapkan ke 50 dalam kebijakan, tetapi payload input memiliki satu atau beberapa elemen yang nilainya berisi lebih dari 50 karakter, maka error ini akan ditampilkan.

Diagnosis

  1. Periksa pesan error untuk mengidentifikasi nama kebijakan dan nomor baris tempat panjang string terlampaui. Dalam contoh berikut, nama kebijakan adalah JSON-Threat-Protection-1 andline dalam payload 3.

    JSONThreatProtection[JSON-Threat-Protection-1]: Execution failed. reason:
    JSONThreatProtection[JSON-Threat-Protection-1]: Exceeded string value length at line 3
    
  2. Catat nilai yang ditentukan untuk elemen <StringValueLength> di (diidentifikasi di Langkah 1).

    Dalam contoh kebijakan JSONThreatProtection berikut, <StringValueLength> disetel ke 50:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <JSONThreatProtection async="false" continueOnError="false" enabled="true" name="JSON-Threat-Protection-1">
        <DisplayName>JSON Threat Protection-1</DisplayName>
        <Properties/>
        <ArrayElementCount>3</ArrayElementCount>
        <ContainerDepth>5</ContainerDepth>
        <ObjectEntryCount>5</ObjectEntryCount>
        <ObjectEntryNameLength>20</ObjectEntryNameLength>
        <Source>request</Source>
        <StringValueLength>50</StringValueLength>
    </JSONThreatProtection>
    
  3. Periksa nomor baris tertentu (yang diidentifikasi di Langkah 1) dari payload input dan periksa apakah panjang nilai lebih besar daripada jumlah karakter yang ditentukan untuk elemen <StringValueLength> (yang diidentifikasi di Langkah 2). Jika panjang nilai melebihi batas, maka itulah penyebab error.

    Berikut adalah contoh payload input:

    {
      "Country": "New Zealand",
      "Place Name": "Taumatawhakatangihangakoauauotamateaturipukakapikimaungahoronukupokaiwhenuakitanatahu"
    }
    

    Payload JSON yang ditampilkan di atas memiliki objek bernama Place Name yang nilainya Taumatawhakatangihangakoauauotamateaturipukakapikimaungahoronukupokaiwhenuakitanatahu memiliki 85 karakter di baris 3. Karena panjang nilai lebih besar dari 50, nilai yang ditentukan dalam elemen <StringValueLength>, Anda akan mendapatkan error berikut:

    JSONThreatProtection[JSON-Threat-Protection-1]: Execution failed. reason:
    JSONThreatProtection[JSON-Threat-Protection-1]: Exceeded string value length
    at line 3
    

Resolusi

Jika kebijakan JSONThreatProtection dimaksudkan untuk melindungi dari payload dengan nilai yang melebihi panjang string tertentu, maka pesan error tersebut sudah sesuai. Dalam hal ini, tidak ada tindakan tambahan yang diperlukan.

Namun, jika Anda menentukan bahwa panjang nilai yang lebih panjang dapat ditentukan dalam payload, ubah <StringValueLength> ke nilai yang sesuai berdasarkan persyaratan Anda.

Misalnya, jika Anda merasa dapat mengizinkan nilai hingga panjang 90, ubah kebijakan sebagai berikut:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<JSONThreatProtection async="false" continueOnError="false" enabled="true" name="JSON-Threat-Protection-1">
    <DisplayName>JSON Threat Protection-1</DisplayName>
    <Properties/>
    <ArrayElementCount>3</ArrayElementCount>
    <ContainerDepth>5</ContainerDepth>
    <ObjectEntryCount>5</ObjectEntryCount>
    <ObjectEntryNameLength>20</ObjectEntryNameLength>
    <Source>request</Source>
    <StringValueLength>90</StringValueLength>
</JSONThreatProtection>

Bukan objek JSON yang valid

Isi respons error

{
    "fault": {
        "faultstring": "JSONThreatProtection[policy_name]:
          Execution failed. reason: string: at line line-num",
        "detail": {
            "errorcode": "steps.jsonthreatprotection.ExecutionFailed"
        }
    }
}

Contoh isi respons Error

{
    "fault": {
        "faultstring": "JSONThreatProtection[JSON-Threat-Protection-1]:
          Execution failed. reason: Expecting : at line 3",
        "detail": {
            "errorcode": "steps.jsonthreatprotection.ExecutionFailed"
        }
    }
}

Penyebab

Error ini terjadi jika payload pesan input yang ditentukan oleh elemen <Source> dalam kebijakan JSONThreatProtection bukan objek JSON yang valid.

Diagnosis

  1. Periksa pesan error untuk mengidentifikasi nama kebijakan dan nomor baris tempat terjadinya error. Dalam contoh berikut, nama kebijakan adalah JSON-Threat-Protection-1 andline dalam payload 2.

    JSONThreatProtection[JSON-Threat-Protection-1]: Execution failed. reason: Expecting : at line 3
    
  2. Periksa nomor baris tertentu (yang diidentifikasi pada Langkah 1) dari payload input dan periksa apakah objek JSON yang diteruskan dalam payload memang merupakan objek JSON yang valid.

    Berikut adalah contoh payload input:

    {
      "Longitude": 6.11499,
      "Latitude"  50.76891
    }
    

    Dalam payload JSON yang ditampilkan di atas, baris 3 tidak memiliki ":" (titik dua). Karena bukan objek JSON yang valid, Anda akan mendapatkan error:

    JSONThreatProtection[JSON-Threat-Protection-1]: Execution failed. reason:
    Expecting : at line 3
    

Resolusi

Pastikan payload JSON input yang valid diteruskan ke Proxy API yang menyertakan kebijakan JSONThreatProtection.

Untuk contoh yang dijelaskan di atas, ubah payload JSON sebagai berikut:

{
    "Longitude": 6.11499,
  "Latitude" : 50.76891
}

SourceUnavailable

Kode Error

steps.jsonthreatprotection.SourceUnavailable

Isi respons error

{
    "fault": {
        "faultstring": "JSONThreatProtection[policy_name]::
          Source[var_name] is not available"
        "detail": {
            "errorcode": "steps.jsonthreatprotection.SourceUnavailable"
        }
    }
}

Contoh isi respons Error

{
    "fault": {
        "faultstring": "JSONThreatProtection[JSON-Threat-Protection-1]::
          Source requests is not available",
        "detail": {
            "errorcode": "steps.jsonthreatprotection.SourceUnavailable"
        }
    }
}

Penyebab

Error ini terjadi jika variabel message yang ditentukan dalam elemen <Source> dari kebijakan JSONThreatProtection adalah:

  • Di luar cakupan (tidak tersedia dalam alur tertentu tempat kebijakan dijalankan)
  • Bukan salah satu nilai valid request, response, atau message

Misalnya, error ini terjadi jika elemen <Source> dalam kebijakan disetel ke variabel yang tidak ada dalam alur tempat kebijakan dijalankan.

Diagnosis

  1. Identifikasi nama kebijakan, dan nama variabel Sumber dari pesan error. Misalnya, dalam pesan error berikut, nama kebijakan adalah JSON-Threat-Protection-1 dan variabel Sumber adalah requests:

    JSONThreatProtection[JSON-Threat-Protection-1]:: Source requests is not available
    
  2. Periksa nilai yang ditentukan untuk elemen <Source> yang diidentifikasi di Langkah 1.

    Dalam contoh kebijakan JSONThreatProtection berikut, elemen <Source> disetel ke requests.

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <JSONThreatProtection async="false" continueOnError="false" enabled="true" name="JSON-Threat-Protection-1">
        <DisplayName>JSON Threat Protection-1</DisplayName>
        <Properties/>
        <ArrayElementCount>3</ArrayElementCount>
        <ContainerDepth>5</ContainerDepth>
        <ObjectEntryCount>5</ObjectEntryCount>
        <ObjectEntryNameLength>20</ObjectEntryNameLength>
        <Source>requests</Source>
        <StringValueLength>50</StringValueLength>
    </JSONThreatProtection>
    

    Nilai yang valid untuk elemen <Source> adalah request, response, atau message. Karena requests bukan nilai yang valid dan tidak ada dalam alur tempat kebijakan dieksekusi, Anda akan mendapatkan error:

    JSONThreatProtection[JSON-Threat-Protection-1]:: Source requests is not available
    

Resolusi

Pastikan variabel yang ditetapkan dalam elemen <Source> dari kebijakan JSONThreatProtection yang gagal ditetapkan ke request, response, atau message dan ada dalam alur tempat kebijakan dijalankan.

Untuk memperbaiki contoh kebijakan JSONThreatProtection yang ditampilkan di atas, Anda dapat mengubah elemen <Source> untuk menggunakan variabel request, karena variabel tersebut ada dalam alur permintaan:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<JSONThreatProtection async="false" continueOnError="false" enabled="true" name="JSON-Threat-Protection-1">
    <DisplayName>JSON Threat Protection-1</DisplayName>
    <Properties/>
    <ArrayElementCount>3</ArrayElementCount>
    <ContainerDepth>5</ContainerDepth>
    <ObjectEntryCount>5</ObjectEntryCount>
    <ObjectEntryNameLength>20</ObjectEntryNameLength>
    <Source>request</Source>
    <StringValueLength>50</StringValueLength>
</JSONThreatProtection>

NonMessageVariable

Kode Error

steps.jsonthreatprotection.NonMessageVariable

Isi respons error

{
    "fault": {
        "faultstring": "JSONThreatProtection[policy_name]:
          Variable var_name does not resolve to a Message"
        "detail": {
            "errorcode": "steps.jsonthreatprotection.NonMessageVariable"
        }
    }
}

Contoh isi respons Error

{
    "fault": {
        "faultstring": "JSONThreatProtection[JSON-Threat-Protection-1]:
          Variable message.content does not resolve to a Message",
        "detail": {
            "errorcode": "steps.jsonthreatprotection.NonMessageVariable"
        }
    }
}

Penyebab

Error ini terjadi jika elemen <Source> dalam kebijakan JSONThreatProtection ditetapkan ke variabel yang bukan berjenis message.

Variabel jenis pesan merepresentasikan seluruh permintaan dan respons HTTP. Permintaan, respons, dan pesan variabel alur Apigee bawaan bertipe pesan. Untuk mempelajari variabel pesan lebih lanjut, lihat Referensi variabel.

Diagnosis

  1. Identifikasi nama kebijakan JSONThreatProtection dan nama variabel Sumber dari pesan error. Misalnya, dalam pesan error berikut, nama kebijakan adalah JSON-Threat-Protection-1 dan variabel Sumber adalah message.content:

    JSONThreatProtection[JSON-Threat-Protection-1]: Variable message.content does not resolve to a Message
    
  2. Periksa elemen <Source> kebijakan JSONThreatProtection (diidentifikasi pada Langkah 1).

    Dalam contoh kebijakan JSONThreatProtection berikut, <Source> disetel ke message.content, bukan message:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <JSONThreatProtection async="false" continueOnError="false" enabled="true" name="JSON-Threat-Protection-1">
        <DisplayName>JSON Threat Protection-1</DisplayName>
        <Properties/>
        <ArrayElementCount>3</ArrayElementCount>
        <ContainerDepth>5</ContainerDepth>
        <ObjectEntryCount>5</ObjectEntryCount>
        <ObjectEntryNameLength>20</ObjectEntryNameLength>
        <Source>message.content</Source>
        <StringValueLength>50</StringValueLength>
    </JSONThreatProtection>
    

    Karena message.content bukan jenis pesan, Anda akan mendapatkan error:

    JSONThreatProtection[JSON-Threat-Protection-1]: Variable message.content does
    not resolve to a Message
    

Resolusi

Pastikan elemen <Source> dalam kebijakan JSONThreatProtection yang gagal ditetapkan ke variabel alur jenis message yang ada dalam alur tempat kebijakan dijalankan.

Untuk memperbaiki kebijakan, Anda dapat mengubah elemen <Source> untuk menentukan variabel yang berjenis pesan. Misalnya, di JSONThreatProtection yang gagal, Anda dapat menentukan elemen <Source> sebagai message:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<JSONThreatProtection async="false" continueOnError="false" enabled="true" name="JSON-Threat-Protection-1">
    <DisplayName>JSON Threat Protection-1</DisplayName>
    <Properties/>
    <ArrayElementCount>3</ArrayElementCount>
    <ContainerDepth>5</ContainerDepth>
    <ObjectEntryCount>5</ObjectEntryCount>
    <ObjectEntryNameLength>20</ObjectEntryNameLength>
    <Source>message</Source>
    <StringValueLength>50</StringValueLength>
</JSONThreatProtection>