sametime client yahoo

SametimeVersion 8.5.2

Welcome to the IBM Sametime Client Yahoo ! Integration Feature

Edition Notice

Note: Before using this information and the product it supports, read the information in"Notices."

This edition applies to version 8.5.2 of IBM Lotus Sametime (program number 5724–J23) andto all subsequent releases and modifications until otherwise indicated in new editions.

© Copyright IBM Corporation 2007, 2011.US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSAADP Schedule Contract with IBM Corp.

IBM Lotus Sametime 8.5.2 Release Notes

1

___________________________________________________________________________________

Welcome to the IBM Sametime Client Yahoo ! Integration Feature__________________________________________________________________________________

Introduction

Sametime is making a client-side feature available that will provide the same level of functionality with Yahoo! that the Sametime Gateway currently does. Starting in June, 2011 Sametime users will no longer be able to interact with Yahoo! users through the Sametime Gateway. This guide will walk through the process of adopting the new Yahoo! Integration feature, including installation, configuration, new features, user experience, what to watch out for, etc.

Getting Started

Prerequisites

Personal Yahoo! accounts

The client-side Yahoo! Integration feature uses your personal Yahoo! account to log in to Yahoo! and interact (chat, get awareness, etc.) with other Yahoo! users. This is a change from the Sametime Gateway implementation that worked with your Sametime account. To be able to use this new integration, you must have a personal Yahoo! account which you can create for free at: http://www.yahoo.com

A supported Sametime client

The following Sametime clients support the Yahoo! Integration feature:

- Sametime Standalone 8.0.2- Sametime Standalone 8.5.1- Sametime Standalone 8.5.2- Notes 8.5.x with Embedded Sametime

Entitlement

The Yahoo! Integration feature is not entitled to customers who are running Sametime Entry or have an Instant Messaging Limited Use version of Sametime.

Installation

To take advantage of this new feature, the first step is to get it and install it.

Delivery Vehicle


2

The Yahoo! Integration feature can be installed using either an add-on installer (recommended) or an update site. Separate add-on installers are available per platform for standalone and embedded.

Yahoo Delivery Vehicle OverviewRelease Yahoo Delivery VehicleST 8.x.x sametime.yahoo.addon (1.0.0)Notes 8.5.x sametime.yahoo.embedded.addon (1.0.0)All sametime.yahoo.addon.update.site (1.0.0)

Yahoo KitsKit Target Productsametime.yahoo.addon.win32 (1.0.0) ST802, ST851, ST852sametime.yahoo.addon.macosx (1.0.0) ST802, ST851, ST852sametime-connect-yahoo-addon.deb (1.0.0) ST802, ST851, ST852sametime-connect-yahoo-addon.rpm (1.0.0) ST802, ST851, ST852

sametime.yahoo.emb.addon.win32 (1.0.0) Notes85Xsametime.yahoo.emb.addon.macosx (1.0.0) Notes85Xsametime-connect-yahoo-emb-addon.deb (1.0.0) Notes85Xsametime-connect-yahoo-emb-addon.rpm (1.0.0) Notes85X

sametime.yahoo.addon.update.site (1.0.0) Notes/ST via typical update site processes

Download

Download the feature from here:

<Coming Soon when feature is released>

Installation

Once you have the appropriate add-on installer for either standalone or embedded, run it to install the Yahoo! Integration feature. To install on Windows, run the setup.exe or setup.msi, for Linux install the RPM (or debian if using Ubuntu), and for Mac, execute the install package.

If installing using the update site, use any of the typical methods for installing using an update site: Administrator update site policy, manual install using the installation UI in the client, etc.

Creating the Yahoo! community

The connection to Yahoo! is now managed through a separate Yahoo! community. Like all other Sametime communities, you create this in the client, enter your Yahoo! credentials, etc. and login to connect to Yahoo!. This is different from the experience with the Sametime Gateway where contact with all external messaging systems was handled through a single Sametime community connected to the Gateway.

After installing the Yahoo! Integration feature, start up the client and log into your default Sametime community. Now it's time to create the Yahoo! community:

1.) Go to the menu: File -> New -> Server Community (or use the New ... Server Community action on the buddy list toolbar)

2.) Choose "Yahoo" as the server community type:


3

3.) Enter your Yahoo! credentials in the user name and password fields.

4.) Optionally choose the options to remember password and automatically log in.

5.) Click OK to complete the process and login to Yahoo!

NOTE: The community dialog allows you to specify many other options for a community including host name, connection type, etc. All of these options are not applicable to Yahoo! so although you can set / change these values, they are not used for a Yahoo! community.

NOTE: The icon for a Yahoo! community will always be the Yahoo! bang icon: , it cannot be changed.

Logging in to Yahoo! from Sametime Embedded in Notes

Logging into Yahoo! for the first time in Notes using Sametime Embedded will trigger two "Issue Cross Certificate" security dialogs for the subjects:

CN=login.yahoo.com/O=Yahoo! Inc....CN=*.login.yahoo.com/OU=Yahoo! Inc/O=Yahoo! Inc.......

IBM Lotus Sametime 8.5.2 ase Notes

4

Click "Cross certify" on both of these dialogs to allow the login to Yahoo! to continue.

This is not required in Sametime standalone.

Administrators - this step can be mitigated by following the process outlined in the Domino Administrator InfoCenter topic: Pushing trusted certificates to Lotus Notes clients which can be found here: http://publib.boulder.ibm.com/infocenter/domhelp/v8r0/index.jsp?topic=/com.ibm.help.domino.admin85.doc/H_PUSHING_CERTIFICATES_TO_CLIENTS_STEPS.html

Yahoo! contacts and awareness

Now that you've created the Yahoo! community and logged in, you can start working with Yahoo! contacts.

Contact Authorization Process


5

Unlike in Sametime, you cannot just add a Yahoo! user to your contact list and get awareness on them. Yahoo! users will get a notification (wherever they are logged into Yahoo! or on their next login) that you are requesting to add them to your contact list and they must accept this request before you can see their status or chat with them. This is the same experience that you get in all Yahoo! based clients like Yahoo! Messenger or Yahoo! Mail. This is also the same experience that is in the Sametime Gateway today, but it is important concept to remember to avoid confusion when contacts you add appear offline initially.

The new Yahoo! integration feature also provides the ability for you to respond to contact requests from other Yahoo! users. When another user attempts to add you to their contact list, a dialog will display in the Sametime client:

- Clicking Accept will allow the other user to add you to their contact list- Clicking Deny will prevent the other user from adding you to their contact list- Closing this window without choosing Allow or Deny will leave this as a pending request, so the next time you log in to Yahoo!, you will be prompted again.

NOTE: In this release we do not provide the ability to block or report abuse, this is being evaluated for a future release. We also do not provide a way to customize the response text.

Import your existing Yahoo ! contact list

An important feature that was added in this integration is the ability to import your existing personal Yahoo! contact list. Taking this action will create a private group in your Sametime buddy list named "Yahoo! Contacts". This private group will get populated with all the contacts from your personal Yahoo! contact list - and because they are already members of your contact list, they have already authorized you so you can instantly see their status and chat with them.

1.) Go to the menu: File -> Import Sametime Contact List -> From Server...

2.) Choose your "Yahoo!" community:


6

3.) Click OK to import your existing contacts into a "Yahoo! Contacts" private group.

Adding new Yahoo! contacts to the buddy list

To add a new Yahoo! contact to the buddy list, follow the same steps as you would for adding a Sametime contact, but choose the Yahoo! community:

1.) Right-click on a private group and choose Add Contact... from the context menu, or choose the New Sametime Contact... action in the buddy list toolbar.

2.) Select the Yahoo! community in the Add Contact dialog that displays:

3.) Enter a user name (with or without the domain) and click Lookup.

4.) When the result window displays, click Add to add the contact to your buddy list.


7

5.) The user will display as offline until they approve the request (see Contact Authorization Process above)

NOTE: When you add a Yahoo! contact to your Sametime contact list, they will in turn get added to your personal Yahoo! contact list.

Deleting Yahoo! contacts from the buddy list

To delete a new Yahoo! contact from the buddy list, right-click on the user and choose Remove from Sametime Contact List

NOTE: When you remove a Yahoo! contact it is the same as removing the contact from your personal Yahoo! contact list (they are inextricably tied together). So removing a Yahoo! user from your Sametime contact list will cause them to be removed from your personal Yahoo! contact list and therefore they will have to accept the authorization request again if you want to ever re-add them.

What about the existing Yahoo ! contacts in my buddy list from the Sametime Gateway ?

Any existing Yahoo! contacts you had in your buddy list from the Sametime Gateway will need to be converted over to the new Yahoo! community. The best way to do this is to delete the contact from the buddy list and re-add them, specifying the new Yahoo! community in the Add Contact dialog as explained in the previous section. Because the request will be coming from your personal Yahoo! account instead of the old Sametime Gateway account, you will likely have to wait until they accept the request before getting awareness unless you already had them in your personal Yahoo! contact list.

NOTE: Yahoo! has a low-rate threshold on adding new contacts to your contact list. This is to prevent denial of service attacks and other spam. Developing a utility to convert / add existing Yahoo! Gateway contacts to your personal Yahoo! contact list could very easily reach this threshold and cause a temporary ban. So the recommended approach is to manually remove and re-add these contacts.

Awareness Status Mappings

The Yahoo! Messenger client only has Available, Busy and Invisible statuses, therefore Sametime will handle the differences by mapping statuses:

- ST Available -> Yahoo Available- ST Away -> Yahoo Busy- ST In Meeting -> Yahoo Busy- ST DND -> Yahoo Busy- Yahoo Available -> ST Available- Yahoo Busy -> ST Away

Status icons and fonts will display as they do in the Gateway implementation today - all Yahoo! contacts will always have the Yahoo! bang icon (colored when online, greyed when offline) and the contact name font will indicate status.

NOTE: The invisible status for Yahoo! is not supported this release - it is being investigated


8

for a future Sametime release.

Chat

Sending and receiving instant messages (chatting) with Yahoo! contacts is the same as the current Sametime Gateway implementation, using the same chat windows and experience as regular Sametime chats. The experience will be most like chatting with an external user or with an older pre-7.5 client (because of the restrictions listed below). A couple points to consider:

- No rich-text support

- No image support including custom emoticons

- No file transfer support

- No n-way chat support. Yahoo! does not support this in their APIs. They do have the concept of a "conference" with multiple users, but they do not provide client API support for this yet.

- Emoticons will be handled exactly as they are with external users today - all clear text. If you choose an emoticon from palette, the clear text version will be sent. If you send or receive an emoticon like :-) the Sametime chat transcript window will display the corresponding Sametime emoticon icon if available.

- Chat history will be maintained if enabled.

Known Issues and Limitations

- Sametime requires that the default community for a Sametime client be a Sametime community. While it is not explicitly prevented, having another type of community (such as Yahoo!) as the default is not supported.

- Multiple Yahoo! communities in a single Sametime client are not supported. It is not currently prevented, but it will be in the next revision.

- The client does not provide the ability to block a user or report abuse

- Sametime is not providing the ability to log in as Invisible in this release.

Deployment Considerations

All calls to Yahoo! are done over standard HTTP and HTTPS so ports 80 and 443 must be open.

Notices

This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services,or features discussed in this document in other countries. Consult your local IBM representative for information on theproducts and services currently available in your area. Any reference to an IBM product, program, or service is notintended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalentproduct, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it isthe user's responsibility to evaluate and verify the operation of any non-IBM product, program, or service.

IBM may have patents or pending patent applications covering subject matter described in this document. The furnishingof this document does not grant you any license to these patents. You can send license inquiries, in writing, to:

IBM Director of LicensingIBM CorporationNorth Castle DriveArmonk, NY 10504-1785U.S.A.

For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department inyour country or send inquiries, in writing, to:

Intellectual Property LicensingLegal and Intellectual Property LawIBM Japan Ltd.1623-14, Shimotsuruma, Yamato-shiKanagawa 242-8502 Japan

The following paragraph does not apply to the United Kingdom or any other country where such provisions areinconsistent with local law:

INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION “AS IS” WITHOUTWARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THEIMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULARPURPOSE.

Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement maynot apply to you.

This information could include technical inaccuracies or typographical errors. Changes are periodically made to theinformation herein; these changes will be incorporated in new editions of the publication. IBM may make improvementsand/or changes in the product(s) and/or the program(s) described in this publication at any time without notice.

Any references in this information to non-IBM Web sites are provided for convenience only and do not in any mannerserve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBMproduct and use of those Web sites is at your own risk. IBM may use or distribute any of the information you supply inany way it believes appropriate without incurring any obligation to you. Licensees of this program who wish to haveinformation about it for the purpose of enabling: (i) the exchange of information between independently created programsand other programs (including this one) and (ii) the mutual use of the information which has been exchanged, shouldcontact:

IBM Corporation5 Technology Park DriveWestford Technology ParkWestford, MA 01886

Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of afee.

The licensed program described in this information and all licensed material available for it are provided by IBM underterms of the IBM Customer Agreement, IBM International Program License Agreement, or any equivalent agreement

between us.

Any performance data contained herein was determined in a controlled environment. Therefore, the resultsobtained in other operating environments may vary significantly. Some measurements may have been made ondevelopment-level systems and there is no guarantee that these measurements will be the same on generallyavailable systems. Furthermore, some measurements may have been estimated through extrapolation. Actualresults may vary. Users of this document should verify the applicable data for their specific environment.

Information concerning non-IBM products was obtained from the suppliers of those products, their publishedannouncements or other publicly available sources. IBM has not tested those products and cannot confirm theaccuracy of performance, compatibility or any other claims related to non-IBM products. Questions on thecapabilities of non-IBM products should be addressed to the suppliers of those products.

All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, andrepresent goals and objectives only. All IBM prices shown are IBM's suggested retail prices, are current and aresubject to change without notice. Dealer prices may vary.

This information is for planning purposes only. The information herein is subject to change before the productsdescribed become available.

This information contains examples of data and reports used in daily business operations. To illustrate them ascompletely as possible, the examples include the names of individuals, companies, brands, and products. All ofthese names are fictitious and any similarity to the names and addresses used by an actual business enterprise isentirely coincidental.

COPYRIGHT LICENSE:

This information contains sample application programs in source language, which illustrate programmingtechniques on various operating platforms. You may copy, modify, and distribute these sample programs in anyform without payment to IBM, for the purposes of developing, using, marketing or distributing applicationprograms conforming to the application programming interface for the operating platform for which the sampleprograms are written. These examples have not been thoroughly tested under all conditions. IBM, therefore,cannot guarantee or imply reliability, serviceability, or function of these programs. The sample programs areprovided "AS IS", without warranty of any kind. IBM shall not be liable for any damages arising out of your useof the sample programs.

Each copy or any portion of these sample programs or any derivative work, must include a copyright notice asfollows:

© (your company name) (year). Portions of this code are derived from IBM Corp.Sample Programs. © Copyright IBM Corp. _enter the year or years_. All rights reserved.

If you are viewing this information softcopy, the photographs and color illustrations may not appear.

Trademarks

These terms are trademarks of International Business Machines Corporation in the United States, othercountries, or both:

IBM

AIX

DB2

DB2 Universal Database Domino

Domino

Domino Designer

Domino Directory

i5/OS

iSeries

Lotus

Notes

OS/400

Sametime

System i

WebSphere

AOL is a registered trademark of AOL LLC in the United States, other countries, or both.

AOL Instant Messenger is a trademark of AOL LLC in the United States, other countries, or both.

Google Talk is a trademark of Google, Inc, in the United States, other countries, or both.

Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or itsaffiliates.

Microsoft, and Windows are registered trademarks of Microsoft Corporation in the United States, othercountries, or both.

Intel and Pentium are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the UnitedStates, other countries, or both.

Linux is a trademark of Linus Torvalds in the United States, other countries, or both.

Other company, product, or service names may be trademarks or service marks of others.

sametime client yahoo

Documents