Configuration des services de stockage

Qalyptus Server vous permet d'enregistrer les rapports générés dans des dossiers, sur des serveurs distants via FTP et SFTP, et dans des services de stockage cloud publics : SharePoint, OneDrive, Google Drive et Dropbox.

Cette section explique comment créer un service de stockage dans Qalyptus Server.

Fonctionnalité Enterprise

La prise en charge des services de stockage est disponible exclusivement dans l'édition Qalyptus Server Enterprise.

1- Créer un service FTP ou SFTP

Pour créer un service FTP ou SFTP, suivez les étapes ci-dessous :

1. Connectez-vous à Qalyptus Server.
2. Accédez à Administration > Système > Services de stockage
3. Cliquez sur Créer un service
4. Renseignez les champs suivants :

• Nom : Saisissez le nom du service.
• Description : Saisissez une description pour le service (facultatif).
• Par défaut : Cochez cette case pour définir ce service comme service par défaut.
• Type : Choisissez FTP ou SFTP.
• Nom d'hôte : Nom d'hôte de votre serveur FTP.
• Nom d'utilisateur : Nom d'utilisateur FTP.
• Mot de passe : Mot de passe de l'utilisateur FTP.
• Port (SFTP uniquement) : Saisissez le port SFTP. Le port par défaut est 22.
• Chemin du répertoire de test : Saisissez le répertoire dans lequel téléverser un fichier test pour vérifier la connexion. Utilisez '/' pour le chemin racine.
• Mode passif (FTP uniquement) : Cochez cette case pour utiliser le mode passif.

5. Cliquez sur Tester la connexion pour vérifier l'accès au service
6. Cliquez sur Enregistrer

2- Créer un service Google Drive

Qalyptus permet d'enregistrer les rapports dans des dossiers Google Drive et sur des Team Drives, qui ne peuvent être créés qu'avec un compte Google Workspace.

Avant de créer un service Google Drive, vous devez activer l'API Google Drive dans votre Console Google Cloud.

a- Activer l'API Google Drive

• Connectez-vous à la Console Google Cloud : https://console.cloud.google.com.
• Sélectionnez un projet existant ou créez-en un nouveau.
• Dans le menu de gauche, cliquez sur APIs et services.
• Cliquez sur + ACTIVER DES APIS ET DES SERVICES.
• Recherchez API Google Drive.
• Dans les résultats de recherche, sélectionnez API Google Drive.
• Cliquez sur Activer.

Après activation de l'API Google Drive, vous serez redirigé vers les détails de l'API. Votre écran ressemblera à ceci :

b- Configurer l'écran de consentement OAuth

• Dans le menu de gauche, cliquez sur Écran de consentement OAuth.
• Choisissez le type d'utilisateur Externe.
• Cliquez sur Créer.
• Donnez un Nom à l'application (Exemple : Qalyptus Server).
• Sélectionnez un E-mail de support utilisateur.
• Ajoutez l'adresse e-mail du contact développeur.
• Cliquez sur Enregistrer et continuer.
• Ajoutez le périmètre suivant : ./auth/drive.
• Cliquez sur Enregistrer et continuer.
• Ajoutez des utilisateurs de test. Avant la publication de l'application, seuls les utilisateurs ajoutés à cette liste peuvent se connecter.
• Cliquez sur Enregistrer et continuer.

c- Créer des identifiants

• Dans le menu de gauche, cliquez sur Identifiants.
• Cliquez sur + CRÉER DES IDENTIFIANTS.
• Choisissez ID client OAuth.
• Dans le type d'application, sélectionnez Application Web.
• Saisissez un nom pour l'identifiant.
• Dans URI de redirection autorisés, saisissez l'URI de redirection OAuth 2 affiché lors de la création du service dans Qalyptus ({nom-hôte-public}/oauth2callback). Conseil : L'URI de redirection est visible sur la page Créer un service dans Qalyptus Server.
• Cliquez sur Créer.
• Un ID client et des clés secrètes sont générés.
• Copiez les deux clés pour les utiliser lors de la création du service Google Drive dans Qalyptus Server.

important

L'URI de redirection autorisé doit être identique dans l'API Google Drive et le service Qalyptus Server. Google Drive n'accepte pas certains formats d'URI, comme un URI avec une extension non publique (https://mon-serveur.local:3994).

d- Créer un service Google Drive dans Qalyptus Server

• Dans Qalyptus Server, accédez à Administration > Système > Services de stockage.
• Cliquez sur Créer un service.
• Saisissez un nom pour le service.
• Ajoutez une description si vous le souhaitez.
• Sélectionnez le type Google Drive.
• Saisissez l'ID client et le Secret client générés précédemment dans la Console Google Cloud.
• Vérifiez que l'URI correspond à celui saisi dans la Console Google Cloud.
• Cliquez sur Enregistrer.

Vous serez redirigé vers l'écran d'autorisation Google. Vous devez vous authentifier et accepter les permissions pour téléverser des fichiers vers votre compte Google Drive.

remarque

L'API Google Drive impose des limites pour le téléversement de fichiers. Consultez la documentation Google ou contactez le support Google pour en savoir plus sur les limites et les éventuels tarifs supplémentaires pour téléverser de nombreux fichiers.

remarque

L'API Google Drive est en mode développement. Vous pouvez continuer à l'utiliser dans ce mode avec les utilisateurs autorisés ou publier l'API en production. La deuxième option nécessite une validation par Google et permet à tous vos utilisateurs de créer une connexion.

remarque

Qalyptus Server maintiendra sa connexion à Google Drive jusqu'à ce que vous la révoquiez depuis Qalyptus Server ou depuis votre compte Google.

3- Créer un service SharePoint/OneDrive

Pour configurer la connexion à OneDrive et SharePoint, vous devez enregistrer une application dans Azure. Vous pouvez créer une seule application pour OneDrive et SharePoint, ou créer une application pour chacun. La seule différence réside dans les permissions. Si vous créez une application unique, vous devez ajouter les permissions nécessaires pour OneDrive et SharePoint.

a- Enregistrer une application dans Azure

• Connectez-vous à votre portail Azure (portal.azure.com).
• Accédez à Azure Active Directory.
• Sélectionnez Enregistrements d'applications.
• Cliquez sur Nouvel enregistrement.
• Saisissez un nom pour l'application (Exemple : Qalyptus Server).
• Dans Comptes pris en charge, choisissez Comptes dans cet annuaire organisationnel uniquement.
• Dans URI de redirection, sélectionnez la plateforme Web, puis saisissez un URI au format suivant : {nom-hôte-public}/oauth2callback. Conseil : L'URI de redirection est visible sur la page Créer un service dans Qalyptus Server.
• Cliquez sur Enregistrer.
• Dans le menu de gauche, cliquez sur Autorisations d'API.
• Cliquez sur Ajouter une autorisation.
• Dans la liste des API, sélectionnez Microsoft Graph.
• Puis sélectionnez Autorisations déléguées.
• Ajoutez les autorisations suivantes pour OneDrive : Files.Read.All, Files.ReadWrite.All et ces autorisations pour SharePoint : Sites.Read.All, Sites.ReadWrite.All.
• Dans le menu de gauche, cliquez sur Certificats et secrets.
• Cliquez sur Nouveau secret client.
• Choisissez la date d'expiration et ajoutez une description si vous le souhaitez.
• Une clé secrète sera générée.
• Copiez la valeur et conservez-la dans un endroit sécurisé. La clé ne sera plus visible après actualisation de la page.
• Vous aurez besoin de la clé secrète pour créer le service dans Qalyptus Server.

d- Créer un service SharePoint ou OneDrive dans Qalyptus Server

• Dans Qalyptus Server, accédez à Administration > Système > Services de stockage.
• Cliquez sur Ajouter un service.
• Saisissez un nom pour le service (Exemple : Qalyptus Server).
• Ajoutez une description si vous le souhaitez.
• Sélectionnez le type SharePoint ou OneDrive.
• Saisissez l'ID client et l'ID de locataire. Vous trouverez ces informations sur la page Vue d'ensemble de l'application.
• Saisissez le Secret client généré précédemment.
• Vérifiez que l'URI correspond à celui saisi dans l'application Azure.
• Cliquez sur Enregistrer.

Vous serez redirigé vers l'écran d'autorisation Microsoft. Vous devez vous authentifier et accepter les permissions pour téléverser des fichiers vers votre compte OneDrive/SharePoint.

important

L'URI de redirection doit être identique dans l'application Azure et le service Qalyptus Server.

remarque

L'application SharePoint/OneDrive est en mode développement. Vous pouvez continuer à l'utiliser dans ce mode ou la publier en production. La deuxième option nécessite une validation Microsoft.

remarque

Qalyptus Server maintiendra sa connexion à SharePoint/OneDrive jusqu'à ce que vous la révoquiez depuis Qalyptus Server ou depuis votre compte Microsoft.

4- Créer un service Dropbox

Avant de créer un service Dropbox, vous devez créer une application dans le portail développeur Dropbox.

a- Créer une application Dropbox

• Connectez-vous au portail développeur Dropbox à cette adresse : https://www.dropbox.com/developers/apps.
• Cliquez sur Créer une application.
• Choisissez Accès à portée limitée.
• Choisissez le type d'accès Dropbox complet.
• Saisissez un nom pour l'application.
• Cliquez sur Créer une application.
• Autorisez des utilisateurs supplémentaires dans Utilisateurs de développement si vous le souhaitez.
• Dans l'onglet Permissions, sélectionnez les autorisations : files.content.read et files.content.write et confirmez.
• Dans URI de redirection OAuth2, saisissez un URI au format suivant : {nom-hôte-public}/oauth2callback. Conseil : L'URI de redirection est visible sur la page Créer un service dans Qalyptus Server.

Une clé d'application et une clé secrète d'application sont créées. Vous aurez besoin de ces deux clés pour créer le service Dropbox dans Qalyptus Server.

important

L'URI de redirection OAuth2 doit être identique dans l'application Dropbox et le service Qalyptus Server.

d- Créer un service Dropbox dans Qalyptus Server

• Dans Qalyptus Server, accédez à Administration > Système > Services de stockage.
• Cliquez sur Ajouter un service.
• Saisissez un nom pour le service (Exemple : Qalyptus Server).
• Ajoutez une description si vous le souhaitez.
• Sélectionnez le type Dropbox.
• Saisissez la Clé de l'application et le Secret de l'application générés précédemment dans le portail développeur Dropbox.
• Vérifiez que l'URI correspond à celui saisi dans la Console Dropbox.
• Cliquez sur Enregistrer.

Vous serez redirigé vers l'écran d'autorisation Dropbox. Vous devez vous authentifier et accepter les permissions pour téléverser des fichiers vers votre compte Dropbox.

remarque

L'API Dropbox impose des limites pour le téléversement de fichiers. Consultez la documentation Dropbox ou contactez le support Dropbox pour en savoir plus sur les limites et les éventuels tarifs supplémentaires pour téléverser de nombreux fichiers.

remarque

L'application Dropbox est en mode développement. Vous pouvez continuer à l'utiliser dans ce mode avec les utilisateurs autorisés ou publier l'application en production. La deuxième option nécessite une validation Dropbox et permet à tous vos utilisateurs de créer une connexion.

remarque

Qalyptus Server maintiendra sa connexion à Dropbox jusqu'à ce que vous la révoquiez depuis Qalyptus Server ou depuis votre compte Dropbox.