Вградете Artavolo във ваше собствено приложение
Обновено
Вашето собствено приложение може да показва таблица, дъска, календар или формуляр на Artavolo в страниците си. Вашите потребители работят със записите, редактират ги, ако позволите, и никога не виждат екран за вход. Вашият сървър подписва токен с кратък живот, който назовава акаунт в Artavolo и база; рамка във вашата страница се отваря с него.
Как работи
Токенът назовава акаунт в Artavolo, базата, по желание единствената таблица за отваряне, дали може да записва, и етикет за вашия собствен потребител. Вградената сесия винаги може да прави по-малко от този акаунт: без настройки, без членове, без права, без импорт, без администрация и нищо извън базата или таблицата в токена. Всяка заявка се проверява спрямо токена, така че работи дори там, където браузърите блокират бисквитките на трети страни.
Първо вижте как работи
- Отворете администрацията (Контролен панел в менюто на акаунта), после Настройки, Вграждане.
- Под Опитайте сега изберете една от вашите бази, таблица или Цялата база, и Само за четене или Четене и запис.
- Натиснете Генерирай и отворете връзката. Това е вграден изглед, който действа от ваше име, за десет минути.
Същото поле след това отпечатва кода с адреса на вашата инстанция, акаунта и базата вече попълнени, за PHP, за Node или за демонстрационната команда.
Настройте го наистина
- Създайте акаунта в Artavolo, от чието име ще действа вграденият изглед, и му дайте точно достъпа, който трябва да имат вашите потребители. Не използвайте администратор.
- В Настройки, Вграждане, отметнете Приемай токени за вграждане.
- Добавете адреса на вашето приложение под Разрешени адреси на хостове, по един на ред, например
https://app.example.com. Всеки друг сайт се отхвърля. - Копирайте Тайния ключ за подписване на вашия сървър. Никога не го поставяйте в код за браузър.
- На вашия сървър подпишете токен при всяко зареждане на страница и го сложете в адреса на рамката. Ръководството за вграждане съдържа формата на токена и работещ код на PHP, Node и Python, както и клиентски пакет с обвивки за React и Vue.
Докато работи
Рамката казва на вашата страница кога е готова, колко висока трябва да бъде и кога се променят записи, така че вашите екрани да остават в синхрон. Вашата страница може да поиска от нея да се презареди.
Добре е да знаете
- Настройването изисква администраторски достъп до инстанцията, затова се прави на ваш собствен сървър или на специална инстанция. На ваш собствен сървър е нужен лицензен ключ, който включва вграждане; то се предлага с White-label или Enterprise.
- Без white-label вграденият изглед запазва малък надпис „powered by“.
- Токените трябва да са с кратък живот: издавайте нов при всяко зареждане на страница. Сесията в рамката след това трае колкото сесията на браузъра, така че никой не се прекъсва по средата на редактиране.
- Всяка вградена сесия е в дневника на промените с вашия етикет за потребителя, така че промените могат да се проследят до вашите собствени потребители.
- Смени до тайния ключ за подписване отхвърля веднага всеки токен, подписан със стария.
- Празна рамка обикновено означава, че вашият адрес липсва в Разрешени адреси на хостове. Грешка в подписа означава грешен таен ключ, а изтекъл токен често означава неточен часовник на сървъра.
- Работят и настолни приложения (Electron, Tauri, WebView2); ръководството обяснява единственото, което е различно.
- За публичен изглед само за четене на уебсайт гостовият достъп е по-прост. Вижте Показване на база на уебсайт.