============================ Twitcher: OWS Security Proxy

.. image:: https://img.shields.io/badge/docs-latest-brightgreen.svg :target: http://twitcher.readthedocs.io/en/latest/?badge=latest :alt: Documentation Status

.. image:: https://zenodo.org/badge/DOI/10.5281/zenodo.3736114.svg :target: https://doi.org/10.5281/zenodo.3736114 :alt: Zenodo DOI

.. image:: https://github.com/bird-house/twitcher/actions/workflows/tests.yml/badge.svg?branch=master :target: https://github.com/bird-house/twitcher/actions/workflows/tests.yml :alt: GitHub Actions Status

.. image:: https://img.shields.io/github/license/bird-house/twitcher.svg :target: https://github.com/bird-house/twitcher/blob/master/LICENSE.txt :alt: GitHub license

.. image:: https://badges.gitter.im/bird-house/birdhouse.svg :target: https://gitter.im/bird-house/birdhouse?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge :alt: Join the chat at https://gitter.im/bird-house/birdhouse

Twitcher (the bird-watcher) a birdwatcher mainly interested in catching sight of rare birds. (Leo <https://dict.leo.org/ende/index_en.html>_).

Twitcher is a security proxy for OWS services like Web Processing Services (WPS). The proxy service uses OAuth2 access tokens to protect the OWS service access. In addition one can also use X.509 certificates for client authentication.

The implementation is not restricted to WPS services. It will be extended to more OWS services like WMS (Web Map Service) and might also be used for Thredds catalog services.

Twitcher extensions:

• Magpie_ is an AuthN/AuthZ service provided by the PAVICS_ project.
• Weaver_ middleware by CRIM_. A reimplementation of an old Twitcher fork <https://github.com/ouranosinc/twitcher/>_ for workflow execution and a Swagger RESTful interface for Web Processing Services.

Twitcher is implemented with the Python Pyramid_ web framework.

You can try Twitcher online using Binder, or view the notebooks on NBViewer.

.. image:: https://mybinder.org/badge_logo.svg :target: https://mybinder.org/v2/gh/bird-house/twitcher.git/master?filepath=notebooks :alt: Binder Launcher :height: 20

.. image:: https://raw.githubusercontent.com/jupyter/design/master/logos/Badges/nbviewer_badge.svg :target: https://nbviewer.jupyter.org/github/bird-house/twitcher/tree/master/notebooks/ :alt: NBViewer :height: 20

Twitcher is part of the Birdhouse_ project. The documentation is on ReadTheDocs_.

Twitcher Docker_ images are also available for most recent tagged versions.

.. _Birdhouse: http://birdhouse.readthedocs.io/en/latest/ .. _Pyramid: http://www.pylonsproject.org .. _ReadTheDocs: http://twitcher.readthedocs.io/en/latest/ .. _Magpie: https://github.com/Ouranosinc/Magpie .. _PAVICS: https://ouranosinc.github.io/pavics-sdi/index.html .. _Weaver: https://github.com/crim-ca/weaver .. _CRIM: https://www.crim.ca/en .. _Swagger: https://swagger.io/ .. _Docker: https://cloud.docker.com/u/birdhouse/repository/docker/birdhouse/twitcher/general