웹훅 서명 헤더 추가 및 수신 팩스 파일 주소 변경

안녕하세요, 솔라피입니다.
웹훅을 더 안전하게 전달하기 위해 아래 두 가지가 변경되었음을 안내드립니다.
대부분의 고객님은 별도로 수정하실 것이 없으며, 보안을 위해 1번의 서명 검증 적용을 강력히 권장드립니다.
1. 웹훅 본문 서명 헤더(X-Solapi-Signature) 추가
웹훅 등록 시 secret 을 설정하신 경우, 모든 웹훅 요청에 X-Solapi-Signature 헤더가 추가로 포함됩니다.
형식:
t=<전송 시각(unix 초)>,v1=<서명>서명:
"<t>.<요청 본문 원본>"을 HMAC-SHA256 으로 계산한 hex 값서명 키: 웹훅에 설정하신 secret 을 SHA1 으로 해시한 소문자 hex 문자열. 지금 받고 계신
X-Solapi-Secret헤더 값과 같아서, 새로 발급받으실 키는 없습니다.
기존 X-Solapi-Secret 헤더는 이전과 같은 값으로 계속 전송되므로, 지금 검증 방식은 그대로 동작합니다. 다만 X-Solapi-Secret 은 매 요청 같은 값이라 한 번 노출되면 위조 요청을 구분할 수 없습니다. 새 서명은 요청 본문과 전송 시각에 묶여 있어 본문 변조와 재전송 공격까지 막을 수 있으니 서명 검증으로 바꾸시기를 강력히 권장드립니다.
검증 방법과 Node.js · Python · Java · PHP 예제 코드는 개발자 문서에서 확인하실 수 있습니다.
수신 서버가 처음 보는 헤더가 있으면 요청을 거절하도록 구현되어 있거나, X-Solapi-Signature 헤더가 있을 때 별도의 방식으로 검증하도록 구현되어 있다면 웹훅 수신이 실패할 수 있습니다. 웹훅 수신 실패(401 등)가 발생했다면 고객센터로 알려 주세요. 수신 서버를 수정하기 어려우신 경우 해당 웹훅에는 서명 헤더를 보내지 않도록 조치해 드립니다.
2. 수신 팩스(FAX-RECEIVE) 웹훅의 파일 주소 변경
수신 팩스 웹훅의 url 이 솔라피 API 주소의 보안 링크로 바뀝니다. 필드 이름과 위치는 그대로입니다.
변경 전:
https://***.s3.ap-northeast-2.amazonaws.com/...변경 후:
https://api.solapi.com/storage/v1/fax-files/<파일 ID>?exp=...&token=...
지금처럼 url 로 GET 요청을 보내시면 팩스 PDF 파일을 그대로 받으실 수 있습니다.
새 링크는 발급 뒤 90일 동안 열 수 있습니다. 90일이 지난 팩스는 콘솔의 팩스 수신함에서 열람하실 수 있습니다.
적용일 이전에 이미 받으신 주소는 이전과 같이 계속 열립니다.
수신 서버에서 외부로 나가는 요청을 도메인 허용 목록으로 제한하고 있다면
api.solapi.com을 허용해 주세요.받은
url이amazonaws.com주소인지 검사하거나 주소 형식을 파싱하는 코드가 있다면 새 형식에 맞게 확인해 주세요.웹훅으로 받은 주소를 저장해 두고 90일이 지난 뒤 다시 여는 경우, 그 전에 파일을 내려받아 보관해 주세요.
문의
변경 내용과 관련해 궁금하신 점은 고객센터로 문의해 주세요.
감사합니다.