Configure Wild Apricot as OAuth provider for Drupal login

This document will help you configure WildApricot as an OAuth provider making Drupal as an OAuth client. Following these steps will allow you to configure OAuth/OpenID SSO between WildApricot and your Drupal site by allowing your users to login to your Drupal site using their WildApricot credentials. 

We provide Drupal OAuth & OpenID Connect Login module which is compatible with Drupal 7, Drupal 8, Drupal 9, and Drupal 10.

Download  Know more

Prerequisite:

• Install and activate the OAuth & OpenID Connect Login - OAuth2 Client SSO Login module on your Drupal site. Click here to check out the module installation step.

Steps to configure Drupal as OAuth Client:

• Once you have installed the module, go to the Configuration tab, and click on the miniOrange OAuth Client Configuration. (/admin/config/people/miniorange_oauth_client/config_clc)

  

• In the Configure OAuth tab, select Wild Apricot from the Select Application dropdown.
• Copy the Callback/Redirect URL and keep it handy.
  

  If your provider only supports HTTPS Callback/Redirect URLs and you have an HTTP site, please make sure to enable the 'Enforce HTTPS Callback URL' checkbox at the bottom of the tab.

• In the Display Name text field, enter the name of the Application. For example, WildApricot.

  

Configure OAuth SSO Application in Wild Apricot:

• Log in into the WildApricot admin console.

• Select Apps from the left navigation panel.

  

• Under Integrations section, select Authorized applications box.

  

• Click the Authorise application button, as seen in the figure below.

  

• Under Application authorization, select Server application from the list of options and click Continue.

  

• In the Application details, enter the name in the Application name text field.

  

• In the same window, under the Authorization page settings section, check the box Authorize users via Wild Apricot single sign-on service.

• Paste the copied Callback/Redirect URL (from your Drupal site) into the Trusted redirect domains text field.

  

Integrating Drupal with Wild Apricot:

• Navigate to the WildApricot portal.

• Under Application credentials for user authorization, click on the Generate client secret button.

  

• Now, copy the Client ID.

  

• Then, go back to the Drupal site and paste the copied Client ID into the Client ID text field.

  

• Again, go back to the WildApricot Dashboard.
• Copy the Client secret from the Application credentials for user authorization section.

• Click on the Save button.

  

• Navigate to the Drupal site and paste the copied Client secret into the Client Secret text field.

  

• On the Configure OAuth screen, provide the required information in below fields:
  

  Authorization Endpoint	https://<your_account_url>/sys/login/OAuthLogin (Ex. your_account_url is the URL <organization_name.wildapricot.org>)
  Access Token Endpoint	https://oauth.wildapricot.org/auth/token
  Get User Info Endpoint	https://api.wildapricot.org/v2.1/accounts/<account_id>/contacts/me (In the accounts section of the Wild Apricot dashboard, navigate to the Billing tab to find your account_id)
  Scope	auto

  Note: In this case, you must enable the checkbox for the WildApricot application to send client credentials in the header.

• Click on the Save Configuration button.

       

Test Configuration of Drupal with WildApricot:

• After successfully saving the configurations, click on the Perform Test Configuration button to check the connection between Drupal and WildApricot.

  

• On a Test Configuration popup, if you don't have any active session in WildApricot on the same browser, you will be asked to login into the WildApricot. Once you are successfully logged into the WildApricot, you will be provided with a list of the attributes that are received from the WildApricot.

• Select the Email Attribute (The Attribute which contains the user's email. In our case it is ‘email’) from the dropdown menu and click on the Done button.

  

• Once clicked on the Done button, you will be automatically redirected to Attribute & Role Mapping tab. Now, you can also choose the Username Attribute from the dropdown and click on the Save Configuration button.

  

Note: Mapping the Email Attribute is mandatory for your login to work. 

Congratulations! You have successfully configured WildApricot as OAuth Provider and Drupal as OAuth Client.

How to perform the SSO login?

• Now, open a new browser/private window and go to your Drupal site login page.
• Click on the Login using WildApricot link to initiate the SSO from Drupal.

• If you want to add the SSO link to other pages as well, please follow the steps given in the image below:

  

 Back to top