Steps for connecting to SQL database

README.md

@@ -55,6 +55,7 @@ To see what is releasing in the FHIR Server, please refer to the [releases](http
 - [SMART on FHIR Proxy tutorial](docs/SMARTonFHIR.md): Describes how to use the proxy to enable SMART on FHIR applications with the FHIR Server.
 - [FHIR Postman tutorial](https://docs.microsoft.com/azure/healthcare-apis/access-fhir-postman-tutorial): Describes how to access a FHIR API using Postman.
 - [Debugging](docs/HowToDebug.md): Describes how to debug FHIR Server for Azure using Visual Studio.
+- [Connect to SQL Database](docs/HowToConnectSQLDatabase.md): Describes how to connect to SQL Database.
 
 ## Blog Posts
 * Blog: [FHIR Server for Azure, an open source project for modern healthcare](https://cloudblogs.microsoft.com/industry-blog/health/2018/11/12/fhir-server-for-azure-an-open-source-project-for-cloud-based-health-solutions/).

docs/HowToConnectSQLDatabase.md

@@ -0,0 +1,43 @@
+# Connecting to a SQL Database
+The procedures for connecting to a SQL database are outlined in this article.
+
+## Active Directory Administrator for SQL Server
+
+The user must set themselves as SQL Server Active Directory Admin when they connect to the database for the first time. 
+
+The actions to do are listed below for it.
+*	Access the SQL Server
+*	Click on Settings -> Microsoft Entra ID -> Set Admin
+![alt text](images/HowToConnectSQLDatabase/entraid-admin.png "Entra Admin")
+*	Choose the User Account
+![alt text](images/HowToConnectSQLDatabase/choose-user-account.png "Entra Admin")
+*	Press the "Save" button.
+![alt text](images/HowToConnectSQLDatabase/save-user-admin-account.png "Entra Admin")
+
+At this point, the user can connect to the database using `Active Directory authentication`.
+
+Create a new user in the database and give them the role `db_owner` after connecting to the database.
+
+The script for the same can be found below: 
+```
+CREATE USER [user-name] FROM EXTERNAL PROVIDER; 
+ALTER ROLE db_owner ADD MEMBER [user-name];
+```
+
+Example query
+```
+CREATE USER [[email protected]] FROM EXTERNAL PROVIDER;
+ALTER ROLE db_owner ADD MEMBER [[email protected]]; 
+```
+
+Revert the SQL Server Active directory admin user changes once the user has been created, that is, set the `OSS FHIR Server(App service)` user assigned identity back to SQL Server admin.
+
+This is a `one-time only` activity. The user can utilize an active directory login to connect directly to the database the next time.
+
+## Important Information
+
+
+During that time, when the `user-assigned identity` assigned to the `OSS FHIR Server(App service)` is removed as the SQL Server admin, 
+the App service would degrade since it won't be able to access to the database.
+
+However, the `OSS FHIR Server(App service)` will return to normal once the user-assigned identity is changed back to admin when the user is created in the database.