제2장
기기 페어링
Mac의 QR 코드를 한 번 스캔하면 iPhone 또는 iPad가 자체 키를 등록합니다. 그다음 기기가 무엇을 할 수 있는지는 Mac이 정확하게 결정합니다.
페어링은 이 앱을 Mac의 현재 라이선스가 유효한 FrontierStack 데스크톱 앱에 연결합니다. QR 코드 하나와 몇 초면 충분합니다. 무료 Network Check는 페어링 전에도 사용할 수 있으며, 모든 모니터링 및 관리 기능은 여기서 시작됩니다.
2.1페어링의 동작 방식
Mac은 두뇌입니다. 서버, 에이전트, 기기와 통신합니다. 이 앱은 그 Mac을 위한 안전한 리모컨입니다. 페어링은 두 기기가 서로를 영구적으로 인식하는 방법입니다. QR 코드를 스캔하면 세 가지가 휴대폰으로 전달됩니다 — Mac에 접근하는 경로(집이나 사무실 네트워크, Tailscale, Cloudflare 터널), 일회용 토큰, 그리고 연결을 고정할 수 있도록 Mac의 인증서 지문입니다. 그런 다음 휴대폰이 자체 키를 생성해 Mac에 등록합니다. 첫 핸드셰이크가 끝나면 일회용 토큰은 소진되며, 이후의 모든 요청은 기기 자체 키로 증명됩니다(보안 참조).
2.2단계별 페어링
- Mac에서 유효한 FrontierStack 라이선스를 활성화하십시오. 라이선스가 없는 데스크톱은 iOS 컴패니언을 등록할 수 없습니다.
- Mac에서 FrontierStack → Paired Devices(Overview 그룹)를 여십시오.
- Pair a device를 클릭하십시오. QR 코드가 나타납니다.
- 이 앱에서 Scan QR code를 탭하고 카메라를 Mac 화면에 맞추십시오.
- 앱이 코드를 읽고, 키를 등록하고, 연결합니다. 새 기기가 Mac의 목록에 나타납니다.
Mac에 접근할 수 없습니까? Bluetooth로 페어링하십시오. 게스트 네트워크, 클라이언트 격리, 캡티브 포털 등 제한이 걸린 Wi-Fi 네트워크에서는 앱이 QR은 제대로 읽어도 연결에 실패할 수 있습니다. Mac에서 Allow Bluetooth pairing이 켜져 있고(Paired Devices 패널) Mac에서 몇 미터 이내에 있다면 Pair over Bluetooth를 탭하십시오. 그러면 대신 근거리 Bluetooth 연결을 통해 등록이 완료됩니다. 같은 일회용 QR 코드와 같은 서명된 핸드셰이크를 사용하고 전송 수단만 바뀌므로, 결과는 네트워크를 통한 페어링과 동일합니다. Mac은 Pair 대화상자가 열려 있는 동안에만 Bluetooth로 자신을 알립니다.
2.3QR 코드에 담긴 정보
QR은 단순한 토큰이 아닙니다. 앱이 Mac에 안전하게 접근하는 데 필요한 모든 것이 담겨 있습니다.
- 접근 경로 — 집/사무실 네트워크, Tailscale, 그리고 Cloudflare 터널이 있다면 그 주소. 집에 있든 밖에 있든 앱이 Mac을 찾을 수 있게 합니다(연결 유지).
- 일회용 토큰 — 최초 등록에만 사용되고 이후 폐기됩니다.
- 인증서 지문 — 앱이 Mac의 HTTPS 인증서를 고정할 수 있게 하므로, 인증서가 자체 서명이어도 연결을 가로챌 수 없습니다.
저장된 경로는 출발점일 뿐, 특정 LAN 주소 하나를 영구히 복사해 둔 것이 아닙니다. 페어링 후 Mac은 고정된 HTTPS 제어 서비스를 Bonjour로 알립니다. Mac의 주소가 바뀌면 휴대폰은 새 주소를 찾아낼 수 있지만, 전체 인증서 지문이 이 페어링과 여전히 일치할 때만 그 주소를 받아들입니다.
2.4새 기기 승인
새로 페어링한 기기는 읽기 전용으로 시작합니다 — 사용자가 허용하기 전까지 상태와 알림은 볼 수 있지만 아무것도 변경할 수 없습니다. Mac의 Paired Devices 패널에는 각 기기가 이름, 키 지문, 마지막 접속 시각과 함께 나열됩니다. 여기서 권한 수준을 올리거나, 이름을 바꾸거나, 폐기할 수 있습니다.
2.5권한 수준
각 기기가 할 수 있는 범위는 Mac이 정합니다. 권한 수준은 Mac의 Paired Devices 패널(Overview 그룹)에서 설정하십시오.
| 수준 | 이 기기가 할 수 있는 일 |
|---|---|
| Read-only | 상태, 알림, 로그, 기기 페이지 보기. 변경 불가. |
| Restart | Read-only에 더해 서비스 시작 / 중지 / 재시작. |
| Operate | Restart에 더해 플릿 작업. |
| Full control | 도구, 스크립트, 공유 열기를 포함한 모든 작업. |
버튼이 비활성화되어 있거나 작업이 거부되면 이 기기의 권한 수준이 허용하지 않는 것입니다 — Mac에서 수준을 올리거나, 이미 권한이 있는 기기를 사용하십시오.
2.6여러 Mac과 페어링하기
iPhone 또는 iPad 한 대는 FrontierStack을 실행하는 모든 Mac(최대 8대)과 페어링할 수 있습니다. 첫 번째 Mac은 위와 같이 페어링합니다. 그 밖의 Mac마다 휴대폰에서 설정 ▸ Mac ▸ 다른 Mac과 페어링을 연 다음, 그 Mac에서 '페어링된 기기'를 열고 기기 페어링을 눌러 코드를 스캔하십시오. 휴대폰의 키는 하나이며 각 Mac이 따로 승인하고 권한 수준도 Mac마다 정합니다. 한 Mac에서는 Full control, 다른 Mac에서는 Read-only로 둘 수도 있습니다.
- Mac 선택 — 설정 ▸ Mac에서 Mac을 누르거나 플릿과 작업 상단의 Mac 메뉴를 사용하십시오. 체크 표시가 선택한 Mac을 나타내며, 모든 화면에 그 Mac의 서버, 장소, 서비스가 표시됩니다.
- Mac별로 분리 — 인벤토리, 메시지 로그, 대기 중인 작업, AI 대화는 휴대폰에 Mac마다 따로 보관됩니다. 전환해도 섞이지 않으며, 원래 Mac으로 돌아가면 그대로 돌아옵니다.
- 알림 — 페어링한 모든 Mac이 휴대폰을 알림 대상으로 등록하므로 화면에 어떤 Mac이 표시되든 모든 Mac에서 알림을 받습니다.
- 페어링 해제 — 설정의 <Mac>과(와)의 페어링 해제는 사용 중인 Mac에서만 휴대폰을 폐기합니다. 다른 Mac과의 페어링은 유지되며 휴대폰의 키는 마지막 Mac을 해제할 때만 삭제됩니다.
선택한 Mac에 연결할 수 없으면 페어링한 다른 Mac이 대신할 수 있습니다. Mac이 자리에 없을 때를 참조하십시오.
기기를 페어링하고 권한 수준을 설정했다면 앱을 사용할 준비가 된 것입니다. 집과 외부에서의 연결은 다음 장인 연결 유지에서, 일상적으로 쓰는 탭은 앱 사용하기에서 다룹니다.
FrontierStack 사용자 설명서 · 버전 1.0.0 · 제2장