Training:External login services in MDriven Turnkey: Difference between revisions

External login services in MDriven Turnkey

Latest revision as of 05:42, 11 January 2024

Settings in Portal

This article helps you set up the external login services (e.g. Google, Facebook, Microsoft) in the MDriven Turnkey application. After these easy steps, your application will offer your users the option to sign in with their existing social accounts.

Go to portal.mdriven.net and sign in under your existing account. Head to your application (Views -> Show my Turnkey sites) in which you want to add the external login services.

Block with settings for the external login services

Google Authentication

To set up authentication through Google Account in your Turnkey app, go to https://console.developers.google.com. Sign in under your Google account (or sign up if you don't have it).

Head to Credentials, press the "Create Credential" button and choose OAuth Client ID.
Next, choose Web application and enter the name, home page URL, and Redirect URL of your application.

Important!

At the end of the redirect URL, add the "sign-in-google" - for example, if your home page URL is — https://mdriventestone.azurewebsites.net/, your redirect URL will be — https://mdriventestone.azurewebsites.net/signin-google

Setting up Google Authentication

Turn on the Google+ API

Turn on the Google+ API.

Copy Secrets to the Portal

Press "Create" and copy your Client ID and Client Secret from the modal window to portal.mdriven.net.

Save the changes and press "Send Settings and Restart" to add Google Authentication to your Turnkey App.

Microsoft Authentication

To set up authentication through a Microsoft Account in your Turnkey app, go to https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps (App registrations). Sign in under your Microsoft Account and click on "New Registration".

Name your application (Note: This name will be visible for users when they use Microsoft Authentication) and press "Create".
Select which account types can use your application login.
Choose "Web" and enter Redirect URLs.

!Important! You have to enter a full link to your app (e.g. https://mdriventestone.azurewebsites.net/) and add "signin-microsoft" at the end of the link.

Registration Information of the App

Click "Register"
On the next screen, in the menu to the left, select "Certificates and secrets".
Select "Client secrets" and then "+ New client secret".
On the pane to the right, enter a description and expiration time, then click "Add".

Your Client Secret will be shown as "Value" in the list of secrets and you need to copy it now (to portal.mdriven.net or somewhere else, because it will be displayed only once).

Microsoft Client Secret

Save the Microsoft Portal and copy your Application ID and Client Secret to portal.mdriven.net (App ID to Microsoft Client ID and Client Secret to Microsoft Client Secret).

In the MDriven Portal, save the change and press "Send settings and restart" to add Microsoft Authentication to your Turnkey App.

Additionally, in the left menu, you can select "Branding and properties" to enter a logo and other information, like the Home page URL of your application.

Enter the Home Page URL of Your App

Extra info: You can view an MS account's given App rights at https://microsoft.com/consent

Windows Authentication

In intranet environments, you may want to use existing Kerberos Windows auth for users of a Turnkey site.

Start by configuring the IIS to use authentication (this means the IIS takes care of this before your application) - you can follow the instructions for MDrivenServer for this.

You must also do some manual changes to the web.config of Turnkey: SingleSignOn

Facebook Authentication

To set up authentication through your Facebook Account in your Turnkey App, go to https://developers.facebook.com. Sign in under your Facebook account or register a new one.

Head to "My apps" and choose "Add a new App". Name your app and on the next screen, press "Set up" on the Facebook login card.
Next, select Web platform and enter the Site URL (URL of your application), press save, and continue but skip other steps.
Head to Settings -> Basic, enter the App domain (URL of your application), and save the changes.
Also at Client OAuth Settings, add <SITE URL>/signin-facebook as a valid OAuth Redirect URI.

Now copy the App ID and App Secret to portal.mdriven.net.

Facebook authentication settings

Paste your App ID and App Secret to Facebook Client ID and Facebook Client Secret, save the changes, and press "Send settings and Restart" to add Facebook Authentication to your Turnkey App.

This page was edited 121 days ago on 01/11/2024. What links here

@@ Line 1: / Line 1: @@
-This article helps you to set up the external login services (e.g. Google, Facebook, Microsoft) in MDriven Turnkey application. After these easy steps, your application will offer your users to sign in with their existing social accounts.
+== Settings in Portal ==
+This article helps you set up the external login services (e.g. Google, Facebook, Microsoft) in the MDriven Turnkey application. After these easy steps, your application will offer your users the option to sign in with their existing social accounts.
-Go to [https://portal.mdriven.net/ portal.mdriven.net] and sign in under your existent account. Head to your application (Views -> Show my Turnkey sites) in which you want to add the external login services.
+Go to [https://portal.mdriven.net/ portal.mdriven.net] and sign in under your existing account. Head to your application (Views -> Show my Turnkey sites) in which you want to add the external login services.
 [[File:Block with settings for the external login services.jpg|none|thumb|428x428px|Block with settings for the external login services]]
 == Google Authentication ==
-To set up an authentication through Google Account in your Turnkey app, you need to go to https://console.developers.google.com. Sign in under your Google account (or sign up if you don`t have it).
+To set up authentication through Google Account in your Turnkey app, go to https://console.developers.google.com. Sign in under your Google account (or sign up if you don't have it).
+# Head to '''Credentials,''' press the "'''Create Credentia'''l" button and choose '''OAuth Client ID'''.
+# Next, choose '''Web application''' and enter the name, home page URL, and Redirect URL of your application.
-Head to '''Credentials''' and press "'''Create Credentia'''l" button and choose '''OAuth Client ID'''.
+==== '''Important!''' ====
+At the end of the redirect URL, add the "'''sign-in-google'''" - for example, if your home page URL is — ''<nowiki>https://mdriventestone.azurewebsites.net/</nowiki>'', your redirect URL will be  — ''https://mdriventestone.azurewebsites.net/signin-google''
+[[File:Google authentication settings.jpg|alt=Setting up Google Authentication|none|thumb|415x415px|Setting up Google Authentication]]
-Next, choose "Web application" and enter the name, home page URL and Redirect URL of your application.
+==== Turn on the Google+ API ====
+Turn on the Google+ API.
+[[File:Google+ API .png|none|thumb]]
-'''!Important.''' At the end of redirect URL you need to add "'''signin-google'''", for example if your home page url is — ''<nowiki>https://mdriventestone.azurewebsites.net/</nowiki>'', your redirect url will be  — ''<nowiki>https://mdriventestone.azurewebsites.net/signin-google</nowiki>''
+==== Copy Secrets to the Portal ====
-[[File:Google authentication settings.jpg|alt=Setting up Google Authentication|none|thumb|415x415px|Setting up Google Authentication]]
+Press "Create" and copy your '''Client ID''' and '''Client Secret''' from the modal window to portal.mdriven.net.
-Press Create and copy your '''Client ID''' and '''Client Secret''' from modal window to portal.mdriven.net.
 Save the changes and press "'''Send Settings and Restart'''" to add Google Authentication to your Turnkey App.
-== Facebook Authentication ==
-To set up an authentication through Facebook Account in your Turnkey App, you need to go to [https://developers.facebook.com/ https://developers.facebook.com] . Sign in under your Facebook account or register a new one.
-Head to "My apps" and choose "'''Add a new App'''". Name your app and on the next screen press "'''Set up'''" on '''Facebook login''' card.
-Next, select '''Web platform''' and enter '''Site URL''' (URL of your application) press save and continue and skip other steps.
 == Microsoft Authentication ==
-To set up an authentication through Microsoft Account in your Turnkey app, you need to go to https://apps.dev.microsoft.com (Application Registration Portal). Sign in under your Microsoft Account and '''add a new application'''.
+To set up authentication through a Microsoft Account in your Turnkey app, go to https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps (App registrations). Sign in under your Microsoft Account and '''click on "New Registration"'''.
+# Name your application (''Note'': This name will be visible for users when they use Microsoft Authentication) and press '''"Create"'''.
+# Select which account types can use your application login.
+# Choose "Web" and enter '''Redirect URLs'''.
+'''!Important!''' You have to enter a full link to your app (e.g. https://mdriventestone.azurewebsites.net/) and add "'''signin-microsoft'''" at the end of the link.
+[[File:Registration information of app.jpg|none|thumb|427x427px|Registration Information of the App]]
+* Click "Register"
+* On the next screen, in the menu to the left, select "Certificates and secrets".
+* Select "Client secrets" and then "+ New client secret".
+* On the pane to the right, enter a description and expiration time, then click "Add".
+Your '''Client Secret''' will be shown as "Value" in the list of secrets and you need to copy it now (to portal.mdriven.net or somewhere else, because it will be displayed '''''only once''''').[[File:Microsoft Client Secret.jpg|none|thumb|817x817px|Microsoft Client Secret]]Save the '''Microsoft Portal''' and copy your Application ID and Client Secret to portal.mdriven.net (App ID to '''Microsoft Client ID''' and Client Secret to '''Microsoft Client Secret''').
+[[File:MS client id.png|none|thumb|850x850px]]
+In the '''MDriven Portal''', save the change and press "'''Send settings and restart'''" to add Microsoft Authentication to your Turnkey App.
-Name your application and check  (note: This name will be visible for users when they will use Microsoft Authentication) and press '''"Create"'''.
+Additionally, in the left menu, you can select "Branding and properties" to enter a logo and other information, like the '''Home page URL''' of your application.[[File:Platforms settings.jpg|none|thumb|677x677px|Enter the Home Page URL of Your App]]''Extra info:'' You can view an MS account's given App rights at https://microsoft.com/consent
-On the next screen you will see registration information with '''App ID'''.
+==== Windows Authentication ====
-[[File:Registration information of app.jpg|none|thumb|427x427px|Registration information of app]]
+In intranet environments, you may want to use existing Kerberos Windows auth for users of a Turnkey site.
-Now you need to press "Generate New Password" button to create an Microsoft Client Secret.
-Your '''Client Secret''' will popup in a modal window and you need to copy (to portal.mdriven.net or to somewhere else, because it will be displayed only one time).
+Start by configuring the IIS to use authentication (this means the IIS takes care of this before your application) - you can follow the [[MDrivenServer with Windows authentication|instructions for MDrivenServer]] for this.
-[[File:Microsoft Client Secret.jpg|none|thumb|426x426px|Microsoft Client Secret]]
-Next, press "Add Platform" and choose "Web". After this, you will see the section where you need to enter '''Redirect URLs'''.
-'''!Important.''' You have to enter a full link to your app (e.g. https://mdriventestone.azurewebsites.net/) and add "'''signin-microsoft'''" at the end of a link.
+You must also do some manual changes to the web.config of Turnkey: [[SingleSignOn]]
-[[File:Platforms settings.jpg|none|thumb|677x677px|Enter home page url of your app]]
-Also, below this page you need to enter '''Home page URL''' of your application.
-Save the changes and copy your App ID and Client Secret to portal.mdriven.net (App ID to '''Microsoft Client Id''' and Client Secret to '''Microsoft Client Secret''').
+== Facebook Authentication ==
+To set up authentication through your Facebook Account in your Turnkey App, go to [https://developers.facebook.com/ https://developers.facebook.com]. Sign in under your Facebook account or register a new one.
-Save change and press "'''Send settings and restart'''" to add Microsoft Authentication to your Turnkey App.
+# Head to "My apps" and choose "'''Add a new App'''". Name your app and on the next screen, press "'''Set up'''" on the '''Facebook login''' card.
+# Next, select '''Web platform''' and enter the '''Site URL''' (URL of your application), press save, and continue but skip other steps.
+# Head to Settings -> Basic, enter the App domain (URL of your application), and save the changes.
+# Also at Client OAuth Settings, add <SITE URL>/signin-facebook as a valid OAuth Redirect URI.
+Now copy the App ID and App Secret to portal.mdriven.net.
+[[File:Facebook authentication settings.jpg|alt=Facebook authentication settings|none|thumb|598x598px|Facebook authentication settings]]
+Paste your App ID and App Secret to '''Facebook Client ID''' and '''Facebook Client Secret''', save the changes, and press "'''Send settings and Restart'''" to add Facebook Authentication to your Turnkey App.
+[[Category:MDriven Turnkey]]
+[[Category:Authentication]]
+[[Category:Intermediate]]