# io.net 기기 ID는 워커 개인 키가 아닙니다

기기 ID는 모니터에 붙이는 UUID입니다. 워커 개인 키와 Bearer 토큰은 비밀입니다. 토큰은 서버에 암호화되어 저장되고 ID 칸에는 들어가지 않으며, 연결을 해제하면 삭제됩니다.

- Canonical: https://iotahome.site/ko/learn/ionet-device-id-vs-worker-key
- Publisher: IOTA Watch
- Topics: io.net
- Published: 2026-10-24
- Updated: 2026-10-24

## 핵심 내용

ID는 기기를 고르고 토큰은 읽기를 허가합니다. 개인 키는 붙이지 마세요. 로그인 계정마다 io.net 읽기 연결은 하나이며, 다시 저장하면 이전 토큰을 바꿉니다.

## 두 값을 어디에 두나

| 가진 값 | 넣는 곳 | 잘못된 곳에 넣으면 |
| --- | --- | --- |
| 기기 ID(UUID) | 기기 ID 칸 | 형식이 아니면 거부되고 하드웨어가 안 나옵니다 |
| Bearer 읽기 토큰 | 로그인 후 읽기 자격 증명, 서버만 | ID 칸에 붙이면 기기가 되지 않고 비밀이 노출됩니다 |
| 워커 개인 키나 시드 | 이 사이트에 주지 않음 | 모니터가 쓰지 않으며, 붙여도 기기를 읽지 못합니다 |

## 바로 답

기기 ID와 워커 개인 키는 같은 칸이 아닙니다. 공식 기기 상세는 `device_id`를 경로에 두고 그 기기의 고유 식별자라고 부릅니다. 인가는 `Authorization: Bearer` 헤더의 OAuth 액세스 토큰입니다. 모니터는 UUID만 기기 ID로 받습니다. 개인 키, 시드, 토큰 자체는 기기 ID가 아닙니다.

[io.net 모니터](https://iotahome.site/ko/projects/ionet)에서 ID 칸에는 UUID만 넣습니다. 읽기 자격 증명은 로그인 뒤에 따로 제출합니다. 서버가 그 토큰을 암호화해 저장하고, 브라우저는 원문을 다시 받지 않습니다. 연결을 해제하면 여기에 저장된 자격 증명이 삭제됩니다.

## 칸이 각각 뜻하는 것

기기 ID는 어느 기기를 읽을지 정합니다. 문서의 경로는 `GET /v1/io-explorer/devices/{device_id}/details`입니다. 문서 예시의 기기 ID는 UUID이고, 옆에 하드웨어 이름과 GPU 수가 있습니다. 그 공개 식별자를 ID 칸에 복사합니다.

Bearer 토큰은 io.net이 이번 읽기를 받아들이는지 정합니다. 하드웨어 일련번호가 아닙니다. 로그인한 계정마다 io.net 연결은 하나입니다. 다시 저장하면 새 토큰이 이전 토큰을 바꿉니다. GPU마다 열쇠를 따로 저장하지 않습니다. 각 기기는 여전히 자신의 UUID를 씁니다.

## 확인할 곳

- io.net 콘솔에서 기기 ID를 복사하고 UUID인지 확인합니다. 개인 키나 토큰이라는 표지가 붙은 비밀이 아니어야 합니다.

- 인가 또는 API 토큰 자리에서 Bearer 토큰을 복사해 읽기 자격 증명에만 붙입니다. 제출 후 입력칸은 비워집니다.

- ID가 거부되면 구간이 8-4-4-4-12인지 봅니다. 공백이나 설명을 붙이지 마세요.

- 자격 증명이 거부되면 io.net에서 토큰을 다시 발급해 연결합니다. 거부된 문자열을 ID 칸으로 옮기지 마세요.

## 행동 분기

- 개인 키만 있다면 공식 콘솔에서 기기 UUID와 읽기 토큰을 찾습니다. 개인 키는 워커 기기에 둡니다.

- 토큰을 ID 칸에 붙였다면 지우고 UUID를 넣은 뒤, 토큰은 자격 증명에 넣습니다. 채팅이나 스크린샷에 나온 토큰은 io.net에서 취소합니다.

- GPU를 하나 더 볼 때는 같은 계정의 읽기 연결을 유지하고 새 기기 ID를 입력합니다. 새 기기 기록으로 저장할 때만 자리가 하나 더 듭니다.

## 예시(설명용)

올바른 쌍은 기기 ID `11111111-1111-4111-8111-111111111111`와, 이 페이지가 보여 주지 않는 Bearer 토큰입니다. 그러면 하드웨어 이름이 나올 수 있습니다. 잘못된 쌍은 토큰이나 개인 키 전체를 ID 칸에 붙입니다. UUID가 아니므로 기기가 선택되지 않고, 하드웨어도 오늘 IO도 나오지 않습니다.

같은 계정의 두 번째 GPU는 다른 UUID를 씁니다. 읽기 자격 증명을 두 번 저장할 필요는 없습니다. 저장된 기기 기록 두 개는 자리 두 개입니다. 콘솔에서 두 번째 기기만 보고 저장하지 않으면 자리는 늘지 않습니다. 이어서 [연결 방법](https://iotahome.site/ko/learn/ionet-monitor-guide)과 [비공개 읽기의 저장](https://iotahome.site/ko/learn/ionet-private-api-connection)을 봅니다.

## 자주 묻는 질문

### 워커 개인 키로 기기 ID를 대신할 수 있나요?

안 됩니다. 개인 키는 붙이지 마세요. 기기 ID는 콘솔의 UUID여야 합니다. 읽기에는 별도의 Bearer 토큰을 씁니다.

### GPU마다 토큰을 따로 저장하나요?

아닙니다. 로그인 계정마다 io.net 읽기 연결은 하나이고, 다시 저장하면 토큰이 바뀝니다. 기기마다 자신의 기기 ID를 씁니다.

### 연결을 끊으면 토큰이 브라우저에 남나요?

남지 않습니다. 연결 해제는 여기에 저장된 자격 증명을 지웁니다. 입력칸도 제출 후 비워집니다. io.net 쪽 권한은 그 플랫폼에서 따로 취소합니다.

## 자료 출처와 구현

- [io.net Device Details](https://io.net/docs/reference/io-explorer/get-device-details)
- [io.net](https://io.net/)