🔗 The oAuth mode

The oAuth mode allows you to use your Decidim platform as an Identity Provider on another platform. The oAuth protocol is an authorization delegation protocol, which can be particularly useful to use your Decidim platform's login data to allow users who would like to connect to another platform to do so with their Decidim credentials (in the same way as with Facebook or Google Connect). 

To create an oAuth application on Decidim, go to the "oAuth Applications" tab in the menu on the left side of your admin area, and click on "New oAuth Application". 

On the window that opens, you have to enter : 

• The title of the oAuth application: the name of the platform requesting the connection data to the Decidim platform. 
• The URI: this is the redirection URL. For example, the URI for Google Connect is "Domainname/auth/google_oauth2/callback".
• The name of the organization: name of your organization
• Organization URL: clickable link to your organization's name
• The organization logo: logo that will appear next to the application to use your account

To understand where these different fields are positioned on the user space, see below. 

Click on "Save". Back on the oAuth application management page, you can edit your application by clicking on the " " icon.Edit" or delete it by clicking on the icon "Delete". 

To see the features of an oAuth application, click on the Application Title (below: "Platform Example"). 

You will then have access to all the information needed to configure the oAuth application on your other platform. To preview the result of your configuration, copy the authentication URL and open it in your browser.