Skip to main content

Introduction

The ftw.bridge tools are used for communication between several Plone instances. It is also possible to communicate with other web services. Requests between web services are proxied through the ftw.bridge.proxy. This makes it possible to move or reconfigure certain dependent webservices (clients) only by reconfiguring the proxy. The clients do not know where other target clients are located - they only communicate with the proxy directly, which forwards the requests to the target client.

http://onegov.ch/approved.png/image

Certified: 01/2013

Features

ftw.bridge.client integrates ftw.bridge support into Plone. It provides tools and utilities for communication and authentication.

  • Authentication: A PAS plugin authenticates requests and logs the user in on the target client without transmitting his password. Only requests from the configured ftw.bridge.proxy are authenticated.

  • Requests: The IBridgeRequest utility is used for making requesting other clients. It is also able to make remote catalog queries and transmitting the result brains to the sources by using fake brains.

  • Brain transport: By using a BrainRepresentation it is possible to get brains from a remote client. A BrainSerializer utility serializes and deserializes all brain metadata so that they can be used on the source client.

  • Watcher portlet: A recently-modified portlet can be used for generic listing a list of recently modified objects on the remote client but it is also possible to list other links. There is a browser view @@watch which creates a recently-modified portlet on the remote client dashboard. The watcher portlet loads its data asynchronously using javascript for not blocking while loading the dashboard.

  • Favorites: A browser view @@remote-add-favorite adds the context to the favorites on the remote client dashboard.

Installation and configuration

  • A installation of ftw.bridge.proxy is required.

  • Add ftw.bridge.client to your eggs in the buildout configuration:

    [instance]
    eggs +=
        ftw.bridge.client
  • Configure the ftw.bridge.proxy data as environment variables:

    [instance]
    environment-vars +=
        bridge_url http://localhost:1234/proxy
        bridge_ips 127.0.0.1, 192.168.1.10
        bridge_client_id workspace
  • Install the generic setup profile. This registers the portlet and installs a PAS plugin.

Configuration Options

The configuration options are set using environment variables:

  • bridge_url: The url to the “/proxy” view of ftw.bridge.proxy.

  • bridge_ips: A comma seperated list of trusted IPs of the ftw.bridge.proxy installation.

  • bridge_client_id: The id of this client as configured in the .ini file on ftw.bridge.proxy.

Compatibility

Runs with Plone 4.1, 4.2, 4.3 or 5.1.

Changelog

1.1.1 (2019-12-14)

  • Use configured name from ftw.dashboard.portlets.favourites.foldername if available. [mathias.leimgruber, tinagerber]

  • Provide precompiled bundle [tinagerber]

1.1.0 (2019-10-29)

  • Add Plone 5.1 support. [tinagerber]

1.0.14 (2016-11-01)

  • Watcher portlet feed: fix error when object was deleted. [jone]

1.0.13 (2016-01-20)

  • Drop Plone < 4.3 support. [elioschmutz]

  • Add types_to_ignore registry entry for the watcher feed. All defined portaltypes will not be listed in the watcher portlet. [elioschmutz]

1.0.12 (2015-04-13)

  • Catalog requests: serialize python datetime objects. [jone]

1.0.11 (2015-04-13)

  • Catalog requests: set response headers. [jone]

1.0.10 (2015-03-24)

  • Brain serializer: fix JSON error when there persistent mutables in the catalog. [jone]

1.0.9 (2014-08-20)

  • Implement uninstall profile. [jone]

  • Use ftw.profilehook instead of custom import steps (setuphandlers). [jone]

  • ftw.solr compatibility hacks

    [jone]

  • Watcher portlet: fix encoding problem when having discussion items. [jone]

1.0.8 (2014-02-28)

  • Drop support for older ftw.tabbedview versions. Requires ftw.tabbedview>=3.2.3. This fixes a ZCML autoinclude load order issue. [jone]

  • Fix “sort_order” bug in catalog query view. The problem is that the catalog does not support unicode strings. [jone]

  • Fix watcher.js (replace jq with $). [mathias.leimgruber]

1.0.7 (2013-05-24)

  • onegov.ch approved: add badge to readme. [jone]

1.0.6 (2012-06-26)

  • Fix proxy support: validate last proxy IP. [jone]

1.0.5 (2012-06-14)

  • View / favorite actions: handle typesUseViewActionInListings so that files and images are not downloaded but displayed. [jone]

1.0.4 (2012-05-24)

  • Fix portlet javascript for IE 8. [jone]

1.0.3 (2012-05-22)

  • Tabbedview integration: disable custom sorting since we have a lazy result. [jone]

1.0.2 (2012-05-09)

  • Add MANIFEST.in and include all resources. [jone]

1.0.1 (2012-05-09)

  • Update readme (fix restructured text markup). [jone]

1.0 (2012-05-09)

  • Initial implementation. [jone]

Release files for ftw.bridge.client 1.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ftw.bridge.client 1.1.1
File Size Uploaded
ftw.bridge.client-1.1.1.tar.gz 45.4 kB Details

Release files / ftw.bridge.client-1.1.1.tar.gz

Download URL ftw.bridge.client-1.1.1.tar.gz
Size 45.4 kB
Tags Source
SHA-256 checksum
How to use checksums
a0b299bbafc0fff4084da71322139f431fe6dd4e84e4ac1a019ffd7a56830b3a
BLAKE2b-256 checksum
How to use checksums
73d758b42166cfbae5cce21689ad9201261bd40dacfbc7766ad42fe9956dccb6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.15.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.6.0 requests-toolbelt/0.9.1 tqdm/4.40.0 CPython/2.7.17

Release history Release notifications | RSS feed

This release

1.1.1 This release

1 release file

1.1.0

1 release file

1.0.14

1 release file

1.0.13

1 release file

1.0.12

1 release file

1.0.11

1 release file

1.0.10

1 release file

1.0.9

1 release file

1.0.8

1 release file

1.0.7

1 release file

1.0.6

1 release file

1.0.5

1 release file

1.0.4

1 release file

1.0.3

1 release file

1.0.2

1 release file

1.0.1

1 release file

1.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page