# Enabling Syncope Login Module

Available in...

* Data Fabric
* Data Services Platform
* ESB
* Qlik Talend Cloud Enterprise Edition
* Qlik Talend Cloud Premium Edition
* Real-Time Big Data Platform

Configure the Syncope login module in Talend ESB by deploying a blueprint descriptor file.

## About this task

Information noteImportant:

From Talend 8.0 R2026-06, Syncope 2 is no longer packaged with Talend ESB installers.

If you currently run Syncope 2, see [Installing Syncope 4](https://help.qlik.com/talend/en-US/installation-guide-linux/8.0/installing-syncope-with-external-tomcat#syncope-greater-versions).

## Procedure

1. Create a Blueprint descriptor based on the template below and configure the parameters:
   ```
   <?xml version="1.0" encoding="UTF-8"?>
   <blueprint xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0"
              xmlns:jaas="http://karaf.apache.org/xmlns/jaas/v1.1.0"
              xmlns:ext="http://aries.apache.org/blueprint/xmlns/blueprint-ext/v1.0.0">

       <jaas:config name="karaf" rank="2">
           <jaas:module className="org.apache.karaf.jaas.modules.syncope.SyncopeLoginModule"
                        flags="required">
              address=https://syncope4.example.com:8443/syncope/rest
              admin.user=admin
              admin.password=secure_password
              version=4
           </jaas:module>
       </jaas:config>

       <service interface="org.apache.karaf.jaas.modules.BackingEngineFactory">
           <bean class="org.apache.karaf.jaas.modules.syncope.SyncopeBackingEngineFactory"/>
       </service>

   </blueprint>
   ```
   1. Set address to your Syncope 4 server address. For example: https://syncope4.example.com:8443/syncope/rest).
   2. Set admin.user and admin.password to your Syncope admin credentials.
   3. Set version=4 for Syncope 4 deployments.

   For Syncope 2 deployments, use the same blueprint structure but set version=2 and address=http://localhost:9080/syncope/rest.

   Information noteNote: Use this configuration if you are using 8.0 R2026-05 or earlier versions.
2. Verify that the Syncope Login Module is installed successfully:
   1. Get the list of available JAAS realms.
      ```
      karaf@trun> jaas:realm-list
      Index | Realm Name | Login Module Class Name
      ------+------------+---------------------------------------------------------
      1     | karaf      | org.apache.karaf.jaas.modules.syncope.SyncopeLoginModule
      ```
   2. Select JAAS Realm using JAAS realm index from previous step.
      ```
      karaf@trun> jaas:realm-manage --index 1
      ```
   3. Look up the Syncope users list.
      ```
      karaf@trun()> jaas:user-list
      ```