API 키 관리
API 키는 인증에 사용되는 고유 식별자로, 사용자, 개발자 또는 프로그램이 API에 안전하게 액세스할 수 있도록 합니다. API 사용을 추적하고 제어하는 데 필수적이며, 남용을 방지하고 안전한 통신을 보장하는 데 도움이 됩니다.
Qlik Cloud API에 연결하기 위해 API 키 사용
API 키를 사용하여 Qlik REST API 참조와 상호 작용할 수 있습니다. API 액세스에는 Postman 또는 qlik-cli와 같은 도구를 사용할 수 있습니다. 자세한 내용은 Qlik API 개요 및 qlik-cli를 참조하십시오.
API 자격 증명은 Qlik Cloud에 대한 직접적인 프로그래밍 방식의 액세스를 제공하며 사용자 인터페이스에서 사용할 수 있는 워크플로에만 국한되지 않습니다. 최소 권한의 원칙을 사용하여 역할 및 OAuth 범위를 할당합니다. 관리자 자격 증명과 동일한 수준의 주의를 기울여 서비스 계정 및 API 자격 증명을 취급하십시오. 자세한 내용은 API 액세스 제어 및 신뢰 경계를 참조하십시오.
예: Postman을 사용하여 Qlik API에 연결
다음과 같이 하십시오.
-
Postman을 시작합니다.
-
HTTP 메서드를 GET으로 설정합니다.
-
Qlik Cloud API 엔드포인트의 URL을 입력합니다.
예를 들어 테넌트의 모든 공간을 나열하려면 다음과 같이 합니다.
https://your-tenant.eu.qlikcloud.com/api/v1/spaces
-
Auth 탭에서 Auth Type으로 Bearer Token을 선택합니다.
-
Token 필드에 API 키를 입력합니다.
-
Send를 클릭합니다.
요청이 성공하면 API는 JSON 응답을 반환합니다. 이 예에서 응답에는 공간 목록이 포함됩니다.
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 키 활동을 정기적으로 확인하여 의심스러운 동작을 식별합니다.