1
0
mirror of https://github.com/Microsoft/sql-server-samples.git synced 2025-12-08 14:58:54 +00:00
Files
sql-server-samples/samples/features/security/azure-active-directory-auth/readme.md
2016-07-25 14:46:55 -07:00

79 lines
3.0 KiB
Markdown

# Sample name
### Contents
[About this sample](#about-this-sample)<br/>
[Before you begin](#before-you-begin)<br/>
[Run this sample](#run-this-sample)<br/>
[Sample details](#sample-details)<br/>
[Disclaimers](#disclaimers)<br/>
[Related links](#related-links)<br/>
<a name=about-this-sample></a>
## About this sample
<!-- Delete the ones that don't apply -->
- **Applies to:** Azure SQL Database, Azure SQL Data Warehouse
- **Key features:** Azure Active Directory Authentication
- **Programming Language:** C#
- **Authors:** Mirek Sztajno [mireks-msft]
## About this sample
<a name=before-you-begin></a>
## Before you begin
To run this sample, you need the following prerequisites:
**Software prerequisites:**
1. Visual Studio 2015 (or higher) with the latest SSDT installed (using .Net Framework 4.6 or higher)
+ .Net Framework 4.6 must be set as the target framework for the Visual Studio project. To do this, double-click on Properties in Solution Explorer, then click the Application tab and check that the Target framework is set to .Net Framework 4.6
+ To install .Net Framework 4.6, see https://msdn.microsoft.com/library/5a4x27ek.aspx
2. Active Directory Authentication Library for SQL Server (ADALSQL.DLL)
+ ADALSQL.DLL enables applications to authenticate to Microsoft Azure SQL Database using Azure Active Directory. The ADALSQL.DLL is not installed with Visual Studio so download the DLL at http://www.microsoft.com/en-us/download/details.aspx?id=48742
+ ADALSQL.DLL is automatically downloaded with Visual Studio 2015 Update 2, SQL Server Management Studio, and the newest version of SQL Server Data tools
**Azure prerequisites:**
1. Azure Active Directory (AD)
2. Permission to create an Azure SQL Database
3. ???
**Other Prerequisites**
1. For Azure Active Directory integrated authentication, a Computer joined to a domain that is federated with Azure Active Directory.
2. A contained database user representing your Azure AD principal (or one of the groups you belong to) must exist in the database and must have at least the CONNECT permission.
<a name=run-this-sample></a>
## Run this sample
<!-- Place sample links here -->
[Integrated Demo](integrated)
[Password Demo](password)
<a name=sample-details></a>
## Sample details
This demo provides a tool for exploring Azure Active Directory authentication to Azure SQL DB or Azure SQL DW.
Azure Active Directory authentication with Azure SQL Database V12 supports the following authentication methods:
- User/password authentication
- Integrated authentication
- Application token authentication [Demo coming soon!]
<a name=disclaimers></a>
## Disclaimers
The code included in this sample is only intended to provide a method to demonstrate sucessful authentication to Azure SQL Database or Azure SQL Data Warehouse via Azure Active Directory authentication methods.
<a name=related-links></a>
## Related Links
<!-- Links to more articles. Remember to delete "en-us" from the link path. -->
<!-- For more information, see these articles: -->