Setting up bridges

A community uses web services to retrieve information from other bridged communities, presenting much of the same information in the local community that people can get by going to the bridged community directly.

Fastpath: Admin Console: System > Settings > Bridges

When you set up the bridge, you're not just making the connection possible. You're also setting how people who are using the community will see the connected community. So as you set up the bridge, when entering values to help identify the bridged community, you should enter values that make sense from a user's perspective. Bridging works for registered users.

When you add a bridge in one community, you set up the bridge in your side. Then you send a request to the other community that an administrator there will need to approve.

This feature is turned off by default. To enable bridging, contact Support.

Creating a bridge

To create a bridge from the current Jive community to another:

  1. On the primary community, add the bridge as follows:
    1. In the Admin Console, go to System > Settings > Bridges.
    2. Click Add bridge.

      This opens the Add bridge dialog box.

    3. In Bridge URL, enter the URL for the community you're bridging to.

      This should be the community's root URL, which points to the community's home page.

    4. In Sign in credentials, enter the user name and password that should be used to connect to the bridged community.

      These credentials should correspond to a valid user account on the community you're bridging to, and are used only to make the request. When the connection is approved, a shared user account is created and used for authenticating between instances.

    5. Click Lookup to attempt to connect to the instance you're bridging to.

      After it succeeds, you are prompted to finish configuring.

    6. In Bridge name, enter the name that users should see when they are browsing content retrieved from the bridged community.

      If the bridged community's name is a long one, you should use a short version of it here.

    7. For Bridge features, select the features that should be available across bridged communities.
    8. If you have an icon that represents the bridged community, browse for its image file.

      For example, you might want to use the bridged community's favicon.

    9. When you're finished, click Save.

Approving a bridge

An administrator from the bridged community must approve the bridge request using that community's Admin Console. To review the bridge request:

  1. In the Admin Console, go to System > Settings > Bridges and locate the pending bridge request.
  2. When reviewing the bridge request, you can:
    • View information about the requesting community (such as its URL) and select features that should be served (that is, reciprocated) to the requesting community by clicking View/edit details.
    • Approve the bridge request by clicking Approve.
    • Reject the request by clicking Reject.
Note: If you have trouble searching across the bridge, double-check the OpenSearch engine associated with it. In the Admin Console, you can do a test search using OpenSearch engines.