제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의 목록에 나타납니다.

스크린샷 추가 예정

그림 2.1. Paired Devices 패널에 페어링 QR 코드가 표시된 Mac과, 그 코드를 스캐너 프레임에 담은 iPhone.촬영 방법: Mac의 “Pair a device” QR 시트와, Scan QR code 카메라 화면을 띄운 iPhone을 나란히 촬영

팁휴대폰을 화면 가까이에 흔들리지 않게 대십시오. 카메라 초점이 맞지 않으면 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 패널에는 각 기기가 이름, 키 지문, 마지막 접속 시각과 함께 나열됩니다. 여기서 권한 수준을 올리거나, 이름을 바꾸거나, 폐기할 수 있습니다.

보안모든 기기는 고유한 키를 가집니다. Mac에서 한 기기를 폐기하면 즉시 차단되며, 다른 페어링된 기기에는 영향이 없습니다. 휴대폰을 분실했다면 여기서 폐기하십시오.

2.5권한 수준

각 기기가 할 수 있는 범위는 Mac이 정합니다. 권한 수준은 Mac의 Paired Devices 패널(Overview 그룹)에서 설정하십시오.

수준	이 기기가 할 수 있는 일
Read-only	상태, 알림, 로그, 기기 페이지 보기. 변경 불가.
Restart	Read-only에 더해 서비스 시작 / 중지 / 재시작.
Operate	Restart에 더해 플릿 작업.
Full control	도구, 스크립트, 공유 열기를 포함한 모든 작업.

버튼이 비활성화되어 있거나 작업이 거부되면 이 기기의 권한 수준이 허용하지 않는 것입니다 — Mac에서 수준을 올리거나, 이미 권한이 있는 기기를 사용하십시오.

팁늘 들고 다니는 휴대폰은 낮은 수준(Read-only 또는 Restart)으로 두고, Full control은 신뢰하는 기기 하나에만 부여하십시오. 일상적으로 잃는 것은 없고, 분실한 휴대폰으로 할 수 있는 일은 제한됩니다.

여러 기기 페어링

iPhone과 iPad는 원하는 만큼 페어링할 수 있습니다 — 각 기기가 자체 키를 등록하고, 자체 권한 수준을 받으며, 자체 요청에 서명합니다. 같은 LAN에 있는 두 휴대폰은 세션을 공유하거나 서로 덮어쓰지 않습니다. 벽에 설치한 iPad는 상태 표시용으로 Read-only로 두고, 주로 쓰는 휴대폰에는 이동 중 빠른 조치를 위해 Restart를 줄 수 있습니다. 같은 LAN에 FrontierStack Mac이 여러 대 있어도 표시 이름이 아니라 고정된 전체 인증서 지문으로 서로 구분됩니다.

기기를 페어링하고 권한 수준을 설정했다면 앱을 사용할 준비가 된 것입니다. 집과 외부에서의 연결은 다음 장인 연결 유지에서, 일상적으로 쓰는 탭은 앱 사용하기에서 다룹니다.

FrontierStack 사용자 설명서 · 버전 1.0.0 · 제2장