{"id":19584764,"url":"https://github.com/oracle-samples/seas-forwarder","last_synced_at":"2025-10-28T10:37:03.975Z","repository":{"id":93185135,"uuid":"515912713","full_name":"oracle-samples/seas-forwarder","owner":"oracle-samples","description":null,"archived":false,"fork":false,"pushed_at":"2023-08-24T09:44:52.000Z","size":51,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-01-09T05:45:32.550Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"upl-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oracle-samples.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-07-20T09:17:05.000Z","updated_at":"2023-02-08T09:07:42.000Z","dependencies_parsed_at":"2025-01-10T07:31:39.738Z","dependency_job_id":null,"html_url":"https://github.com/oracle-samples/seas-forwarder","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle-samples%2Fseas-forwarder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle-samples%2Fseas-forwarder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle-samples%2Fseas-forwarder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle-samples%2Fseas-forwarder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oracle-samples","download_url":"https://codeload.github.com/oracle-samples/seas-forwarder/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240858536,"owners_count":19868997,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-11T07:49:36.982Z","updated_at":"2025-10-28T10:37:03.871Z","avatar_url":"https://github.com/oracle-samples.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Seas Forwarder\n\nThe SEAS Forwarder is a python script that installs as a SSH daemon subsystem,\nsimilar to how 'sftp-server' installs as an sftp subsystem.  The forwarder\nallows the EAGLE SEAS client to connect, via SSH, to the SEAS server running\nthis script.\n\nThe EAGLE SEAS client will connect to the SSH SEAS subsystem.  The SSH daemon\nupon seeing the SEAS subsystem request, will start an instance of the SEAS\nForwarder script.  The forwarder will then establish a TCP/IP connection to\nthe local SEAS server.\n\nAfter the connections are established, the SEAS Forwarder will act as a\nconduit for all IP traffic passed between the EAGLE SEAS client and the SEAS\nserver.  The traffic that is passed through the SEAS Forwarder is unaltered.\n\nRequirements\n------------\nPython 2.5.6 and above (Python 3.x not supported)\nSSH Daemon\n\n## Installation\n\nThe SEAS Forwarder zip file will contain the following files:\n    - seas_forwarder.py\n    - seas_forwarder.cfg\n    - README.txt\n\n1. Create the following directory \"seas_forwarder\".  This directory may be \n   placed anywhere you choose.\n2. Install all three files into \"\u003cinstall path\u003e/seas_forwarder/\n3. Open seas_forwarder.cfg and verify/update the following settings for\n   logging.  See the field descriptions below.\n    - logEnable\n    - logLevel\n    - syslogdAddress\n    - traceLogFileDir\n    - traceLogFileName\n    - traceLogFileSize\n    - traceBackupCount\n    - traceLogEnable\n4. Open seas_forwarder.cfg and verify/update the following settings for the\n   SEAS Server.  See the field descriptions below.\n    - hostName\n    - ipMap\n    - serverTimeout\n5. Save the changes to seas_forwarder.cfg\n6. Add the SEAS subsystem to the SSH daemon:\n    - Edit the SSH daemon configuration file: \"/etc/ssh/sshd_config\"\n    - Add the following line:\n        Subsystem   seas    /\u003cinstall path\u003e/seas_forwarder/seas_forwarder.py\n    - Save and close the file\n7. Restart the SSH daemon to allow sshd_config file changes to take effect\n    - From the command line run:\n        \u003e service sshd restart\n    - The service restart will not affect existing SSH sessions.\n\n\nSEAS Forwarder Configuration\n----------------------------\nlogEnable - Enable or disable all logging support(syslogd and trace logging)\n            Trace logging must still be enabled separately.  If trace logging\n            is enabled and logEnable is set to 0, all logging including trace\n            logging will be disabled.\n    - Valid values:  0 or 1\n    - 0 disable all logging\n    - 1 (default) enable logging\n\nlogLevel - If enabled, set the verbosity of the log output\n    - Valid values: INFO, DEBUG, or TRACE\n    - INFO (default) The minimum output level.  Logs the start and end of the\n                     seas forwarder instance.\n    - DEBUG  Provides additional details.  Includes INFO output.\n    - TRACE  Very verbose output.  Logs all traffic sent between SEAS server\n             and EAGLE SEAS client.  Includes INFO and DEBUG output.\n\nsyslogdAddress - Specifies the location of the syslogd log socket\n    - Default value:  /dev/log\n\ntraceLogFileDir - Destination directory for \"logLevel = TRACE\" output\n    - Default value:  /tmp/\n\ntraceLogFileName - Name for \"logLevel = TRACE\" output file\n    - Default value:  seas_forwarder.log\n\ntraceLogFileSize - Maximum size of \"logLevel = TRACE\" output file in MBs.\n    - Valid values:   1 or higher\n    - Default value:  2\n\ntraceBackupCount -  Maximum number of \"logLevel = TRACE\" backup files.\n    - Valid values:   0 or higher\n    - Default value:  5\n\ntraceLogEnable - Enable or disable trace logging for all instances of the\n                      SEAS Forwarder process if logEnable is set to 1.\n    - Valid values:  0 or 1\n    - 0 (default) disable trace logging\n    - 1 enable trace logging\n\nhostName - The name of the SEAS server host. It should be the CCS-MR hostname.\n    - Default value:  localhost\n\nipMap - Mapping of STP IP address and port number. Port number is the one on which CCSMR is listening on.\n            It should be in json format as shown in the example below.\n            Using this port number and above hostName seas_forwarder script will try to make connection to CCS-MR.\n    - Default value:  None\nExample.\nipMap = {\n    \"10.75.147.14\" : \"10005\",\n    \"10.75.146.107\" : \"10004\",\n    \"10.75.136.216\" :\"10000\"\n    }\n\nserverTimeout - The amount of time the connection between the SEAS\n                Forwarder and the SEAS server can remain idle before\n                disconnecting.\n    - Default value:  300 seconds\n\n## Need Help?\n\n* Create a GitHub [issue](https://github.com/oracle-samples/seas-forwarder/issues).\n\n## Contributing\n\nThis project welcomes contributions from the community. Before submitting a pull request, please [review our contribution guide](./CONTRIBUTING.md).\n\n## Security\n\nThe [Security Guide](./SECURITY.md) contains information about security vulnerability disclosure process. If you discover a vulnerability, consider filing an [issue](https://github.com/oracle-samples/seas-forwarder/issues).\n\n## License\n\nCopyright (c) 2022, 2023 Oracle and/or its affiliates.\n\nReleased under the Universal Permissive License v1.0 as shown at\n\u003chttps://oss.oracle.com/licenses/upl/\u003e.\n\nSubject to the condition set forth below, permission is hereby granted to any person obtaining a copy of this software, associated documentation and/or data (collectively the \"Software\"), free of charge and under any and all copyright rights in the Software, and any and all patent rights owned or freely licensable by each licensor #hereunder covering either (i) the unmodified Software as contributed to or provided by such licensor, or (ii) the Larger Works (as defined below), to deal in both\n\n(a) the Software, and \n(b) any piece of software and/or hardware listed in the lrgrwrks.txt file if one is included with the Software (each a “Larger Work” to which the Software is contributed by such licensors),\n\nwithout restriction, including without limitation the rights to copy, create derivative works of, display, perform, and #distribute the Software and make, use, sell, offer for sale, import, export, have made, and have sold the Software and the Larger Work(s), and to sublicense the foregoing rights on either these or other terms.\n\nThis license is subject to the following condition:\n\nThe above copyright notice and either this complete permission notice or at a minimum a reference to the UPL must be included in all copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foracle-samples%2Fseas-forwarder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foracle-samples%2Fseas-forwarder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foracle-samples%2Fseas-forwarder/lists"}