Foire Aux Questions de l'Adullact

Comment utiliser les APIs S²LOW en JAVA ?

De plus en plus de collectivités souhaitent automatiser les échanges dématérialisés, et cela passe naturellement par la mise en place de dialogue inter-application. Exemple de code pour se connecter à S²LOW en JAVA

Pré-requis pour une installation du parapheur électronique.

Vous trouverez ci-dessous la liste des Pré-requis pour une installation du parapheur électronique. Pour l'application serveur, les pré-requis matériels sont :

1 Go de RAM minimum (2 Go Recommandés) libres pour l'application (iParapheur + OOo + MySQL + Apache)
Un espace disque de 40Go + Espace disque en fonction du nombre de dossiers à archiver
Minimum: CPU 1Ghz mono-coeur <= 20 utilisateurs, pour une utilisation supérieure à 20 utilisateurs augmenter sensiblement la RAM et le CPU (processeur multi-coeurs).

ADULLACT recommande un serveur GNU/Linux.
L'installation a été validée sur la plateforme Ubuntu 8.04 Server LTS (plateforme supportée), Ubuntu 9.10 Server, Debian Etch et Lenny. Le parapheur électronique peut également être installé sous d'autres systèmes d'exploitation: Fedora/CentOS/RedHat ES, Mandriva Server, Gentoo, SUSE... sous réserve que les pré-requis logiciels ci-dessous soient respectés, et sous réserve de validation par les équipes techniques de l'Adullact.
Pendant l'installation, le serveur doit-être connecté à Internet afin de récupérer et installer les dernières mises-à-jour de composants logiciels disponibles.

Les principaux pré-requis logiciels sont:

MySQL 5
OpenOffice.org 2.4 ou supérieur, et ImageMagick
Sun JDK JAVA6
Apache2, agrémenté des modules complémentaires proxy_ajp (ou bien mod_jk, parfois difficile à obtenir), mod_ssl
et bien entendu un package bundle Alfresco (version 3.2 Community) fourni par Alfresco (format tar.gz pour Linux, .zip autrement)

L'installation sur serveur Microsoft Windows est aussi théoriquement possible, mais non supportée à ce jour par l'équipe technique Adullact: le paramétrage SSL avec authentification forte par certificat pose problème sur cette plateforme.

Pour les postes utilisateurs :

Le parapheur électronique nécessite l'utilisation exclusive d'un navigateur WEB, avec plug-in JAVA pour les signataires.
L'utilisateur peut utiliser n'importe quel navigateur.
L'ADULLACT préconise les navigateurs conformes W3C.
La JVM 1.6 doit être installée sur les postes clients des signataires afin de pouvoir signer numériquement les dossiers.

Pour l'environnement système :

Si un annuaire de type LDAP est déjà en place, l'organisation de l'annuaire doit être communiquée au préalable, afin de créer le lien avec le parapheur et faire en sorte que les utilisateurs inscrits dans le LDAP soient connus du parapheur électronique.
Les ports HTTP (TCP 80) et HTTPS (TCP 443) doivent être ouverts entre le serveur et les postes clients. L'usage de certains serveurs mandataires (proxy HTTP et HTTPS) peut gêner le bon fonctionnement des applets Java de signature électronique.

Démarrage sur la place des marchés publics

Pour démarrer au mieux sur la plate-forme des marchés publics de l'association, merci de suivre les instructions ci-dessous

Acheteur public: Plateforme "exercice"

Une plateforme "exercice" vous permettant d'experimenter l'utilisation de notre plateforme de marchés publics. je vous invite à vous y exercer au travers d'une pseudo-collectivité "adullact".
http://www.klekoon-recette.com

Dans la rubrique en haut vous entrez le login principal:
entrez votre login: contacter support@adullact.org
mot de passe: contacter support@adullact.org

Une fois connecté, vous choisissez votre login personnel et tappez le mot de passe qui vous aura été communiqué.

Une fois loggué avec votre nom, vous avez acces à la rubrique "dematerialisation" qui vous permet de publier vos DCE en 15 etapes. vous y trouverez egalement une doc utilisateur.
En cas de publication au JOUE ou BOAMP et pour eviter une double saisie, vous passerez par la rubrique "publication"

Acheteur public: Plateforme "opérationelle"

Comment démarrer sur la place des marchés publics ADULLACT ?

Une fois l'expérimentation (voir ci-dessus) concluante, vous pouvez demander un accès à la plateforme des marchés publics ADULLACT de production. Pour cela, il vous suffit d'envoyer un Email à support@adullact.org renseignant les champs suivants:

Nom & prénom & coordonnées (email, adresse, tel) de la personne responsable de cette plateforme et en lien avec ADULLACT
Coordonnées précises de la collectivité
Logo de la collectivité

La personne responsable nommée ici sera en mesure de créer elle-même de nouveaux utilisateurs pour le compte de sa collectivité. Elle sera en mesure d'attribuer les droits d'accès en rapport avec le rôle de ces personnes.
Vous serez ensuite averti par Email de l'ouverture de votre accès opérationnel.

Comment utiliser la place des marchés publics ADULLACT ?

Une fois que vous avez reçu la confirmation de votre inscription (voir ci-dessus), il vous suffit de vous rendre sur la place des marchés publics ADULLACT, et entrer le login principal de votre collectivité, et son mot de passe pour accéder à votre environnement.
Une fois connecté dans votre environnement, selectionnez votre login, tappez votret mot de passe (option): vous êtes en mesure de travailler avec la plateforme.

Cas particulier des collectivités mutualisantes (CDG, ADM, ...)

Les collectivités mutualisantes sont invitées à contacter ADULLACT afin d'être en mesure d'inscrire elles-même leurs collectivités. Ce gain d'indépendance permet de gagner en réactivité et en simplicité de gestion.
Ces collectivités mutualisantes auront à fournir leur logo à ADULLACT : ce logo apparaitra dans la partie droite de l'écran pour toutes leurs collectivités dépendantes.

Entreprise

Les entreprises souhaitant consulter les offres publiées sur notre plateforme sont invitées à s'y connecter et à s'y créer un compte. D'autres services à valeurs ajoutées sont disponibles aux entreprises.

Comment utiliser les APIs S²LOW en PHP ?

Vous trouverez ci-dessous un exemple d'utilisation des APIs S²LOW en PHP... Les pré-requis techniques pour l'envoi de document à s2low sont les suivants :

PHP > 5.2.x
le module php_curl

La documentation des API disponibles pour S²LOW est accessible à l'adresse : http://adullact.net/docman/view.php/222/865/Tedetis-1.0.5-API_HTTP-1.1.pdf

<?php 

   
    // Url vers la plateforme s2low que vous voulez atteindre
    $host  = 'https://demo-s2low.extranet.adullact.org'; 
    // l'api que vous voulez utiliser
    $api = $url."/modules/actes/actes_transac_submit.php"
    // Enveloppe à envoyer à s2low 
    $file = "/var/www/s2low/adl-TACT--123456725--20080624-1.tar.gz"; 
 

    // la partie x509 du certificat :  openssl pkcs12 -in certificat.p12 -out client.pem -clcerts -nokeys 
    define('PEM',      './key/client.pem');
    //  la clé privée du certificat :   openssl pkcs12 -in certificat.p12 -out key.pem -nocerts
    define('SSLKEY',   './key/key.pem'); 

    //le certificat du CA :           openssl pkcs12 -in certificat.p12 -out ca.pem -cacerts -nokeys
    define('CA_PATH',  './key/'); 
    define('PASSWORD', 'passwd'); 

    // En fonction de l'api que l'on appelle, on doit renseigner le tableau suivant : 
    $data = array('api'           => '1', 
                    'enveloppe' => "@$file" );

    $ch = curl_init(); 

    // Paramétrage des options curl 
    curl_setopt($ch, CURLOPT_URL, $url);
    // En cas d'utilisation d'un proxy, on renseigne ici son adresse 
    // curl_setopt($ch, CURLOPT_PROXY, 'x.x.x.x:8080'); 
    curl_setopt($ch, CURLOPT_POST, TRUE);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $data );
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE); 
    curl_setopt($ch, CURLOPT_CAPATH, CA_PATH);
    curl_setopt($ch, CURLOPT_SSLCERT, PEM);
    curl_setopt($ch, CURLOPT_SSLCERTPASSWD, PASSWORD); 
    curl_setopt($ch, CURLOPT_SSLKEY,  SSLKEY); 
    curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE); 
    curl_setopt($ch, CURLOPT_VERBOSE, true); 
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE); 

    $curl_return = curl_exec($ch); 

    if ($curl_return === false) {
        echo 'KO\nErreur dans le module curl.' . '<br /gt;';
        echo 'curl_errno() = ' . curl_errno($ch) . '<br /gt;';
        echo 'curl_error() = ' . curl_error($ch) . '<br /gt;';
    } else {
       echo 'Document envoyé<br >'; 
    }

    curl_close($ch); 


?>

Comment ouvrir un fichier ODT directement dans mon application Web ?

L'objectif principal de ce billet est d'utiliser le protocole WebDAV pour rendre possible la lecture et l'écriture de fichiers de type bureautique ou autre, à travers le web, sans avoir à télécharger le fichier sur son disque dur.
Exemple: cela permet en cliquant simplement sur un fichier OpenOffice.org (ex: monfichier.odt) dans ma page web, de directement lancer OOo, de modifier le fichier à la volée, puis de sauvegarder ce fichier en cliquant simplement sur le bouton "enregistrer" de OOo. Vous trouverez ci-dessous les manipulations à effectuer afin d'ouvrir en mode lecture-ecriture un fichier ODT sur un serveur distant.

Préparation du serveur :

Configuration Apache

En supposant que le module APACHE2 est installé sur un serveur linux/debian, les pages web sont stockées dans le répertoire /var/www/monappli/ et accessibles sur ce serveur via une url du type http://monserveur/monappli/

1) Activer le module Webdav

en utilisant les commandes issues du package apache2 :

 
    # a2enmod dav    

    # a2enmod dav_fs

2) Enrichir la Balise Directory de l'application:

Dans la configuration apapche dédiée à l'application web:


<Directory /var/www/monappli/*>

    DAV On

    Options FollowSymlinks Indexes

    order allow,deny

    allow from all

</Directory>

3) Déposer le fichier ODT dans le répertoire de mon site web:

Écrire un fichier monfichier.odt dans le répertoire /var/www/monappli/

Adresse du fichier odt :

Dans notre démonstration, le protocole utilisé est le suivant : vnd.sun.star.webdav://(*)

exemple d'adresse web :
vnd.sun.star.webdav://monserveur.local/monappli/monfichier.odt

Préparation du client :

Sur Microsoft Windows :

Pour ouvrir directement le fichier odt avec OpenOffice, il faudra inscrire le fichier OOo_vnd.sun.star.webdav.reg ("Clid Droit" > "Enregistrer le lien sous..." ) suivant dans votre système d'exploitation :

    Windows Registry Editor Version 5.00

    [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\vnd.sun.star.webdav]
    @="URL:OpenOffice WebDAV Protocol"
    "URL Protocol"=""

    [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\vnd.sun.star.webdav\shell]

    [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\vnd.sun.star.webdav\shell\open]

    [HKEY_LOCAL_MACHINE\SOFTWARE\Classes\vnd.sun.star.webdav\shell\open\command]
    @="\"C:\\Program Files\\OpenOffice.org 3\\program\\soffice.exe\" \"%l\""

Attention de bien saisir le chemin vers votre OpenOffice (installé sur le poste client).

Sur linux :

Avec firefox; il vous suffira d'associer une action au protocole vnd.sun.star.webdav.

Pour les versions de Firefox 3.5 :

* Taper about:config dans la barre d'adresse de votre navigateur,
* Faites un clic droit -> Nouvelle -> Booléenne -> Saisissez le nom : network.protocol-handler.expose.vnd.sun.star.webdav -> Value -> false
* La prochaine fois que vous cliquerez sur un lien qui appelle ce protocole, firefox vous demandera avec quelle application l'associer.

Pour les versions de Firefox 3.0 :

Taper about:config dans la barre d'adresse de votre navigateur,
Faites un clic droit -> Nouvelle -> Booléenne -> Saisissez le nom : network.protocol-handler.external.vnd.sun.star.webdav -> Value -> true
Faites un clic droit -> Nouvelle -> Booléenne -> Saisissez le nom : network.protocol-handler.external.vnd.sun.star.webdav -> /usr/bin/soffice
Assurrez vous que la valeur network.protocol-handler.expose-all soit réglée à true.

Pour Opera v10.0

Vous pouvez ajouter une action pour le protocole vnd.sun.star.webdav allant dans les préférences du navigateur.
Cliquez sur Avancé > Programmes
Ajouter le protocole : vnd.sun.star.webdav et associez lui l'action d'ouvrir OpenOffice (/usr/bin/soffice)

Vérification

Une fois votre navigateur correctement configuré, vous pouvez tester à l'aide de l'exemple fourni : monfichier.odt. Vous modifiez le fichier, le sauvegardez, sortez de OpenOffice.org, recliquez sur le fichier pour l'ouvrir à nouveau et vérifier que vos modifications ont bien été enregistrées.
Note: comme pour toutes les démonstrations ADULLACT, le contenu de ce fichier est réinitialisé chaque nuit!
---
(*) le protocole utilisé dans notre démonstration (vnd.sun.star.webdav) est inspiré du protocole utilisé dans alfresco pour réaliser cela. Il est possible de remplacer ce texte par n'importe quel texte dédié à votre application web. Exemple: pour WebDelib, nous utilisons le protocole webdelib.webdav en lieu et place du vnd.sun.star.webdav décrit ici. Pour cela, il suffit de remplacer la chaîne de caractère vnd.sun.star.webdav par webdelib.webdav, partout dans cet article!

Comment utiliser mon application Maarch LetterBox depuis le passage à l'année 2010 ?

Depuis le passage à l'année 2010, l'application Maarch Lettetbox rencontre des anomalies... Le correctif suivant est valable pour les versions de Maarch LetterBox <= 2.6

Pour corriger le problème, il vous suffit de :

vous connecter à un interpréteur MySQL (la plupart des clients tourne avec PhpMyAdmin)
vous connecter à la base adéquate avec l'utilisateur désiré
Executer la commande suivante :
INSERT INTO `parameters` (`KEY1`, `KEY2`, `KEY3`, `VALUE`, `LIB_PARAM`, `id`, `param_value_char`, `param_value_int`) VALUES('CHRONO', '', '2010', '1', '', NULL, NULL, NULL);

Pré-requis pour une installation de Web-RSA

Vous trouverez ci-dessous la liste des Pré-requis pour une installation de Web-RSA Pour le serveur :

4Go de ram Recommandé
Un espace disque de 50Go évolutif (coté Serveur applicatif)
Un espace disque de 50Go évolutif pour la base de donnée Postgres
CPU dual core ou un quad core (2Ghz et +)

Les pré-requis logiciels sont :

Apache2.2.8, agrémenté des modules complémentaires mod_rewrite, dav, dav_fs, actions
PHP >= 5.2.4 avec les modules libcurl php-soap et php-curl
PostgresSQL 8.3
Sun JDK JAVA 6
Alfresco 3
Mysql 5.0.5
GEDOOo 0.3.4
OpenOffice.org 2.4
imagemagick 6.3.7

Lors de l'installation plusieurs points sont à vérifier. La ré-écriture (rewrite) d'url pour le framework CakePhp, les droits utilisateurs sur la base de données.

Pour plus d'information consultez la documentation :
https://adullact.net/docman/index.php?group_id=613&selected_doc_group_id=1126&language_id=1

Voici le lien pour les pré-requis d'une installation Gedooo :
http://faq.adullact.org/index.php?2009/10/23/53-pre-requis-pour-une-installation-de-gedooo

Pour les postes utilisateurs :

web-RSA nécessite l'utilisation exclusive d'un navigateur WEB.
L'utilisateur peut utiliser n'importe quel navigateur. L'ADULLACT préconise les navigateurs conformes W3C.

Pour plus d'information visiter la forge http://adullact.net/projects/webrsa/

Pré-requis pour une installation de GEDOOo

Vous trouverez ci-dessous la liste des Pré-requis pour une installation d'un serveur GEDOOo. Pour le serveur, les pré-requis matériels sont :

2Go de Ram Recommandé
CPU 1Ghz mono coeur

ADULLACT recommande un serveur GNU/Linux.

L'installation a été validée sur la plateforme Ubuntu 8.04 server LTS, GEDOOo peut également être installé sous d'autres systèmes d'exploitation: Debian Etch, Fedora/CentOS/RedHat ES, Mandriva Server,... sous réserve que les pré-requis logiciels ci-dessous soient respectés, et sous réserve de validation par les équipes techniques de l'ADULLACT.
Pour l'installation, le serveur doit-être connecté à Internet afin de récupérer et installer les derniers paquets disponibles.

Les pré-requis logiciels sont :

MySQL 5
OpenOffice.org 2.3
Sun JDK JAVA6
Apache2, agrémenté des modules complémentaires dav, dav_fs, actions
PHP >= 5.2.3 avec les modules libcurl php-soap

Pour plus d'information visiter la forge http://adullact.net/projects/gedooo/

Pré-requis pour une installation de WebDelib

Vous trouverez ci-dessous la liste des Pré-requis pour une installation de WebDelib. Pour le serveur, les pré-requis matériels sont :

1 Go de Ram
Un espace disque de 40Go (A raison de 150 Mo pour environ 500 délibérations)
CPU 1Ghz mono coeur

Les pré-requis logiciels sont :

MySQL 5
Apache2, agrémenté des modules complémentaires mod_rewrite, dav, dav_fs, actions
PHP 5.2.3 ou supérieur, avec les modules libcurl php-soap
Une connexion à un serveur GEDOOo (en cas d'installation, vous trouverez ici les pré-requis d'installation)

Lors de l'installation plusieurs points sont à vérifier. La ré-écriture (rewrite) d'url pour le framework CakePhp, les droits utilisateurs sur la base de données.
Pour plus d'information consultez la documentation :

Pour les postes utilisateurs :

Webdelib nécessite l'utilisation exclusive d'un navigateur WEB.
L'utilisateur peut utiliser n'importe quel navigateur. L'ADULLACT préconise les navigateurs conformes W3C.
Selon votre navigateur l'affichage peut différer, ce problème est du au feuille de style css.

Pour plus d'information visiter la forge http://adullact.net/projects/webdelib/

Comment créer votre propre certificat selon le produit utilisé ou votre rôle?

WebOssl est une interface Web de création et d'administration de Certificats de type Openssl. WebOssl est une interface Web de création et d'administration de Certificats sur la PKI interne ADULLACT.

Cet outil vous permet de créer vos propres certificats utilisables sur certaines applications ADULLACT (s2low, iParapheur...) et en stage de formation.
Il est accessible à l'adresse suivante : http://pki.adullact.org
(merci de nous contacter pour obtenir un mot de passe: 04-67-65-05-88)

Une fois connecté, il suffit de remplir le formulaire, cliquer sur "générer le certificat" puis d'enregistrer ce certificat dans un lieu sûr ainsi que le mot de passe qui l'accompagne (nous ne sommes pas en mesure de vous communiquer ce mot de passe. Il n'est pas enregistré : ne le perdez pas!).

Ce certificat devra ensuite être enregistré dans votre navigateur pour être utilisable sur les applications concernées.

Pour en savoir plus, consultez http://webossl.adullact.net/