> For the complete documentation index, see [llms.txt](https://help.genesis.autify.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.genesis.autify.com/features-ko/settings/connection-settings/remote-machines.md).

# 원격 머신

이 문서에서는 Autify Genesis에서 자신의 머신을 SSH로 연결하여 Genesis 에이전트가 해당 머신에서 이름으로 지정한 명령을 실행할 수 있도록 하는 절차(BYO 컴퓨트)를 설명합니다.

{% hint style="warning" %}
원격 머신은 조직 단위로 활성화된 경우에만 사용할 수 있습니다. 설정 화면에 **원격 머신**이 표시되지 않으면 Autify 지원팀에 문의하십시오.
{% endhint %}

## 사전 조건

* 머신을 추가·편집·삭제·활성화/비활성화하려면 조직의 **관리자** 또는 **소유자** 역할이 필요합니다. **멤버** 역할은 등록된 머신을 조회만 할 수 있습니다.
* 추가할 머신이 SSH로 접근 가능해야 하며, 연결에 사용할 사용자 이름과 자격 증명(개인 키 또는 비밀번호)이 필요합니다.

## 머신 추가하기

1. 화면 왼쪽 아래의 계정 메뉴에서 **설정**을 열고, 왼쪽 사이드바의 **연결** > **원격 머신**을 클릭하십시오.
2. **머신 추가**를 클릭하십시오.
3. **이름**에 Genesis 에이전트가 이 머신을 참조할 때 사용할 이름을 입력하십시오.
4. **설명**에 이 머신의 용도를 입력하십시오(선택). Genesis 에이전트가 적절한 머신을 선택하는 데 도움이 되도록 표시됩니다.
5. **호스트**와 **포트**에 연결할 SSH 호스트(예: `example.com` 또는 `10.0.0.5`)와 포트 번호(기본값은 `22`)를 입력하십시오.
6. **사용자 이름**에 SSH 연결에 사용할 사용자 이름을 입력하십시오.
7. **인증 방법**에서 **개인 키** 또는 **비밀번호**를 선택하십시오.
8. 선택한 인증 방법에 따라 다음 항목을 입력하십시오.

   | 인증 방법 | 입력 항목                                    |
   | ----- | ---------------------------------------- |
   | 개인 키  | **개인 키(PEM)**, **키 암호문**(키에 암호문이 설정된 경우) |
   | 비밀번호  | **비밀번호**                                 |
9. **사용 범위**에서 이 머신을 사용할 수 있는 워크스페이스를 설정하십시오. 자세한 내용은 이 문서의 [사용 범위 설정하기](#사용-범위-설정하기)를 참조하십시오.
10. **연결 테스트**를 클릭하십시오. 처음 연결할 때는 이 문서의 [머신 식별 정보 확인하기](#머신-식별-정보-확인하기)에서 설명하는 확인 대화 상자가 표시됩니다.
11. 연결 테스트에 성공하면 **저장**을 클릭하십시오.

{% hint style="info" %}
입력한 개인 키, 암호문, 비밀번호는 저장 시 암호화됩니다.
{% endhint %}

## 머신 식별 정보 확인하기

처음 연결하는 호스트이거나 호스트·포트를 변경한 경우, Genesis는 연결 전에 머신의 SSH 호스트 키 지문을 가져와 확인 대화 상자에 표시합니다. 표시된 지문이 연결할 머신의 것과 일치하는지 확인한 뒤 **신뢰하고 연결 테스트**를 클릭하십시오.

등록된 머신의 호스트 키를 다시 가져오려면 머신 편집 화면에서 **식별 정보 다시 확인**을 클릭하십시오. 다시 확인하려면 현재 자격 증명을 입력해야 합니다.

## 사용 범위 설정하기

머신마다 사용할 수 있는 워크스페이스 범위를 설정할 수 있습니다.

* **모든 워크스페이스에서 사용 가능**을 활성화하면 조직 내 모든 워크스페이스의 Genesis 에이전트가 이 머신을 사용할 수 있습니다.
* 비활성화하면 워크스페이스 목록에서 개별적으로 선택한 워크스페이스만 이 머신을 사용할 수 있습니다. 워크스페이스를 하나 이상 선택해야 합니다.

## 머신 관리하기

**원격 머신** 페이지에는 등록된 머신의 이름, 인증 방법, 연결 상태(테스트 안 됨 / 연결 가능 / 연결 불가), 사용 범위가 표시됩니다. 각 머신에 대해 다음 작업을 할 수 있습니다.

* **연결 테스트**: 저장된 자격 증명으로 머신에 대한 SSH 연결을 확인합니다.
* **활성화됨** 스위치: Genesis 에이전트가 이 머신을 사용할 수 있는지 여부를 전환합니다. 비활성화해도 머신의 등록 정보는 유지됩니다.
* **편집**: 이름·연결 정보·인증 방법·사용 범위를 변경합니다.
* **삭제**: 머신의 등록을 삭제합니다.

{% hint style="danger" %}
머신을 삭제하면 Genesis 에이전트가 더 이상 이 머신에서 명령을 실행할 수 없습니다. 이 작업은 되돌릴 수 없습니다.
{% endhint %}

## 참고 자료

* [연결](/features-ko/settings/connection-settings.md)
* [도구](/features-ko/ai-feature/tools.md)