S-CDN 포털 API Key 관리: 조회·등록·유효기간 수정 전 확인할 항목

배포 작업에 쓰는 API Key를 누가 발급했는지, 언제까지 사용할 예정인지 바로 찾을 수 있나요? 키가 목록에 있다는 사실과 현재 연동이 그 키를 사용한다는 사실은 다릅니다. S-CDN 포털에서 기간을 바꾸기 전에는 계정 화면의 대상과 실제 업무의 사용처를 먼저 맞춰 보는 것이 출발점이죠.

계정에서 발급한 API Key는 어디서 확인하나요?

로그인한 계정의 계정정보에서 API Key 탭을 열면, 해당 계정이 발급받은 키 목록을 확인할 수 있습니다.

S-CDN 공식 포털 매뉴얼의 API Key 관리는 로그인 후 우측 상단의 계정 ID와 계정정보를 차례로 선택하도록 안내합니다. 계정정보 페이지 상단의 API Key 탭에서 해당 계정이 발급받은 모든 API Key를 조회하는 흐름이죠.

이 목록을 조직 전체의 키 목록이나 실제 호출 이력으로 확대해서 읽지는 마세요. 매뉴얼이 설명하는 조회 범위는 해당 계정이 발급받은 키입니다. 먼저 어떤 계정으로 로그인했는지 확인해야 하죠.

운영 문서에는 계정, 담당 업무, 사용처를 함께 정리하는 방법을 제안해요. 이는 팀에서 작성할 확인 자료이며 포털이 사용처를 자동으로 찾아 준다는 뜻은 아니에요. 화면을 공유할 때는 실제 키 값을 가리고 필요한 설정 정보만 남겨 두세요.

기간 제한 없음과 직접 설정은 어떻게 다른가요?

기간 제한 없음은 유효기간 없이 등록하고, 직접 설정은 시작일과 종료일을 지정하는 방식으로 구분합니다.

API Key 등록 버튼을 누르면 등록 팝업이 나타납니다. 공식 매뉴얼은 기간 설정에서 두 방식을 선택할 수 있다고 안내하죠.

기간 제한 없음은 만료일을 따로 두지 않는 설정이죠. 담당자가 바뀌어도 계속 보관해야 한다거나, 한 번 정하면 관리가 끝난다는 뜻은 아닙니다. 기간 설정과 키를 유지할 업무상의 필요는 나누어 검토하는 편이 좋아요.

기간을 직접 정할 때도 모든 조직에 같은 유효기간을 권하지 않습니다. 실제로 키를 쓰는 업무와 변경 가능한 시점을 먼저 확인하는 방법을 제안합니다. 짧은 기간을 선택했다는 사실만으로 연동 점검까지 끝난 것은 아니죠.

등록할 때 시작일과 종료일은 어떻게 정하나요?

시작일과 종료일은 연동에 필요한 기간을 먼저 정리한 뒤, 등록 화면에서 선택 가능한 날짜와 대조합니다.

매뉴얼은 직접 설정의 시작일과 종료일을 당일 이후로 설정할 수 있다고 설명합니다. 이 안내에 없는 종료 시각이나 기준 시간대를 임의로 더해 계산하지 않습니다. 날짜 경계가 중요한 작업이라면 실제 입력 화면과 이용 조건을 확인하는 것이 좋아요.

예를 들어 특정 작업에 사용할 키라면 작업을 시작할 날과 키가 필요한 마지막 날을 먼저 기록합니다. 같은 작업을 재실행하거나 일정이 바뀔 가능성도 담당자와 함께 검토하죠. 이는 기간 선택을 위한 운영 예시이며 자동 연장 기능이 있다는 설명은 아니죠.

포털에 날짜를 저장한 뒤에는 의도한 설정이 남았는지 다시 확인하세요. 설정을 확인했다는 기록과 실제 연동이 정상 동작했다는 기록도 구분합니다. 날짜를 골랐다는 이유만으로 업무가 예정대로 끝날 것이라고 보장하지 않아요.

기존 API Key에서 수정할 수 있는 값은 무엇인가요?

기존 API Key의 수정 화면에서는 삭제되지 않은 키를 대상으로 유효기간 설정을 변경할 수 있습니다.

수정할 API Key 버튼을 선택하면 대상 Key 값이 표시되고, 유효기간 설정을 변경할 수 있습니다. 매뉴얼은 이 수정 작업이 삭제되지 않은 Key를 대상으로 한다고 설명합니다. 이미 삭제한 키를 이 화면에서 복구할 수 있다고 읽지 않는 것이 좋죠.

여기서 유효기간 수정과 새 키 발급을 구분해야 합니다. 기간을 수정한 작업을 키 문자열 교체나 연동 설정 교체까지 마친 작업으로 기록하지 마세요. 무엇을 변경했는지가 달라지면 이후 확인할 항목도 달라지죠.

기존 기간을 줄이거나 늘릴 때는 해당 키를 쓰는 업무와 변경 이유를 함께 남기는 방법을 제안해요. 포털에 이런 기록이 자동으로 생성된다고 단정하는 것은 아니에요. 담당자가 나중에 대상과 의도를 확인할 수 있는 자체 기록을 준비합니다.

계정의 도메인·퍼지·메뉴 접근은 S-CDN 포털 권한 분리: 도메인·퍼지·메뉴 접근을 나누는 방법에서 다룹니다. API Key 유효기간 설정을 계정 권한을 세분화하는 기능과 같은 것으로 보지 않아야 하죠.

연동에 사용 중인 키를 바꾸기 전 무엇을 확인하나요?

계정과 대상 키, 실제 사용처를 확인한 뒤 기간 수정과 삭제·교체가 업무에 미칠 영향을 따로 검토합니다.

먼저 자동 작업이나 연동 설정에서 해당 키를 사용하는 곳을 담당자와 확인하는 순서를 제안합니다. 키 원문을 공유 문서에 모으기보다, 승인된 보관 위치와 업무 정보를 기준으로 대조하세요. 포털 목록만으로 모든 사용처가 확인되는 것은 아니죠.

위 표는 팀의 변경 검토를 위한 예시이며 제품에 기본 제공되는 관리 항목 목록은 아니죠. 자동 교체나 무중단 전환을 보장하는 절차로 설명하지 않습니다. 적용 방법과 확인 범위는 사용하는 연동에 맞춰 정해야 하죠.

공식 매뉴얼의 삭제 기능은 확인 팝업에 대상 Key를 표시한 뒤 삭제 버튼으로 처리하는 흐름입니다. 사용처를 모르는 상태에서 목록 정리를 위해 먼저 삭제하는 방식은 권하지 않아요. 기간만 바꿀 작업인지, 키 자체를 더 이상 사용하지 않을 작업인지 먼저 구분하세요.

시크릿 보관과 회전의 일반 원칙은 시크릿 관리 입문: 하드코딩된 Access Key가 사고가 되기 전에에서 확인할 수 있습니다. 그 글에서 소개한 다른 도구의 자동화 기능을 S-CDN 포털의 기능으로 옮겨 설명하지 않아요.

S-CDN 도입이나 포털의 API Key 관리 범위가 궁금하다면, 필요한 연동 업무와 기간 조건을 정리해 스피디에 문의할 수 있습니다. 문의 내용에는 실제 키 값을 넣지 말고 확인하려는 설정과 운영 조건을 적어 주세요.

이것만 기억하세요

자주 묻는 질문 (FAQ)