> For the complete documentation index, see [llms.txt](https://docs.fylamynt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fylamynt.com/resources/ssh.md).

# SSH Targets

## Use Cases

* Ability to execute a command over SSH and collect logs.
* Ability to configure SSH keys to be used to execute commands on target VMs. (Private keys provided to Fylamynt are securely managed.)

## To Configure an SSH Target in Fylamynt

* Navigate to **Settings** > **Resources** > **SSH Targets**
* Click **Manage Resource** to create and configure a new integration instance
* Click on **Add New**

Details needed to set up an **SSH Target Instance** in **Fylamynt**:

| **Parameters**  | **Description**                                              | **Required** |
| --------------- | ------------------------------------------------------------ | ------------ |
| Target Name     | Unique human readable name for resource                      | True         |
| Host Identifier | Identifier to target machine such as (hostname, public IPv4) | True         |
| Private Key     | Private RSA key to run command without username/password     | True         |

Follow the steps listed below to get the desired parameters to enter in **Fylamynt**

* Target Name parameter is the unique human readable name for resource, any string could be provided, Since this is unique identifier 2 resources can not have the same target name
* Host Identifier parameter is needed to communicate with your target, generally this is either a **IPv4** or **Domain Name**
* Priavte Key this parameter is needed for authentication / authorization, this is a Private RSA Key

![](/files/-MbgxjMITmIInSa-3g8Y)

## Integration Actions <a href="#integration-actions" id="integration-actions"></a>

You can add these actions in Fylamynt workflow builder, as part of your workflow.

1. [SSH Execute](#ssh-execute)

### SSH Execute

Integration node to run SSH Execute Template

#### **Input**

| **Parameter Name** | **Description**                                   | **Required** |
| ------------------ | ------------------------------------------------- | ------------ |
| alias              | AWS assume role alias                             | True         |
| target\_name       | Template Id of configured CloudFormation resource | True         |
| user\_name         | Username, against which command would be executed | True         |
| command            | Command to be executed                            | True         |
| bucket\_name       | S3 bucket name to store logs                      | True         |

**Note:** Make sure to add correct target\_name (which has been configured from Settings Page)

#### **Output**

| **Parameter Name** | **Type** | **Description**                     |
| ------------------ | -------- | ----------------------------------- |
| execution\_status  | String   | Status of run (ie: S\_OK / E\_FAIL) |
| result             | String   | SSH command execution result        |

#### Action Example

![](/files/-MbgxmdcHh_aj-bjf1tj)