OIDC for WordPress
In this section, you will find steps to configure an extension to cidaas from WordPress using latter's openID connect extension.
If you are in this section, we assume you are already using WordPress, and would like to connect cidaas with your WordPress instance!
If you don't have WordPress installed, follow WordPress installation steps which we explained in the later sections of this tutorial.
Overall process would be
- Activating OpenID connect plugin
- Configure cidaas endpoints
- Create login page and configure
- Verify your configuration
How to configure cidaas as an extension
By configuring cidaas as an extension in WordPress, you can login to Wordpress site with your cidaas credentials.
We will guide you through the process — it is quite easy!
Activating OpenID Connect plugin
In this section we will explain steps needed to activate OpenID Connect plugin from your Wordpress. To do this, you have to search for OpenID connect plugin in Wordpress repository, activate it and configure plugin with cidaas endpoints.
Steps to activate OpenID Plugin
1. Open WordPress on your local machine and login with your credentials.
2. Select Plugins menu on the side bar.
3. Select Add new menu that appears.
4. Search for OpenID Connect Generic Client in the search bar and click on Install now button to install the extension.
Click on Activate button to activate the extension.
Configure cidaas endpoints
Now that you have activated OpenID Connect (OIDC) plugin from your Wordpress, you need to integrate cidaas endpoints for it.
Steps to add cidaas endpoint details
1. Click on Settings menu in the sidebar and a new submenu named OpenId Connect Client will be displayed. Click on it.
2. Fill all the required details here. Get ClientID, Client Secret and Scopes from cidaas and enter here.
To know more about how to get clientID and Client Secret, refer to steps to create cidaas application section below.
Scroll down and fill cidass endpoint details.
Make note of the redirect URI and login button short code before clicking Save.
Click on Save changes button to update your changes.
Create Login Page
Now you need to create a login page to show Login with OpenID connect button on it. Then we can link this created login page on your WordPress top menu bar for quick access.
If you already have a login page, just add previously copied login shortcode in the content area.
Steps to create login page
1. Select Pages menu on the sidebar and then select Add New from the submenu appeared.
2. Provide suitable title for your page.
3. Search for shortcode block.
4. Paste the previously copied login shortcode in this content area. Click on Publish button to publish your page.
Adding Page to the menu
Follow steps below to link your newly created page in the top menu of your Wordpress interface.
1. Select Appearance menu on the sidebar and then select Menus option from the submenu.
2. Under Add menu items section, select recently created login page and click on Add to Menu button. Click on Save Menu button.
Congratulations! We are now done with the setup!
Verifying your Configuration
You can now verify configurations made in your Wordpress.
1. Run your WordPress application.
2. Click on Login menu.
3. Click on Login with OpenID connect button.
4. You will now be redirected to the cidaas login page. Here you can use your cidaas credentials and login.
Steps to create cidaas app
In order to get client ID and Client Secret, you need to cretae an "App" in cidaas. This section provides steps to create "App" using cidaas administration interface, which is available after you sign up with cidaas.
1. Navigate to cidaas Administrator dashboard -> Apps -> App Settings.
2. Click on Create New App button.
3. Enter app name and then select App type as per your requirement.
4. Under App Settings, select 'email', 'openid', 'profile' as Scopes.
5. Fill out all required information and click on Save button.
If you don't have WordPress installed, follow these steps:
1. Download WordPress from https://wordpress.org/download/.
2. You can then install WordPress by following the installation steps provided in the WordPress portal. [Refer Installation steps here.]