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 "Germany/Projekte/Top 10 fuer Entwickler-2013/A8-Cross-Site Request Forgery (CSRF)"

From OWASP
Jump to: navigation, search
m
(added Examples, tbd: Links to ESAPI ; prove of example = hidden field?)
Line 45: Line 45:
 
----
 
----
 
----
 
----
−
... tbd ...
+
{{Top_10_2010_Developer_Edition_De:SubsectionAdvancedTemplate|type={{Top_10_2010:StyleTemplate}}|number=3|risk=5}}
 +
{{Top_10_2010:ExampleBeginTemplate}}
 +
'''/** (1) CSRF-Token erzeugen **/'''<br/>
 +
private String csrfToken = resetCSRFToken();<br/>
 +
...<br/>
 +
public String resetCSRFToken() {<br/>
 +
: csrfToken = ESAPI.randomizer().getRandomString(8, DefaultEncoder.CHAR_ALPHANUMERICS);<br/>
 +
: return csrfToken;<br/>
 +
}<br/>
  
−
{{Top_10_2010_Developer_Edition_De:SubsectionAdvancedTemplate|type={{Top_10_2010:StyleTemplate}}|number=3|risk=5}}
 
−
====Tbd!!====
 
  
−
{{Top_10_2010:ExampleBeginTemplate}}Tbd
+
'''/** (2) In zu schützenden FORM-Seiten, oder Urls das CSRF-Token als 'hidden field' hinzufügen, vgl [http://code.google.com/searchframe#N8fUvf0LCCY/trunk/src/main/java/org/owasp/esapi/reference/DefaultHTTPUtilities.java ESAPI DefaultHTTPUtilities.java]**/'''<br/>
 +
 
 +
final static String CSRF_TOKEN_NAME = "ctoken";<br/>
 +
<span style="color: green;">'''public String addCSRFToken(String href) {'''</span><br/>
 +
: User user = ESAPI.authenticator().getCurrentUser();<br/>
 +
: if (user.isAnonymous()) {<br/>
 +
:: return href;<br/>
 +
: }<br/>
 +
: // if there are already parameters append with &amp;, otherwise append with ?<br/>
 +
: <span style="color: green;">'''String token = CSRF_TOKEN_NAME + "=" + user.getCSRFToken();'''</span><br/>
 +
: <span style="color: green;">'''return href.indexOf( '?') != -1 ? href + "&amp;" + token : href + "?" + token;'''</span><br/>
 +
}<br/>
  
 +
...<br/>
 +
public String getCSRFToken() {<br/>
 +
: User user = ESAPI.authenticator().getCurrentUser();<br/>
 +
: if (user == null) return null;<br/>
 +
: return user.getCSRFToken();<br/>
 +
}
 
{{Top_10_2010:ExampleEndTemplate}}  
 
{{Top_10_2010:ExampleEndTemplate}}  
  
 
{{Top_10_2010_Developer_Edition_De:SubsectionAdvancedTemplate|type={{Top_10_2010:StyleTemplate}}|number=4|risk=5}}
 
{{Top_10_2010_Developer_Edition_De:SubsectionAdvancedTemplate|type={{Top_10_2010:StyleTemplate}}|number=4|risk=5}}
−
====Tbd!!====
+
{{Top_10_2010:ExampleBeginTemplate}}
−
{{Top_10_2010:ExampleBeginTemplate}}Tbd!!
+
'''/** (3) Beim Empfang der Daten das CSRF-Token prüfen **/'''<br/>
−
public String addCSRFToken(String href) {
+
public void verifyCSRFToken(HttpServletRequest request) throws IntrusionException {<br/>
−
: User user = ESAPI.authenticator().getCurrentUser();
+
: User user = ESAPI.authenticator().getCurrentUser();<br/>
−
: if (user.isAnonymous()) {
+
: // check if user authenticated with this request - no CSRF protection required<br/>
−
:: return href;
+
: if( request.getAttribute(user.getCSRFToken()) != null ) {<br/>
−
: }
+
:: return;<br/>
−
: // if there are already parameters append with &, otherwise append with ?
+
:}<br/>
−
: <span style="color: green;">'''String token = CSRF_TOKEN_NAME + "=" + user.getCSRFToken();'''</span><br>
+
 
−
: <span style="color: green;">'''return href.indexOf( '?') != -1 ? href + "&" + token : href + "?" + token;'''</span><br>
+
: String token = request.getParameter(CSRF_TOKEN_NAME);<br/>
−
:}
+
: if ( !user.getCSRFToken().equals( token ) ) {<br/>
−
*[http://code.google.com/searchframe#N8fUvf0LCCY/trunk/src/main/java/org/owasp/esapi/reference/DefaultHTTPUtilities.java ESAPI DefaultHTTPUtilities.java]
+
::  throw new IntrusionException("Authentication failed", "Possibly forged HTTP request without proper CSRF token detected");<br/>
 +
:}<br/>
 +
}<br/>
 +
 
 +
 
 +
'''/** (4) Beim Abmelden bzw. Timeout die Session ungültig machen **/'''<br/>
 +
public void logout() {<br/>
 +
: ESAPI.httpUtilities().killCookie( ESAPI.currentRequest(), ESAPI.currentResponse(), HTTPUtilities.REMEMBER_TOKEN_COOKIE_NAME );<br/>
 +
: HttpSession session = ESAPI.currentRequest().getSession(false);<br/>
 +
: if (session != null) {<br/>
 +
:: removeSession(session);<br/>
 +
::  session.invalidate();<br/>
 +
:}<br/>
 +
 
 +
:ESAPI.httpUtilities().killCookie(ESAPI.currentRequest(), ESAPI.currentResponse(), "JSESSIONID");<br/>
 +
:loggedIn = false;<br/>
 +
:logger.info(Logger.SECURITY_SUCCESS, "Logout successful" );<br/>
 +
:ESAPI.authenticator().setCurrentUser(User.ANONYMOUS);<br/>
 +
}<br/>
 
{{Top_10_2010:ExampleEndTemplate}}
 
{{Top_10_2010:ExampleEndTemplate}}
  
 
{{Top_10_2010_Developer_Edition_De:SubsectionAdvancedTemplate|type={{Top_10_2010:StyleTemplate}}|number=7|risk=5}}
 
{{Top_10_2010_Developer_Edition_De:SubsectionAdvancedTemplate|type={{Top_10_2010:StyleTemplate}}|number=7|risk=5}}
 
====Tbd!!====
 
====Tbd!!====
−
Z.B. Bookmarks
+
Z.B. Keine Bookmarks auf ausgefüllte Eingabe-Formulare, Suchergebnisse
  
 
{{Top_10_2010_Developer_Edition_De:SubsectionAdvancedTemplate|type={{Top_10_2010:StyleTemplate}}|number=8|risk=5}}
 
{{Top_10_2010_Developer_Edition_De:SubsectionAdvancedTemplate|type={{Top_10_2010:StyleTemplate}}|number=8|risk=5}}
Line 87: Line 128:
 
{{Top_10_2010:SubSubsectionExternalReferencesTemplate}}
 
{{Top_10_2010:SubSubsectionExternalReferencesTemplate}}
 
*[http://cwe.mitre.org/data/definitions/352.html CWE Entry 352 on CSRF]
 
*[http://cwe.mitre.org/data/definitions/352.html CWE Entry 352 on CSRF]
 +
*[http://www.jtmelton.com/2010/05/16/the-owasp-top-ten-and-esapi-part-6-cross-site-request-forgery-csrf John Melton's Weblog: The OWASP Top Ten and ESAPI –Part 5–]
  
 
{{Top_10_2010_Developer_Edition_De:BottomAdvancedTemplate|type={{Top_10_2010:StyleTemplate}}|usenext=NextLink_Germany_Projekte|next=Top_10_fuer_Entwickler/A6 Sicherheitsrelevante Fehlkonfiguration|useprev=PrevLink_Germany_Projekte|prev=Top_10_fuer_Entwickler/A4 Unsichere direkte Objektreferenzen}}
 
{{Top_10_2010_Developer_Edition_De:BottomAdvancedTemplate|type={{Top_10_2010:StyleTemplate}}|usenext=NextLink_Germany_Projekte|next=Top_10_fuer_Entwickler/A6 Sicherheitsrelevante Fehlkonfiguration|useprev=PrevLink_Germany_Projekte|prev=Top_10_fuer_Entwickler/A4 Unsichere direkte Objektreferenzen}}
  
 
[[Category:OWASP Top 10 fuer Entwickler]]
 
[[Category:OWASP Top 10 fuer Entwickler]]

Revision as of 17:07, 18 February 2013

← Top_10_fuer_Entwickler/A4 Unsichere direkte Objektreferenzen
Top 10 fuer Entwickler-2013: Inhaltsverzeichnis

Die Top-10-Risiken

Top_10_fuer_Entwickler/A6 Sicherheitsrelevante Fehlkonfiguration →

Testseite in Bearbeitung (BAUSTELLE!!)

die Überschriften kommen z.T noch von den Templates der englischen Top 10, Tbd!!

A5 Cross-Site Request Forgery (CSRF) (untergeschobene Requests)

Threat Agents
Attack Vectors
Security Weakness
Technical Impacts
Business Impacts
______ Ausnutzbarkeit
DURCHSCHNITTLICH		 Verbreitung
SEHR HÄUFIG		 Auffindbarkeit
EINFACH		 Auiswirkung
MITTEL		 Application / Business Specific
Jeder, der einem Nutzer einer Webanwendung einen nicht beabsichtigten Request für diese Anwendung unterschieben kann. Hierfür kommt jede Website oder jede HTML-Quelle in Betracht, die der Nutzer verwendet. Durch Image-Tags, XSS oder andere Techniken löst das Opfer unbeabsichtigt einen gefälschten HTTP-Request für eine Anwendung aus. Falls der Nutzer authentisiert ist, wird dieser Angriff Erfolg haben. CSRF zielt auf Anwendungen, die es dem Angreifer erlauben, alle Details eines Requests für eine bestimmte Aktion vorherzusagen.

Da Browser Informationen zum Session-Management automatisch mitsenden, kann ein Angreifer gefälschte Requests auf bösartigen Websites hinterlegen, die von legitimen Requests nicht unterschieden werden können.

CSRF-Schwächen sind leicht durch Penetrationstests oder Quellcode-Analysen auffindbar.		 Der Angreifer kann unbemerkt das Opfer über dessen Browser dazu veranlassen, alle Daten zu ändern oder jede Funktion auszuführen, für die das spezifische Opfer berechtigt ist. Betrachten Sie den Geschäftswert der betroffenen Daten oder Funktionen. Es bleibt die Unsicherheit, ob der Nutzer die Aktion ausführen wollte. Bedenken Sie mögliche Auswirkungen auf Ihre Reputation.
Am I Vulnerable To 'Cross-Site Request Forgery (CSRF)'?

Die Anwendung erlaubt es einem Benutzer, einen zustandsändernden Request auszulösen, der kein geheimes Token beinhaltet, wie z.B.:

http://example.com/app/transferFunds?amount=1500&destinationAccount=4673243243

Dadurch kann ein Angreifer einen Request erzeugen, der Geld vom Konto des Opfers auf das Konto des Angreifers transferiert. Diesen bettet er in einem Image-Tag oder einem Iframe ein und hinterlegt ihn in einer beliebigen Website.

<img src="http://example.com/app/transferFunds?amount=1500&destinationAccount=attackersAcct#" width="0" height="0" />

Wenn das Opfer eine präparierte Seite besucht, während es z.B. bereits auf example.com authentisiert ist, wird der untergeschobene Request unbemerkt ausgeführt, da der Browser die aktuellen Session-Informationen automatisch mitsendet und somit unbeabsichtigt autorisiert.

How Do I Prevent 'Cross-Site Request Forgery (CSRF)'?

Um CSRF zu verhindern, muss ein unvorhersagbarer Token im Body oder in der URL eines jeden HTTP-Requests eingebettet sein (und geprüft werden). Ein solcher Token sollte für mindestens jede Nutzer-Session, besser noch für jeden Request, einzigartig sein.

  1. Die bevorzugte Methode, ein solches Token unterzubringen ist ein Hidden-Input-Feld. Damit wird der Token-Wert im Body des HTTP-Requests und nicht im URL übertragen. Eine Übertragung im URL kann leichter ausgespäht werden.
  2. Ein solches Token kann auch direkt in den URL geschrieben oder als URL-Parameter übergeben werden. Jedoch birgt diese Vorgehensweise das Risiko, dass der URL dem Angreifer in die Hände fällt und somit das geheime Token kompromittiert ist. OWASPs CSRF Guard kann genutzt werden, um automatisch solche Token in Java EE, .NET oder PHP Anwendungen einzubinden. OWASPs ESAPI / OWASP’s ESAPI (tbd!!) beinhaltet Token-Generatoren und Validatoren, die Entwickler einsetzen können, um ihre Transaktionen zu schützen.

JAVA

Example Attack Scenarios

/** (1) CSRF-Token erzeugen **/
private String csrfToken = resetCSRFToken();
...
public String resetCSRFToken() {

csrfToken = ESAPI.randomizer().getRandomString(8, DefaultEncoder.CHAR_ALPHANUMERICS);
return csrfToken;

}


/** (2) In zu schützenden FORM-Seiten, oder Urls das CSRF-Token als 'hidden field' hinzufügen, vgl ESAPI DefaultHTTPUtilities.java**/

final static String CSRF_TOKEN_NAME = "ctoken";
public String addCSRFToken(String href) {

User user = ESAPI.authenticator().getCurrentUser();
if (user.isAnonymous()) {
return href;
}
// if there are already parameters append with &, otherwise append with ?
String token = CSRF_TOKEN_NAME + "=" + user.getCSRFToken();
return href.indexOf( '?') != -1 ? href + "&" + token : href + "?" + token;

}

...
public String getCSRFToken() {

User user = ESAPI.authenticator().getCurrentUser();
if (user == null) return null;
return user.getCSRFToken();

}

References

/** (3) Beim Empfang der Daten das CSRF-Token prüfen **/
public void verifyCSRFToken(HttpServletRequest request) throws IntrusionException {

User user = ESAPI.authenticator().getCurrentUser();
// check if user authenticated with this request - no CSRF protection required
if( request.getAttribute(user.getCSRFToken()) != null ) {
return;
}
String token = request.getParameter(CSRF_TOKEN_NAME);
if ( !user.getCSRFToken().equals( token ) ) {
throw new IntrusionException("Authentication failed", "Possibly forged HTTP request without proper CSRF token detected");
}

}


/** (4) Beim Abmelden bzw. Timeout die Session ungültig machen **/
public void logout() {

ESAPI.httpUtilities().killCookie( ESAPI.currentRequest(), ESAPI.currentResponse(), HTTPUtilities.REMEMBER_TOKEN_COOKIE_NAME );
HttpSession session = ESAPI.currentRequest().getSession(false);
if (session != null) {
removeSession(session);
session.invalidate();
}
ESAPI.httpUtilities().killCookie(ESAPI.currentRequest(), ESAPI.currentResponse(), "JSESSIONID");
loggedIn = false;
logger.info(Logger.SECURITY_SUCCESS, "Logout successful" );
ESAPI.authenticator().setCurrentUser(User.ANONYMOUS);

}

style="vertical-align: top; padding:5px; width: 50%;
          border: 3px solid
  1. 4F81BD;
          background-color:
  1. F2F2F2;">

Tbd!!

Z.B. Keine Bookmarks auf ausgefüllte Eingabe-Formulare, Suchergebnisse 

style="vertical-align: top; padding:5px; width: 50%;
          border: 3px solid
  1. 4F81BD;
          background-color:
  1. F2F2F2;">

OWASP

External

← Top_10_fuer_Entwickler/A4 Unsichere direkte Objektreferenzen
Top 10 fuer Entwickler-2013: Inhaltsverzeichnis

Die Top-10-Risiken

Top_10_fuer_Entwickler/A6 Sicherheitsrelevante Fehlkonfiguration →
© 2002-2013 OWASP Foundation This document is licensed under the Creative Commons Attribution-ShareAlike 3.0 license. Some rights reserved. CC-by-sa-3 0-88x31.png
Retrieved from "https://wiki.owasp.org/index.php?title=Germany/Projekte/Top_10_fuer_Entwickler-2013/A8-Cross-Site_Request_Forgery_(CSRF)&oldid=144966"