NoxHash에서 API 키 생성 및 관리 방법
NoxHash API 키를 안전하게 생성, 저장, 로테이션, 취소하세요. 자동화와 서드파티 연동을 위한 보안 모범 사례를 단계별로 안내합니다.
NoxHash API 키는 외부 스크립트, 대시보드 또는 봇이 비밀번호를 공유하지 않고도 마이닝 데이터를 읽고 계정에서 동작을 수행할 수 있도록 해주는 고유한 비밀 토큰입니다. 프로필 페이지에서 키를 생성하고, 각 키에 이름을 붙이며, 비밀 문자열을 한 번만 복사하고, 언제든 키를 취소할 수 있습니다.
NoxHash API 키가 필요한 이유
대부분의 사용자는 전혀 필요하지 않습니다 — 대시보드가 이미 잔액, 마이너, 지급 내역을 실시간으로 보여주기 때문입니다. API 키는 브라우저가 아닌 머신이 계정과 상호작용하기를 원하는 순간부터 유용해집니다. 키를 프로그램적 액세스로 범위가 제한된, 이름이 있고 취소 가능한 비밀번호라고 생각하시면 됩니다 — 로그인 정보를 넘기지 않고도 스크립트를 인증해 줍니다.
자동화 스크립트
야간 cron job으로 hashrate와 수익을 끌어오고, 자체 데이터베이스에 기록하거나 마이너가 오프라인이 될 때 알림을 트리거하실 수 있습니다.
개인 대시보드
Grafana, Notion, 또는 스프레드시트 뷰를 만들어 NoxHash 수익과 다른 크립토 데이터를 합쳐 보실 수 있습니다 — 모두 읽기 전용이고, 모두 사용자의 것입니다.
서드파티 모니터링
자체 호스팅 uptime monitor, 신뢰하는 모바일 앱, 또는 마이닝 지급 내역의 읽기 전용 피드가 필요한 회계 도구에 데이터를 공급하실 수 있습니다.
위 중 어느 것도 해당되지 않는다면 API 키는 건너뛰셔도 됩니다. 키는 보호해야 할 새로운 비밀을 추가하는데, 사용하지 않는 비밀은 불필요한 부담입니다. 실제로 필요한 날에 다시 돌아와 생성하시면 됩니다.
NoxHash에서 API 키 찾는 위치
API 키는 프로필 페이지의 보안과 활동 섹션 아래에 있습니다. 패널 제목은 API Keys이며, 설명은 "Manage API keys for programmatic access."로 표시됩니다. 아직 하나도 만들지 않으셨다면 작은 빈 상태 아이콘과 함께 "No API keys created yet."이라는 문구가 보입니다 — 여기가 시작점입니다.
API 키 만드는 방법 — 단계별 안내
키 생성은 약 30초가 걸립니다. 이름을 붙이고, 키를 생성하고, 비밀 문자열을 한 번 복사한 뒤 연동이 필요한 곳에 붙여 넣습니다. 아래 다섯 단계를 정확히 따르십시오 — 특히 4단계는, 전체 비밀은 단 한 번만 보실 수 있기 때문입니다.
프로필을 열고 API Keys로 스크롤
오른쪽 상단의 아바타를 클릭하고 프로필을 선택한 뒤, API Keys 패널이 나올 때까지 아래로 스크롤하십시오. 계정 삭제 영역 바로 위, 페이지 하단 근처에 있습니다.
설명적인 Key Name 입력
Key Name 필드는 나중에 목록에서 키를 알아보기 위한 것입니다. laptop-hashrate-logger나 notion-earnings-sync 같은 구체적인 이름을 쓰십시오. "test"나 "app" 같은 일반적인 이름은 나중의 로테이션을 추측 게임으로 만듭니다.
Generate New Key 누르기
녹색 Generate New Key 버튼을 클릭하십시오. NoxHash가 즉시 키를 만들고 녹색 배너를 보여줍니다: "Key created. Copy it now — it won't be shown again.". 배너는 전체 키 문자열을 모노스페이스 코드 블록 안에 표시합니다.
즉시 키 복사
코드 블록 옆의 Copy 버튼을 누르십시오. "Copied!"가 동작을 확인해 줍니다. 전체 비밀을 볼 수 있는 유일한 기회이며 — 이후 NoxHash는 해시만 저장하므로, 잃어버리면 유일한 해결책은 취소하고 새 키를 생성하는 것뿐입니다.
비밀 저장소에 붙여넣기
복사된 값을 바로 비밀번호 관리자(1Password, Bitwarden), git-ignored 된 .env 파일, 또는 CI/CD 시크릿 볼트로 옮기십시오. Slack, Discord, 티켓, 스크린샷에는 붙여 넣지 마십시오 — 가장 흔한 유출 경로입니다.
안전한 방식으로 키 이름 짓기, 저장, 로테이션하기
키를 복사한 뒤 남은 위험의 대부분은 사람에게서 옵니다. 키의 이름을 어떻게 짓고, 어디에 저장하고, 언제 로테이션하는지가 미래의 실수가 몇 분의 손실로 끝날지, 아니면 비트코인의 손실로 이어질지를 결정합니다. 미국 사이버보안 및 인프라 보안국(CISA)은 API 토큰을 강력한 비밀번호와 동일하게 취급합니다 — 길고, 고유하며, 서비스 간에 절대 재사용하지 않습니다.
연동당 키 하나
두 스크립트 사이에 하나의 키를 공유하지 마십시오. 하나가 유출되어도 다른 것들을 건드리지 않고 해당 연동만 취소하실 수 있습니다.
secret manager 안에 저장
비밀번호 관리자와 CI 볼트는 비밀을 저장된 상태에서 암호화하고 쉘 히스토리에서 멀리 떨어뜨립니다. 데스크톱의 일반 텍스트 파일은 저장이 아닙니다 — 엽서입니다.
일정에 따라 로테이션
60~90일마다 키를 취소하고 재생성하며, 기기를 분실, 판매, 또는 침해당한 직후에도 즉시 교체하십시오. Last Used 컬럼은 안전하게 은퇴시킬 수 있는 휴면 키를 찾는 데 도움을 줍니다.
Git에 커밋 금지
공개 저장소 유출은 노출된 API 토큰의 1순위 원인입니다. .gitignore, git-secrets 같은 스캐닝 도구를 사용하시고, 뭐라도 빠져나가면 즉시 취소하십시오.
기존 키 관리하기
지금까지 만드신 모든 키는 네 개의 컬럼이 있는 표에 나타납니다: Key Name, prefix (비밀의 첫 몇 글자 — 나머지는 해시됨), Last Used, 그리고 생성 날짜입니다. 각 행의 오른쪽에는 빨간색 Revoke 동작이 있습니다.
| 컬럼 | 무엇을 알려주는지 | 사용 방법 |
|---|---|---|
| Key Name | 어떤 연동이 그것을 소유하는지 | 취소하기 전에 이름을 해당 스크립트나 대시보드와 대조하십시오. |
| Key (prefix) | 비밀의 처음 몇 개의 공개 문자 | 볼트에 저장된 값과 대조하는 데 사용하십시오. |
| Last Used | 가장 최근 API 요청 시각 (또는 "Never") | 휴면 키("Never" 또는 몇 달 된 것)는 취소의 우선 후보입니다. |
| Date | 키가 생성된 시점 | 60~90일 로테이션 일정을 세우는 데 사용하십시오. |
| Revoke | 즉시 영구 비활성화 | 한 번의 클릭으로 키는 사망합니다. 그것을 사용하는 모든 스크립트는 즉시 작동을 멈춥니다. |
키를 취소하시려면 해당 행을 찾아 빨간색 Revoke 동작을 클릭하고 확인하십시오. 취소는 즉시적이고 되돌릴 수 없습니다. 키가 라이브 스크립트를 돌리고 있었다면, 그 스크립트는 바로 다음 요청에서 인증 오류를 반환하기 시작합니다 — 무언가 유출되었을 때 바로 그 동작을 원하시는 것입니다.
첫 번째 키를 — 안전하게 생성하십시오
위에서 전체 생성·관리 흐름을 보셨습니다. 새 탭에서 NoxHash를 열어 프로필로 이동하시고, 비밀번호 관리자를 준비한 상태로 다섯 단계를 따르셔서 비밀 문자열을 안전하게 잡아두십시오.
피해야 할 흔한 API 키 실수
매년 OWASP 프로젝트는 API Security Top 10을 발표하며 — 매년 유출되거나 잘못 처리된 인증 토큰이 상위권에 오릅니다. 여러분의 NoxHash 키도 예외가 아닙니다. 현실에서 가장 큰 피해를 일으키는 네 가지 실수는 다음과 같습니다.
- 공개 채팅이나 포럼에 키를 붙여넣기. Discord, Telegram, Reddit, GitHub issues, 그리고 "디버그 좀 도와주세요" 스크린샷은 모두 충분히 공개적이어서 유출로 간주됩니다. 봇들이 이런 채널을 적극적으로 스크랩해 살아있는 키를 수 초 안에 찾아냅니다.
- 비밀을 버전 관리 시스템에 커밋하기. 비공개 저장소조차 나중에 공개로 바뀌거나 침해된 노트북에 복제될 수 있습니다.
.env+.gitignore를 사용하시고, 모든 커밋에 시크릿 스캐너를 돌리십시오. - 클라이언트 측 앱 내부에 키를 하드코딩하기. 브라우저, 모바일 앱, 또는 데스크톱 바이너리에 배포되는 것은 사실상 공개입니다 — 리버스 엔지니어링은 몇 분이면 됩니다. 대신 API 호출을 여러분 자신의 서버를 통해 라우팅하십시오.
- 사용이 끝난 뒤에도 키를 오래 살려두기. Last Used 컬럼은 바로 이 이유로 존재합니다. 한 달 뒤에도 키가 Never를 표시하거나 90일 동안 건드리지 않았다면 취소하십시오.
좋은 소식: 위 상황 중 어느 것이 발생하더라도 복구는 동일하고 빠릅니다 — 키 취소, 새 키 생성, 연동 업데이트. 비밀번호 재설정도, 지원 티켓도, 이미 완료된 동작을 키가 승인한 경우가 아니라면 BTC 손실도 없습니다.
자주 묻는 질문
NoxHash를 평범하게 쓰기 위해서만 API 키가 필요한가요?
아닙니다. 웹 대시보드가 이미 잔액, 마이너, 수익을 실시간으로 보여드립니다. API 키는 외부 스크립트, 대시보드, 또는 모니터링 도구를 연결하실 때만 필요합니다. 대부분의 사용자는 한 번도 만들지 않으며 — 전혀 문제없습니다.
저장하는 것을 잊은 API 키를 잃어버리면 어떻게 되나요?
NoxHash는 키의 해시만 저장하므로 — 사용자도, 지원팀도 — 아무도 원래 비밀을 복구할 수 없습니다. 잃어버린 키를 취소해 비활성화하시고 새로운 것을 생성하십시오. 새 값으로 연동을 업데이트하시면 1분 안에 다시 작동합니다.
API 키를 몇 개까지 만들 수 있나요?
필요하신 만큼 만드실 수 있습니다. 서로 다른 연동마다 하나의 키를 권장합니다 — 예를 들어 서버 cron job, Notion 대시보드, 로컬 테스트 스크립트 각각에 별도의 키를 두십시오. 그래야 한 번의 유출이 모든 것을 한꺼번에 로테이션하도록 강요하지 않습니다.
키를 취소하면 마이닝이나 지갑에 영향을 주나요?
아닙니다. 키 취소는 그것을 사용하던 외부 요청만 중단시킵니다. 마이너는 계속 돌아가고, BTC 잔액은 그대로 있으며, 이전과 동일하게 이메일과 비밀번호로 로그인하실 수 있습니다. 취소된 키를 가진 스크립트만 고장 납니다.
누군가가 API 키만으로 제 BTC를 훔칠 수 있나요?
유출된 키는 심각한 보안 사고입니다 — 그렇게 다루십시오. 노출이 의심되기만 해도 프로필에서 즉시 취소하시고 대체 키를 생성하십시오. 로그인 2FA와 결합된 신속한 취소는 피해가 발생하기 전에 공격자를 차단하는 가장 빠른 방법입니다.
API 키를 얼마나 자주 로테이션해야 하나요?
좋은 기준선은 60~90일마다이며, 키를 보관하던 노트북이나 휴대폰을 분실, 판매, 또는 침해가 의심될 때마다 함께 교체하시는 것입니다. Last Used 컬럼이 도움이 됩니다: 몇 주 동안 건드리지 않은 키라면 취소하십시오 — 활동 중인 연동은 언제나 쉽게 재생성됩니다.
보안 안내이며, 금융 조언이 아닙니다
이 가이드는 NoxHash API 키 생성 및 관리 위생만을 다룹니다. API 키는 계정 접근 권한을 부여하므로 — 다른 어떤 크립토 자격 증명과 동일한 주의로 취급하십시오. 클라우드 마이닝에는 시장 리스크가 따릅니다: Bitcoin 수익은 변동하는 BTC 가격과 네트워크 난이도에 의존합니다. 감당할 수 있는 금액만 투자하시고, 해당 지역에 특화된 문의는 현지 세무 또는 법률 자문가와 상담하십시오.