.. _gnrextra/gnrauth/oidc:

Il package OIDC
===============

.. toctree::
   :maxdepth: 1
   :titlesonly:


   oidc_config/oidc_config.rst
   service_oidc



Il package OIDC permette di effettuare il login a un applicativo Genropy utilizzando l'OpenID Connect, ovvero un sistema di autenticazione che permette di creare un utente da uno esistente su Google, Apple, Facebook ecc.

Includere il package OIDC nel progetto
--------------------------------------
Il package OIDC è incluso nel «gnrextra» di Genropy, e può quindi essere facilmente incluso in tutti i progetti semplicemente modificando il file instanceconfig.xml come segue::

  <packages>
       <gnrauth_bnck pkgcode="gnrauth:oidc"/>
  </packages>

Una volta incluso il package nel progetto e avviata una *gnrdbsetup* dell'istanza è possibile procedere con la configurazione dei vari servizi necessari.

Prerequisiti
------------
Il package OIDC utilizza la libreria `oic <https://pypi.org/project/oic/>`_, è quindi necessario preinstallarla con il comando::

  pip install oic

.. sectionauthor:: Davide Paci

.. raw:: html

   <p style="font-size:0.8em;">Data di pubblicazione 06-02-2023</p>