This site is the archived OWASP Foundation Wiki and is no longer accepting Account Requests.
To view the new OWASP Foundation website, please visit https://owasp.org

Difference between revisions of "Poor Logging Practice"

From OWASP
Jump to: navigation, search
 
m (Moved page into the right category. See Java space page for me details. Content has not been reviewed in this edit.)
 
(11 intermediate revisions by 3 users not shown)
Line 2: Line 2:
 
{{Template:Fortify}}
 
{{Template:Fortify}}
  
==Abstract==
+
Last revision (mm/dd/yy): '''{{REVISIONMONTH}}/{{REVISIONDAY}}/{{REVISIONYEAR}}'''
  
Declare loggers to be static and final.
+
[[ASDR_TOC_Vulnerabilities|Vulnerabilities Table of Contents]]
  
 
==Description==
 
==Description==
 +
 +
===Logger Not Declared Static Final===
 +
Loggers should be declared to be static and final.
  
 
It is good programming practice to share a single logger object between all of the instances of a particular class and to use the same logger for the duration of the program.
 
It is good programming practice to share a single logger object between all of the instances of a particular class and to use the same logger for the duration of the program.
 
==Examples ==
 
  
 
The following statement errantly declares a non-static logger.
 
The following statement errantly declares a non-static logger.
Line 19: Line 20:
 
</pre>
 
</pre>
  
==Related Threats==
+
===Poor Logging Practice: Multiple Loggers===
 +
It is a poor logging practice to use multiple loggers rather than logging levels in a single class.
 +
 
 +
Good logging practice dictates the use of a single logger that supports different logging levels for each class.
 +
 
 +
The following code errantly declares multiple loggers.
 +
 
 +
<pre>
 +
public class MyClass {
 +
  private final static Logger good =   
 +
Logger.getLogger(MyClass.class);
 +
  private final static Logger bad =   
 +
Logger.getLogger(MyClass.class);
 +
  private final static Logger ugly =   
 +
Logger.getLogger(MyClass.class);
 +
  ...
 +
}
 +
 
 +
</pre>
 +
 
 +
===Use of a System Output Stream===
 +
Using System.out or System.err rather than a dedicated logging facility makes it difficult to monitor the behavior of the program. It can also cause log messages accidentally returned to the end users, revealing internal information to attackers.
 +
 
 +
The first Java program that a developer learns to write often looks like this:
 +
 
 +
<pre>
 +
public class MyClass
 +
  public static void main(String[] args) {
 +
System.out.println("hello world");
 +
  }
 +
}
 +
</pre>
 +
 
 +
While most programmers go on to learn many nuances and subtleties about Java, a surprising number hang on to this first lesson and never give up on writing messages to standard output using System.out.println().
 +
 
 +
The problem is that writing directly to standard output or standard error is often used as an unstructured form of logging. Structured logging facilities provide features like logging levels, uniform formatting, a logger identifier, timestamps, and, perhaps most critically, the ability to direct the log messages to the right place. When the use of system output streams is jumbled together with the code that uses loggers properly, the result is often a well-kept log that is missing critical information. In addition, using system output streams can also cause log messages accidentally returned to end users, revealing application internal information to attackers.
 +
 
 +
Developers widely accept the need for structured logging, but many continue to use system output streams in their "pre-production" development. If the code you are reviewing is past the initial phases of development, use of System.out or System.err may indicate an oversight in the move to a structured logging system.
 +
 
 +
==Risk Factors==
 +
 
 +
TBD
 +
 
 +
==Examples==
 +
 
 +
 
 +
==Related [[Attacks]]==
 +
 
 +
* [[Attack 1]]
 +
* [[Attack 2]]
  
==Related Attacks==
 
  
==Related Vulnerabilities==
+
==Related [[Vulnerabilities]]==
  
==Related Countermeasures==
+
* [[Vulnerability 1]]
 +
* [[Vulnerabiltiy 2]]
  
==Categories==
+
==Related [[Controls]]==
  
 +
* [[Control 1]]
 +
* [[Control 2]]
 +
 +
 +
==Related [[Technical Impacts]]==
 +
 +
* [[Technical Impact 1]]
 +
* [[Technical Impact 2]]
 +
 +
 +
==References==
 +
Note: A reference to related [http://cwe.mitre.org/ CWE] or [http://capec.mitre.org/ CAPEC] article should be added when exists. Eg:
 +
 +
* [http://cwe.mitre.org/data/definitions/79.html CWE 79].
 +
* http://www.link1.com
 +
* [http://www.link2.com Title for the link2]
 +
 +
__NOTOC__
 +
 +
 +
[[Category:OWASP ASDR Project]]
 
[[Category:Code Quality Vulnerability]]
 
[[Category:Code Quality Vulnerability]]
 
 
[[Category:Java]]
 
[[Category:Java]]
 
 
[[Category:Implementation]]
 
[[Category:Implementation]]
 
 
[[Category:Code Snippet]]
 
[[Category:Code Snippet]]
 
+
[[Category:Logging and Auditing Vulnerability]]
[[Category:Logging and Auditting Vulnerability]]
+
[[Category:Vulnerability]]

Latest revision as of 21:49, 10 November 2017

This is a Vulnerability. To view all vulnerabilities, please see the Vulnerability Category page.

This article includes content generously donated to OWASP by MicroFocus Logo.png

Last revision (mm/dd/yy): 11/10/2017

Vulnerabilities Table of Contents

Description

Logger Not Declared Static Final

Loggers should be declared to be static and final.

It is good programming practice to share a single logger object between all of the instances of a particular class and to use the same logger for the duration of the program.

The following statement errantly declares a non-static logger.

	private final Logger logger =     
				Logger.getLogger(MyClass.class);

Poor Logging Practice: Multiple Loggers

It is a poor logging practice to use multiple loggers rather than logging levels in a single class.

Good logging practice dictates the use of a single logger that supports different logging levels for each class.

The following code errantly declares multiple loggers.

	public class MyClass {
	  private final static Logger good =     
				Logger.getLogger(MyClass.class);
	  private final static Logger bad =     
				Logger.getLogger(MyClass.class);
	  private final static Logger ugly =     
				Logger.getLogger(MyClass.class);
	  ...
	}

Use of a System Output Stream

Using System.out or System.err rather than a dedicated logging facility makes it difficult to monitor the behavior of the program. It can also cause log messages accidentally returned to the end users, revealing internal information to attackers.

The first Java program that a developer learns to write often looks like this:

	public class MyClass 
	  public static void main(String[] args) {
		System.out.println("hello world");
	  }
	}

While most programmers go on to learn many nuances and subtleties about Java, a surprising number hang on to this first lesson and never give up on writing messages to standard output using System.out.println().

The problem is that writing directly to standard output or standard error is often used as an unstructured form of logging. Structured logging facilities provide features like logging levels, uniform formatting, a logger identifier, timestamps, and, perhaps most critically, the ability to direct the log messages to the right place. When the use of system output streams is jumbled together with the code that uses loggers properly, the result is often a well-kept log that is missing critical information. In addition, using system output streams can also cause log messages accidentally returned to end users, revealing application internal information to attackers.

Developers widely accept the need for structured logging, but many continue to use system output streams in their "pre-production" development. If the code you are reviewing is past the initial phases of development, use of System.out or System.err may indicate an oversight in the move to a structured logging system.

Risk Factors

TBD

Examples

Related Attacks


Related Vulnerabilities

Related Controls


Related Technical Impacts


References

Note: A reference to related CWE or CAPEC article should be added when exists. Eg: