API 키 관리
API 키는 인증을 위한 고유 식별자 역할을 하여 사용자, 개발자 또는 프로그램이 API에 안전하게 액세스할 수 있도록 합니다. API 키는 남용을 방지하기 위해 API 사용량을 추적하고 제어하는 데 사용되는 경우가 많습니다.
API 키 개요
관리 활동 센터의 API 키 섹션에서 테넌트와 관련된 모든 API 키를 볼 수 있습니다. 이름, ID 또는 소유자별로 키를 검색할 수 있습니다.
API 키의 상태는 다음과 같습니다.
- 활성: API 키가 현재 사용 중입니다.
- 만료됨: 만료 날짜에 도달했습니다.
- 취소됨: API 키가 취소되어 더 이상 사용할 수 없습니다.
테넌트 관리자는 API 키 생성을 활성화하고 API 키를 모니터링 및 취소할 수 있습니다. API 키를 생성, 편집 또는 삭제하려면 개발자 역할이 필요합니다. 테넌트 관리자는 자신을 포함한 사용자에게 이 역할을 할당할 수 있습니다.
테넌트에서 API 키 활성화
기본적으로 API 키는 비활성화되어 있습니다. 테넌트 관리자는 테넌트 내에서 API 키를 활성화할 수 있습니다.
다음과 같이 하십시오.
- 관리 활동 센터에서 설정으로 이동합니다.
- API 키 섹션을 찾아 API 키 사용을 선택합니다.
- 필요한 경우 다음 설정을 조정합니다.
최대 토큰 만료 변경: 새로 생성된 토큰의 만료를 수정합니다. 기존 API 키는 원래 만료 값을 유지합니다. 이 값에는 최대 제한이 없습니다.
정보 메모사용자 프로필 페이지의 API 키 섹션에 반영된 이 값의 변경 내용을 보려면 브라우저를 새로 고쳐야 할 수도 있습니다.- 사용자당 최대 활성 API 키 변경: 이 설정은 새 API 키에만 영향을 미칩니다. 제한에 도달하면 새 API 키 만들기가 거부됩니다. 최댓값은 1000입니다.
-
API 키 생성을 시작하려면 새로 생성을 클릭합니다. 그러면 새 키를 만들 수 있는 사용자 프로필 페이지의 API 키 섹션으로 리디렉션됩니다.
API 키 생성 중
프로필에서 API개의 키를 생성할 수 있습니다. 시작하기 전에 다음 요구 사항이 충족되는지 확인합니다.
-
활성 라이센스가 있습니다.
- 관리 활동 센터에서 API 키 사용이 켜져 있습니다.
- 사용자에게는 개발자 역할이 있습니다.
다음과 같이 하십시오.
-
오른쪽 상단에 있는 사용자 프로필 아이콘을 클릭하고 프로필 설정을 선택합니다.
-
API 키 섹션에서 새 키 생성을 클릭합니다.
-
API 키에 대한 설명과 만료 시간을 제공합니다.
-
키를 만들려면 만들기를 클릭합니다.
-
생성된 API 키를 즉시 복사하여 안전하게 보관합니다. 키는 나중에 검색할 수 없습니다.
만들기 후 API 키 이름을 편집하거나 필요한 경우 삭제할 수 있습니다.
API 키를 사용하면 Postman과 같은 도구를 사용하여 qlik.dev에서 REST API 참조를 탐색하거나 qlik-cli를 설치하여 명령줄에서 Qlik 기능에 직접 액세스할 수 있습니다. 자세한 내용은 Qlik API 개요 및 qlik-cli를 참조하십시오.
API 키 모니터링 및 취소
테넌트 관리자는 보안을 위해 API 키 활동을 모니터링해야 합니다. 의심스러운 활동이 감지되면 API 키를 취소할 수 있습니다.
API 키를 취소하면 API 키가 즉시 비활성화되어 이에 의존하는 진행 중인 프로세스나 통합에 영향을 미친다는 점을 기억해야 합니다. 취소는 되돌릴 수 없으며 취소된 API 키는 다시 활성화될 수 없습니다.
다음과 같이 하십시오.
-
관리 활동 센터에서 이벤트 섹션으로 이동합니다.
-
특정 API 키의 과도한 사용과 같은 의심스러운 활동을 찾아보십시오.
-
이벤트 옆에 있는 을 클릭하여 세부 정보를 확장하고 API 키 ID를 복사합니다.
-
API 키 섹션으로 이동하여 해당 ID를 사용하여 API 키를 검색합니다.
-
키 옆에 있는 을 클릭하고 취소를 선택합니다. 활성 상태인 키만 취소할 수 있습니다.
-
여러 API 키를 취소하려면 표에서 해당 키를 선택하고 오른쪽 상단에 있는 취소를 클릭합니다.
API 키 삭제
API 키를 제거하면 시스템에서 영구적으로 제거됩니다. API 키를 제거하면 되돌릴 수 없으며 액세스 권한이 즉시 제거됩니다. 이 작업으로 인해 키에 의존하는 진행 중인 프로세스나 통합이 중단되지 않는지 확인합니다.
API 키를 삭제하려면 개발자 역할이 필요합니다.
다음과 같이 하십시오.
-
오른쪽 상단에 있는 사용자 프로필 아이콘을 클릭하고 프로필 설정을 선택합니다.
-
API 키 섹션을 선택합니다.
-
삭제하려는 API 키 옆에 있는 을 클릭하고 삭제를 선택합니다.
-
모든 키를 제거하려면 API 키 목록 위에 있는 모두 제거를 클릭합니다.