Skip to content

Commit 8ac1ea8

Browse files
authored
ssh sdk prep (#3250) (#3258)
1 parent 187f755 commit 8ac1ea8

File tree

6 files changed

+53
-37
lines changed

6 files changed

+53
-37
lines changed

plugins/ssh/.CHECKSUM

+3-3
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
2-
"spec": "9247db0545cd8d1474eabb488c08997c",
3-
"manifest": "58de38307d29215935d4e06a1a0943c7",
4-
"setup": "b0941213ed47967cbec2b3e8a68bf900",
2+
"spec": "3562c6d84061cd5d7f1fb41d11f447f0",
3+
"manifest": "00e46897a559bac59a27dee57b448468",
4+
"setup": "5fac1a750187e4a7a3ee01491454a88c",
55
"schemas": [
66
{
77
"identifier": "run/schema.py",

plugins/ssh/Dockerfile

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
FROM --platform=linux/amd64 rapid7/insightconnect-python-3-slim-plugin:6.2.3
1+
FROM --platform=linux/amd64 rapid7/insightconnect-python-3-slim-plugin:6.2.5
22

33
LABEL organization=rapid7
44
LABEL sdk=python

plugins/ssh/bin/komand_ssh

+1-1
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ from sys import argv
66

77
Name = "SSH"
88
Vendor = "rapid7"
9-
Version = "4.0.3"
9+
Version = "4.0.4"
1010
Description = "[Secure Shell](https://en.wikipedia.org/wiki/Secure_Shell) (SSH) is a cryptographic network protocol for operating network services securely over an unsecured network. This plugin uses the [paramiko](http://www.paramiko.org/) to connect to a remote host via the library. The SSH plugin allows you to run commands on a remote host"
1111

1212

plugins/ssh/help.md

+3-2
Original file line numberDiff line numberDiff line change
@@ -110,12 +110,12 @@ Example output:
110110
## Troubleshooting
111111

112112
* The `key` field in connection setup takes a base64 encoded RSA private key which must contain a newline character after the BEGIN marker and before the END marker:
113-
E.g.
113+
E.g.
114114

115115
```
116116
-----BEGIN RSA PRIVATE KEY-----
117117
MIIEogIBAAKCAQEA6NF8iallvQVp22WDkTkyrtvp9eWW6A8YVr+kz4TjGYe7g4h53s=
118-
...
118+
...
119119
-----END RSA PRIVATE KEY-----
120120
```
121121

@@ -124,6 +124,7 @@ This can then be pasted into the Connection's `key` input field
124124

125125
# Version History
126126

127+
* 4.0.4 - Updated SDK to the latest version (6.2.5)
127128
* 4.0.3 - Updated dependencies | Updated SDK to the latest version
128129
* 4.0.2 - Initial updates for fedramp compliance | Updated SDK to the latest version
129130
* 4.0.1 - Update from komand to insight-plugin-runtime

plugins/ssh/plugin.spec.yaml

+44-29
Original file line numberDiff line numberDiff line change
@@ -3,57 +3,72 @@ extension: plugin
33
products: [insightconnect]
44
name: ssh
55
title: SSH
6-
description: "[Secure Shell](https://en.wikipedia.org/wiki/Secure_Shell) (SSH) is a cryptographic network protocol for operating network services securely over an unsecured network. This plugin uses the [paramiko](http://www.paramiko.org/) to connect to a remote host via the library. The SSH plugin allows you to run commands on a remote host"
7-
version: 4.0.3
6+
description: '[Secure Shell](https://en.wikipedia.org/wiki/Secure_Shell) (SSH) is
7+
a cryptographic network protocol for operating network services securely over an
8+
unsecured network. This plugin uses the [paramiko](http://www.paramiko.org/) to
9+
connect to a remote host via the library. The SSH plugin allows you to run commands
10+
on a remote host'
11+
version: 4.0.4
812
connection_version: 4
9-
supported_versions: ["SSH 2025-01-15"]
13+
supported_versions: [SSH 2025-01-15]
1014
vendor: rapid7
1115
support: community
1216
status: []
1317
resources:
1418
source_url: https://github.com/rapid7/insightconnect-plugins/tree/master/plugins/ssh
1519
license_url: https://github.com/rapid7/insightconnect-plugins/blob/master/LICENSE
1620
tags:
17-
- ssh
18-
- remote
19-
- tunnel
21+
- ssh
22+
- remote
23+
- tunnel
2024
hub_tags:
2125
use_cases: [threat_detection_and_response]
2226
keywords: [ssh]
2327
features: []
2428
fedramp_ready: true
2529
sdk:
2630
type: slim
27-
version: 6.2.3
31+
version: 6.2.5
2832
user: nobody
2933
key_features:
30-
- Run remote commands with SSH
34+
- Run remote commands with SSH
3135
requirements:
32-
- Credentials for the target remote host
33-
- Address and port for the target remote host
36+
- Credentials for the target remote host
37+
- Address and port for the target remote host
3438
troubleshooting:
35-
- "The `key` field in connection setup takes a base64 encoded RSA private key which must contain a newline character after the BEGIN marker and before the END marker:\nE.g.\n\n```\n-----BEGIN RSA PRIVATE KEY-----\nMIIEogIBAAKCAQEA6NF8iallvQVp22WDkTkyrtvp9eWW6A8YVr+kz4TjGYe7g4h53s=\n...\n-----END RSA PRIVATE KEY-----\n```\n\nYou can easily encode a private key file and copy a key to your clipboard on MacOS with the following command: `base64 < .ssh/id_rsa | pbcopy`.\nThis can then be pasted into the Connection's `key` input field"
39+
- "The `key` field in connection setup takes a base64 encoded RSA private key which
40+
must contain a newline character after the BEGIN marker and before the END marker:\n
41+
E.g.\n\n```\n-----BEGIN RSA PRIVATE KEY-----\nMIIEogIBAAKCAQEA6NF8iallvQVp22WDkTkyrtvp9eWW6A8YVr+kz4TjGYe7g4h53s=\n
42+
...\n-----END RSA PRIVATE KEY-----\n```\n\nYou can easily encode a private key file
43+
and copy a key to your clipboard on MacOS with the following command: `base64 <
44+
.ssh/id_rsa | pbcopy`.\nThis can then be pasted into the Connection's `key` input
45+
field"
3646
version_history:
37-
- "4.0.3 - Updated dependencies | Updated SDK to the latest version"
38-
- "4.0.2 - Initial updates for fedramp compliance | Updated SDK to the latest version"
39-
- "4.0.1 - Update from komand to insight-plugin-runtime"
40-
- "4.0.0 - Upgrade the plugin runtime to `komand/python-3-37-plugin` and run as least-privileged user | Change the SSH key credential type to `credential_secret_key` to skip PEM validation in the product UI"
41-
- "3.0.1 - Fixed issue obtaining username in connection"
42-
- "3.0.0 - Update connection username from credential_secret_key to string"
43-
- "2.0.0 - Update Run action output to return 3 output fields i.e. `stderr`, `stdout`, and `all_output`"
44-
- "1.0.3 - New spec and help.md format for the Extension Library"
45-
- "1.0.2 - Fixed issue where Run was excluded"
46-
- "1.0.1 - Fix issue where run action was excluded from plugin on build"
47-
- '1.0.0 - Support web server mode | Update to new credential types | Rename "Run remote command" action to "Run Remote Command"'
48-
- "0.1.3 - SSL bug fix in SDK"
49-
- "0.1.2 - Strip extra newlines in key"
50-
- "0.1.1 - Connection SSH key input is now type bytes"
51-
- "0.1.0 - Initial plugin"
47+
- 4.0.4 - Updated SDK to the latest version (6.2.5)
48+
- 4.0.3 - Updated dependencies | Updated SDK to the latest version
49+
- 4.0.2 - Initial updates for fedramp compliance | Updated SDK to the latest version
50+
- 4.0.1 - Update from komand to insight-plugin-runtime
51+
- 4.0.0 - Upgrade the plugin runtime to `komand/python-3-37-plugin` and run as least-privileged
52+
user | Change the SSH key credential type to `credential_secret_key` to skip PEM
53+
validation in the product UI
54+
- 3.0.1 - Fixed issue obtaining username in connection
55+
- 3.0.0 - Update connection username from credential_secret_key to string
56+
- 2.0.0 - Update Run action output to return 3 output fields i.e. `stderr`, `stdout`,
57+
and `all_output`
58+
- 1.0.3 - New spec and help.md format for the Extension Library
59+
- 1.0.2 - Fixed issue where Run was excluded
60+
- 1.0.1 - Fix issue where run action was excluded from plugin on build
61+
- 1.0.0 - Support web server mode | Update to new credential types | Rename "Run remote
62+
command" action to "Run Remote Command"
63+
- 0.1.3 - SSL bug fix in SDK
64+
- 0.1.2 - Strip extra newlines in key
65+
- 0.1.1 - Connection SSH key input is now type bytes
66+
- 0.1.0 - Initial plugin
5267
links:
53-
- "[Secure Shell](https://en.wikipedia.org/wiki/Secure_Shell)"
68+
- '[Secure Shell](https://en.wikipedia.org/wiki/Secure_Shell)'
5469
references:
55-
- "[OpenSSH](https://www.openssh.com/)"
56-
- "[paramiko](https://www.paramiko.org/)"
70+
- '[OpenSSH](https://www.openssh.com/)'
71+
- '[paramiko](https://www.paramiko.org/)'
5772
types:
5873
results:
5974
stdout:

plugins/ssh/setup.py

+1-1
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33

44

55
setup(name="ssh-rapid7-plugin",
6-
version="4.0.3",
6+
version="4.0.4",
77
description="[Secure Shell](https://en.wikipedia.org/wiki/Secure_Shell) (SSH) is a cryptographic network protocol for operating network services securely over an unsecured network. This plugin uses the [paramiko](http://www.paramiko.org/) to connect to a remote host via the library. The SSH plugin allows you to run commands on a remote host",
88
author="rapid7",
99
author_email="",

0 commit comments

Comments
 (0)