API 키 관리
API 키는 인증에 사용되는 고유 식별자로, 사용자, 개발자 또는 프로그램이 API에 안전하게 액세스할 수 있도록 합니다. API 사용을 추적하고 제어하는 데 필수적이며, 남용을 방지하고 안전한 통신을 보장하는 데 도움이 됩니다.
API 키를 사용하여 Qlik Cloud API에 연결
API 키를 사용하여 Qlik REST API 참조와 상호 작용할 수 있습니다. Postman 또는 qlik-cli와 같은 도구를 사용하여 API에 액세스할 수 있습니다. 자세한 내용은 Qlik API 개요 및 qlik-cli를 참조하십시오.
예: Postman을 사용하여 Qlik API에 연결
다음과 같이 하십시오.
-
Postman를 시작합니다.
-
GET을 수행할 HTTP 메서드를 설정합니다.
-
Qlik Cloud API 종료 지점의 URL을 입력합니다.
예를 들어, 테넌트의 모든 공간을 나열하려면:
https://your-tenant.eu.qlikcloud.com/api/v1/spaces
-
인증 탭에서 인증 유형으로 전달자 토큰을 선택합니다.
-
토큰 필드에 API 키를 입력합니다.
-
보내기를 클릭합니다.
요청이 성공하면 API는 JSON 응답을 반환합니다. 이 예에서 응답에는 공백 목록이 포함됩니다.
테넌트에서 API 키 활성화
테넌트 관리자는 사용자가 테넌트에서 API 키를 생성할 수 있는지 여부를 제어할 수 있습니다.
다음과 같이 하십시오.
- 관리 활동 센터에서 설정으로 이동합니다.
- API 키에서 API 키 사용을 켜거나 끕니다.
API 키 설정 구성
다음과 같이 하십시오.
관리 활동 센터에서 설정 > API 키로 이동합니다.
필요에 따라 다음 설정을 조정합니다.
최대 토큰 만료 기간 변경: 새로 생성된 API 토큰의 만료 기간을 설정합니다. 기존 API 키는 원래 만료 값을 유지합니다. 이 값에는 상한이 없습니다.
- 사용자당 활성 API 키의 최댓값 변경: 사용자가 가질 수 있는 API 키의 수에 대한 제한을 설정합니다. 이 제한은 새 키에만 적용됩니다. 제한에 도달하면 사용자는 추가 키를 만들 수 없습니다. 최댓값은 1000입니다.
개인 설정 페이지의 API 키 섹션에 변경 사항이 반영된 것을 보려면 브라우저를 새로 고쳐야 할 수도 있습니다.
API 키 생성 및 관리
API 키 생성 중
새로운 API 키를 생성하려면 API 키 관리 권한이 있는 사용자 지정 역할이 있어야 하거나 사용자 기본값 설정에서 해당 권한을 활성화해야 합니다.
다음과 같이 하십시오.
-
사용자 프로필 아이콘을 클릭하고 설정을 선택합니다.
-
API 키 섹션으로 이동하여 새 키 생성을 클릭합니다.
-
API 키에 대한 설명을 제공하고 만료 시간을 설정합니다.
-
키를 만들려면 만들기를 클릭합니다.
-
생성된 API 키를 복사하여 안전하게 보관합니다. 나중에 키를 찾을 수 없습니다.
API 키 편집
API 키는 생성 후 이름을 변경할 수 있습니다.
API 키 삭제
다음을 수행합니다.
-
사용자 프로필 아이콘을 클릭하고 설정을 선택합니다.
-
API 키 섹션으로 이동합니다.
-
삭제하려는 API 키 옆에 있는
을 클릭하고 삭제를 선택합니다.
-
모든 키를 제거하려면 키 목록 위에 있는 모두 삭제를 클릭합니다.
API 키 모니터링 및 취소
테넌트와 관련된 모든 API 키는 관리 활동 센터의 API 키 섹션에서 볼 수 있습니다. 이름, ID 또는 소유자별로 키를 검색할 수 있습니다.
API 키 상태
API 키의 상태는 다음과 같습니다.
- 활성: API 키가 현재 사용 중입니다.
- 만료됨: 만료 날짜에 도달했습니다.
- 취소됨: API 키가 취소되어 더 이상 사용할 수 없습니다.
API 키 취소
테넌트 관리자로서 API 키 활동을 적극적으로 모니터링하는 것은 보안을 유지하는 데 필수적입니다. 의심스러운 활동이 감지되면 API 키를 취소할 수 있습니다.
다음과 같이 하십시오.
-
관리 활동 센터에서 이벤트로 이동합니다.
-
특정 API 키의 과도한 사용과 같은 의심스러운 활동을 찾아보십시오.
-
이벤트 옆에 있는
을 클릭하여 세부 정보를 확장하고 API 키 ID를 복사합니다.
-
API 키 섹션으로 이동하여 해당 ID를 사용하여 API 키를 검색합니다.
-
키 옆에 있는
을 클릭하고 취소를 선택합니다. 활성 상태인 키만 취소할 수 있습니다.
-
여러 API 키를 취소하려면 표에서 해당 키를 선택하고 오른쪽 상단에 있는 취소를 클릭합니다.
API 키 관리를 위한 모범 사례
-
키를 기밀로 유지: API 키를 안전하게 저장하고 공개 코드 리포지토리에 노출하지 마십시오.
-
정기적으로 다시 생성: 보안을 강화하기 위해 API 키를 주기적으로 다시 생성합니다.
-
사용량 모니터링: API 키 활동을 정기적으로 확인하여 의심스러운 동작을 식별합니다.