IBM Support

Table of Client types that are connecting to a Sametime server

Question & Answer


Question

There are a variety of ways to connect to an IBM Sametime server. Is there a way to configure allowed client types? Can certain client types be blocked?

Also, can you see which users are connecting to a Sametime server using a custom-built client, a Sametime client, or a Notes client?

Answer

Clients who log in to a Sametime server declare their client type upon log in as follows:

Client type

ClientClient IDAnonymous
Client ID
Sametime Connect clients (stand-alone)Sametime Connect 9.0.10x130F
Sametime Connect 9.00x130E
Sametime Connect 8.5.20x130D
Sametime Connect 8.5.1 0x130C
Sametime Connect 8.5.0 0x130B
Sametime Connect 8.0.2 0x130A
Sametime Connect 8.0.10x1308
Sametime Connect 8.00x1306
Sametime Connect 7.5, 7.5 CF1, 7.5.10x1304
Sametime Connect for desktop (C++ client) 3.1, 6.5.1, 7.00x1002
Sametime Connect for browsers (Java client) 3.1, 6.5.1, 7.00x1003
Sametime Proxy clientsSametime 9 Proxy Server (Browser client)0x14AF
Sametime 9 Proxy Server (Meeting client, redirected from login page)0x14B10x1CB1
Sametime 9 Proxy Server (Meeting client)0x14B20x1CB2
Sametime 9 Proxy Server (iNotes client)0x14B4
Sametime 9 Proxy Server (SDK App)0x14B60x1CB6
Sametime 9 Proxy Server (SDK App) with concurrent login support0x14B8
Sametime browser (Web proxy) client 8.5.20x14AD
Sametime browser (Web proxy) client 8.5.10x14A2
Sametime browser (Web proxy) client 8.5.00x14A0
Verse 0x14B9
Sametime Directory appletSametime Directory applet 7.5.1 IMLU and later0x1010
Sametime MeetingsSametime Meeting Room client (browser)0x10990x1899
Sametime Mobile and STLinksSametime 9 Mobile for Browser0x1443
Sametime 9 Mobile for iOS0x143A
Sametime 9 Mobile for Android0x143B
Sametime 9 Mobile Embedded for iOS0x143E0x1C3E
Sametime 9 Mobile Embedded for Android0x143F0x1C3F
Sametime Mobile 8.5.2 IFR1 for iOS 0x143A
Sametime Mobile 8.5.2 for iOS0x143A
Sametime Mobile MIDP client 8.5.20x1437
Sametime Mobile 8.5.2 for Windows Mobile Expeditor0x1438
Sametime Mobile 8.5.2 for Android0x143B
Sametime Mobile iOS client 8.5.10x143A
Sametime Mobile UCC client 8.5.10x1435
Sametime Mobile MIDP client 8.5.10x1434
Sametime Mobile UCC client 8.5.00x100A
Sametime Mobile MIDP client 8.5.00x1431
Sametime Mobile 8.0.1 client, Sametime Links (stlinks) applications, such as Domino Web Access0x100A0x180A
Sametime Mobile 8.0 client0x101A
Sametime Mobile 7.5.1 client0x101A
Notes clientsNotes 9.0.1 (using the embedded Sametime 9.0.1 client)0x129C
Notes 9.0.1 (using the embedded Sametime 9.0 client)0x1299
0x129A

Notes 9.0.1 (using the embedded Sametime 8.5.2 client)0x1298
Notes 9.0 (using the embedded Sametime 9.0.1 client)0x129B
Notes 9.0 (using the Sametime 9.0 client)0x1247
Notes 9.0 (using the Sametime 8.5.2 client)0x1246
Notes 9.0 Beta0x1246
Notes 8.5.3 (using the embedded Sametime 8.5.2 client)0x1244
Notes 8.5.3 (using the embedded Sametime 8.5.1 client)0x1243
Notes 8.5.3 Basic/Admin client0x1216
Notes 8.5.2 (using the embedded Sametime 8.5.2 client)0x1240
Notes 8.5.2 (using the embedded Sametime 8.5.1 client)0x123D
Notes 8.5.2 (using the embedded Sametime 8.0.2 client)0x123C
Notes 8.5.2 Basic/Admin client0x1216
Notes 8.5.1 (using the embedded Sametime 8.5.2 client)0x1248
Notes 8.5.1 (using the embedded Sametime 8.5.1 client)0x123B
Notes 8.5.1 (using the embedded Sametime 8.5.0 client)0x123A
Notes 8.5.1 (using the embedded Sametime 8.0.2 client)0x1235
Notes 8.5.1 Basic/Admin client0x1216
Notes Beta 8.5.10x1235
Notes 8.50x1234
Notes Beta 8.50x1333
Notes 8.0.2 Basic/Admin client0x1216
Notes 8.0.2 Standard0x1233
Notes 8.0.2 Mobile client0x1200
Notes 8.0.10x1233
Notes 8.0 with hotfix 179 (hf179)0x1150
Notes 8.0 Standard (Eclipse)0x1231
Notes 8.0 Basic (non-Eclipse)0x1215
Notes client 7.0.4 (includes FP1, FP2)0x1216
Notes client 7.0.30x1216
Notes client 7.0.2 on Macintosh0x1220
Notes client 7.0.2 (does not include Mac client)0x1215
Notes 7.0.2 Admin client0x1214 and 0x1215
Notes client 7.0.10x1215
Notes client 7.0 HF2770x1216
Notes client 7.00x1214
Notes client 6.5.5 CCH10x1204
Notes client 6.5.50x1203
Notes client 6.5.4 CCH2 0x1201
Notes client 6.5.4 CCH60x1204
Notes client 6.5.4 CCH4/CCH50x1203
Notes client 6.5.40x1200
Notes client 6.5.3 CCH50x1203
Notes client 6.5.20x1200
Notes client 6.5.10x1002
TelephonyTelephony Presence Adapter 8.5.10x17AA
Third partyTrillian Pro with IBM Sametime Plug-in 1.2.1 (alphaworks)0x16BB0x1EBB
Trillian Sametime Plug-in 0.9.2.0 (SourceForge)0x16AA0x1EAA
GAIM Meanwhile 1.2.80x17000x1F00
Pidgin Instant Messaging 2.5.10x17000x1F00
ToolkitsDefault value for clients on top of the C++ toolkit, (such as GXS Monitor)0x10000x1800
Default value for clients on top of the Java toolkit (such as BlackBerry client)0x10010x1801
Proxy 8.5.2 SDK clients0x14AB0x1CAB
Proxy 8.5.2 SDK in iNotes0x14A40x1CA4
Proxy 8.5.1 SDK clients0x14A30x1CA3
Proxy 8.5.0 SDK clients0x14A10x1CA1
Proxy 8.5 SDK in iNotes0x14A40x1CA4



Determining the client type

You can enable the following debug setting in the sametime.ini file to determine the client type for any client:

[Debug]
VPS_DEBUG_LOGIN_MSG=1

Then check the stcommunity_*txt trace file for eType= or for the user name of the user that you are testing with.


Configuring allowed client types

A Sametime server can be configured to allow only certain clients to log in based upon their unique Client ID (that is, blocking any other clients). The following flag can be added to the [Config] section of the sametime.ini file:
    VPS_ALLOWED_LOGIN_TYPES

to specify the allowed login types. This list of allowed login types should be comma-separated, and should contain the client types in hexadecimal format, but without the leading "0x". For steps, refer to "Configuring allowed client types" in the Sametime product documentation.

To specify an anonymous client, add 0x0800 to the client ID value; for example:

Sametime Connect 8.5.2 client ID = 0x130D
Anonymous Sametime Connect 8.5.2 client ID = 0x1B0D

Both the authenticated and the anonymous version of each client ID is included in the table above.

This flag affects all log-ins where this Sametime server is the home server. By default (if this flag is not specified), all login types are allowed.

Example: The following client IDs limit log-ins to the Sametime Connect client (authenticated users and anonymous users) and the Notes 9 embedded client (authenticated users and anonymous users)
    Example sametime.ini file:
    [Config]
    VPS_ALLOWED_LOGIN_TYPES=130D,1B0D,1246,1A46

Note: after updating the sametime.ini file, you must restart the Sametime server for the changes to take effect.

Example entry from stlog.nsfwhen client connects, with annotations:

Severity: Very Low
Community Server Event Type: Login
Date and Time: 01/29/YYYY 10:01 AM
IP Address:
Application Name: unknown type(0x1201) This indicates the Notes client release (Notes client 6.5.4 CCH2 ). This parameter also differentiates between different Notes clients.

Reason:
User ID: CN=User Name/OU=IS/OU=US/O=IBM
IBM Lotus Sametime Connectivity: Direct
Client Version: V6.5.1 This is the version used by the Sametime components in the relevant client. For example, the release of toolkit used to develop the IM feature in the Notes client.



Configuring the preferred login list

You can also use the values in this table to configure the preferred login list -- the login order that Sametime should use to determine which client type, for users connected through several different. clients, should receive the instant messaging session. For steps, refer to "Configuring the preferred login list."

Default Sametime 8.5.1 list:
VPS_PREFERRED_LOGIN_TYPES=130C,130B,130A,1308,1306,1304,1436,1435,1434,1433,1432,1431,1430,14A3,14A2,14A1,14A0

Internal Use Only

ST90/901 embedded:

Sametime 9.0.1 embedded in Notes 9.0 (add-on)H: 129B added
D: 4763
Sametime 9.0.1 embedded in Notes 9.0.1 (add-on)H: 129C added
D: 4764
Sametime 9.0.1 embedded in Notes 9.0.2 (add-on or out-of-box ?? )H: 129D tbd when Notes 902 ships
D: 4765


Beta information

Sametime 8.5.2 embedded in Notes 8.5.4H: 1246
Sametime 8.5.3 embedded in Notes 8.5.4
Removed from published version because there never was a Sametime 8.5.3.
H: 1247




Statistics output

In the Statistics output, you will see resolve calls listed for Type: 8192 with various versions.
Type 8192 Resolve requests are requests created by server applications. All server applications, including legacy GW, STGW, ST Proxy, and SUT have the same login type - 2000 - and contribute to resolve requests.

================================================================
Enabling Debug:
You can turn on a debug flag to determine the Client Type and User ID. Public version of these steps is in technote 1090528 linked to above.
  1. Clean the \trace folder.
  2. Edit the sametime.ini to include:
    [Debug]
    VPS_DEBUG_LOGIN_MSG=1
  3. Restart the server.
  4. Login with the application you are interested in.
  5. To determine the client and user ID, in the StCommunity trace (under the \trace folder, StCommunity_*.txt) look for the following line:

    LOGIN_MSG 21/Jul/05, 15:58:56 Sending LOGIN_ACK to 9.148.46.66, masterChId=74, info: eId=2d 09942dd2, uId=CN=admin admin/O=cloud, eType=1003, name=admin admin/cloud, clusterName=cn=cloud/ou=cloud/o=cloud

    uId is the user Identification
    eType is the login type
===============================================================

Additional information
Please note that this feature has one big flaw, which is that every application can declare any login type upon login to the sametime server - especially if this application is developed on top of the C++ toolkit or the Java toolkit. In other words, if the administrator limits the logins types to specific login types, it is relatively easy for other applications to adjust the login type to one of the allowed login types.



Associated SPRs:


SPRIDSystem
CLYH5MTJPLSametime SPRs

Contributors: Todd Page, Suzy Stewart, Kendell Zahn, Jason Schmitt, Michael Altman, Neena Richard, Vineet Rohatgi



End of Support version info

Limited Use server:
By default the Sametime Connect client for Desktops is not enabled in the Limited Use installation of the Sametime 7.0 Server. The customer is not entitled to this functionality. The default sametime.ini setting for 7.0 Limited Use Server installation is:

VPS_ALLOWED_LOGIN_TYPES=1003,100A,1200,1201,1202,1203,1204,1205,1206,1207,1214,1215,1216,1217,1218,1220,1221,1222

Note: The client filter is only available on the following versions:
Sametime 3.0 IF3
Sametime 3.1 with a hotfix. Please contact Lotus Technical Support for a copy of the fix.
Sametime 6.5.1
Sametime 7.x
Sametime 8.0.x
Sametime 8.5.x

Table of client type values to identify or configure which users are connecting using a custom-built client, a Sametime client, or a Notes client.

[{"Product":{"code":"SSKTXQ","label":"IBM Sametime"},"Business Unit":{"code":"BU003","label":"Collaboration Solutions"},"Component":"Connectivity","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF012","label":"IBM i"},{"code":"PF016","label":"Linux"},{"code":"PF022","label":"OS X"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"9.0.1;9.0.0.1;9.0;8.5.2.1;8.5.2;8.5.1;8.5","Edition":"Communicate;Complete;Limited Use;Standard;Advanced;Entry"},{"Product":{"code":"SSKTWP","label":"IBM Notes"},"Business Unit":{"code":"BU003","label":"Collaboration Solutions"},"Component":"Instant Messaging","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF017","label":"Mac OS"},{"code":"PF033","label":"Windows"}],"Version":"8.5;8.0;7.0","Edition":""}]

Document Information

Modified date:
30 August 2019

UID

swg21114318