| Line 44: | Line 44: | ||
On the pane to the right, enter a description and and expiration time, then click "Add". | On the pane to the right, enter a description and and expiration time, then click "Add". | ||
Your '''Client Secret''' will be shown as "Value" in list of secrets and you need to copy it now (to portal.mdriven.net or to somewhere else, because it will be displayed only one time).[[File:Microsoft Client Secret.jpg|none|thumb|817x817px|Microsoft Client Secret]]Save the the '''Microsoft portal''' and copy your | Your '''Client Secret''' will be shown as "Value" in list of secrets and you need to copy it now (to portal.mdriven.net or to somewhere else, because it will be displayed only one time).[[File:Microsoft Client Secret.jpg|none|thumb|817x817px|Microsoft Client Secret]]Save the 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 change and press "'''Send settings and restart'''" to add Microsoft Authentication to your Turnkey App. | In the '''MDriven portal''', save change and press "'''Send settings and restart'''" to add Microsoft Authentication to your Turnkey App. | ||
Additionally, in the left menu, you can select " | Additionally, in the left menu, you can select "Branding and properties" to enter a logo and other information, like '''Home page URL''' of your application.[[File:Platforms settings.jpg|none|thumb|677x677px|Enter home page url of your app]]Extra info: You view an MS accounts given App rights at https://microsoft.com/consent | ||
==== Windows authentication ==== | ==== Windows authentication ==== | ||
Revision as of 11:26, 20 January 2022
Settings in Portal
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.
Go to 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.
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).
Head to Credentials and press "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 redirect URL you need to add "signin-google", for example if your home page url is — https://mdriventestone.azurewebsites.net/, your redirect url will be — https://mdriventestone.azurewebsites.net/signin-google
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 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 an authentication through Microsoft Account in your Turnkey app, you need to 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 will 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 a link.
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 and expiration time, then click "Add".
Your Client Secret will be shown as "Value" in list of secrets and you need to copy it now (to portal.mdriven.net or to somewhere else, because it will be displayed only one time).
Save the 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 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 Home page URL of your application.
Extra info: You view an MS accounts 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 is takes care of this prior to your application needs to ) - you can follow the instruction for MDrivenServer for this.
You must also do some manual change to the web.config of turnkey: SingleSignOn
Facebook Authentication
To set up an authentication through Facebook Account in your Turnkey App, you need to 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 Facebook login card.
Next, select Web platform and enter Site URL (URL of your application) press save and continue and skip other steps.
Head to Settings -> Basic and enter App domain (URL of your application), save the changes
Also at Client OAuth Settings, add <SITE URL>/signin-facebook as a valid OAuth Redirect URI.
Now copy App ID and App Secret to portal.mdriven.net.
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.