.. _gnrextra/oidc/oidc_intro:

Introduzione
============




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>
       <gnrextra_bnck pkgcode="gnrextra: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