Agenda on slash-root.fr

Nextcloud : Importer ses données de Google

Thu, 16 Jun 2022 08:00:16 +0200

Contexte

Il est possible de donner aux utilisateurs, un moyen de pouvoir importer plusieurs données de leur compte Google au sein de leur compte Nextcloud comme :

Les agendas
Les contacts
Les photos
Les fichiers

Pour se faire, plusieurs APIs Google vont être exploitées.

Google integration

Se connecter en admin sur l'interface web du Nextcloud.
Rechercher, télécharger, installer l'application Google integration.
Dans les Paramètres d'Administration, se rendre dans Comptes connectés (1). C'est à cet endroit qu'il va falloir renseigner l'ID Client et le Secret client (2) afin de pouvoir autoriser les utilisateurs à s'authentifier plus tard sur leur compte Google afin de procéder à l'importation de leur données dans leur espace Nextcloud.
Cliquer sur Paramètres de l'API Google (3) afin de créer une application OAuth Google et de récupérer les informations à renseigner (2) pour finaliser l'intégration de Google.
S'identifier avec un compte Google sur la Google Cloud Platform.

Ce compte Google sera exploité uniquement pour l'API Google.

Google Cloud Platform

Projet

Créer un nouveau Projet.
Nommer le projet (1). Puis, valider (2).

Consentement

Dans Ecran de consentement OAuth (1), définir le type d'utilisateur (2). Puis, valider (3).
Entrer le nom de l'application demandant l'autorisation (1) ainsi que l'adresse mail d'assistance (2).

Il est possible de spécifier un logo qui apparaitra sur la page de consentement lorsque l'utilisateur saisira ces informations de compte Google.
Tout en bas de la page, indiquer vos coordonnées de développeur. Puis Enregistrer et continuer.
Sur l'écran suivant, Enregistrer et continuer tout en bas de la page.
A ce stade le projet a un status de publication à l'état de Test. Il est nécessaire d'ajouter (1) les comptes Google (2) que les utilisateurs utiliseront pour les autoriser à utiliser ce projet. Puis, Enregistrer et continuer.
Un résumé de l'écran de consentement paramétré est afficher.

Identifiants

Maintenant, il faut générer des identifiants de type OAuth dans le projet Google Cloud Platform créé. Ceux-ci seront à renseigner par la suite dans le paramétrage de Nextcloud.

Dans le menu API et services à gauche, se rendre dans Identifiants (1). Créer des identifiants (2) de type ID client OAuth (3).
Renseigner le Type d'application (1). Indiquer un Nom (2) pour identifier le client dans la console Google Cloup Platform. Indiquer l'URI de redirection (3) autorisés. Cette URI est disponible dans l'interface Nextcloud vu précédemment, dans la parti Intégration de Google. Puis, Créer (4).
l'ID client et le code secret du client sont disponible.
Retourner sur l'interface web de Nextcloud dans la partie Intégration de Google. Puis, indiquer l'ID client (1) et le Secret client (2).

API

Toujours sur Google Cloud Platform, dans API et services, se rendre dans Bibliothèque.
Rechercher et activer les API suivantes :
- Google Drive API
- Google Calendar API
- Google People API
- Photos Library API

Nextcloud

Dorénavant, lorsqu'un utilisateur se connectera sur l'interface web de son Nextcloud, une section Migration de données (1) est disponible dans ses paramètres. Cela va permettre à l'utilisateur de connecter son compte Google (2) afin de migrer les données voulues vers son compte Nextcloud.

Une fois que l'utilisateur a connecté son compte Google et autorisé l'accès aux données à migrer, il suffit de sélectionner les éléments à importer.

Si aucune données n'est présente dans une des fonctionnalités Google, celle-ci ne sera pas proposée à l'import.

Nextcloud : Ajouter un calendrier Google privé (Sans credentials)

Thu, 09 Jun 2022 08:00:00 +0200

Contexte

Le but est d'ajouter un calendrier Google (Google Agenda) dans les calendriers d'un utilisateur Nextcloud.

Le calendrier Google restera privé et ne passera donc pas en publique.

De plus, il ne sera accessible qu'en lecture. C'est comme ça...

Attention : L'accès au calendrier ne se fera pas avec les credentials du compte mais à l'aide d'une URL secrète (A ne surtout pas diffuser).

Côté Google

Se connecter au compte Google à ajouter dans Nextcloud.
Dans la partie gauche de l'interface web, cliquer sur les 3 petits points à droite du calendrier à intégrer dans Nextcloud (1). Puis sélectionner Paramètres et partage (2).

Faire défiler jusqu'à la partie Intégrer l'agenda.
L'adresse secrète au format iCal est disponible (1). Afin de mettre cette adresse dans le presse-papier, cliquer sur l'icône "Copier" en bout de ligne (2).

En utilisant cette adresse secrète, il n'est pas obligatoire de rendre l'agenda publique. De ce fait, le calendrier Google restera privé. Attention toutefois, son accès se fait sans credentials mais uniquement en lecture seule.

Côté Nextcloud

Se connecter sur le compte Nextcloud qui doit bénificer de l'agenda Google et se rendre dans la section Agenda.
Ajouter un nouvel agenda (1). Puis, créer un nouvel abonnement par lien (2).

Coller l'adresse secrète récupérée précédemment. Puis, valider.

Un nouveau calendrier calendar.google.com a été ajouté en lecture seule. Il est possible de la renommer pour lui donner un nom plus explicite.

Taux de rafraîchissement

Le taux de rafraîchissement (refresh rate), d'une souscription à un calendrier dans Nextcloud, est d'une fois toutes les semaines par défaut.

https://docs.nextcloud.com/server/19/user_manual/pim/calendar.html

Subscriptions are refreshed every week by default. Your admin may have changed this setting.

Modifier le taux de rafraîchissement :

Se connecter avec un terminal en root à l'instance Nextcloud.

Se positionner à la racine du site Nextcloud.

cd /var/www/nextcloud.example.com/www/ # Par exemple

Obtenir le propriétaire du fichier config.php.

ls -l config/config.php
.rw-r----- nextcloud nextcloud 1.5 KB Wed May 25 10:17:35 2022 config/config.php

Modifier la valeur de l'option calendarSubscriptionRefreshRate de l'application calendrier de Nextcloud à 5 minutes.
```
sudo -u nextcloud php8.0 occ config:app:set dav calendarSubscriptionRefreshRate --value "PT5M"
# Résultat :
# Config value calendarSubscriptionRefreshRate for app dav set to PT5M
```
- Utiliser l'utilisateur étant propriétaire du fichier config .php avec la commande sudo.
- Utiliser le binaire php correspondant à la version du Nextcloud.

Vérifier la prise en compte.

sudo -u nextcloud php8.0 occ config:list | grep -i calendar
# Résultat :
# "calendar": {
# "calendarSubscriptionRefreshRate": "PT5M",

Crontab

Editer la crontab de l'utilisateur étant propriétaire du fichier config.php vu précédemment.
```
sudo -u nextcloud crontab -e
```
Ajouter une tâche toutes les 5 minutes exécutant le script php situé à la racine du site Nextcloud.
```
*/5 * * * * php8.0 -f /var/www/nextcloud.example.com/www/cron.php
```
Utiliser le binaire php correspondant à la version du Nextcloud.
Se connecter en admin sur l'interface web de Nextcloud. Puis se rendre dans Paramètres.
Dans la section Administration en bas à gauche, se rendre dans Paramètres de base.
S'assurer que les Tâches de fond soient configurées avec Cron.

Agenda on slash-root.fr

Nextcloud : Importer ses données de Google

Contexte

Google integration

Google Cloud Platform

Projet

Consentement

Identifiants

API

Nextcloud

Nextcloud : Ajouter un calendrier Google privé (Sans credentials)

Contexte

Côté Google

Côté Nextcloud

Taux de rafraîchissement

Crontab

Sources