Пријавите се на главни садржај

Администрација сервера

Функције администрације сервера у ChurchApps доступне су само корисницима са дозволом Server.Admin. Ове алатке се користе за операције платформе, подршку и решавање проблема у свим црквама у систему.

Ограничен приступ

Функције описане на овој страници захтевају дозволу Server.Admin и нису доступне обичним администраторима цркве. Намењене су искључиво оператерима платформе и особљу за подршку.

Приступ администрацији сервера​

Корисници са дозволом Server.Admin могу да приступе панелу за администрацију сервера из B1 Admin-а:

  1. Пријавите се на admin.b1.church
  2. Отворите мени Jump, проширите Подешавања и кликните на Server Admin. (Можете и direktno да одете на admin.b1.church/admin.)
  3. Панел Server Admin приказује своје одељке дуж леве стране, у три групе: Именик (Цркве, Корисници, Имперсонирај корисника), Операције (Позадински послови, Commons, Трендови коришћења) и Систем (Преводи, Стање сервера, Миграције базе података)

Ресетовање пријаве у два корака​

Ако корисник има укључену пријаву у два корака, а изгубио је и телефон и резервне кодове, администратор сервера може да је искључи:

  1. Отворите одељак Корисници у панелу Server Admin и пронађите корисника.
  2. Корисници са укљученом пријавом у два корака приказују значку Two-factor on. Кликните на Reset 2FA поред ње.
  3. Потврдите упит. Ово урадите тек након што потврдите са ким разговарате.

Корисник затим може да се пријави само лозинком и поново подеси пријаву у два корака са свог профила. Ресетовања се бележе у дневнику активности као mfa_reset. Крајња тачка је POST /membership/users/mfa/reset/:userId и захтева Server.Admin.

Имперсонација корисника​

Функција имперсонације омогућава администраторима сервера да се пријаве као други корисник ради подршке и решавања проблема. Корисна је када се истражују проблеми које су пријавили корисници или када се црквама помаже у подешавању система.

Како имперсонирати корисника​

  1. Отворите одељак Имперсонирај корисника у панелу Server Admin.
  2. Унесите име или адресу е-поште корисника у поље за претрагу.
  3. Кликните на Претражи или притисните Enter.
  4. Među резултатима претраге кликните на корисника кога желите да имперсонирате.
  5. Потврдите имперсонацију у дијалогу који се појави.
  6. Бићете пријављени као тај корисник и преусмерени на његов налог.

Важне напомене​

  • Имперсонација ствара нову сесију са дозволама и приступом црквама циљног корисника.
  • Ваша првобитна администраторска сесија завршава се када имперсонирате другог корисника.
  • Све радње предузете док сте имперсонирани бележе се у дневнику активности.
  • Да бисте се вратили на свој администраторски налог, одјавите се и поново се пријавите својим акредитивима.
  • Имперсонацију користите само када је то заиста потребно за подршку и увек обавестите кориснике када приступате њиховим налозима ради подршке.

API крајња тачка​

Функцију имперсонације подржава крајња тачка /users/:userId/impersonate у Membership API-ју. Технички детаљи налазе се на страници Membership Endpoints.

Безбедносна разматрања​

  • Имперсонација захтева дозволу Server.Admin. Ову дозволу треба додељивати штедљиво и само поузданим оператерима платформе.
  • Сви догађаји имперсонације бележе се са ID-јем администратора и ID-јем циљног корисника.
  • Црквe се не обавештавају када дође до имперсонације, зато утврдите јасне смернице о томе када и како се ова функција сме користити.
  • Размислите о томе да догађаје имперсонације документујете у систему за евиденцију тикета ради одговорности.

Модерација Commons-а​

Commons је заједнички ред за модерацију садржаја које корисници шаљу у различитим производима. WorshipCommons песме, лекције са Lessons.church-а, FreeShow шаблони и шаблони за B1 изградњу веб-сајтова пролазе кроз исти ред, уместо кроз засебне алатке за преглед по производу.

Приступ Commons-у​

  1. Идите на картицу Commons у панелу Server Admin.
  2. Видећете три подкартице: Ред, Извештаји и Датотеке.

Ограничена улога уређивача музике такође може да види картицу Ред, али не може да одобрава пошиљке које мењају права или лиценцирање песме.

Ред​

Ред приказује све пошиљке на чекању у свим производима, које се могу филтрирати по производу и врсти садржаја. Сваки ред показује да ли је пошиљка нови садржај, измена његовог првобитног аутора или измена треће стране. Такође приказује историју одобрења пошиљаоца и колико дуго пошиљка чека. Пошиљке које чекају дуже од 72 сата означене су.

Кликните на Прегледај да бисте отворили панел са разликама по пољима, прегледима датотека и уграђеним прегледом ставке само за читање. Пречицама a и r одобравате или одбијате пошиљку, а тастерима j и k прелазите на следећу или претходну пошиљку без напуштања панела. Одбијање захтева избор разлога (на пример квалитет, дупликат, лиценцирање, ccli, ai или није на тему) и белешку.

Извештаји​

Картица Извештаји обрађује извештаје о ауторским правима и извештаје о политици и квалитету поднете против већ објављеног садржаја. Подељена је на засебне редове Ауторска права и Политика и остало, плус историју Решено. Преузмите извештај да бисте почели да га обрађујете, а затим га решите одговарајућим решењем (потврђено, одбачено или дупликат) и радњом (ништа, поништи објаву или уклони).

Датотеке​

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

Посебно за песме, овде се песма постаје спремна за недељу и може да се појави у претрази песама у B1 Admin-у цркве. Рецензент отвара садржај и означава сваки објављени тон као Саслушано када га саслуша и потврди да су партитура, акорди и слајдови присутни. Песма постаје спремна за недељу тек када су сви тонови означени.

инфо

Модерација Commons-а је само за особље. Појединачне цркве никада не виде овај ред. Једино место где B1 Admin цркве додирује податке Commons-а јесте одељак „WorshipCommons — бесплатно“ у претрази песама, који приказује само песме које су већ прошле кроз овај процес прегледа.

Погледајте страницу Архитектура Content Commons-а за основни модел података и животни циклус пошиљки.

Одобрење е-поште групе​

Цркве не могу да шаљу е-пошту коју су написале (е-пошта групе, праћење образаца, е-пошта токова рада и позивнице за налоге) док администратор сервера не одобри слање. Ово спречава да цркве регистроване путем бота користе заједничку адресу ChurchApps-а за слање спама.

  1. Отворите картицу Цркве у панелу Server Admin.
  2. Свака црква приказује ознаку Group Email: Approved (зелено) или Not approved (са оквиром).
  3. Кликните на ознаку и потврдите да бисте одобрили цркву или опозвали одобрење.

Особље цркве тражи одобрење дугметом Request review у дијалогу Send Email у B1 Admin-у. Захтев се шаље е-поштом на адресу за подршку и садржи назив цркве, ID, датум регистрације, локацију и ко је захтев поднео. Црква може да пошаље један захтев недељно. Погледајте Ограничења е-поште коју пише црква за дневну квоту и аутоматску паузу при неисправним адресама и жалбама.

Миграције базе података​

Радни ток Deploy Prod сам примењује миграције на чекању. Хостоване базе података прихватају везе само изнутра мреже Api-ја, па GitHub runner не може да им приступи. Уместо тога, одмах након serverless deploy радни ток позива Lambda функцију migrate Api-ја (api-Prod-migrate). Она покреће миграције на чекању за сваки модул истим извршиоцем као ова картица и прекида деплој ако било који модул откаже или буде одбијен. Rollback Prod враћа само код Lambda функције. Примењене миграције остају примењене. Картица Миграције базе података служи за проверу статуса, за покретање онога што деплој није покренуо (на пример на демо окружењу, чији деплој не извршава миграције) и за постављање почетне тачке за модуле без историје. (Self-hosted Docker инсталације и даље аутоматски извршавају миграције када се Api контејнер покрене.)

Картица приказује тренутно окружење и по један ред за сваки модул (membership, attendance, giving и тако даље) са његовим статусом, бројем примењених и миграција на чекању и последњом примењеном миграцијом.

  • Покрени миграције на чекању примењује сваку миграцију на чекању, по један модул у реду, редом. Зауставља се на првом квару и приказује шта је примењено за сваки модул.
  • Модул označen као No history има базу података која претходи праћењу миграција. Никада се не покреће аутоматски, јер би то поново извршило старе миграције података над живим табелама. Уместо тога кликните на Провери шему за тај модул. Api упоређује табеле, колоне и индексе које свака миграција креира са живом базом података и означава сваку миграцију као Већ примењено, Недостаје, Делимично примењено или Само подаци. Провера ништа не мења.
  • У резултатима провере, Забележи као већ примењено уписује откривене миграције у историју миграција без њиховог извршавања (након потврде). Све до последње миграције Већ примењено се бележи, укључујући миграције Само подаци у том опсегу. Миграције Недостаје остају на чекању и затим се могу нормално покренути дугметом Покрени миграције на чекању.
  • Миграција Делимично примењено блокира бележење. Ако је миграцију безбедно поново покренути (прво је прочитајте), означите Поново покрени како би остала на чекању и поново се извршила од почетка.

Панел Server Admin и CLI (yarn migrate:up) користе исти Kysely мигратор и табелу kysely_migration, па се увек слажу око тога шта је примењено. Крајње тачке које то подржавају су GET /membership/serverHealth/migrations, POST /membership/serverHealth/migrations/:module/run, GET .../:module/detect и POST .../:module/baseline, све само за Server.Admin.

Повезане странице​