Компјутерски тунел

Повежите свој рачунар преко Beeuni Agent Tunnel-а, уз потребне дозволе.

Компјутер је ваша машина — лаптоп, десктоп или сервер — повезана са Beeuni-јем преко обрнутог тунела са дозволама. Компјутер није сандбокс. Сандбокс је привремена машина у облаку коју Beeuni прави за сесију. Компјутер је машина коју већ поседујете и остаје повезан између сесија.

Повезани компјутер је налог конектора computer connector, баш као што је лични Gmail сандучић налог Gmail конектора. Сваки пројекат има уграђен конектор computer; никада га не додајете нити уклањате. Сваки члан повезује свој компјутер, који прати ту особу: то је налог у сваком пројекту коме припада, у сваком радном простору, без подешавања за сваки пројекат.

1. Додајте Computer Tunnel из каталога конектора пројекта.
2. Покрените команду за упаривање приказану у профилу, на пример npx --yes @beeuni/agent-tunnel@latest connect --api-url <url>.
3. Одобрите везу у прегледачу.
4. Изаберите упарену машину за профил.

Картица Повежите свој компјутер налази се на бочној траци пројекта док не повежете компјутер. Затворите је помоћу × ако вам није потребна; остаје скривена у том прегледачу. Картица се не приказује на инсталацији на којој су компјутери искључени.

Приступ одобравате за сваку могућност посебно: систем датотека, љуску или радну површину. За сваку могућност можете да ограничите дозвољене путање, команде или функције радне површине. Одобрење за могућност је подешавање за један ресурс на једној машини, а не Beeuni улога. Оно не одобрава ништа што одлука о улози забрањује — погледајте Налози и приступ. Агент добија само оно што му одобрите. Позив могућности која није одобрена ствара захтев за дозволу. Отворите машину у њеном профилу Computer Tunnel да бисте одобрили или одбили захтев.

У прегледачу. Кликните Повежите свој компјутер на картици. У дијалогу се нуди Преузмите Beeuni за десктоп, чиме се компјутер повезује једним кликом. Да бисте се повезали без апликације, изаберите Уместо тога користите CLI и покрените приказану команду на компјутеру:

Како агент приступа компјутеру

Упаривањем се машина додаје у вашу флоту налога. Не уписује се додела, па се тиме не одобрава приступ пројекту. Додајте Computer Tunnel из каталога конектора пројекта, а затим изаберите једну или више упарених машина за тај профил.

Један профил може да садржи једну машину или скуп машина. Скуп машина није група налога — група налога је субјект у моделу улога, а ово су машине. Можете да направите више профила са различитим или делимично преклапајућим скуповима машина. Сваки профил има независна одобрења за агенте и смернице за алате.

Алат list_computers враћа само машине додељене активном профилу. Други алати прихватају необавезни назив или ID машине computer из тог резултата. Изборник није обавезан ако је на мрежи тачно једна додељена машина.

beeuni connectors call studio-computers.list_computers '{}'

beeuni connectors call studio-computers.fs.read \
  '{"computer":"MacBook-Pro-9.local","path":"/etc/hosts"}'

Команда приказује код и отвара страницу за одобравање. На страници за одобравање:

1. Проверите да ли се код подудара са оним на компјутеру.
2. Именујте компјутер. Име постаје ознака налога.
3. Изаберите Ко може да користи овај компјутер: Само ви (подразумевано: сваки пројекат, ваше приватне сесије) или Делите и са пројектом који је наведен у команди. За дељење је потребна дозвола за управљање везама тог пројекта.
4. Изаберите шта агенти смеју да раде: Систем датотека, Љуска, Коришћење компјутера.

Компјутер ће се затим приказивати под Прилагоди → Конектори → Компјутер → Налози у сваком пројекту ком припадате. Његов ред изгледа и ради као налог сваког другог конектора; ако компјутер тренутно није повезан, испод његовог имена пише Ван мреже.

Beeuni препознаје сваки компјутер помоћу хеша његовог хардверског ID-а (IOPlatformUUID на macOS-у, /etc/machine-id на Linux-у, MachineGuid на Windows-у). Поновним повезивањем истог компјутера, након поновне инсталације, преименовања или промене мреже, ажурира се његов постојећи унос уместо додавања другог. Име, дељење и везе са сесијама остају сачувани.

Ваш компјутер (десктоп апликација)

Отворите мени радног простора (назив пројекта на врху бочне траке) и изаберите Ваш компјутер. Тачка поред њега означава статус компјутера. Дијалог приказује име компјутера и један од статуса: На мрежи, Повезивање, Ван мреже, Паузирано или Потребно је поново повезати (компјутер је прекинуо везу на другом месту; Повежите овај компјутер поново га упарује). Одатле можете да:

• Паузирате везу / Наставите везу: зауставите или поново покренете услугу у позадини. Паузирани компјутер је агентима ван мреже (computer_offline) и остаје паузиран после поновног покретања.
• Приступ: да ли агенти смеју да користе компјутер док је повезан. Погледајте Приступ на компјутеру.
• Одржавајте овај компјутер будним док је прикључен на напајање (macOS и Linux): компјутер не прелази у стање спавања док је на напајању, па агенти могу да му приступе. Подразумевано је искључено. У Windows-у се у реду наводи да ова опција још није доступна.
• Дељење: отворите картицу Accounts конектора компјутера и изаберите Дели у реду компјутера.
• Прикажи евиденције: отворите датотеку евиденције агента.
• Прекини везу: уклоните компјутер из Beeuni-ја и свих пројеката и зауставите услугу у позадини.

Приступ на компјутеру

Сам компјутер одлучује да ли агент сме да га користи, без обзира на то шта пројекат дозвољава. Подешава се у Ваш компјутер → Приступ или преко иконе на траци менија:

• Питај сваки пут (подразумевано за компјутер повезан преко десктоп апликације): при првом позиву агента на компјутеру се приказује упит: Дозволи 24 сата, Дозволи 1 сат (подразумевано дугме) или Одбиј. Одобрење важи за датотеке, љуску и екран и тастатуру, за све агенте који могу да приступе компјутеру, док не истекне. Док је одобрење активно, у дијалогу пише Дозвољено до 14 и Опозови сада. После избора Одбиј, позиви се одмах одбијају наредних 10 минута без новог упита. Промена режима прекида тренутно одобрење или одбијање.
• Увек дозвољено: нема упита. Ово је подразумевана вредност за компјутер повезан само преко CLI-ја, јер ништа на том компјутеру не може да прикаже упит. Компјутери повезани пре увођења ове поставке такође се овако понашају док је не промените.
• Искључено: сваки позив се одбија.

Само ви, на самом компјутеру, можете да проширите приступ. Када Beeuni страница затражи Увек дозвољено или ново одобрење, десктоп апликација прво приказује изворни дијалог и примењује промену тек када кликнете Дозволи. При сваком новом упаривању поново се примењује подразумевана вредност, а избором Прекини везу поставка се уклања.

Поставка се чува на компјутеру (~/.agent-tunnel/access.json). Ред налога и алат status приказују је, па агент може да вам каже да чека ваше одобрење.

Ко може да користи компјутер

На компјутер важе иста правила као и за сваки други налог конектора:

• Приватни компјутер (подразумевано, Само ви) ради само у приватним сесијама власника, у сваком пројекту ком власник припада. Други члан не може да га види ни користи.
• Избором Дели у реду компјутера отвара се исти дијалог као за Gmail налог: изаберите људе, групе или све у пројекту. Ништа се не мења док не изаберете Сачувај, а дељење остаје укључено за вас док себе не уклоните. За дељење је потребна дозвола за управљање везама пројекта. Компјутер остаје један налог у том пројекту; у реду се затим приказује ко може да га користи.
• Компјутер који се дели са свима ради за све у пројекту, укључујући аутоматизована покретања: окидаче, распореде и Slack поруке без повезаног корисника. Аутоматизовано покретање може да приступи само дељеним компјутерима.
• Ваш ред вас прати, па се не уклања само из једног пројекта. Избором Прекини везу уклања се компјутер из Beeuni-ја и свих пројеката. Да би остао повезан, али се не користио, подесите му приступ на Искључено на самом компјутеру.

Да бисте ризичне позиве условили људским одобрењем, подесите смерницу конектора на картици Алати конектора компјутера (на пример, Питај за shell.exec). Захтев ће се затим појавити у одобрењима пројекта.

Шта компјутер дозвољава

Могућности бирате једном, када одобрите компјутер. Да бисте касније дозволили неку могућност, поново повежите компјутер и изаберите је.

Локална конфигурација агента представља највишу границу за сваки позив, без обзира на то шта Beeuni дозвољава. Чува се у ~/.agent-tunnel/config.json на компјутеру:

Неограничена љуска може да покрене било коју извршну датотеку доступну вашем корисничком налогу. Ограничите allowedPaths и allowedCommands на оно што је потребно за посао.

За коришћење компјутера потребна је засебно инсталирана локална датотека cua-driver. Агент не преузима, инсталира нити ажурира ту извршну датотеку.

Профиле Computer Tunnel подешавате на контролној табли, а не из beeuni.yaml. На картици Accounts профила можете да упарујете, бирате, прегледате, преименујете и уклањате машине. На картици Tools подешавате смернице конектора.

Безбедан пренос бинарних датотека

За табеле, PDF-ове, слике и друге бинарне датотеке, преносите бајтове директно из изворне датотеке. Никада не тражите од агента да копира base64 садржај из излаза алата. То може да промени бајтове иако величина датотеке остане иста.

На машини или у сандбоксу у ком се налази извор, подесите TUNNEL_API_URL, TUNNEL_TOKEN и TUNNEL_ID, па покрените:

agent-tunnel-cli fs_upload '{"source":"/tmp/report.xlsx","path":"/Users/me/Desktop/report.xlsx"}'

Команда подржава датотеке до 3 MiB и захтева могућност система датотека. Рачуна SHA-256 хеш извора и проверава хеш који врати одредиште. Ажурирајте повезаног агента ако његов одговор нема поље sha256.

За веће датотеке направите артефакт на одредишту. Пре испоруке проверите формат извора. Исти хеш потврђује да су бајтови стигли непромењени; величина датотеке и њена екстензија не доказују да Excel може да отвори радну свеску.