## Headless 플레이를 위한 링크 생성하기

Headless 플레이 모드는 모니터링 보드 화면을 제외한 모든 어플리케이션과 관련된 프레임을 제거하고 실행하는 방법을 제공합니다. 이 모드로 실행하는 데 필요한 headless link를 만들어내는 방법을 아래에서 안내합니다.

## Headless Link 만들기

1. **플레이 대상 URL 확인하기**: 헤드리스 플레이 대상이 될 URL을 확인합니다. 이 URL은 모니터링 보드 화면을 실행하려는 기본 페이지 주소입니다.

![headless-link-01]

2. **Query Key 설정하기**: 파라미터들을 전체적으로 오브젝트화하여 하나의 키로 전달하려면, `오브젝트형 파라미터 키(query key)`를 설정합니다.

- 이 키를 설정하면, 다음의 설정된 파라미터들은 하나의 오브젝트로 플레이될 보드에 전달됩니다.
- 이 키를 설정하지 않으면, 각 파라미터들은 자신의 키와 값으로 플레이될 보드에 전달됩니다.

3. **파라미터 키-값 설정하기**: 실행에 필요한 파라미터 키와 값을 설정합니다. 이 파라미터들은 실행될 보드에 전달됩니다.

4. **권한 부여 장치(appliance) 선택하기**: 플레이를 시키기 위해 필요한 권한을 부여할 장치(appliance)를 선택합니다.

- 장치를 선택하지 않으면, 헤드리스 링크에는 권한 정보가 포함되지 않으므로, 헤드리스 플레이를 실행시킬 때 먼저 로그인을 요청할 수 있습니다.
- 헤드리스 플레이를 실행시킬 사용자가 이미 로그인 계정과 권한을 가지고 있는 상황이면, 이 장치를 선택하지 않아도 됩니다.
- 장치를 선택하면 해당 장치의 access_token이 헤드리스 링크의 파라미터에 포함되게 됩니다.

![headless-link-02]

5. **Headless Link 복사하기**: 최종 완성된 headless link를 배포하기 위해서는 생성된 링크를 복사하여 사용합니다.

![headless-link-03]

## 예제

아래는 headless link를 만드는 예제입니다.

```markdown
1. 베이스 URL: https://vis.hatiolab.com/domain/system
2. 플레이 대상 URL: https://vis.hatiolab.com/domain/system/headless-player/1234567890abcde
3. Query Key: query
4. 파라미터 키-값:
   - param1: 123456
   - param2: ABCDE
   - param3: abc
5. access token: abcdefgh12345678

생성된 Headless Link 예시:
https://vis.hatiolab.com/domain/system/headless-player/1234567890abcde?query={"param1":123456,"param2":"ABCDE","param3":"abc"}&access_token=abcdefgh12345678
```

이제 생성된 headless link를 복사하여 브라우저에서 URL로 사용하시면 됩니다.

[headless-link-01]: ./images/headless-link-01.png
[headless-link-02]: ./images/headless-link-02.png
[headless-link-03]: ./images/headless-link-03.png
