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 "Query Parameterization Cheat Sheet (Hawaiian Pidgin English)"

From OWASP
Jump to: navigation, search
m (this to dis)
(gone)
 
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:
__NOTOC__
+
{{taggedDocument
<div style="width:100%;height:160px;border:0,margin:0;overflow: hidden;">[[File:Cheatsheets-header.jpg|link=]]</div>
+
| type=delete
 
+
}}
{| style="padding: 0;margin:0;margin-top:10px;text-align:left;" |-
 
| valign="top"  style="border-right: 1px dotted gray;padding-right:25px;" |
 
Last revision (mm/dd/yy): '''{{REVISIONMONTH}}/{{REVISIONDAY}}/{{REVISIONYEAR}}'''
 
= Introduction  =
 
__TOC__{{TOC hidden}}
 
 
 
'Ey, Howzit? One [[SQL Injection]] is da moddah of all web vulnerabilities. Fo' real! So much so that it's the [[Top_10_2013-A1|#1 item in the OWASP Top 10]].  It represents a serious threat because SQL Injection allows evil attacker code to change the structure of a web application's SQL statement in a way that can steal data, modify data, or potentially facilitate command injection to the underlying OS. 
 
Dis cheat sheet is a derivative work of the [[SQL Injection Prevention Cheat Sheet]].  Mahalos yeah fo' checking out dis place. Shoots!
 
 
 
= Parameterized Query Examples =
 
 
 
SQL Injection is best prevented through the use of [[SQL_Injection_Prevention_Cheat_Sheet#Defense_Option_1:_Prepared_Statements_.28Parameterized_Queries.29|''parameterized queries'']]. The following chart demonstrates, with real-world code samples, how to build parameterized queries in most of the common web languages. The purpose of these code samples is to demonstrate to the web developer how to avoid SQL Injection when building database queries within a web application.
 
 
 
== Prepared Statement Examples ==
 
 
 
{| class="wikitable nowraplinks"
 
|-
 
! Language - Library
 
! Parameterized Query
 
|-
 
| Java - Standard
 
 
String custname = request.getParameter("customerName");
 
String query = "SELECT account_balance FROM user_data WHERE user_name = ? "; 
 
'''PreparedStatement pstmt = connection.prepareStatement( query );'''
 
'''pstmt.setString( 1, custname); '''
 
ResultSet results = pstmt.executeQuery( );
 
|-
 
| Java - Hibernate
 
|
 
//HQL
 
Query safeHQLQuery = session.createQuery("from Inventory where productID=:productid");
 
safeHQLQuery.setParameter("productid", userSuppliedParameter);
 
 
 
//Criteria API
 
String userSuppliedParameter = request.getParameter("Product-Description"); // Dis should REALLY be validated too
 
// perform input validation to detect attacks
 
Inventory inv = (Inventory) session.createCriteria(Inventory.class).add
 
(Restrictions.eq("productDescription", userSuppliedParameter)).uniqueResult();
 
|-
 
| .NET/C#
 
|
 
String query = "SELECT account_balance FROM user_data WHERE user_name = ?";
 
try {
 
    OleDbCommand command = new OleDbCommand(query, connection);
 
    '''command.Parameters.Add(new OleDbParameter("customerName", CustomerName Name.Text));'''
 
    OleDbDataReader reader = command.ExecuteReader();
 
    // …
 
} catch (OleDbException se) {
 
    // error handling
 
}
 
|-
 
| ASP.NET
 
|
 
string sql = "SELECT * FROM Customers WHERE CustomerId = @CustomerId";
 
'''SqlCommand command = new SqlCommand(sql);'''
 
'''command.Parameters.Add(new SqlParameter("@CustomerId", System.Data.SqlDbType.Int));'''
 
command.Parameters["@CustomerId"].Value = 1;
 
|-
 
| Ruby - ActiveRecord
 
 
'''# Create'''
 
Project.create!(:name => 'owasp')
 
'''# Read'''
 
Project.all(:conditions => "name = ?", name)
 
Project.all(:conditions => { :name => name })
 
Project.where("name = :name", :name => name)
 
'''# Update'''
 
project.update_attributes(:name => 'owasp')
 
'''# Delete'''
 
Project.delete(:name => 'name')
 
|-
 
| Ruby
 
|
 
insert_new_user = db.prepare "INSERT INTO users (name, age, gender) VALUES (?, ? ,?)"
 
insert_new_user.execute 'aizatto', '20', 'male'
 
|-
 
| PHP - PDO
 
|
 
$stmt = $dbh->prepare("INSERT INTO REGISTRY (name, value) VALUES (:name, :value)");
 
'''$stmt->bindParam(':name', $name);'''
 
'''$stmt->bindParam(':value', $value);'''
 
|-
 
| Cold Fusion
 
|
 
<cfquery name = "getFirst" dataSource = "cfsnippets">
 
    '''SELECT * FROM #strDatabasePrefix#_courses WHERE intCourseID ='''
 
    '''<cfqueryparam value = #intCourseID# CFSQLType = "CF_SQL_INTEGER">'''
 
</cfquery>
 
|-
 
| Perl - DBI
 
|
 
my $sql = "INSERT INTO foo (bar, baz) VALUES ( ?, ? )";
 
'''my $sth = $dbh->prepare( $sql );'''
 
'''$sth->execute( $bar, $baz );'''
 
|}
 
 
 
== Stored Procedure Examples ==
 
 
 
The SQL you write in your web application isn't the only place that SQL injection vulnerabilities can be introduced. If you are using Stored Procedures, and you are dynamically constructing SQL inside them, you can also introduce SQL injection vulnerabilities. To ensure dis dynamic SQL is secure, you can parameterize dis dynamic SQL too using bind variables. Here are some examples of using bind variables in stored procedures in different databases:
 
 
 
{| class="wikitable nowraplinks"
 
|-
 
! Language - Library
 
! Parameterized Query
 
|-
 
| Oracle - PL/SQL
 
|
 
Normal Stored Procedure - no dynamic SQL being created. Parameters passed in to stored procedures are naturally bound to their location within the query without anything special being required.
 
 
 
  PROCEDURE SafeGetBalanceQuery(
 
    UserID varchar, Dept varchar) AS BEGIN
 
 
 
    SELECT balance FROM accounts_table WHERE user_ID = UserID AND department = Dept;
 
  END;
 
 
 
|-
 
| Oracle - PL/SQL
 
 
Stored Procedure Using Bind Variables in SQL Run with EXECUTE. Bind variables are used to tell the database that the inputs to dis dynamic SQL are 'data' and not possibly code.
 
 
 
  PROCEDURE AnotherSafeGetBalanceQuery(
 
    UserID varchar, Dept varchar) AS
 
    stmt VARCHAR(400); result NUMBER;
 
 
 
  BEGIN
 
    stmt := 'SELECT balance FROM accounts_table WHERE user_ID = :1
 
      AND department = :2';
 
    EXECUTE IMMEDIATE stmt INTO result USING UserID, Dept;
 
    RETURN result;
 
  END;
 
|-
 
| SQL Server- Transact-SQL
 
|
 
Normal Stored Procedure - no dynamic SQL being created. Parameters passed in to stored procedures are naturally bound to their location within the query without anything special being required.
 
 
 
  PROCEDURE SafeGetBalanceQuery(
 
    @UserID varchar(20),
 
    @Dept varchar(10)) AS BEGIN
 
 
 
    SELECT balance FROM accounts_table WHERE user_ID = @UserID AND department = @Dept
 
  END
 
|-
 
| SQL Server- Transact-SQL
 
|
 
Stored Procedure Using Bind Variables in SQL Run with EXEC. Bind variables are used to tell the database that the inputs to dis dynamic SQL are 'data' and not possibly code.
 
 
 
  PROCEDURE SafeGetBalanceQuery(@UserID varchar(20),
 
      @Dept varchar(10)) AS BEGIN
 
    DECLARE @sql VARCHAR(200)
 
    SELECT @sql = 'SELECT balance FROM accounts_table WHERE '
 
      + 'user_ID = @UID AND department = @DPT'
 
    EXEC sp_executesql @sql,
 
      '@UID VARCHAR(20), @DPT VARCHAR(10)',
 
      @UID=@UserID, @DPT=@Dept
 
  END
 
|}
 
 
 
= References =
 
* [http://bobby-tables.com/ The Bobby Tables site (inspired by the XKCD webcomic) has numerous examples in different languages of parameterized Prepared Statements and Stored Procedures]
 
* OWASP [[SQL Injection Prevention Cheat Sheet]]
 
 
 
= Authors and Primary Editors  =
 
 
 
Jim Manico - jim [at] owasp.org<br/>
 
[[User:Wichers|Dave Wichers - dave.wichers]] [at] aspectsecurity.com<br/>
 
Neil Matatal - neil [at] owasp.org
 
 
 
== Other Cheatsheets ==
 
 
 
{{Cheatsheet_Navigation_Body}}
 
 
 
|}
 
 
 
[[Category:Cheatsheets]]
 

Latest revision as of 21:30, 16 August 2018

This page has been recommended for deletion.
You can help OWASP by improving it or discussing it on its Talk page.
Please add a comment to your tag. See
FixME