Coverage Report - org.owasp.dependencycheck.suppression.SuppressionRule
 
Classes in this File Line Coverage Branch Coverage Complexity
SuppressionRule
71%
94/132
66%
75/112
2.967
 
 1  
 /*
 2  
  * This file is part of dependency-check-core.
 3  
  *
 4  
  * Licensed under the Apache License, Version 2.0 (the "License");
 5  
  * you may not use this file except in compliance with the License.
 6  
  * You may obtain a copy of the License at
 7  
  *
 8  
  *     http://www.apache.org/licenses/LICENSE-2.0
 9  
  *
 10  
  * Unless required by applicable law or agreed to in writing, software
 11  
  * distributed under the License is distributed on an "AS IS" BASIS,
 12  
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 13  
  * See the License for the specific language governing permissions and
 14  
  * limitations under the License.
 15  
  *
 16  
  * Copyright (c) 2013 Jeremy Long. All Rights Reserved.
 17  
  */
 18  
 package org.owasp.dependencycheck.suppression;
 19  
 
 20  
 import java.util.ArrayList;
 21  
 import java.util.Iterator;
 22  
 import java.util.List;
 23  
 import org.owasp.dependencycheck.dependency.Dependency;
 24  
 import org.owasp.dependencycheck.dependency.Identifier;
 25  
 import org.owasp.dependencycheck.dependency.Vulnerability;
 26  
 
 27  
 /**
 28  
  *
 29  
  * @author Jeremy Long <jeremy.long@owasp.org>
 30  
  */
 31  61
 public class SuppressionRule {
 32  
 
 33  
     /**
 34  
      * The file path for the suppression.
 35  
      */
 36  
     private PropertyType filePath;
 37  
 
 38  
     /**
 39  
      * Get the value of filePath.
 40  
      *
 41  
      * @return the value of filePath
 42  
      */
 43  
     public PropertyType getFilePath() {
 44  
         return filePath;
 45  
     }
 46  
 
 47  
     /**
 48  
      * Set the value of filePath.
 49  
      *
 50  
      * @param filePath new value of filePath
 51  
      */
 52  
     public void setFilePath(PropertyType filePath) {
 53  
         this.filePath = filePath;
 54  
     }
 55  
     /**
 56  
      * The sha1 hash.
 57  
      */
 58  
     private String sha1;
 59  
 
 60  
     /**
 61  
      * Get the value of sha1.
 62  
      *
 63  
      * @return the value of sha1
 64  
      */
 65  
     public String getSha1() {
 66  
         return sha1;
 67  
     }
 68  
 
 69  
     /**
 70  
      * Set the value of sha1.
 71  
      *
 72  
      * @param sha1 new value of sha1
 73  
      */
 74  
     public void setSha1(String sha1) {
 75  
         this.sha1 = sha1;
 76  
     }
 77  
     /**
 78  
      * A list of CPEs to suppression
 79  
      */
 80  61
     private List<PropertyType> cpe = new ArrayList<PropertyType>();
 81  
 
 82  
     /**
 83  
      * Get the value of cpe.
 84  
      *
 85  
      * @return the value of cpe
 86  
      */
 87  
     public List<PropertyType> getCpe() {
 88  
         return cpe;
 89  
     }
 90  
 
 91  
     /**
 92  
      * Set the value of cpe.
 93  
      *
 94  
      * @param cpe new value of cpe
 95  
      */
 96  
     public void setCpe(List<PropertyType> cpe) {
 97  
         this.cpe = cpe;
 98  
     }
 99  
 
 100  
     /**
 101  
      * Adds the cpe to the cpe list.
 102  
      *
 103  
      * @param cpe the cpe to add
 104  
      */
 105  
     public void addCpe(PropertyType cpe) {
 106  50
         this.cpe.add(cpe);
 107  50
     }
 108  
 
 109  
     /**
 110  
      * Returns whether or not this suppression rule as CPE entries.
 111  
      *
 112  
      * @return whether or not this suppression rule as CPE entries
 113  
      */
 114  
     public boolean hasCpe() {
 115  15
         return cpe.size() > 0;
 116  
     }
 117  
     /**
 118  
      * The list of cvssBelow scores.
 119  
      */
 120  61
     private List<Float> cvssBelow = new ArrayList<Float>();
 121  
 
 122  
     /**
 123  
      * Get the value of cvssBelow.
 124  
      *
 125  
      * @return the value of cvssBelow
 126  
      */
 127  
     public List<Float> getCvssBelow() {
 128  
         return cvssBelow;
 129  
     }
 130  
 
 131  
     /**
 132  
      * Set the value of cvssBelow.
 133  
      *
 134  
      * @param cvssBelow new value of cvssBelow
 135  
      */
 136  
     public void setCvssBelow(List<Float> cvssBelow) {
 137  
         this.cvssBelow = cvssBelow;
 138  
     }
 139  
 
 140  
     /**
 141  
      * Adds the cvss to the cvssBelow list.
 142  
      *
 143  
      * @param cvss the cvss to add
 144  
      */
 145  
     public void addCvssBelow(Float cvss) {
 146  7
         this.cvssBelow.add(cvss);
 147  7
     }
 148  
 
 149  
     /**
 150  
      * Returns whether or not this suppression rule has cvss suppressions.
 151  
      *
 152  
      * @return whether or not this suppression rule has cvss suppressions
 153  
      */
 154  
     public boolean hasCvssBelow() {
 155  12
         return cvssBelow.size() > 0;
 156  
     }
 157  
     /**
 158  
      * The list of cwe entries to suppress.
 159  
      */
 160  61
     private List<String> cwe = new ArrayList<String>();
 161  
 
 162  
     /**
 163  
      * Get the value of cwe.
 164  
      *
 165  
      * @return the value of cwe
 166  
      */
 167  
     public List<String> getCwe() {
 168  
         return cwe;
 169  
     }
 170  
 
 171  
     /**
 172  
      * Set the value of cwe.
 173  
      *
 174  
      * @param cwe new value of cwe
 175  
      */
 176  
     public void setCwe(List<String> cwe) {
 177  
         this.cwe = cwe;
 178  
     }
 179  
 
 180  
     /**
 181  
      * Adds the cwe to the cwe list.
 182  
      *
 183  
      * @param cwe the cwe to add
 184  
      */
 185  
     public void addCwe(String cwe) {
 186  2
         this.cwe.add(cwe);
 187  2
     }
 188  
 
 189  
     /**
 190  
      * Returns whether this suppression rule has CWE entries.
 191  
      *
 192  
      * @return whether this suppression rule has CWE entries
 193  
      */
 194  
     public boolean hasCwe() {
 195  13
         return cwe.size() > 0;
 196  
     }
 197  
     /**
 198  
      * The list of cve entries to suppress.
 199  
      */
 200  61
     private List<String> cve = new ArrayList<String>();
 201  
 
 202  
     /**
 203  
      * Get the value of cve.
 204  
      *
 205  
      * @return the value of cve
 206  
      */
 207  
     public List<String> getCve() {
 208  
         return cve;
 209  
     }
 210  
 
 211  
     /**
 212  
      * Set the value of cve.
 213  
      *
 214  
      * @param cve new value of cve
 215  
      */
 216  
     public void setCve(List<String> cve) {
 217  
         this.cve = cve;
 218  
     }
 219  
 
 220  
     /**
 221  
      * Adds the cve to the cve list.
 222  
      *
 223  
      * @param cve the cve to add
 224  
      */
 225  
     public void addCve(String cve) {
 226  11
         this.cve.add(cve);
 227  11
     }
 228  
 
 229  
     /**
 230  
      * Returns whether this suppression rule has CVE entries.
 231  
      *
 232  
      * @return whether this suppression rule has CVE entries
 233  
      */
 234  
     public boolean hasCve() {
 235  15
         return cve.size() > 0;
 236  
     }
 237  
     /**
 238  
      * A Maven GAV to suppression.
 239  
      */
 240  61
     private PropertyType gav = null;
 241  
 
 242  
     /**
 243  
      * Get the value of Maven GAV.
 244  
      *
 245  
      * @return the value of gav
 246  
      */
 247  
     public PropertyType getGav() {
 248  
         return gav;
 249  
     }
 250  
 
 251  
     /**
 252  
      * Set the value of Maven GAV.
 253  
      *
 254  
      * @param gav new value of Maven gav
 255  
      */
 256  
     public void setGav(PropertyType gav) {
 257  
         this.gav = gav;
 258  
     }
 259  
 
 260  
     /**
 261  
      * Returns whether or not this suppression rule as GAV entries.
 262  
      *
 263  
      * @return whether or not this suppression rule as GAV entries
 264  
      */
 265  
     public boolean hasGav() {
 266  0
         return gav != null;
 267  
     }
 268  
 
 269  
     private boolean base;
 270  
 
 271  
     /**
 272  
      * Get the value of base
 273  
      *
 274  
      * @return the value of base
 275  
      */
 276  
     public boolean isBase() {
 277  
         return base;
 278  
     }
 279  
 
 280  
     /**
 281  
      * Set the value of base
 282  
      *
 283  
      * @param base new value of base
 284  
      */
 285  
     public void setBase(boolean base) {
 286  
         this.base = base;
 287  
     }
 288  
 
 289  
     /**
 290  
      * Processes a given dependency to determine if any CPE, CVE, CWE, or CVSS scores should be suppressed. If any
 291  
      * should be, they are removed from the dependency.
 292  
      *
 293  
      * @param dependency a project dependency to analyze
 294  
      */
 295  
     public void process(Dependency dependency) {
 296  30
         if (filePath != null && !filePath.matches(dependency.getFilePath())) {
 297  0
             return;
 298  
         }
 299  30
         if (sha1 != null && !sha1.equalsIgnoreCase(dependency.getSha1sum())) {
 300  1
             return;
 301  
         }
 302  29
         if (gav != null) {
 303  17
             final Iterator<Identifier> itr = dependency.getIdentifiers().iterator();
 304  17
             boolean gavFound = false;
 305  37
             while (itr.hasNext()) {
 306  21
                 final Identifier i = itr.next();
 307  21
                 if (identifierMatches("maven", this.gav, i)) {
 308  1
                     gavFound = true;
 309  1
                     break;
 310  
                 }
 311  20
             }
 312  17
             if (!gavFound) {
 313  16
                 return;
 314  
             }
 315  
         }
 316  
 
 317  13
         if (this.hasCpe()) {
 318  8
             final Iterator<Identifier> itr = dependency.getIdentifiers().iterator();
 319  22
             while (itr.hasNext()) {
 320  14
                 final Identifier i = itr.next();
 321  14
                 for (PropertyType c : this.cpe) {
 322  22
                     if (identifierMatches("cpe", c, i)) {
 323  7
                         if (!isBase()) {
 324  4
                             dependency.addSuppressedIdentifier(i);
 325  
                         }
 326  7
                         itr.remove();
 327  7
                         break;
 328  
                     }
 329  15
                 }
 330  14
             }
 331  
         }
 332  13
         if (hasCve() || hasCwe() || hasCvssBelow()) {
 333  5
             final Iterator<Vulnerability> itr = dependency.getVulnerabilities().iterator();
 334  10
             while (itr.hasNext()) {
 335  5
                 boolean remove = false;
 336  5
                 final Vulnerability v = itr.next();
 337  5
                 for (String entry : this.cve) {
 338  3
                     if (entry.equalsIgnoreCase(v.getName())) {
 339  1
                         remove = true;
 340  1
                         break;
 341  
                     }
 342  2
                 }
 343  5
                 if (!remove) {
 344  4
                     for (String entry : this.cwe) {
 345  1
                         if (v.getCwe() != null) {
 346  1
                             final String toMatch = String.format("CWE-%s ", entry);
 347  1
                             final String toTest = v.getCwe().substring(0, toMatch.length()).toUpperCase();
 348  1
                             if (toTest.equals(toMatch)) {
 349  1
                                 remove = true;
 350  1
                                 break;
 351  
                             }
 352  
                         }
 353  0
                     }
 354  
                 }
 355  5
                 if (!remove) {
 356  3
                     for (float cvss : this.cvssBelow) {
 357  3
                         if (v.getCvssScore() < cvss) {
 358  1
                             remove = true;
 359  1
                             break;
 360  
                         }
 361  2
                     }
 362  
                 }
 363  5
                 if (remove) {
 364  3
                     if (!isBase()) {
 365  3
                         dependency.addSuppressedVulnerability(v);
 366  
                     }
 367  3
                     itr.remove();
 368  
                 }
 369  5
             }
 370  
         }
 371  13
     }
 372  
 
 373  
     /**
 374  
      * Identifies if the cpe specified by the cpe suppression rule does not specify a version.
 375  
      *
 376  
      * @param c a suppression rule identifier
 377  
      * @return true if the property type does not specify a version; otherwise false
 378  
      */
 379  
     boolean cpeHasNoVersion(PropertyType c) {
 380  26
         if (c.isRegex()) {
 381  2
             return false;
 382  
         }
 383  24
         if (countCharacter(c.getValue(), ':') == 3) {
 384  18
             return true;
 385  
         }
 386  6
         return false;
 387  
     }
 388  
 
 389  
     /**
 390  
      * Counts the number of occurrences of the character found within the string.
 391  
      *
 392  
      * @param str the string to check
 393  
      * @param c the character to count
 394  
      * @return the number of times the character is found in the string
 395  
      */
 396  
     int countCharacter(String str, char c) {
 397  27
         int count = 0;
 398  27
         int pos = str.indexOf(c) + 1;
 399  111
         while (pos > 0) {
 400  84
             count += 1;
 401  84
             pos = str.indexOf(c, pos) + 1;
 402  
         }
 403  27
         return count;
 404  
     }
 405  
 
 406  
     /**
 407  
      * Determines if the cpeEntry specified as a PropertyType matches the given Identifier.
 408  
      *
 409  
      * @param identifierType the type of identifier ("cpe", "maven", etc.)
 410  
      * @param suppressionEntry a suppression rule entry
 411  
      * @param identifier a CPE identifier to check
 412  
      * @return true if the entry matches; otherwise false
 413  
      */
 414  
     boolean identifierMatches(String identifierType, PropertyType suppressionEntry, Identifier identifier) {
 415  52
         if (identifierType.equals(identifier.getType())) {
 416  29
             if (suppressionEntry.matches(identifier.getValue())) {
 417  5
                 return true;
 418  24
             } else if ("cpe".equals(identifierType) && cpeHasNoVersion(suppressionEntry)) {
 419  17
                 if (suppressionEntry.isCaseSensitive()) {
 420  0
                     return identifier.getValue().startsWith(suppressionEntry.getValue());
 421  
                 } else {
 422  17
                     final String id = identifier.getValue().toLowerCase();
 423  17
                     final String check = suppressionEntry.getValue().toLowerCase();
 424  17
                     return id.startsWith(check);
 425  
                 }
 426  
             }
 427  
         }
 428  30
         return false;
 429  
     }
 430  
 
 431  
     /**
 432  
      * Standard toString implementation.
 433  
      *
 434  
      * @return a string representation of this object
 435  
      */
 436  
     @Override
 437  
     public String toString() {
 438  0
         final StringBuilder sb = new StringBuilder();
 439  0
         sb.append("SuppressionRule{");
 440  0
         if (filePath != null) {
 441  0
             sb.append("filePath=").append(filePath).append(",");
 442  
         }
 443  0
         if (sha1 != null) {
 444  0
             sb.append("sha1=").append(sha1).append(",");
 445  
         }
 446  0
         if (gav != null) {
 447  0
             sb.append("gav=").append(gav).append(",");
 448  
         }
 449  0
         if (cpe != null && cpe.size() > 0) {
 450  0
             sb.append("cpe={");
 451  0
             for (PropertyType pt : cpe) {
 452  0
                 sb.append(pt).append(",");
 453  0
             }
 454  0
             sb.append("}");
 455  
         }
 456  0
         if (cwe != null && cwe.size() > 0) {
 457  0
             sb.append("cwe={");
 458  0
             for (String s : cwe) {
 459  0
                 sb.append(s).append(",");
 460  0
             }
 461  0
             sb.append("}");
 462  
         }
 463  0
         if (cve != null && cve.size() > 0) {
 464  0
             sb.append("cve={");
 465  0
             for (String s : cve) {
 466  0
                 sb.append(s).append(",");
 467  0
             }
 468  0
             sb.append("}");
 469  
         }
 470  0
         if (cvssBelow != null && cvssBelow.size() > 0) {
 471  0
             sb.append("cvssBelow={");
 472  0
             for (Float s : cvssBelow) {
 473  0
                 sb.append(s).append(",");
 474  0
             }
 475  0
             sb.append("}");
 476  
         }
 477  0
         sb.append("}");
 478  0
         return sb.toString();
 479  
     }
 480  
 }