1- # MAGE Authentication and Identity Providers
1+ # Mage Authentication and Identity Providers
22
33To configure authentication settings and identity providers
4- 1 . Click the gear icon in the upper right of the MAGE web app to load the _ Admin_ page.
4+ 1 . Click the gear icon in the upper right of the Mage web app to load the _ Admin_ page.
551 . Click, the _ Settings_ tab in the tab strip on the left of the page.
661 . Click the _ Authentication_ tab near the top of the main content pane. This tab should be selected by default.
771 . Click any of the accordion headings to expand the section for the authentication you want to configure, or
@@ -11,13 +11,13 @@ To configure authentication settings and identity providers
1111
1212## OAuth 2.0
1313
14- Here is an example of using Google's OAuth 2.0 [ endpoints] ( https://developers.google.com/identity/gsi/web/guides/overview ) to authenticate MAGE
14+ Here is an example of using Google's OAuth 2.0 [ endpoints] ( https://developers.google.com/identity/gsi/web/guides/overview ) to authenticate Mage
1515users. This setup is very similar to Google OpenID Connect authentication.
1616
1717Obtain your _ Client Identifier_ and _ Client Secret_ from Google's [ API Console] ( https://console.cloud.google.com/apis/credentials/oauthclient ) .
1818Additionally on that page, ensure you register the correct callback URL, e.g., ` https://mage.example.com/auth/oauth/callback `
1919
20- On the MAGE Admin page, click the _ Settings_ tab.
20+ On the Mage Admin page, click the _ Settings_ tab.
2121
2222_ Authorization URL_ - ` https://accounts.google.com/o/oauth2/v2/auth `
2323_ Token URL_ - ` https://oauth2.googleapis.com/token `
@@ -30,7 +30,7 @@ _Display Name Property_ - `name`
3030
3131## LDAP
3232
33- You can setup MAGE to authenticate users with an LDAP server. For development
33+ You can setup Mage to authenticate users with an LDAP server. For development
3434testing, the [ ` auth-idp ` ] ( ../docker/auth-idp/docker-compose.yml ) Compose file
3535uses the [ osixia/openldap] ( https://github.com/osixia/docker-openldap ) and
3636[ osixia/phpLDAPAdmin] ( https://github.com/osixia/docker-phpLDAPAdmin ) images
@@ -79,9 +79,9 @@ Using the phpLDAPAdmin UI to setup a simple group structure.
7979You now have a simple group structure and user account in your LDAP database.
8080
8181Now that you have an LDAP database with a user account, you can configure LDAP
82- authentication in MAGE . This assumes you're running a MAGE server on
82+ authentication in Mage . This assumes you're running a Mage server on
8383http://localhost:4242 .
84- 1 . Open the MAGE web app in your browser.
84+ 1 . Open the Mage web app in your browser.
85851 . Click the gear icon in the top right to load the _ Admin_ page.
86861 . Click the _ Security_ tab in the vertical tab strip on the left.
87871 . Click the _ New Authentication_ button.
@@ -108,15 +108,15 @@ http://localhost:4242.
1081081 . Adjust the color settings to your preference.
1091091 . Click the _ Next_ button.
1101101 . Review the settings and click the _ Save_ button.
111- 1 . Open a new private browser tab or window and load your MAGE server web app.
111+ 1 . Open a new private browser tab or window and load your Mage server web app.
1121121 . The sign-in page should display a button labeled _ SIGN IN WITH LOCAL LDAP_
113113 under two text fields.
1141141 . In the _ Local LDAP Username_ text field, enter ` batman ` .
1151151 . In the _ Local LDAP Password_ text field, enter ` i heart alfred ` .
1161161 . Click the _ SIGN IN WITH LOCAL LDAP_ button.
1171171 . The page will most likely display a dialog that states the account needs
118118 admin approval.
119- 1 . In the browser tab with your MAGE admin page, click the _ Users_ tab in the
119+ 1 . In the browser tab with your Mage admin page, click the _ Users_ tab in the
120120 tab strip on the left.
1211211 . Click the _ Inactive_ search facet near the top left of the main pane. The
122122 user list should contain the _ Batman_ user with a green _ Activate_ button.
@@ -130,7 +130,7 @@ http://localhost:4242.
1301301 . You are now authenticated with your LDAP account.
131131
132132## SAML
133- You can setup MAGE to authenticate users with an SAML server. For development
133+ You can setup Mage to authenticate users with an SAML server. For development
134134testing, the [ ` auth-idp ` ] ( ../docker/auth-idp/docker-compose.yml ) Compose file
135135uses the [ kristophjunge/test-saml-idp] ( https://github.com/kristophjunge/docker-test-saml-idp )
136136Start the ` mage-idp-saml ` SAML
@@ -144,7 +144,7 @@ The docker compose file is set to seed a few users with the .saml/authsources.ph
144144file is mounted under volumes in the docker compose. Once it is spun up, you are ready to
145145configure your saml authentication provider.
146146
147- 1 . Open the MAGE web app in your browser.
147+ 1 . Open the Mage web app in your browser.
1481481 . Click the gear icon in the top right to load the _ Admin_ page.
1491491 . Click the _ Security_ tab in the vertical tab strip on the left.
1501501 . Click the _ New Authentication_ button.
@@ -168,7 +168,7 @@ configure your saml authentication provider.
1681681 . Adjust the color settings to your preference.
1691691 . Click the _ Next_ button.
1701701 . Review the settings and click the _ Save_ button.
171- 1 . Open a new private browser tab or window and load your MAGE server web app.
171+ 1 . Open a new private browser tab or window and load your Mage server web app.
1721721 . The sign-in page should display a button labeled _ Continue with SAML_
1731731 . Clicking this button will take you to a simple login page where the saml server is running.
1741741 . for Username enter ` saml.user1 `
0 commit comments