Decidim::IdcatMobil
User registration, login and verification through IdCat mòbil, an authentication method that uses OAuth 2.0 protocol. IdCat mòbil is an identity validator from VÀLid (Validador d'Identitats del Consorci AOC).
Installation
Add this line to your application's Gemfile:
gem 'decidim-idcat_mobil'
And then execute:
bundle install
Usage
To use it you have to first configure the omniauth-idcat_mobil and then this gem as a verification handler.
omniauth-idcat_mobil configuration
IdCat mòbil
will be available as a configurable OAuth2 strategy.
Check how to configure the strategy in Decidim's related documentation. The summary is that you have to edit your config/secrets.rb
and simply enable the strategy:
omniauth:
idcat_mobil:
enabled: true
icon_path: decidim/idcat_mobil/icon.svg
Omniauth's configuration is setted in config/initializers/omniauth_idcat_mobil.rb
. Nothing has to be modified there but it expects IDCAT_MOBIL_CLIENT_ID
, IDCAT_MOBIL_CLIENT_SECRET
and IDCAT_MOBIL_SITE_URL
environment variables to be setted.
Refer to omniauth-idcat_mobil
gem for further documentation.
Contributing
See Decidim.
Run tests
Create a dummy app in your application (if not present):
bin/rails decidim:generate_external_test_app
And run tests:
rspec spec
License
This engine is distributed under the GNU AFFERO GENERAL PUBLIC LICENSE.