API 토큰
개요
이 섹션에서는 API 토큰을 생성하고 관리할 수 있습니다.
API 토큰은 Zabbix API에서 인증에 사용됩니다.
각 API 토큰은 단일 사용자에게 할당되며 해당 사용자의 권한을 상속합니다.
API 토큰으로 인증된 요청은 연결된 사용자의 역할 및 권한에 따라 승인됩니다.
이름, 토큰이 할당된 사용자, 만료일, 토큰을 생성한 사용자, 또는 상태(사용/사용 안 함)로 API 토큰을 필터링할 수 있습니다. 목록에서 토큰 상태를 클릭하면 빠르게 토큰을 사용/사용 안 함으로 전환할 수 있습니다. 또한 목록에서 항목을 선택한 뒤 목록 아래의 Enable/Disable 버튼을 클릭하여 여러 토큰을 한 번에 사용/사용 안 함으로 설정할 수도 있습니다.
새 토큰을 생성하려면 우측 상단의 Create API token 버튼을 클릭한 다음 토큰 설정 화면에서 필수 항목을 입력합니다:
| 매개변수 | 설명 |
|---|---|
| Name | 토큰에 표시되는 이름입니다. |
| User | 토큰을 할당할 사용자입니다. 사용자를 빠르게 선택하려면 사용자명, 이름 또는 성을 입력하기 시작한 다음 자동 완성 목록에서 원하는 사용자를 선택하십시오. 또는 Select 버튼을 클릭하여 전체 사용자 목록에서 선택할 수도 있습니다. 토큰은 한 명의 사용자에게만 할당할 수 있습니다. |
| Description | 선택 사항인 토큰 설명입니다. |
| Set expiration date and time | 토큰에 만료일을 설정하지 않으려면 이 체크박스의 선택을 해제하십시오. |
| Expiry date | 토큰 만료일을 선택하려면 달력 아이콘을 클릭하거나, YYYY-MM-DD hh:mm:ss 형식으로 직접 날짜를 입력하십시오 |
| Enabled | 사용 안 함 상태로 토큰을 생성하려면 이 체크박스의 선택을 해제하십시오. |
토큰을 생성하려면 Add를 클릭하십시오.
페이지를 닫기 전에 Auth token 값을 복사하여 안전한 곳에 저장한 다음 Close를 클릭하십시오. 토큰이 목록에 표시됩니다.
Auth token 값은 이후에 다시 확인할 수 없습니다. 이 값은 토큰 생성 직후에만 확인할 수 있습니다. 저장한 토큰을 분실한 경우 다시 생성해야 하며, 이 경우 새로운 인증 문자열이 생성됩니다.
토큰 이름을 클릭하면 이름, 설명, 만료일 설정 또는 토큰 상태를 편집할 수 있습니다. 단, 토큰이 할당된 사용자는 변경할 수 없습니다. 변경 사항을 저장하려면 Update 버튼을 클릭하십시오. 토큰이 분실되었거나 노출된 경우 Regenerate 버튼을 클릭하여 새 토큰 값을 생성할 수 있습니다. 이 작업을 진행하면 기존에 생성된 토큰이 무효화되므로, 이를 확인하는 확인 대화 상자가 표시됩니다.
Administration 메뉴 섹션에 접근 권한이 없는 사용자는 User profile → API tokens 섹션에서 자신에게 할당된 토큰의 상세 정보를 확인하고 수정할 수 있으며, 이는 사용자 역할 권한에서 Manage API tokens가 허용된 경우에만 가능합니다.