====== Pré-requis ======

Avoir un serveur Redmine fonctionnel et installé comme indiqué ici :[[computing:network_system:installation_d_un_serveur_redmine|Dépendances]]

====== Installation ======

===== En tant qu'utilisateur redmine =====

Rappelons que l'utilisateur redmine est le compte utilisateur exécutant notre serveur Redmine. Pour se connecter avec ce compte :
<code>sudo su - redmine</code>

Rendons nous dans le répertoire contenants les plugins de notre serveur Redmine :
<code>cd redmine/plugins</code>

Récupérons le plugin d'authentification :
<code>git clone -b ARC https://github.com/ncsuarc/redmine_omniauth_google.git</code>

Revenons ensuite à la racine de notre serveur :
<code>cd ~/redmine</code>

Et installons l'ensemble des Gems manquantes :
<code>bundle install</code>

Le plugin est installé, il faut maintenant repasser sur le compte administrateur pour relancer notre serveur web et ainsi prendre en compte le plugin.
<code>exit</code>

===== En tant qu'administrateur =====

Rechargeons donc notre serveur web avec la commande suivante:
<code>sudo service apache2 reload</code>

Le plugin est maintenant disponible depuis notre navigateur.

====== Configuration ======

Il faut se connecter sur le Redmine via votre navigateur web préféré en tant qu'administrateur.
Sur la page **"Administration"**, sélectionner **"Plugins"**, puis cliquer sur le lien **"Configurer"** du plugin **"Redmine Omniauth Google plugin"**.\\
\\
Ensuite, il faut renseigner les champs **"Client ID"**, **"Client Secret"** et cocher la case **"Oauth authentification"** pour activer l'authentification via Google+.

Si vous n'avez pas encore de **"Client ID"** et de **"Client Secret"**, vous pouvez en obtenir un de cette facon :
  - Aller sur [[https://console.developers.google.com/project|la console des développeurs Google]]
  - Sélectionner un projet (en créer un nouveau si besoin)
  - aller sur la page "APIs & auth->APIs" via le menu de gauche
  - Activer "Google+ API"
  - Aller sur la page "APIs & auth->Credentials" via le menu de gauche
  - Cliquer sur le bouton "Create new Client ID"
  - Sur le formulaire :
    - Selectionner "Web Application"
    - Dans "AUTHORIZED JAVASCRIPT ORIGINS" rentrer l'URL du serveur Redmine : [[https://myredmineserver.home]]
    - Dans "AUTHORIZED REDIRECT URI" rentrer l'URL de la callback oauth2 du serveur Redmine : [[https://myredmineserver.home/oauth2callback]]
    - Cliquer sur "Create Client ID"
  - Les "CLIENT ID" et "CLIENT SECRET" sont maintenant disponibles pour la configuration du plugin