업로드 체크섬 알고리즘 단일화
아틀라시안이 2026년 11월 9일 개발자 변경 이력을 통해 Forge Object Store 업로드 API의 체크섬 허용 알고리즘을 SHA256으로 통일한다고 공지했다. 2026년 12월 10일부터 SHA1, CRC32, CRC32C 등 다른 체크섬 유형을 사용하는 요청은 HTTP 400으로 거부할 예정이다.
적용 대상은 @forge/object-store 패키지의 createUploadUrl과 createPublicUploadUrl 메서드, 그리고 @forge/bridge 패키지의 objectStore API에 포함된 GeneratedMetadata의 checksumType 필드다. 공지는 해당 필드에서 SHA256 이외의 값을 더 이상 허용하지 않는 변경으로 설명했다.
해시 계산과 API 인자 함께 점검
회사가 안내한 대응은 앱 코드에서 모든 객체의 해시를 SHA256으로 계산하도록 바꾸는 것이다. 두 업로드 메서드에 checksumType을 직접 전달하는 앱은 값을 SHA256으로 수정해야 한다. 체크섬은 데이터의 무결성을 확인하는 값이므로, 명칭만 바꾸는 것이 아니라 실제 해시 계산 방식도 함께 맞춰야 한다.
아틀라시안은 checksumType에서 SHA256 외 유형을 제거한 @forge/object-store의 새로운 주 버전을 배포할 계획도 밝혔다. 새 버전이 제공되면 업그레이드해 변경된 API 형식에 맞추라는 안내다. 이번 공지에는 새 주 버전의 구체적인 배포일은 제시되지 않았다. 기존에 SHA256을 사용하는지와 별개로 패키지 변경 내용도 확인할 필요가 있다.
시행일 전 업로드 경로 호환성 확인
개발 실무 관점에서는 두 업로드 메서드와 브리지 API를 사용하는 경로를 찾아, 해시 생성 방식과 전달 인자가 일치하는지 시험하는 작업이 핵심이다. 시행일 이후 다른 유형을 보내면 요청이 거부된다는 점이 직접적인 운영 영향이다.
회사는 기존에 다른 체크섬 유형을 쓰고 있어 한 달의 전환 기간 안에 이행하기 어렵다면 ECOHELP 지원 티켓으로 문의하라고 안내했다. 공식 발표는 API 허용 알고리즘과 전환 일정에 관한 내용이며, 특정 취약점이나 실제 악용 사례는 제시하지 않았다.
참고 자료: 아틀라시안 개발자 변경 이력: 2026년 11월 9일 Forge Object Store 공지
){kind=small}
){kind=small}
){kind=small}
){kind=small}