주요 변경 사항
API key를 다시 확인할 수 있습니다. Dashboard에서 key를 생성한 뒤 자리를 비웠다가 다음 주에 돌아와도 클릭 한 번으로 확인할 수 있습니다. 또한 API playground의 몇 가지 불편한 점을 개선하여 curl 재현 코드가 실제로 즉시 실행되도록 수정했습니다.
새로운 기능
다시 확인할 수 있는 API key
대부분의 SaaS API는 key를 한 번만 보여줍니다. 분실하면 재생성해야 합니다. 기존 key를 사용하던 모든 서비스를 업데이트하고 다시 배포해야 합니다. 다들 겪어본 번거로운 과정입니다.
FourA는 이 방식을 개선하고자 변경했습니다.
앞으로 생성되는 key는 다시 확인할 수 있는 복사본이 함께 제공됩니다. Dashboard를 열고 key 옆의 눈 아이콘을 클릭한 뒤 확인을 누르면 전체 pk_live_... 값이 표시됩니다. 15초 후 자동으로 숨겨지며 페이지에서 지워집니다. 모든 확인 기록은 감사 로그에 저장됩니다.
주요 구현 세부사항은 다음과 같습니다.
- 요청을 인증하는 경로는 변경 없이 단방향 해시로 유지됩니다. 다시 확인할 수 있는 복사본은 해시 경로와 별도로 저장되는 암호화된 두 번째 아티팩트(AES-256-GCM)입니다. 암호화 키를 교체하더라도 인증 검증은 정상적으로 작동합니다.
- 이번 변경 이전에 생성된 key는 확인할 수 없습니다. 다시 읽어올 암호화된 복사본이 없기 때문입니다. 기존 key는 해시 경로를 통해 계속해서 정상 작동합니다. Dashboard에 작은 자물쇠 표시와 "regenerate to enable" 안내가 표시되어 새 기능이 적용된 key와 그렇지 않은 key를 구분할 수 있습니다.
- 접근 제어는 기존 keys API와 동일합니다. 본인의 key를 확인할 수 있습니다. 조직 관리자는 조직 내 모든 key를 확인할 수 있습니다. Team-write 권한이 있는 멤버는 팀 key를 확인할 수 있습니다. 읽기 전용 역할은 확인할 수 없습니다.
- 조직 관리자가 팀원을 대신해 생성한 key도 동일한 규칙에 따라 확인할 수 있습니다. 이 기능은 생성 방식이 아닌 key 자체에 종속됩니다.
FourA key를 비밀번호 관리 프로그램에 일일이 저장해 두지 않아도 됩니다.
실제 curl 명령어로 동작하는 재현 코드
Playground에서 작성하는 모든 요청 옆에는 바로 복사해 사용할 수 있는 curl 명령어가 제공됩니다. UI에서 요청을 올바르게 구성한 뒤 curl 명령어를 복사하여 스크립트, 팀원의 터미널, 버그 리포트에 바로 붙여넣어 사용하는 방식입니다.
이번 주 전까지는 curl 명령어에 key가 들어갈 자리가 플레이스홀더(PASTE_PLAINTEXT_FOR_my-key)로 되어 있어 실행 전에 직접 입력해야 했습니다. 재현 코드가 아니라 템플릿에 불과했습니다.
이제 개선되었습니다. 다시 확인할 수 있는 key의 경우 curl 패널에 Reveal 버튼이 표시됩니다. 버튼을 클릭하면 실제 평문이 curl 명령어에 반영되며, 전체를 복사해 터미널에 붙여넣으면 바로 실행됩니다. 다시 클릭하면 숨겨집니다. 표시된 값은 해당 세션의 메모리에만 유지되며 디스크에 저장되지 않습니다. 또한 curl 패널은 key 드롭다운과 연동되어 key를 변경해도 이전 값이 유출되지 않습니다. 이전의 다시 확인할 수 없는 key는 평문을 복원할 수 없으므로 플레이스홀더가 그대로 유지됩니다.
진행 중인 요청을 위한 Cancel 버튼
느린 대상 사이트를 상대로 playground request를 보냈을 때 이전에는 timeout이 날 때까지 기다리는 것 외에 방법이 없었습니다. 이제 로딩 패널에 Cancel 버튼을 추가했습니다. 이 버튼을 클릭하면 request가 깔끔하게 중단되며, response 영역에는 위협적인 에러 메시지 대신 "Request canceled."와 함께 대기 상태로 돌아갑니다.
작은 변화지만, 이제 playground는 단순한 데모가 아니라 실질적인 툴처럼 느껴집니다. 불안정한 사이트를 테스트하고, 중단하고, request를 조정한 뒤, 하염없이 기다릴 필요 없이 즉시 다시 시도할 수 있습니다.
내부 구현 세부사항
초기 배포 이후 cURL Reveal 버튼에 세 가지 작은 개선 작업이 이루어졌습니다. 에러 토스트에 기계 에러 코드 대신 친절한 메시지가 표시되고, 다른 예외가 발생해도 버튼이 "Revealing…" 상태에 갇히지 않으며, reveal을 지원하지 않는 키에서 버튼이 계속 표시되던 CSS 우선순위 버그를 해결했습니다.
해당 문제들을 겪으셨다면 이제 모두 수정되었을 것입니다. 겪지 않으셨다면 신경 쓰지 않으셔도 됩니다.
생성하고, 복사하고, 붙여넣은 뒤 잊어버리셔도 괜찮습니다. 나중에 다시 돌아오세요. Dashboard가 기억합니다.