Metadata-Version: 2.1
Name: churchkey
Version: 1.1.5
Summary: a tool tunneling ssh over http proxy;
Home-page: https://github.com/cykerway/churchkey
Author: Cyker Way
Author-email: cykerway@example.com
License: UNKNOWN
Project-URL: Funding, https://paypal.me/cykerway
Project-URL: Source, https://github.com/cykerway/churchkey/
Project-URL: Tracker, https://github.com/cykerway/churchkey/issues
Description: # churchkey
        
        a tool tunneling ssh over http proxy;
        
        churchkey tunnels ssh sessions through http proxy, so that users can log into
        remote server via http proxy if direct access is not working; churchkey uses
        http *connect* method and only works with http proxies supporting this method;
        
        churchkey supports two http authentication methods: [basic] and [digest];
        
        technical details are described in [rfc 2817];
        
        alternative projects include [corkscrew] and [proxytunnel];
        
        ## install
        
        install via pip:
        
            pip install churchkey
        
        ## usage
        
        1.  create a file `~/.ssh/proxyauth` with proxy username and password:
        
                {username}:{password}
        
        2.  edit `~/.ssh/config` as follows:
        
                Host {host}
                    HostName {hostname}
                    Port {port}
                    User {user}
                    ProxyCommand churchkey {proxy_host} {proxy_port} %h %p ~/.ssh/proxyauth
        
        3.  log into remote server as usual:
        
                ssh {host}
        
        ## license
        
        Copyright (C) 2016-2018 Cyker Way
        
        This program is free software: you can redistribute it and/or modify
        it under the terms of the GNU General Public License as published by
        the Free Software Foundation, either version 3 of the License, or
        (at your option) any later version.
        
        This program is distributed in the hope that it will be useful,
        but WITHOUT ANY WARRANTY; without even the implied warranty of
        MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
        GNU General Public License for more details.
        
        You should have received a copy of the GNU General Public License
        along with this program.  If not, see <http://www.gnu.org/licenses/>.
        
        [rfc 2817]: https://tools.ietf.org/html/rfc2817
        [basic]: https://en.wikipedia.org/wiki/Basic_access_authentication
        [digest]: https://en.wikipedia.org/wiki/Digest_access_authentication
        [corkscrew]: http://agroman.net/corkscrew/
        [proxytunnel]: http://proxytunnel.sourceforge.net/
        
        
Keywords: ssh,http,proxy,network
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: System
Description-Content-Type: text/markdown
