Pre-requisites : Download And Installation

• Log into your Typo3 instance as an admin.
• Navigate to Extensions tab from left pane.
• Select Get Extension from the dropdown and search for miniOrange OAuth and install the extension.
• Now select Installed Extensions from the dropdown menu and search for OAuth and activate the extension.

Steps to configure WSO2 OAuth & OpenID Single Sign-On (SSO) Login into Typo3

1. Setup WSO2 as OAuth Provider

Follow the steps below to configure WSO2 as OAuth Provider

 Configure WSO2 as OAuth Provider

• First, let’s register this Consumer App in WSO2 IS. Download and start WSO2 IS.

• Once logged in, go to Main -> Service Provider and click on Add.

• Enter the Service Provider Name and Description and click on Register.

• Now go to the Service Provider->List and edit the Service Provider you have created.
• Scroll down and select Inbound Authentication Configuration and then select OAuth/OpenID Connect Configuration and click on Configure.

• Select the OAuth Version 2.0 and enter the Redirect/Callback URL from the plugin in Callback URL field. Click on Add.

• When the app has been added, Client ID and Client Secret are generated for the application. Configure the miniOrange Typo3 OAuth Client plugin with Client ID, Client Secret, Authentication and Access Token, Get User Info Endpoint of WSO2. Endpoints are provided at the bottom of this guide.

• Attribute Mapping: To get attributes from WSO2 you have to add following Claim URIs in your WSO2 application.
• Go to Service Provider->Claim Configuration.
• Select https://wso2.org/claims/emailaddress from Subject Claim URI dropdown.
• Add following URIs in Service Provider Claim Dialect: https://wso2.org/oidc/claim & https://wso2.org/claims

• You have successfully completed your WSO2 Server side configurations.

2. Configuring Typo3 as OAuth Client

• After successfully configuring OAuth Provider, enter the OAuth Provider Name, Client ID, Client Secret, Scope and provided endpoints.
  
  

  Please refer below Endpoints to configure the OAuth client

  
  

  Scopes	openid
  Authorize Endpoint	https://<domain-name>/oauth2/auth
  Token Endpoint	https://<domain-name>/oauth2/token
  Userinfo Endpoint	https://<domain-name>/oauth2/userinfo

• Click on the Save button to save the settings.

• Click on the Test Configuration button.

• You will see all the values returned by your OAuth Provider to Typo3 in a table. If you don't see value for First Name, Last Name, Email or Username, make the required settings in your OAuth Provider to return this information.
• You have successfully configured your Typo3 as an OAuth Client. You will see the SSO button on your frontend. Click on the button and test the SSO.

3: Attribute Mapping (Optional). *This is Premium feature.

• You can map attributes in the Attribute Mapping tab. Only username and email are allowed to be mapped in free version of the extension. However, in the premium version of the extension, you can map various attributes coming from your OAuth Provider to the attributes present in your Typo3 site.

4: Group Mapping (Optional). *This is Premium feature.

• You can specify a default role in the free extension that will be allocated to all non-admin users when they conduct SSO.
• Go to Group mapping tab and navigate to Group Mapping section.
• Select the Default Role and click on the Save button.

By configuring WSO2 as an OAuth Provider and Typo3 as an OAuth Client using our Typo3 OAuth Client extension, you have successfully installed Typo3 WSO2 Single Sign-On (SSO). Within minutes, you'll be able to provide safe access to your Typo3 site utilising WSO2 login credentials thanks to this solution.

Additional Resources

• What is Single Sign-On (SSO) Login?
• What is OAuth 2.0?
• How OAuth works?
• Typo3 OAuth and OpenID Single Sign On (SSO) Plugin.
• Typo3 SAML Single Sign On (SSO) Plugin.

If you are looking for anything which you cannot find, please drop us an email on info@xecurify.com