Add admin users to Connections security roles – the easy way

It happened again some weeks ago when I installed the Connections 3.0.1.1 fixpack, all the users I added to the security roles of the different apps were gone after the update

But instead of adding them again manually through the Admin console I searched for a better solution and found an old blog entry from Marco Ensing:

http://www.ibmconnections.org/wordpress/index.php/2010/04/mapping-groups-to-a-role-in-lotus-connections/

This was the basis for this little jython script, which you can use to recreate your settings:

 ConfigureConnectionsRoles.py

Just download it & open it with a text editor. It’s rather self-explaining, add your users and change roles where needed.

Finally run the script via wsadmin tool:

wsadmin.bat -lang jython -port 8879 -username wasadmin -pw YOURPW -f ConfigureConnectionsRoles.py

Have fun!

Using SSL in Sametime 8.5.x for LDAP connections Part 2

Took me a little bit longer as expected but here is now part 2, how to enable SSL for LDAP connections on the community server.

In part 1 described how you can enable SSL for LDAP connections on the WAS servers.

You can find some information on this topic in the Sametime Wiki but I found it rather confusing and misleading.

First of all I had to set up iKeyman and the GSKit on the community server to support Cryptographic Message Syntax (CMS) and create the Keystore DBs. We need 3 different Keystore databases:

- CMS Keystore key.kdb -> used by different Sametime server components to connect securely to LDAP server

- Java Keystore stkeys.jks -> used by the userinfo servlet (Business Card) to connect securely to LDAP server

- Keyring File sametime85.kyr -> used by the Domino server (directory assistance) to connect securely to LDAP server

Install GSKit

- Go to the folder where you extracted the Sametime Standard Server Installation files. In there you find a folder “GSKit” – “Win32″. Run gsk8crypt32.exe as Admin

- Use standard values for installation wizard

- Run gsk8ssl32.exe as Admin and use standard values for installation wizard

- Add you Domino java folder as JAVA_HOME system variable

Update iKeyman to support CMS

- copy gskikm.jar and ibmcmsprovider.jar from you Sametime System Console (SSC) server to the community server and replace the older ones. You can find these files in the C:\WAS_INSTALL_DIR\WebSphere\UpdateInstaller\java\jre\lib\ext\ folder. Copy them to C:\DOMINO_INSTALL_DIR\ibm-jre\jre\lib\ext\ folder.

- Edit the file java.security in folder C:\DOMINO_INSTALL_DIR\ibm-jre\jre\lib\security\

- after security.provider.5=com.ibm.security.sasl.IBMSASL add following line:
security.provider.6=com.ibm.security.cmskeystore.CMSProvider 

Create CMS and Java Keystore files

- Start iKeyman (double click ikeyman.exe) which you can find in C:\DOMINO_INSTALL_DIR\ibm-jre\jre\bin\ folder

- Check the “Help” – “About iKeyman”, you should see

If you see an older Version# check if you copied  gskikm.jar and ibmcmsprovider.jar from you Sametime System Console (SSC)

- Now create a new CMS database by clicking on “Key Database file” – “New”. Choose CMS as type, name it key.kdb (has to be exactly this name!) and place it in C:\DOMINO_INSTALL_DIR\ (D:\IBM\Lotus\Domino in my example)

- Define a password and activate “Stash password to a file”

- Go to the “Signer Certificates” and click on “Add”

- Click “Browse” and open the Root.cer file (which you have create before on the SSC Server in Part 1)

- Enter a Label for the Certificate (i.e. GeoTrust Root Certificate)

- Do the same for the Intermediate Certificate

- You should now see 2 Signer Certificates in your keyDB

- Now create a new JKS database by clicking on “Key Database file” – “New”. Choose JKS as type, name it stkeys.jks and place it in C:\DOMINO_INSTALL_DIR\ (D:\IBM\Lotus\Domino in my example)

- Repeat all steps to import the root certificate and the intermediate certificate

Create the Domino Keyring file

- open the Server Certificate Admin DB (certsrv.nsf) on your Community Server with your Notes Client

- click on “1. Create Key Ring” to create a new keyring file

- fill in a name and a password and define your key size

- fill in your server name as Common Name, add your Organization/State/Country and click “Create Key Ring”

- you will see a confirmation window

- now import your Root Certificate, click on “3. Install Trusted Root Certificate…” and fill in a Label/Source/File Name and choose the appropriate file format

- click on “Merge Trsuted Root Certificate…” and fill in the password for the key ring file

- you will see a success window, click on “OK”

- import your intermediate certificate with same steps

- copy your keyring file and stash file to the data directory of your Community Server

- open the server document of your community server and go to “Ports” – “Internet Ports” and fill in your keyring file name

- save the document and close it

Encrypt the UserInfoServlet

- open UserInfoConfig.xml (in D:\IBM\Lotus\Domino)

- change SslEnabled to true and ensure SslPort is 636

- in the SslProperties tag add the path to your stkeys.jks file and insert your password for the keystore

Configuring Directory Assistance for SSL& Connect Sametime Community Server through SSL

- open the Directory Assistance DB (da.nsf) on your community server with your notes client and change the LDAP settings

- Click “Save and Close” and close the DB

- Now open the Sametime Community Server webpage and login as Sametime Admin and click on “Administer the Server”

- go to “LDAP Directory” > “Connectivity” and enable the use of SSL for LDAP and ensure that the used SSL port is 636

- Click on “Update”

(Optional) If you want to improve performance, you may choose to loosen security and encrypt only user credentials as follows:

- Open the sametime.ini file (in D:\IBM\Lotus\Domino)

- Locate the [Directory] section within the file and add the following setting:

ST_DB_LDAP_SSL_ONLY_FOR_PASSWORDS=1

- Save and close the file

- Restart your Community Server

That’s it, now you Security Officer is your friend again!

Change Sametime Client 8.5.x settings after deployment through managed-settings.xml

There are many possibilities to change you Sametime Clients settings before and after a client rollout i.e. by changing/adding some lines to plugin_customization.ini (direct or indirect through Notes policies).

Unfortunately changing plugin_customization.ini through Notes policies is not really bulletproofed an often doesn’t work at all. So I searched for some alternatives and found following in Sametime Infocenter:
Automatically updating client preferences with the managed-settings.xml file

The Infocenter does not go into too much details so I will give you an example how you can use it within your environment. In this example I will change two settings on the clients:

- Contact List Synchronization -> Force this setting, even if user has changed it and lock it
- Chat Window – Partner Status Updates View -> Change setting but do not lock it

First you have to point your Sametime Clients to an Update Site:

1. Open your Sametime System Console (SSC) and go to “Manage Policies”
2. Edit the “Instant Messaging” policy of the user group (or default policy)
3. Scroll down to “Sametime update site URL” and fill in your Sametime Communtiy Server URL and add “/update” as folder name

4. Click “OK” to save your changes
5. It can take up to an hour to refresh the settings on your Sametime Community Server and on your clients. To speed up things restart your Community Domino Server.

During your server restart you can create the needed managed-setings.xml file in your Domino http/update folder:
1. Access you Community Server and create a subfolder “update” inside your Domino http folder (data directory/domino/html)

2. Create a file called “managed-settings.xml”.

3. Open up the file with an editor and add following lines:

<ManagedSettings>
<settingGroup name=”com.ibm.collaboration.realtime.imhub”>
<setting name=”showBuddyListConflictDialog” value=”false” isLocked=”true”/>
<setting name=”buddyListConflictPref” value=”replaceLocal” overwriteUnlocked=”true” isLocked=”true”/>
</settingGroup>
<settingGroup name=”com.ibm.collaboration.realtime.chatwindow”>
<setting name=”showstatusupdates” value=”true” isLocked=”false”/>
</settingGroup>
</ManagedSettings>

4. Before you save the file check your actual settings in your Sametime Client

-> partner status updates are not displayed

-> Client will ask you what to do if contact list falls out of sync

5. Now save the managed-settings.xml file and try to access the file in your browser http://yourcommunityserver.ch/update/managed-settings.xml. You should see your added lines if you look at the HTML page source:

6. Restart your Sametime Client twice (first restart it picks up the updates site configuration via policy, the second time it will pick up the settings inside the managed-settings.xml file)
7. Open up your Sametime client settings:

-> Setting is changed to “Replace the local copy…” and locked

-> Display of partner status updates is enabled but NOT locked

Et voilà, you’re now able to change almost every Sametime client setting centrally.

You can find a complete list of Client settings (8.5.1) here or in the Sametime Wiki here.