Authentication.md

Authentication

ASP.NET Core Identity is a membership system that adds login functionality to ASP.NET Core apps.

Instructions

Below you will find the instructions, step-by-step to configure the following external login provider in your development environment.

• Facebook
• Microsoft
• LinkedIn
• GitHub
• Google

Facebook

0. Log In to Facebook using your account
1. Go to All Apps - Facebook for Developers
2. In the upper right corner, select My Apps and then click on Create App
3. Fill the fields Display Name and Contact Email then click Create App ID
4. You will see in the Dashboard a list of Products that you can add, we're going to configure Facebook Login, so, click on the Set Up button for that product
5. On the menu on the left, under Facebook Login, click on Settings. Under the Client OAuth Settings, there is a field called Valid OAuth Redirect URIs, where you have to put the URL of the project, eg. https://localhost:5001/, and then click on the Save Changes button.
6. On the menu on the left, under Settings, click on Basic, you will see the Facebook App ID and App Secret, necessary to configure the Authentication in the project, copy them, you will need it in next step.
7. In the Web project go to the file appsettings.Development.json go to the Facebook object, under Authentication, paste the App ID, and App Secret copied in the previous step.
8. Run the project and Log In using Facebook.

Microsoft

0. Log In to Microsoft Azure Portal using your Microsoft account

1. Go to App registrations

2. In the upper left corner, select New registration, now we need to fill the basic information about the application:

   • Fill the Name field for the application name, eg.: Emplea.do.

   • For Supported account types choose Accounts in any organizational directory (Any Azure AD directory - Multitenant) and personal Microsoft accounts (e.g. Skype, Xbox), this will allow to login anyone with a Microsoft account.

   • For Redirect URI we need to use: https://localhost:5001/signin-microsoft, in the Development Environment this is the local URL that the projects use, appending the 'signin-microsoft' that identifies the login provider, in this case, Microsoft.

   • Click the Register button.

     

3. In the left menu, select Certificates & secrets, under Client secrets:

   • Click the New client secret button.
   • Add a Description for the new client secrete, eg.: ClientSecret
   • Select when this secret Expires, eg.: In 1 year

   This will generate a new client secret, copy the value we will need it.

4. In the left menu, go to the application Overview, there you will see the Application (client) ID, copy it, we will need it in the next step.

5. Back in our Emplea.do Web project go to the file appsettings.Development.json to the Microsoft object under Authentication and paste the App ID and App Secret copied in the previous steps.

7. Run the project and Log In using Microsoft.

LinkedIn

0. Log In to LinkedIn using your account

1. Go to Developers | Linkedin and click in the Create app button

2. We need to fill the basic information about the application:

   • Set the App name, eg.: Emplea.do.

   • LinkedIn Page: select one company page that you have access to, or just create one with testing propose, you can delete it later, eg: TestEmpleado

   • Logo, choose the company logo

   • Accept the Legal agreement and click the Create app button

     

3. Go to the Auth tab, in the OAuth 2.0 settings add https://localhost:5001/signin-github in the Redirect URLs. From the Application credentials section copy the Client ID and the Client Secret, we will need it in the next step.

4. Go to he Products tab, Select the product Sign In with LinkedIn, in almost 2 minutes they will approve your application.

   

5. Back in our Emplea.do Web project go to the file appsettings.Development.json to the Linkedin object under Authentication and paste the ClientId and ClientSecret copied in the previous steps.

6. Run the project and Log In using LinkedIn.

GitHub

0. Log In to GitHub using your account

1. Go to New OAuth Application

2. We need to fill the basic information about the application:

   • Set the Application Name, eg.: Emplea.do.

   • Homepage URL: https://localhost:5001

   • For Authorization callback URL we need to use: https://localhost:5001/signin-github, in the Development Environment this is the local URL that the projects use, appending the 'signing-github' that identifies the login provider, in this case, GitHub.

   • Click the Register Application button.

     

3. Copy the Client ID and Client Secret, we will need it in the next step.

4. Back in our Emplea.do Web project go to the file appsettings.Development.json to the Github object under Authentication and paste the ClientId and ClientSecret copied in the previous steps.

5. Run the project and Log In using GitHub.

Google

0. Log In to Google using your account

1. Go to Integrating Google Sign-In into your web app and click in the Configure a project button

2. From the dropdown, select + Create a new project, we need to fill the basic information about the application:

   • Set the Project name and click next, eg.: Empleado.
   • Enter the Product Name and click next, eg.: Emplea.do
   • From the dropdown select Web server as your OAuth client and set https://localhost:44343/signin-google as Authorized redirect URIs and click Create

3. Copy the Client ID and Client Secret, we will need it in the next step.

4. Back in our Emplea.do Web project go to the file appsettings.Development.json to the Google object under Authentication and paste the ClientId and ClientSecret copied in the previous steps.

5. Run the project and Log In using Google.

References

• Facebook, Google, and external provider authentication in ASP.NET Core

• External OAuth authentication providers

• Facebook external login setup in ASP.NET Core

• Microsoft Account external login setup with ASP.NET Core

• Authenticating with OAuth 2.0 Overview (LinkedIn)

• Authorizing OAuth Apps (GitHub)

• Google external login setup in ASP.NET Core