APIトークン
概要
このセクションでは、APIトークンの作成と管理を行えます。
APIトークンは、Zabbix APIでの認証に使用されます。
各APIトークンは1人のユーザーに割り当てられ、そのユーザーの権限を継承します。
APIトークンで認証されたリクエストは、関連付けられたユーザーのロールと権限に従って認可されます。
APIトークンは、名前、トークンが割り当てられているユーザー、有効期限、トークンを作成したユーザー、またはステータス（有効/無効）でフィルターできます。リスト内のトークンのステータスをクリックすると、すぐにトークンを有効/無効にできます。また、リストでトークンを選択してから、リストの下にある有効化/無効化ボタンをクリックすると、複数のトークンを一括で有効/無効にできます。
新しいトークンを作成するには、右上隅にあるAPIトークンの作成ボタンをクリックし、トークン設定画面で必須フィールドに入力します。
| パラメーター | 説明 |
|---|---|
| 名前 | トークンに表示される名前。 |
| ユーザー | トークンを割り当てるユーザー。ユーザーをすばやく選択するには、ユーザー名、名、または姓の入力を開始し、オートコンプリートリストから必要なユーザーを選択します。または、選択ボタンをクリックして、ユーザーの全リストからユーザーを選択できます。トークンを割り当てられるユーザーは1人だけです。 |
| 説明 | 任意のトークンの説明。 |
| 有効期限と時刻を設定 | トークンに有効期限を設定しない場合は、このチェックボックスの選択を解除します。 |
| 有効期限 | カレンダーアイコンをクリックしてトークンの有効期限を選択するか、YYYY-MM-DD hh:mm:ss形式で日付を手動入力します。 |
| 有効 | 無効な状態でトークンを作成する場合は、このチェックボックスの選択を解除します。 |
追加をクリックしてトークンを作成します。
認証トークンの値をコピーして安全な場所に保存してから、ページを閉じる前に、閉じるをクリックします。 トークンがリストに表示されます。
認証トークンの値は、後から再度表示することはできません。トークンの作成直後にのみ使用できます。保存したトークンを紛失した場合は、再生成する必要があります。再生成すると、新しい認証文字列が作成されます。
トークン名をクリックすると、名前、説明、有効期限の設定、またはトークンのステータスを編集できます。トークンが割り当てられているユーザーを変更することはできません。更新ボタンをクリックして変更を保存します。 トークンを紛失または漏えいした場合は、再生成ボタンをクリックして新しいトークン値を生成できます。操作の実行後は以前に生成されたトークンが無効になるため、この操作の確認を求める確認ダイアログボックスが表示されます。
管理メニューセクションへのアクセス権がないユーザーは、ユーザーロールの権限でAPIトークンの管理が許可されている場合に限り、ユーザープロファイル > APIトークン セクションで、自分に割り当てられたトークンの詳細を表示および変更できます。