Usługa Windows

Instalator rejestruje phaf jako usługę Windows. Usługa startuje razem z serwerem, działa niezależnie od tego, czy ktoś jest zalogowany, i uruchamia phaf ponownie, jeśli kiedykolwiek się zatrzyma. Ta strona pokazuje, jak nią zarządzać i jak uruchomić ją na dedykowanym koncie.

1. Uruchamianie, zatrzymywanie i sprawdzanie

Użyj przystawki Usługi (services.msc) lub PowerShell:

$svc = Get-Service | Where-Object DisplayName -like 'phaf*'
$svc                      # Status and start type
Stop-Service  $svc.Name
Start-Service $svc.Name

# Is phaf answering?
Invoke-WebRequest http://127.0.0.1:8181/ -UseBasicParsing | Select-Object StatusCode   # 200

Uruchom serwer ponownie raz, aby potwierdzić, że phaf wraca sam.

2. Uruchamianie usługi na dedykowanym koncie

Dedykowane konto ogranicza to, do czego phaf ma dostęp na serwerze. Użyj konta domenowego, gdy przepływy odczytują lub zapisują udziały sieciowe Windows, ponieważ konto lokalne nie może ich otworzyć.

1. Utwórz konto, na przykład lokalne:

$password = Read-Host 'Password for phaf-svc' -AsSecureString
New-LocalUser -Name 'phaf-svc' -Password $password -PasswordNeverExpires -AccountNeverExpires -Description 'Runs phaf DATA CONNECTOR'

2. Nie dodawaj go do grupy Administrators. Zapisz jego hasło w menedżerze haseł.
3. Nadaj mu uprawnienia do folderów z następnego kroku.
4. W przystawce Usługi otwórz usługę phaf › Logowanie › To konto, wpisz konto i jego hasło, a następnie uruchom usługę ponownie.

3. Uprawnienia do folderów

Konto usługi odczytuje aplikację i zapisuje dane. Folder danych zawiera klucz szyfrowania, więc otwierać go mogą tylko konto usługi, SYSTEM i administratorzy.

# Application: read only
icacls C:\phaf\app /grant 'phaf-svc:(OI)(CI)RX'

# Data: no inherited access, only SYSTEM, Administrators and phaf-svc
icacls C:\phaf\data /inheritance:r /grant:r 'SYSTEM:(OI)(CI)F' 'Administrators:(OI)(CI)F' 'phaf-svc:(OI)(CI)M'

Jeśli używasz konta domenowego, zapisz je jako YOURDOMAIN\svc-phaf. Jeśli przepływy odczytują lub zapisują inne foldery lokalne, nadaj kontu dostęp także do nich. Nawet jeśli zostajesz przy domyślnym koncie systemowym, ogranicz folder danych do SYSTEM i Administrators.

Jeśli usługa się nie uruchamia

• Błąd logowania — hasło konta jest błędne lub się zmieniło albo konto nie ma uprawnienia „Logowanie w trybie usługi”. Wpisz hasło ponownie na karcie Logowanie; Windows nadaje to uprawnienie przy zapisie.
• Usługa działa, ale phaf nie odpowiada — sprawdź błędy usługi w Podglądzie zdarzeń › Dzienniki systemu Windows › Aplikacja i System. Błąd uprawnień do C:\phaf\data oznacza, że pominięto krok 3.
• Zajęty port — po instalacji port zajął inny program. Zwolnij go albo zmień port w config.json, zaktualizuj proxy i uruchom usługę ponownie.