Step by Step Guide to Configure Bitrix24 as an OAuth/OpenId Connect Server in Drupal 8

Step 1: Configure Bitrix as an OAuth/OpenId Connect Server.

  • Go to https://dev.clever.com/ and sign up/login to register a new app.
  • Under Start your Clever Sandbox, click on the Click here to get started option.
  • Bitrix go to link
  • Go to https://apps.clever.com/signup and Signup/Login to your account
  • Follow the steps to create an application. (Refer to the images below)
  • Bitrix go to your account Bitrix link page Bitrix link page
  • Click on Clever Instant Login option to continue.
  • Bitrix clever instant plugin
  • Click on Next button to continue.
  • Bitrix continue button
  • Copy the Client ID and the Client Secret and store it in your miniOrange OAuth Client module under the Client ID and Client Secret text fields respectively. Copy the Redirect/Callback URL from your miniOrange oauth client module and store it in the Redirect URIs text field.
  • Finally, click on the Save button to save your configurations.
  • Bitrix save configuration
  • Click on the Next button to continue to next step.
  • Select the browsers you want to be supported for certificate survey and select Secure Authorization Grant Flow for the which authorization flow do you use question.
  • Bitrix support
  • Enter all the other fields according to your use case and click on the Submit button in the end to save your configurations.

Step 2: Configure miniOrange Drupal 8 OAuth Client module.

  • Click on the link here to download the miniOrange OAuth Client module.
  • Scroll down and download module by clicking in the zip option under Downloads.
  • Drupal go to link
  • Login in your Drupal 8 site’s admin console and click on Extend from the top navigation bar.
  • Select the Install new module option to install a new module on your Drupal 8 site.
  • Drupal install module
  • Upload the downloaded zip file of the Module and click on the Install button to continue.
  • Select Enable newly added modules.
  • Drupal install module
  • Scroll down till you find miniOrange OAuth Client. Click on the checkbox next to it and click on the Install button to enable the module.
  • Drupal navigation bar
  • Click on Configuration from the top navigation bar and Select Drupal OAuth client Configuration.
  • Drupal configuration page
  • Register/Login to your miniOrange account.
  • Drupal register login
  • Click on the Configure OAuth Client tab and select your OAuth Provider from the Select Application dropdown. In case you do not find your OAuth Provider listed in the dropdown, please select Custom OAuth Provider and continue.
  • Drupal click on save
  • Enter your OAuth Provider information in their respective fields and click on the Save button to continue. Also, copy the Callback/Redirect URL and save it on your OAuth Provider.
  • Drupal test configuration
  • Now click on the Test Configuration option. This Test Configuration link will give you the list of the attributes that are coming from your OAuth Provider.
  • Drupal test configuration
  • Copy the email and the name attributes and save them under the Attribute & Role Mapping tab in the Email Attribute and Name Attribute text field respectively.
  • Please note: This step is mandatory for your login to work. Click on the Save button on the bottom of the page to save your attribute configurations.

    Drupal click on save
  • Now logout and go to your Drupal 8 site’s login page, you will automatically find a Login withYour OAuth Provider link there. If you want to add your login link to other pages as well, please follow the steps given in the below image:
  • Drupal logout
  • If you want to check out our complete list of features and our various licensing plans, you can go to the Licensing Plan tab in the module.
  • Still, if you are facing any difficulty or if you have any questions in mind, you can reach out to us by submitting a query in the Support tab of a module or by sending us a mail at info@miniorange.com.
  • Congratulations, you have successfully configured the miniOrange Drupal 8 OAuth Client module.