Installer Syncope avec un Tomcat externe

Dernière mise à jour : 15/10/2026

Déployez Apache Syncope sur Apache Tomcat pour gérer les utilisateur.trices et les groupes dans Talend ESB.

Pourquoi et quand exécuter cette tâche

Version	Version de Syncope	Version de Java	Version de Tomcat
Talend 8.0 R2026-05 et versions antérieures	Syncope 2	Java 8	Tomcat 9
Talend 8.0 R2026-06 et versions ultérieures	Syncope 4.1	Java 21	Tomcat 10

Installation de Syncope 4

Avant de commencer

Téléchargez et installez la version la plus récente de Tomcat, la version 10.x, à partir du site Web d'Apache Tomcat (uniquement en anglais) (en anglais).

Pourquoi et quand exécuter cette tâche

Suivez cette procédure lorsque vous utilisez Talend 8.0 R2026-06 ou des versions ultérieures.

Conseil : Une installation basée sur Docker Compose est également disponible pour les configurations hors production. Consultez la documentation sur Apache Syncope Docker (uniquement en anglais) (en anglais).

Procédure

Si Tomcat est en cours d'exécution, arrêtez-le.
Activez Java 21.
Dans apache-tomcat-xxx/bin, ouvrez ou créez un fichier appelé setenv.sh et ajoutez ou modifiez la valeur de JAVA_OPTS comme suit :
```
JAVA_OPTS="-DCATALINA_HOME=$CATALINA_HOME -DCATALINA_BASE=$CATALINA_BASE"
```
Téléchargez le pilote JDBC PostgreSQL (postgresql-xx.jar) auprès de PostgreSQL JDBC Driver (uniquement en anglais) et placez-le dans apache-tomcat-xxx/lib/.
Démarrez une instance de PostgreSQL (exemple avec Docker) :
```
docker run --name syncope-db 
  -e POSTGRES_PASSWORD=syncope 
  -e POSTGRES_USER=syncope 
  -e POSTGRES_DB=syncope 
  -p 5432:5432 -d postgres
```
Sinon, utilisez un serveur PostgreSQL existant et créez une base de données et un.e utilisateur.trice dédié.e.
Construisez les fichiers WAR Syncope 4.1 à partir de l'archétype Maven, comme décrit dans la documentation sur Apache Syncope (uniquement en anglais) (en anglais). Les fichiers WAR requis sont les suivants : syncope.war, syncope-console.war, syncope-enduser.war.
Décompressez syncope.war et ajoutez ce qui suit à WEB-INF/classes/core.properties :
```
keymaster.username=anonymous
keymaster.password=anonymousKey
keymaster.address=http://localhost:8080/syncope/rest/keymaster
```
La valeur keymaster.password doit correspondre au mot de passe que vous avez défini à l'étape 6.

Décompressez syncope-console.war et ajoutez ce qui suit à WEB-INF/classes/console.properties :

keymaster.username=anonymous
keymaster.password=anonymousKey
keymaster.address=http://localhost:8080/syncope/rest/keymaster

Copiez les répertoires syncope et syncope-console décompressés et syncope-enduser.war dans apache-tomcat-xxx/webapps/.
Facultatif : Pour modifier le port par défaut, mettez la valeur du port du connecteur à jour dans apache-tomcat-xxx/conf/server.xml.
Facultatif : Pour améliorer la sécurité, modifiez le mot de passe d'administrateur.rice par défaut en modifiant le paramètre adminPassword dans syncope/WEB-INF/classes/security.properties.
Démarrez Tomcat.

Résultats

Vous pouvez à présent accéder à la console Apache Syncope.

Installation de Syncope 2

Déprécié·e

La procédure suivante explique comment installer Syncope 2 avec une instance Tomcat externe. Syncope 2 n'est plus packagé avec Talend ESB et est déprécié. Utilisez cette procédure uniquement si vous maintenez une installation Syncope 2 existante.

Avant de commencer

Téléchargez et installez la version la plus récente de Tomcat, la version 9.0.x, à partir du site Web d'Apache Tomcat (uniquement en anglais) (en anglais).

Pourquoi et quand exécuter cette tâche

Remarque : Suivez cette procédure lorsque vous utilisez Talend 8.0 R2026-05 ou des versions antérieures.

Procédure

Si Tomcat est en cours d'exécution, arrêtez-le.
Dans apache-tomcat-xxx/bin, ouvrez ou créez un fichier appelé setenv.sh et ajoutez ou modifiez la valeur de JAVA_OPTS comme suit :
```
JAVA_OPTS="-DCATALINA_HOME=$CATALINA_HOME -DCATALINA_BASE=$CATALINA_BASE"
```
Note InformationsRemarque : Apache Syncope supporte Java 21.
La variable d'environnement JAVA_HOME ou JRE_HOME (selon la distribution de Java utilisée) n'est pas strictement nécessaire, mais il est recommandé de la configurer.
Allez dans Talend-ESB-V8.0.1.RXXXX-XX-RT/container/system/com/h2database/h2/2.2.220, copiez le fichier h2-2.2.220.jar et collez-le dans le dossier apache-tomcat-xxx/lib.
Copiez les fichiers add-ons/syncope/ figurant parmi les fichiers d'installation ESB et collez-les dans le dossier apache-tomcat-xxx/webapps de votre Tomcat.
Dézippez les fichiers suivants :
- syncope-console.war
- syncope-enduser.war
Vous n'avez pas besoin de dézipper syncope.war et sts.war.
Ouvrez les fichiers suivants et mettez à jour la valeur du port pour utiliser le port 9080 :
- syncope-enduser/WEB-INF/classes/enduser.properties
- syncope-console/WEB-INF/classes/console.properties
Alignez la valeur du port de Tomcat : dans le dossier apache-tomcat-xxx/conf, ouvrez le fichier server.xml et remplacez la valeur du port du connecteur par 9080.
Facultatif : Pour améliorer la sécurité, modifiez les identifiants par défaut du compte d'utilisateur.rice Apache Syncope par défaut, en modifiant le paramètre adminPassword dans le fichier syncope/WEB-INF/classes/security.properties.
Pour plus d'informations, consultez la documentation Apache Syncope (uniquement en anglais) (en anglais).
Démarrez Tomcat.

Résultats

Vous pouvez accéder à la console Apache Syncope à l'aide de l'URL suivante : http://localhost:9080/syncope-console/.

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – faites-le-nous savoir.

Laissez vos commentaires ici