Sun ONE logo      Previous      Contents      Index      Next     

Sun ONE Portal Server 6.1 Administrator's Guide

Chapter 7
Administering My Yahoo! Enterprise Edition Provider

My Yahoo!™ Enterprise Edition Provider 1.0 connects a Sun ONE Portal Server to My Yahoo! Enterprise Edition, a service that supplies content for portal channels. This service is part of Yahoo!® Enterprise Solutions (YES) portal solutions. For information about this service and to receive a Corporate Account, see:

https://admin.corporate.yahoo.com/dat/myee_trial?vendor=SUNW&ver=00

The Sun ONE Portal Server with My Yahoo! Enterprise Edition is a way to provide valuable custom content to users in different organizations and roles using minimal administration. These come to the portal as a set of channels. Yahoo! aggregates and packages current content from many sources to deliver to a portal and makes My Yahoo! accounts available to users.

YahooContainer

The YahooContainer is essential to the My Yahoo! Enterprise Edition. It provides two critical functions. First, it is the authentication point for the Yahoo! Enterprise servers. Therefore, there must be only one YahooContainer in the used portion of display profile: the portion of the hierarchy that is loaded to display the user’s desktop. Second, it retrieves the content for every Yahoo! channel within its containment area. For this propose, it is a data gateway, and currently functions only as a HTML data gateway. For these reasons, the YahooContainer should be placed on top of the display profile hierarchy, but below the MAP container (WirelessDesktopDispatcher) if applicable. In addition, it is not designed as an UI container, like JSPTableContainer. Therefore it must not contain channels directly. Refer to the Sun ONE Portal Server 6.1 Administrator’s Guide for more detail about the display profile.

For the default installation with the Sample Portal configuration, the YahooContainer has the JSPTabContainer in its selected list. You replace that Default Channel Name with YahooContainer. After that, you can import Yahoo channels into containers contained by the JSPTabContainer. The display profile hierarchy looks like this:

YahooContainer
    JSPTabContainer
        MyFrontPageTabPanelContainer
            UserInfo channel
            other channels
            some Yahoo! channels
        SamplesTabPanelContainer
        SearchTabPanelContainer

Connecting to the My Yahoo! Enterprise Edition Service

Follow these steps to connect to the Yahoo! servers.

  1. Log in to the Sun ONE Identity Server admin console as administrator.

    2. By default, Identity Management is selected in the location pane and Organizations is selected in the Navigation pane.

  2. Select View: Service Management.
  3. Click the Properties arrow next to My Yahoo! EE Provider in the navigation pane.
  4. If you do not have a Corporate Account, click the Sign up for a new Corporate Account from Yahoo! link.

    5. This takes you to a URL that gives the information you need to sign up for an account. As of December 2002, this URL is https://admin.corporate.yahoo.com/dat/myee_trial?vendor=SUNW&ver=00

  5. If you already have a Corporate Account, fill in your Corporate Deployment Number, Deployment Key and Deployment Key confirmation.
  6. Enter the appropriate Data and Edit Servers for your locale.

    7. The default is for the United States. For Europe, use data.europe.corporate.yahoo.com and edit.europe.corporate.yahoo.com. There is only one Administration server.

  7. Enter information for Locale Mapping if appropriate.

    8. For example, if you have users needing the fr-BE (French/Belgium) locale, which is not supported, enter fr-BE|fr-FR (French/France) in the Locale Mapping box to give these users support in French. To add fr-BE|fr-FR to the Locale Mapping box, enter fr-BE|fr-FR in the text box below the Locale Mapping box and click Add.

    To remove a Locale Mapping entry, highlight it, then click Remove.

  8. In Modules Blocked for Anonymous Desktop box, enter any modules that you want unavailable to the authlessanonymous user. There are already a number of blocked modules listed in the box.

    9. For example, if you want to make the auctions channel unavailable, you enter auctions in the text box below the Modules Blocked for Anonymous Desktop box, and click Add. These entries are based on the Yahoo! module or channel names. The Yahoo! module name for this example is Yahoo_auctions.

    To remove a Modules Blocked for Anonymous Desktop entry, highlight it, then click Remove.

  9. Check Disable Personalization if you want all users not to be able to personalize (edit) the Yahoo! channels on their desktops or connect to My Yahoo! accounts.
  10. Enter the Model Account information (optional) and Save.

    11. This pings the Yahoo! servers and displays an error message if the Deployment Number or Deployment Key is not correct.

Selecting Channels for Your Portal

Plan how you are going to represent your organization, suborganizations, roles and users. Decide what Yahoo! Modules each group should be able to access, what modules should be restricted, what modules you want to customize for your organization, what modules should be customizable by the end user, and if personalized Yahoo! (My Yahoo!) accounts should be made available.

This procedure details how to select channels (Yahoo! Modules) for your main organization.

  1. Log in to the Sun ONE Identity Server admin console as administrator.

    2. By default, Identity Management is selected in the location pane and Organizations is selected in the Navigation pane.

  2. Click on your organization’s link.

    3. The Location changes to isp > organization.

  3. Select View: Services.

    4. A list of Identity Server Configuration Authentication and Portal Server Configuration possibilities to register is listed.

  4. Click the Properties arrow next to My Yahoo! EE Provider in the navigation pane.

    5. A Dynamic My Yahoo! EE Provider form is displayed.

  5. Check Disable Personalization if you want users not to be able to personalize (edit) the Yahoo! channels on their desktops.
  6. Enter the Model Account information (optional). Since this is the organization level, usually you would enter the same Model Account information you entered in Connecting to the My Yahoo! Enterprise Edition Service Step 10 (global level). This Model Account information can be different from the global level Model Account information.
  7. Save.
  8. Click the Properties arrow next to Desktop in the navigation pane.

    9. A Dynamic Desktop form (Figure 1) is displayed.

  9. Change the Default Channel Name (JSPTabContainer) to YahooContainer and Save.

    10. Figure 1  Dynamic Desktop Form
    Dynamic Desktop Form: buttons:Save,Reset,Delete;Default Channel Name;Display Profile actions: Edit XML, Upload XML, Download XML, Channel & Container Management.

  10. Click Channel and Container Management.

    11. The data pane displays a list of Container Channels and Channels.

  11. Only perform this step if your original Default Channel Name was not JSPTabContainer, click the YahooContainer link.
    1. In the Channel Management section, select JSPTabContainer in the Available and Visible box and Remove it to the Existing Channels box.
    2. Select your original default channel name in the Existing Channels box and Add it to the Available and Visible box. Click Save.
    3. Click root at the top of the pane to return to the list of Container Channels and Channels.
  12. Click the Container Channel link that you want to add the Yahoo! Modules to.

    13. For example, the default tab containers available are MyFrontPageTabPanelContainer, SamplesTabPanelContainer and SearchTabPanelContainer.

    A Container Channels and Channels Management screen (Figure 2) is displayed for the selected Container Channel.

  13. Click Import My Yahoo! EE Provider Modules.

    14. A list of Available My Yahoo! Enterprise Edition Modules is displayed. To preview a module, click on the link to that module. To select a module, check the checkbox.

    Note

    Yahoo! Modules are marked N for narrow and W for wide. These correspond to T for Thin and W for Wide channels in the Portal Server Desktop. So the narrow Yahoo! Modules are added as Thin Desktop channels and the wide Yahoo! Modules are added as Wide Desktop channels.

  14. Check the channels (Yahoo! Modules) you want to import and click Import.

    15. This returns you to the Container Channels and Channels Management screen (Figure 2) with the newly imported channels listed in the Available box (lower right). The modules or channels that are listed in the Available box are available to regular users, but not displayed unless the user selects them. If you want the modules to be visible to users, you must Add them to the Available and Visible box.

  15. Arrange the newly imported channels in the Available box or the Available and Visible box, then click Save.

    16. Figure 2  Complete Container Channels and Channels Management Screen
    Channel Management: bottom left - Existing Channels; bottom right: upper box - Available & Visible, lower box - Available

To Add the My Yahoo! Enterprise Edition Service to a Suborganization (Register a Service)

  1. Log in to the Sun ONE Identity Server admin console as administrator.

    2. By default, Identity Management is selected in the location pane and Organizations is selected in the Navigation pane.

  2. Register the My Yahoo! EE Provider service for the new organization.
  3. Select Organizations from the View menu in the navigation pane and select the suborganization from the Name menu.
  4. Select Services from the View menu.
  5. Click Register.

    6. The Register Services page appears in the data pane. Click the check box for the My Yahoo! EE Provider service, then click Register.

    The newly registered services appear in the navigation pane.

  6. Configure the My Yahoo! EE Provider service by clicking the properties arrow. Click Create to modify the configuration attributes. See the Sun ONE Identity Server Administration Guide for a description of attributes that are not specific to Portal Server configuration

    Note

    Suborganizations must register their services independently of the parent organization.

  7. Create a template for the My Yahoo! EE Provider service.
    1. Select Services from the View menu in the navigation pane.
    2. One by one, click the properties arrow icon next to the services and create the templates.
  8. Create the My Yahoo! EE Provider referral policy for the new organization.

    9. The referral must define the parent organization as the resource in the rule, and it must contain a SubOrgReferral with the sub-organization as the value in the referral

    1. Select Identity Management from the navigation pane.
    2. Select Policies from the View menu.
    3. Click New to create new policy.

      4. The Create Policy page appears in the data pane.

    4. For Name, type SubOrgReferral_MyYahoo Then click Create.
    5. Select My Yahoo! EE Provider in Service and click Next
    6. Click Rules from the View menu in the data pane and click Add. Make sure My Yahoo! EE Provider is selected and click Create.
    7. Click Referrals from the View menu in the data pane and click Add. Make sure that the name of the sub-organization is selected for Value in the data pane and click Create to complete the policy’s configuration.
  9. Create a normal My Yahoo! EE Provider policy for the new organization.
    1. Choose Policies from the View menu.

      2. The policies for that organization are displayed.

    2. Select New in the navigation pane. The New Policy page opens in the data pane.
    3. Make sure you select Normal in Type of Policy.
    4. Choose Rules from the View menu in the data pane and click Add. The Add Rule page opens in the data pane
    5. Select My Yahoo! EE Provider from the Service menu and click Next. Make sure Has Privilege to Execute My Yahoo! EE Provider is checked and click Create to complete the policy’s configuration.
    6. Choose Subjects from the View menu in the data pane and click Add. The Add Subject page opens in the data pane.
    7. Select a subject that the My Yahoo! EE Provider policy will be applied and choose Next to complete the subject configuration.
    8. Click Create to complete the policy’s configuration.
  10. In the My Yahoo! EE Provider default template, check Disable Personalization if you want users not to be able to personalize the Yahoo! channels on their desktops.

    11. Check that the Model Account is correct, then click Save.

  11. Click on the Properties arrow next to Desktop.

    12. The data pane displays the Dynamic Desktop form.

  12. Change the Default Channel Name to YahooContainer and Save.
  13. If this suborganization is to have only the organization’s Yahoo! Modules, you are finished. If you want to add other Yahoo! Modules to this suborganization, click Channel and Container Management.

    14. The data frame displays a list of Container Channels and Channels.

  14. Click the Container Channel link that you want to add the Yahoo! Modules to.

    15. For example, the default tab containers available are MyFrontPageTabPanelContainer, SamplesTabPanelContainer and SearchTabPanelContainer.

    A Container Channels and Channels Management screen (Figure 2) is displayed.

    Note

    If you want to have one of the channels available to the organization not be available to the users in the suborganization, check the appropriate Yahoo! channel and click Delete.

  15. Click Import My Yahoo! EE Provider Modules.

    16. A list of Available Yahoo! Modules is displayed. The ones that are already chosen for the organization are checked.

  16. Check the additional channels (Yahoo! Modules) you want to import for the suborganization and click Import.

    17. This returns you to the Container Channels and Channels Management screen (Figure 2) with the newly imported channels listed in the Available box. The modules or channels that are listed in the Available box are available to regular users, but not displayed unless the user selects them. If you want the modules to be visible to users, you must Add them to the Available and Visible box.

  17. Arrange the newly imported channels in the Available box or the Available and Visible box, then click Save.

To Add a Channel for a User

  1. Log in to the Sun ONE Identity Server admin console as administrator.

    2. By default, Identity Management is selected in the location pane and Organizations is selected in the Navigation pane.

  2. Click on the organization link.
  3. Click on a suborganization link.

    4. The Location changes to isp > organization > suborganization.

  4. Select View: Users in the navigation pane.

    5. A list of current users is displayed.

  5. Click on the Properties arrow next to the chosen user.

    6. The properties for the chosen user are displayed.

  6. Click Edit under Desktop.

    7. A popup data frame window displays an abbreviated Dynamic Desktop form.

  7. Click Channel and Container Management.

    8. The popup data frame window displays a list of Container Channels and Channels.

  8. Click appropriate Container Channel link.

    9. In the popup data frame window, a Container Channels and Channels Management screen is displayed for the selected Container Channel.

  9. Click Import My Yahoo! EE Provider Modules.

    10. A list of Available Yahoo! Modules is displayed. The ones that are already chosen for the user are checked.

  10. Check the additional channels (Yahoo! Modules) you want to import for the user and click Import.

    11. This returns you to the Container and Channels Management screen with the newly imported channels listed in the Available box. The modules or channels that are listed in the Available box are available to regular users, but not displayed unless the user selects them. If you want the modules to be visible to the user, you must Add them to the Available and Visible box.

  11. Arrange the newly imported channels in the Available box or the Available and Visible box, then click Save.

To Delete a Channel from a User

  1. Log in to the Sun ONE Identity Server admin console as administrator.

    2. By default, Identity Management is selected in the location pane and Organizations is selected in the Navigation pane.

  2. Click on the organization link.
  3. Click on a suborganization link.

    4. The Location changes to isp > organization > suborganization.

  4. Select View: Users in the navigation pane.

    5. A list of current users is displayed.

  5. Click on the Properties arrow next to the chosen user.

    6. The properties for the chosen user are displayed.

  6. Click Edit under Desktop.

    7. A popup data frame window displays an abbreviated Dynamic Desktop form.

  7. Click Channel and Container Management.

    8. The popup data frame window displays a list of Container Channels and Channels.

  8. Click appropriate Container Channel link.

    9. In the popup data frame window, a Container Channels and Channels Management screen is displayed for the selected Container Channel. It lists all the channels available to the user.

  9. Check channel(s) you want to delete and click Delete.
  10. Click Save.

To Lock a Channel

As an administrator, you may want to have one of the Yahoo! news channels always present on your corporate portal for all users.

  1. In a terminal window, log in to your portal server as root.
  2. Use the dpadmin command to change value of the channelsIsRemovable property for the channel in the container’s display profile. See the Command-Line Utilities chapter in the Sun ONE Portal Server 6.1 Administrator’s Guide for more information.
Example

The property for locking a channel is channelsIsRemovable on the container level.

To lock the Yahoo_companysummary channel in the container MyFrontPageTabPanelContainer, in the channel definition for MyFrontPageTabPanelContainer, you need to modify the value of the channelsIsRemovable property to false. To do this, type:

$ /opt/SUNWps/bin/dpadmin modify -p MyFrontPageTabPanelContainer -u "uid=amAdmin,ou=people,o=sesta.com,o=isp" -w passphrase -d "o=sesta.com,o=isp" <<EOF

<?xml version="1.0" encoding="utf-8" standalone="no"?>

<!DOCTYPE DisplayProfile SYSTEM "jar://resources/psdp.dtd">

<Collection name="channelsIsRemovable">

<Boolean name="Yahoo_companysummary" value="false"/>

</Collection>

EOF

For your organization, replace sesta.com with your organization name and the passphrase with the one you entered at installation.

To Add a Tab with Only Yahoo! Content

  1. Log in to the Sun ONE Identity Server admin console as administrator.

    2. By default, Identity Management is selected in the location pane and Organizations is selected in the Navigation pane.

  2. Click on the organization link.

    3. The Location changes to isp > organization.

  3. Navigate to the suborganization or role you want to add the tab for.
  4. Select View: Services in the navigation pane.

    5. A list of current services is displayed.

  5. Click on the Properties arrow next to Desktop.

    6. The data pane displays the Dynamic Desktop form.

  6. Click Channel and Container Management.

    7. The data pane displays a list of Container Channels and Channels.

Note

If you want to add a container at the root level, click Add under Container Channels.

  1. To add a container to an existing Container Channel, click a Container Channel link. For example, you can use JSPTabContainer, which is the default Container Channel from the install.
  2. Click Add under Container Channels.
  3. Select the radio button that Adds the new channel to this container.
  4. Select the radio button that Makes the new channel available and visible on desktop.
  5. Enter a channel name.
  6. Select a provider that supports the Container Channel you selected. For example, for the JSPTabContainer Container Channel select the JSPTableContainerProvider.
  7. Click Create.

    8. You are returned to the previous level of Container Channels. The new Container Channel is added to the Container Channels list.

  8. Click on the new container channel’s link.

    9. Click Import My Yahoo! EE Provider Modules.

  9. Make your selections and click Import.

    10. In the Channel Management section, select the imported modules in the Available box and Add them to the Available and Visible box. Click Save.

  10. Go up a level in the Container Path.
  11. Check that the new container channel is in the Available and Visible box. Click Save.

For more information, see the Sun ONE Portal Server 6.1 Administrator’s Guide and the Sun ONE Portal Server 6.0 Desktop Customization Guide.

To Create Your Own Model Account

  1. Log in to the Sun ONE Identity Server admin console as administrator.

    2. By default, Identity Management is selected in the location pane and Organizations is selected in the Navigation pane.

  2. Click on the organization link.

    3. The Location changes to isp > organization.

  3. Navigate to the suborganization or role for which you want to create a model account.
  4. Select View: Services Management in the location pane.

    5. A list of current services is displayed.

  5. Click on the Properties arrow next to the My Yahoo! EE Provider.

    6. The My Yahoo! EE Provider form is displayed.

  6. Click Administer Corporate Account on Yahoo! Server link.

    7. A separate browser window appears displaying a Yahoo! Model Account Administration page from a Yahoo! server.

  7. Enter a name for your account.
  8. Select a radio button for Use default or Use an existing account’s customization as the basis for this new account.
  9. Click Create a model account button.
  10. If you chose Use an existing account’s customization, you need to enter the account name and password. Otherwise, go to Step 11.
  11. On this page, you need to provide a password, select and answer a security question, enter your birthday and e-mail address. Select your country of residence and preferred language. Click Submit This Form button.

    12. You are returned to the Yahoo! Model Account Administration page. Your new model account name is added in the Edit a Model Account box.

  12. Click your new model account name in the Edit a Model Account box.

    13. The channels in your new model account are displayed.

  13. When you are finished, close the extra browser windows.

    14. This customized content or a subset of it is what the user sees unless the user has linked to a my.yahoo id.

To Customize Channel Content for a Model Account

  1. Log in to the Sun ONE Identity Server admin console as administrator.

    2. By default, Identity Management is selected in the location pane and Organizations is selected in the Navigation pane.

  2. Click on the organization link.

    3. The Location changes to isp > organization.

  3. Navigate to the suborganization or role for which you want to customize a model account.
  4. Select View: Services Management in the location pane.

    5. A list of current services is displayed.

  5. Click on the Properties arrow next to the My Yahoo! EE Provider.

    6. The My Yahoo! EE Provider form is displayed.

  6. Click Administer Corporate Account on Yahoo! Server link.

    7. A separate browser window appears.

  7. Click on the model account you want to edit.

    8. A separate browser window appears displaying the channels in the model account. This is the my.yahoo page for that particular Model Account.

  8. Select the channel you want to customize and click edit.
  9. Follow the directions on the edit page and click Finished when done.

    10. The model account is displayed with your modification.

  10. Close the browser windows.



Previous      Contents      Index      Next     

Copyright 2003 Sun Microsystems, Inc. All rights reserved.