AiHummer
Тоҷикӣ
Даромадан
v1.0.x
{ }Swagger

Плагини Pocket Agent

v1.0.x · навсозӣ шуд 2026-06-26

Pocket Agent абзори дастрасии дурдасти кӯтоҳмуддат бо тикети TTL аст. Он ба оператор имкон медиҳад, ки барои иҷрои як вазифаи маҳдуд ба мошини ҳадаф расад, бо модели амниятие, ки тарроҳӣ шудааст, то ҳадаф ҳеҷ гоҳ маҷбур нашавад порте кушояд ё ба пайвасти воридшаванда эътимод кунад.

[!WARNING] Pocket Agent барномаи ҳамроҳи мобилӣ нест. Ном ба як агенти хурди дастрасии дурдасти аз рӯи талабот ишора мекунад, на клиенти телефон. Барои барномаи клиент нигаред ба плагини Барномаи мобилӣ ва десктоп.

Он ба таври host-native кор мекунад ва бо gateway тавассути қарордод гуфтугӯ мекунад.

Далелҳо

Майдон Қимат
Версия 0.1.0
Порт 8814
Runtime host-native

Он чист

Роҳе барои иҷрои як амали маҳдуд дар ҳадафи дурдаст бидуни инфрасохтори доимӣ дар он ҳадаф. Ба ҷои демоне, ки фармонҳои воридшавандаро гӯш мекунад, модел тикетдор ва танҳо содиршаванда аст:

  1. Оператор тикет содир мекунад — як грант (иҷозат)-и кӯтоҳмуддат (бо TTL маҳдудшуда) барои як вазифаи мушаххас.
  2. Ҳадаф бутстрапи имзошударо иҷро мекунад, ки тикетро тасдиқ мекунад.
  3. Сипас ҳадаф ба як ҳалқаи пурсиши содиршаванда ворид мешавад, барои гирифтани кор ва гузориши натиҷаҳо дастрасӣ мекунад.

Вақте TTL-и тикет тамом мешавад, дастрасӣ нест мешавад. Ҳеҷ чизи доимии гӯшкунанда боқӣ намемонад.

Модели амният

[!NOTE] Тамоми ҳадафи Pocket Agent ҳолати амният аст, на роҳатӣ. Пеш аз деплой онро фаҳмед:

  • Тикетҳои кӯтоҳмуддат (TTL). Дастрасӣ бо вақт маҳдуд аст; тикети тамомшуда ҳеҷ чизе намедиҳад.
  • Бутстрапи имзошуда. Ҳадаф танҳо пас аз тасдиқи бутстрапи имзошудаи ба тикет вобаста идома медиҳад.
  • Танҳо ҳалқаи пурсиши содиршаванда. Ҳадаф ҳамаи пайвастҳоро оғоз мекунад. Сокети воридшаванда барои ҳамла нест ва канали push нест.
  • Allowlist. Ҳадафҳо ва амалҳо бо allowlist маҳдуданд.
  • Аудит. Фаъолият барои баррасӣ сабт мешавад.

Азбаски на гӯшкунандаи воридшаванда ва на push вуҷуд дорад, сатҳи ҳамла дар ҳадаф ҳадди ақалл аст: ҳамлагар наметавонад тавассути Pocket Agent ба ҳадаф пайваст шавад, ва дастрасӣ ҳангоми тамом шудани тикет худкорона қатъ мешавад.

Чӣ тавр истифода мешавад

Оператор барои як вазифаи мушаххас тикет содир мекунад; ҳадаф онро тавассути бутстрапи имзошуда ва ҳалқаи пурсиши содиршаванда мегирад, кори дар allowlist бударо иҷро мекунад ва гузориш медиҳад. Ҳар қадам бо TTL-и тикет маҳдуд ва дар изи аудит сабт мешавад.

operator issues TTL ticket ─▶ target verifies signed bootstrap ─▶ target polls outbound ─▶ allowlisted work ─▶ audit

Насб

Pocket Agent-ро бо як клик аз бозор дар админ UI насб кунед. Деплойери host-native плагинро зеркашӣ мекунад, қадами насби онро иҷро мекунад, як воҳиди systemd-и изолятсияшударо ренд мекунад ва пеш аз омода эълон кардан, мунтазири саломатӣ мешавад — нигаред ба Насб ва навсозиҳо. Ҳеҷ контейнер дахл надорад.

Амният ва маҳдудиятҳо

  • Танҳо дастрасии тикети TTL — дар вақт маҳдуд, на сессияи дурдасти доимӣ.
  • Танҳо содиршаванда — на сокети воридшаванда, на канали push дар ҳадаф.
  • Allowlist + бутстрапи имзошуда + аудит иҷро мекунанд, ки кӣ чӣ карда метавонад ва онро сабт мекунанд.
  • Барномаи ҳамроҳ нест — ин дастрасии дурдасти аз ҷониби оператор пешбаришуда аст, на клиенти телефон.
  • Host-native — зери systemd кор мекунад, на дар контейнер.

Минбаъд ба куҷо