Extension Installation

composer req miniorange/miniorange-oidc

Using zip file:

• Download the zip file of the OAuth/OIDC SSO SSO extension from TYPO3 marketplace.
• Rename the zip file from oauth_openid_single_sign_on.zip to oauth.zip
• Go to your TYPO3 backend and click on Extensions section at the left side of your screen.
• Upload the zip file as represented in the below image.

Prerequirements Before Configuring

You must have atleast two pages before configuring the extension.

• Navigate to the Pages section and create new standard page with name feoidc and add feoidc plugin to it.
• Similarly create a page named response and and response plugin to it.
• You can refer to the below screenshots for the same.

Extension Configurations

• Once the extension is installed successfully, navigate to the OpenID Connect Client tab of the plugin and fill in all the required fields as below:

- OAuth/ OpenID Provider Name: {Name of your provider}

• Application type: OAuth/OpenID Connect
• Frontend Redirect/Callback Url : {Response Plugin Page URL which you created in step 4} (You will need to provide this URL to your OAuth/OIDC provider)
• feoidc page URL: {feoidc Plugin Page URL which you created in step 4}
• Client ID : {You will get it from your provider}
• Client Secret : {You will get it from your provider}
• Scope : openid profile email
• Authorization Endpoint : {Authorization Endpoint of your OAuth/OpenID Provider}
• Token Endpoint : {Access Token Endpoint of your OAuth/OpenID Provider}
• User Info Endpoint : {Userinfo Endpoint of your OAuth/OpenID Provider}
• Set client credentials in : Header/Body

• Provide the redirect/callback URL in your OAuth/OIDC Provider application by copying it from Frontend Redirect/Callback Url field in OpenID Connect Client tab.
• Once you are done with the configurations on both ends (i.e., Typo3 and your OAuth/OIDC Provider), click on the Test Configuration button in the OpenID Connect Client tab of the plugin and check if you are able to test it successfully.

• Navigate to the Attribute Mapping tab and map the Username attribute to your OAuth/OIDC Provider attribute using which you want to identify the users in Typo3 (you can find all the attributes received from your OAuth/OIDC Provider in the test configuration).

• Navigate to the Group Mapping tab of the plugin and save the Group Mapping for Frontend Users by selecting the Default Usergroup.

• Once you have done all the above steps, you are ready to test the SSO. You can use your Feoidc Page URL in order to initiate the SSO.

You can choose the setup guide according to your OAuth/OIDC Provider from below link: https://plugins.miniorange.com/typo3-sso-single-sign-on-with-oauth-openid-connect-setup-guides

Installation

• How should the extension be installed?
• Are they dependencies to resolve?
• Is it a static template file to be included?

To install the extension, perform the following steps:

1. Go to the Extension Manager
2. Install the extension
3. Load the static template
4. ...

For a list of configuration options, using a definition list is recommended:

Some Configuration

This option enables...

Other configuration

This other option is for all the rest...

Configuration

• Where and how the extension should be configured? TypoScript? PHP?
• Are there other prerequisite to full fill beforehand? For example, configure a setting in a special way somewhere.

FAQ

Possible subsection: FAQ

What does it do?

This chapter should give a brief overview of the extension. What does it do? What problems does it solve? Who is interested in this? Basically, this section includes everything people need to know to decide whether they should go on with this extension or not.

Screenshots

This chapter should help people figure how the extension works. Remove it if not relevant.