일반 설정
설정 > 일반 설정 화면에서는 현재 로그인한 계정과 선택된 조직의 기본 정보를 확인하고, SDK·API 연동에 사용하는 조직 API 키를 발급·재발급·비활성화할 수 있습니다.
1. 계정 정보
화면 상단 왼쪽 계정 정보 카드에서 현재 로그인한 사용자 정보를 확인합니다. 이 영역은 조회 전용이며, 사용자 정보 변경은 설정 > 사용자 관리에서 진행합니다.
| 항목 | 설명 |
|---|---|
| 이메일 | 로그인 계정 이메일 주소입니다. |
| 이름 | 계정에 등록된 표시 이름(닉네임)입니다. |
| 역할 | 조직 내 권한(소유자 / 관리자 / 사용자)입니다. |
2. 조직 정보
계정 정보 카드 오른쪽 조직 정보 카드에서 현재 선택된 조직의 기본 정보를 확인합니다. 조직을 선택하지 않았거나 정보를 불러올 수 없는 경우 안내 문구가 표시됩니다. 조직 정보 수정·추가·삭제는 설정 > 조직 설정에서 진행합니다.
| 항목 | 설명 |
|---|---|
| 조직 이름 | 조직의 표시 이름입니다. |
| 조직 ID | 시스템 내부에서 조직을 식별하는 고유 ID입니다. |
| 조직 식별자 | 조직 슬러그(slug)입니다. |
| 설명 | 조직 설명입니다(등록된 경우에만 표시). |
| 생성일 | 조직이 생성된 날짜입니다. |
3. API 키 관리
API 키 관리 섹션에서는 SDK 연동과 API 호출에 사용하는 조직 단위 API 키를 관리합니다. 이 키는 SDK 초기화 시 전달하는 apiKey 값과 동일하며, 이벤트 수집·어트리뷰션 등 모든 데이터 전송의 인증에 사용됩니다.
API 키 목록 표
| 컬럼 | 설명 |
|---|---|
| API 키 | 발급된 키 값입니다. |
| 상태 | 활성 또는 비활성 상태를 표시합니다. |
| 생성일 | 키가 발급된 일시입니다. |
| 마지막 사용 | 키가 마지막으로 사용된 일시입니다. 사용 이력이 없으면 사용 안 함으로 표시됩니다. |
| 작업 | 활성 키에 한해 비활성화 버튼이 표시됩니다. |
목록 하단에는 전체 N개 키 (활성: N, 비활성: N) 형태의 요약과 페이지 이동 컨트롤이 표시됩니다(키가 5개를 초과하면 페이지가 나뉩니다).
키 발급 / 재발급
새 키 생성 버튼을 눌러 새 키를 발급합니다. 키가 하나도 없는 경우 목록 영역에 첫 번째 키 생성 버튼이 표시됩니다.
이미 활성 키가 있는 상태에서 새 키를 발급하면, 기존 활성 키가 모두 자동으로 비활성화됩니다. 이 경우 확인 대화상자가 먼저 뜨며, 발급을 진행하면 SDK·API 연동에 사용 중인 키를 새 키로 모두 교체해야 합니다.
새 키가 발급되면 별도의 대화상자에 전체 키 값이 한 번 표시됩니다. 복사 버튼으로 키를 복사해 안전한 곳에 보관해야 합니다.
키 비활성화
활성 키 행의 작업 영역에 있는 삭제(휴지통) 아이콘을 누르면 비활성화 확인 대화상자가 표시됩니다. 비활성화된 키는 더 이상 API 호출에 사용할 수 없습니다.
4. 보안 알림
화면 하단의 보안 알림 안내에 따라 다음을 준수하시기 바랍니다.
| 항목 | 설명 |
|---|---|
| 안전한 보관 | 키를 안전한 곳에 보관하고, 소스 코드에 직접 포함하지 않습니다. |
| 유출 시 조치 | 키가 유출된 것으로 의심되면 즉시 해당 키를 비활성화하고 새 키를 발급합니다. |