타사 봇을 위해 Gate.io에서 API 키를 설정하는 방법은 무엇입니까? (보안 팁)

Gate.io에서 API 키 생성

1. 공식 웹사이트나 모바일 애플리케이션을 통해 Gate.io 계정에 로그인하세요.

2. 오른쪽 상단으로 이동하여 프로필 아이콘을 클릭한 다음 계정 관리 → API 관리를 선택합니다.

3. 최신 통합을 위한 API v4 키 또는 레거시 호환성을 위한 API v2 키 중에서 선택하세요. 새로운 설정에는 v4를 적극 권장합니다.

4. 새 API 키 생성을 클릭하고 "TradingBot-Production" 또는 "Monitoring-Readonly"와 같은 설명 이름을 입력합니다.

5. 최소 권한 원칙을 엄격히 준수하여 권한을 구성합니다. 데이터 모니터링을 위해 읽기만 활성화하고, 주문 실행이 필요한 경우에만 거래를 추가하고, 반드시 필요한 경우가 아니면 출금을 활성화하지 마십시오.

보안 구성 필수 사항

1. 봇을 호스팅하는 서버의 고정 공용 IPv4 주소를 입력하여 IP 화이트리스트를 활성화합니다. 이렇게 하면 다른 네트워크의 무단 액세스 시도가 차단됩니다.

2. “main” 또는 “bot”과 같은 일반적인 용어를 피하고 기능과 환경을 반영하는 추측할 수 없는 고유한 API 키 이름을 할당합니다.

3. 일반 텍스트 파일, 버전 제어 저장소 또는 웹 서버를 통해 액세스할 수 있는 구성 파일에 API 키를 저장하지 마십시오.

4. 환경 변수 또는 보안 비밀 관리자(예: HashiCorp Vault 또는 AWS Secrets Manager)를 사용하여 런타임에 자격 증명을 삽입합니다.

5. 테스트 또는 폐기 후 즉시 사용하지 않는 API 키를 비활성화합니다. Gate.io는 계정당 최대 5개의 활성 v4 키를 허용합니다.

개인 끝점에 대한 서명 처리

1. Gate.io v4에서는 모든 개인 요청에 세 가지 필수 HTTP 헤더( X-Gate-Apikey , X-Gate-Signature 및 X-Gate-Timestamp ) 를 포함해야 합니다.

2. 서명은 메소드, 엔드포인트, 타임스탬프 및 요청 본문(있는 경우)으로 구성된 표준 문자열에 대해 HMAC-SHA512를 사용하여 생성되어야 하며 개행 문자로 결합되어야 합니다.

3. 타임스탬프는 Unix epoch 이후의 초 단위여야 하며 Gate.io의 서버 시간에서 60초 이상 벗어나서는 안 됩니다. NTP를 통해 시스템 시계를 동기화하세요.

4. 타임스탬프 재사용을 피하세요. 각 요청은 신선하고 단조롭게 증가하는 값을 전달해야 합니다.

5. 서명 생성 중에 비밀 키를 하드코딩하지 마십시오. 메모리 전용 버퍼를 통해 비밀 키를 안전하게 전달하고 사용 후에는 0으로 설정하십시오.

Python Quant 도구와 통합

1. pip: pip install Gate-api 를 사용하여 공식 Gate-api-python SDK를 설치합니다.

2. 올바른 호스트를 지정하여 API 키와 비밀로 클라이언트를 초기화합니다. 현물 거래의 경우 https://api.gateio.ws/api/v4 , 영구 계약의 경우 https://api.gateio.ws/api/v4/futures .

3. 다양한 권한 범위에 대해 별도의 API 클라이언트를 인스턴스화합니다. 예를 들어 잔액 폴링을 위한 읽기 전용 인스턴스 하나와 주문 제출을 위한 거래 가능 인스턴스 하나를 인스턴스화합니다.

4. 속도 제한 응답(HTTP 429), 인증 실패(HTTP 401) 및 네트워크 시간 초과를 처리하려면 항상 try-Exception 블록으로 API 호출을 래핑하세요.

5. 로그에 민감한 매개변수를 노출하지 않고 디버깅하기 위해 X-Request-Id 헤더에 반환된 요청 ID를 기록합니다.

자주 묻는 질문

Q: 여러 봇에서 동일한 API 키를 재사용할 수 있습니까? 아니요. 각 봇에는 좁은 범위의 권한과 고유한 IP 화이트리스트 규칙을 갖춘 전용 API 키가 있어야 합니다.

Q: 내 API 키가 실수로 노출되면 어떻게 되나요? Gate.io의 API 관리 대시보드를 통해 즉시 취소하고 대체품을 생성하세요. 비정상적인 거래 또는 인출에 대한 최근 활동 로그를 감사합니다.

Q: Gate.io는 서명을 위해 하드웨어 보안 모듈(HSM)을 지원합니까? Gate.io는 HSM을 직접 통합하지 않지만 개발자는 서명된 페이로드를 제출하기 전에 FIPS 호환 암호화 라이브러리를 사용하여 오프라인 서명 생성을 구현할 수 있습니다.

Q: 실제 자금을 위험에 빠뜨리지 않고 API 키를 테스트할 수 있는 방법이 있습니까? 예. Gate.io는 선물 API에 대한 데모 거래 모드를 제공하며 읽기 권한만 있는 현물 API 키는 통합 테스트 중에 재정적 위험을 초래하지 않습니다.