CWE-1285: Improper Validation of Specified Index, Position, or Offset in Input

The following example retrieves the sizes of messages for a pop3 mail server. The message sizes are retrieved from a socket that returns in a buffer the message number and the message size, the message number (num) and size (size) are extracted from the buffer and the message size is placed into an array using the message number for the array index.

In this example the message number retrieved from the buffer could be a value that is outside the allowable range of indices for the array and could possibly be a negative number. Without proper validation of the value to be used for the array index an array overflow could occur and could potentially lead to unauthorized access to memory addresses and system crashes. The value of the array index should be validated to ensure that it is within the allowable range of indices for the array as in the following code.

/* capture the sizes of all messages */                      int getsizes(int sock, int count, int *sizes) {                         ...char buf[BUFFER_SIZE];int ok;int num, size;                                                        // read values from socket and added to sizes array                            while ((ok = gen_recv(sock, buf, sizeof(buf))) == 0){                                                                                                   // continue read from socket until buf only contains '.'                                  if (DOTLINE(buf))break;                                  else if (sscanf(buf, "%d %d", &num, &size) == 2)sizes[num - 1] = size;                                                           }...                                               }

The following example retrieves the sizes of messages for a pop3 mail server. The message sizes are retrieved from a socket that returns in a buffer the message number and the message size, the message number (num) and size (size) are extracted from the buffer and the message size is placed into an array using the message number for the array index.

In this example the message number retrieved from the buffer could be a value that is outside the allowable range of indices for the array and could possibly be a negative number. Without proper validation of the value to be used for the array index an array overflow could occur and could potentially lead to unauthorized access to memory addresses and system crashes. The value of the array index should be validated to ensure that it is within the allowable range of indices for the array as in the following code.

/* capture the sizes of all messages */                      int getsizes(int sock, int count, int *sizes) {                         ...char buf[BUFFER_SIZE];int ok;int num, size;                                                        // read values from socket and added to sizes array                            while ((ok = gen_recv(sock, buf, sizeof(buf))) == 0){                                                                                                   // continue read from socket until buf only contains '.'                                  if (DOTLINE(buf))break;                                  else if (sscanf(buf, "%d %d", &num, &size) == 2) {                                     if (num > 0 && num <= (unsigned)count)sizes[num - 1] = size;                                        else                                                                                                                                       /* warn about possible attempt to induce buffer overflow */                                              report(stderr, "Warning: ignoring bogus data for message sizes returned by server.\n");                                                                                                               }                            }...                                               }

In the following example the method displayProductSummary is called from a Web service servlet to retrieve product summary information for display to the user. The servlet obtains the integer value of the product number from the user and passes it to the displayProductSummary method. The displayProductSummary method passes the integer value of the product number to the getProductSummary method which obtains the product summary from the array object containing the project summaries using the integer value of the product number as the array index.

In this example the integer value used as the array index that is provided by the user may be outside the allowable range of indices for the array which may provide unexpected results or cause the application to fail. The integer value used for the array index should be validated to ensure that it is within the allowable range of indices for the array as in the following code.

// Method called from servlet to obtain product information                      public String displayProductSummary(int index) {                                               String productSummary = new String("");                            try {String productSummary = getProductSummary(index);                                                        } catch (Exception ex) {...}                            return productSummary;                      }                      public String getProductSummary(int index) {return products[index];}

In the following example the method displayProductSummary is called from a Web service servlet to retrieve product summary information for display to the user. The servlet obtains the integer value of the product number from the user and passes it to the displayProductSummary method. The displayProductSummary method passes the integer value of the product number to the getProductSummary method which obtains the product summary from the array object containing the project summaries using the integer value of the product number as the array index.

In this example the integer value used as the array index that is provided by the user may be outside the allowable range of indices for the array which may provide unexpected results or cause the application to fail. The integer value used for the array index should be validated to ensure that it is within the allowable range of indices for the array as in the following code.

// Method called from servlet to obtain product information                      public String displayProductSummary(int index) {                                               String productSummary = new String("");                            try {String productSummary = getProductSummary(index);                                                        } catch (Exception ex) {...}                            return productSummary;                      }                      public String getProductSummary(int index) {                         String productSummary = "";                            if ((index >= 0) && (index < MAX_PRODUCTS)) {productSummary = products[index];}else {System.err.println("index is out of bounds");throw new IndexOutOfBoundsException();}                            return productSummary;                      }

In the following example the method displayProductSummary is called from a Web service servlet to retrieve product summary information for display to the user. The servlet obtains the integer value of the product number from the user and passes it to the displayProductSummary method. The displayProductSummary method passes the integer value of the product number to the getProductSummary method which obtains the product summary from the array object containing the project summaries using the integer value of the product number as the array index.

In this example the integer value used as the array index that is provided by the user may be outside the allowable range of indices for the array which may provide unexpected results or cause the application to fail. The integer value used for the array index should be validated to ensure that it is within the allowable range of indices for the array as in the following code.

ArrayList productArray = new ArrayList(MAX_PRODUCTS);...try {productSummary = (String) productArray.get(index);} catch (IndexOutOfBoundsException ex) {...}

The following example asks a user for an offset into an array to select an item.

The programmer allows the user to specify which element in the list to select, however an attacker can provide an out-of-bounds offset, resulting in a buffer over-read (CWE-126).

int main (int argc, char **argv) {char *items[] = {"boat", "car", "truck", "train"};int index = GetUntrustedOffset();printf("User selected %s\n", items[index-1]);}