OKX에 로그인할 때 "인증 코드가 만료되었습니다"를 수정하는 방법은 무엇입니까?

시간 동기화 문제

1. OKX에서는 API 요청의 타임스탬프가 서버 시간의 ±30초 이내여야 합니다. 불일치하면 '인증 코드 만료' 오류가 발생합니다.

2. 개발자는 /api/v5/public/time 을 통해 현재 OKX 서버 시간을 가져와서 로컬 시스템 시간 대신 해당 값을 사용해야 합니다.

3. datetime.utcnow()가 동기화된 것처럼 보이더라도 마이크로초 수준의 드리프트 또는 시간대 구성 오류로 인해 서명이 거부될 수 있습니다.

4. 일부 Python 환경은 기본적으로 UTC 시간대를 인식하지 못하는 순진한 날짜/시간 객체로 설정되어 문자열 형식화 중에 자동 변환 오류가 발생합니다.

5. ISO 8601 형식은 Z 로 끝나야 하며 밀리초는 정확히 세 자리로 잘려야 합니다(예: 2026-05-28T11:24:36.123Z ).

서명 생성 오류

1. HMAC-SHA256 서명은 타임스탬프, 대문자 HTTP 메서드, 요청 경로 및 본문을 엄격한 순서로 연결해야 합니다.

2. 빈 JSON 본문은 {} 또는 None 이 아닌 빈 문자열( '' )로 전달되어야 합니다. 그렇지 않으면 메시지 다이제스트가 유효하지 않게 됩니다.

3. 비밀 키는 hmac.new() 의 첫 번째 인수로 사용되어야 합니다. 키와 메시지의 순서를 반대로 바꾸면 잘못된 서명이 생성됩니다.

4. Base64 인코딩은 16진수 인코딩 또는 문자열 래핑 버전이 아닌 원시 다이제스트 바이트에 직접 적용되어야 합니다.

5. 비밀 키 또는 암호 문구에 후행 공백이나 보이지 않는 유니코드 문자가 있으면 서명이 자동으로 무효화됩니다.

API 키 구성 실수

1. 거래 또는 출금 권한이 있는 API 키에는 IP 바인딩이 필요합니다. 바인딩 해제된 키는 14일 동안 활동이 없으면 자동으로 비활성화됩니다.

2. 프로덕션 도메인에서 테스트넷 API 키를 사용하거나 그 반대의 경우 환경 불일치를 나타내는 명시적인 오류 코드 없이 즉시 인증 실패가 발생합니다.

3. 암호는 대소문자를 구분하며 되돌릴 수 없는 해시로 저장됩니다. 문자를 하나만 잘못 입력해도 잘못된 API 키와 구별할 수 없는 401 응답이 생성됩니다.

4. 소스 파일의 자격 증명을 하드코딩하는 것은 보안 모범 사례를 위반하며 디버깅 또는 버전 제어 사고 중에 키가 노출될 수 있습니다.

5. 동일한 API 키를 사용하여 여러 번 동시에 로그인을 시도하면 인증 엔드포인트에서 속도 제한이 트리거되어 유효한 요청이 일시적으로 차단될 수 있습니다.

네트워크 및 라우팅 제약

1. 특정 프록시 서버나 회사 방화벽을 통해 라우팅된 요청은 OK-ACCESS-TIMESTAMP 헤더를 제거하거나 변경하여 서버 측에서 만료 감지를 유발할 수 있습니다.

2. 로드 밸런서 또는 CDN은 인증이 필요한 경우에도 REST 엔드포인트에 대한 응답을 캐시하여 세션 전체에서 오래된 타임스탬프가 재사용되는 경우가 있습니다.

3. OS 수준에서 듀얼 스택 폴백이 비활성화된 경우 IPv6 전용 네트워크 구성이 OKX의 DNS 레코드를 올바르게 확인하지 못할 수 있습니다.

4. 오래된 암호화 제품군 또는 인증서 고정 불일치로 인한 TLS 핸드셰이크 실패로 인해 헤더가 인증 계층에 완전히 도달하지 못합니다.

5. 지리적 위치 기반 라우팅은 글로벌 api.okx.com 도메인보다 더 엄격한 유효성 검사 규칙을 적용하는 지역 엔드포인트(예: myokx.com)로 요청을 전달할 수 있습니다.

자주 묻는 질문

Q: 60초 이내에 인증 코드를 입력했는데도 OKX가 인증 코드를 거부하는 이유는 무엇입니까? A: 거부는 사용자 입력 타이밍에 관한 것이 아니라 서버 측 서명 확인 실패를 반영합니다. '만료됨' 라벨은 SMS 코드 수명이 아니라 서명된 요청 내의 타임스탬프 매개변수를 나타냅니다.

Q: 여러 요청에서 동일한 타임스탬프를 재사용할 수 있습니까? A: 아니요. 각 요청에는 고유하고 단조롭게 증가하는 타임스탬프가 있어야 합니다. 값을 재사용하면 재생 방지 보호가 트리거되고 오류 코드 10000 이 반환됩니다.

Q: 2단계 인증을 활성화하면 API 로그인 흐름에 영향을 미치나요? 답: 그렇습니다. TOTP 또는 하드웨어 키 등록은 API 액세스에 대한 SMS 기반 확인을 완전히 비활성화합니다. API 키 + 암호 + 서명된 요청만 허용됩니다.

Q: 실시간 요청을 제출하지 않고 내 서명 논리를 확인할 수 있는 방법이 있습니까? 답: 그렇습니다. OKX는 서명되지 않은 GET 요청을 허용하는 공개 테스트 엔드포인트 /api/v5/public/time을 제공합니다. 개인 끝점에 서명하기 전에 기본 연결 및 시간 정렬을 확인하는 데 사용합니다.