Přeskočit obsah

Applications

Modul Applications je ústřední modul pro deklaraci aplikací (dříve prostředků), které pak uživatelé Bastion vidí na svém portálu. Každá aplikace deklaruje typ služby (přístupový protokol: RDP, SSH, VNC, Web, SMB…) a sadu parametrů cíle, uživatelského prostředí, zabezpečení a nahrávání. Tato stránka popisuje rozhraní modulu: seznam, filtry, formulář pro přidání a úpravu, akce agenta a import/export.

Tento modul je dostupný z konzoly pro správu a otevírá se také v režimu bulk z jiných modulů (například RDS servers), aby bylo možné vytvořit několik aplikací najednou z jediné šablony.

Seznam aplikací

Hlavní okno zobrazuje stránkovaný seznam aplikací.

Sloupec Popis
Name Název aplikace, před kterým je ikona znázorňující typ služby.
Application type Privileged (monitorovaný přístup) nebo Standard.
Service Typ služby, tedy přístupový protokol (viz tabulka níže).
Recorded videos Ikona, která ukazuje, zda se relace nahrává.
Server Adresa cílového serveru a přidružená komponenta Edge Gateway. U aplikací s dynamickým cílem rozsah IP / seznam IP / IP + maska. U Citrix Storefront adresa URL. U obecného tunelu seznam cílů server:port.
SSO Nakonfigurovaný režim SSO (Enabled, Disabled, Request, Fixed s názvem aliasu).
Tags Přidružené značky. Sloupec je ve výchozím nastavení skrytý.
Description Popis ve volném textu. Sloupec je ve výchozím nastavení skrytý.

Počet řádků na stránku lze nastavit.

Pole zahrnutá do vyhledávání

Vyhledávání hledá podřetězec současně v pěti polích: v názvu, popisu, značkách, cílovém serveru a typu služby. Aplikace je tedy zahrnuta do výsledků, jakmile kterékoli z těchto pěti polí obsahuje zadaný text — včetně dvou sloupců, které jsou ve výchozím nastavení skryté.

Podporované typy služeb

Rozevírací seznam Service type ve formuláři nabízí následující hodnoty, seřazené abecedně podle popisku. Pravý sloupec uvádí odpovídající technický identifikátor, který používá veřejné API a soubor CSV pro import / export.

Typ služby (zobrazený popisek) Účel Identifikátor
Citrix ICA Relace Citrix přes klienta ICA. ica
Citrix Storefront Portál Citrix Storefront. nfuse
HTML5 (RDP) Relace RDS vykreslovaná v prohlížeči. html5rdp
HTML5 (SSH) Terminál SSH v prohlížeči. html5ssh
HTML5 (VNC) Relace VNC v prohlížeči. html5vnc
netBIOS Sdílená složka NetBIOS připojená jako jednotka. netBios
RDS Relace Vzdálené plochy systému Windows, nativní klient. rdp
Reverse proxy Webová aplikace publikovaná přes reverzní proxy, s nahráváním. webrecord_rp
SMB Sdílená složka SMB. smb
SSH (Secure Shell) Terminál SSH, nativní klient. ssh
Generic tunnel Tunel TCP/UDP k jednomu nebo více cílům server:port. redirectionport
VNC (Virtual Network Computing) Relace VNC, nativní klient. vnc
VPN Izolovaný přístup VPN. vpn
Web Nahrávaná webová aplikace. webrecord_web

Dostupnost

Tři typy HTML5 se při vytváření nabízejí pouze tehdy, je-li na platformě povolena funkce HTML5; jinak zůstávají viditelné jen při úpravách. Typy VPN, Generic tunnel, Citrix Storefront, Citrix ICA, SMB a netBIOS existují pouze pro aplikace typu Standard.

Režim bez agenta pro RDS

Typy RDS a HTML5 (RDP) mohou fungovat s agentem Bastion nasazeným na cílovém serveru, nebo bez něj: jde o zaškrtávací políčko formuláře, nikoli o samostatný typ služby. Vizuálně se ikona aplikace liší (barevná ikona s agentem, šedá ikona bez agenta) a filtry seznamu obě varianty skutečně rozlišují. Zaznamenaná metadata se podle toho liší:

Přístup Stisky kláves Schránka Otevření / zavření okna Spuštění programu
RDS s agentem ✓ ✓ ✓ ✓
RDS bez agenta ✓ — — —
SSH ✓ N/A N/A N/A
VNC ✓ — — —

Filtry

Sbalitelná oblast filtrů nad tabulkou zužuje seznam:

Filtr Popis
Application type Zaškrtávací políčka Privileged a/nebo Standard.
Service type Jedno zaškrtávací políčko pro každý typ, každé s vlastní ikonou.

Kliknutím na Display filtry použijete, kliknutím na Reset všechny filtry vymažete.

Vytvoření aplikace

Klikněte na tlačítko +. Otevře se formulář pro vytvoření. Vytvoření probíhá ve dvou krocích:

  1. zvolte typ aplikace (Privileged / Standard) a poté typ služby;
  2. vyplňte pole — ta se výrazně liší podle zvoleného typu služby.

Formulář je rozdělen na dvě karty.

Pole společná téměř všem aplikacím (kromě několika velmi specifických typů).

Pole Popis
Name Povinné, jedinečné. Znaky @ a , jsou zakázány.
Description Volný text.
Category Kategorie zobrazení na portálu (viz modul Categories).
Tags Volné značky, zadávané jednotlivě a přidávané tlačítkem Add. Již připojená značka je odmítnuta. Připojené značky se zobrazují ve vyhrazené skupině polí.
Ask for a comment to the user Požádá uživatele, aby před spuštěním zadal kontext svého připojení. Komentář je k dispozici v nahraném videu.
Check video integrity at playback Vypočítá a ověří hodnotu hash záznamů.
Allow manual removal of archives Umožní autorizovanému správci odstranit konkrétní video.
Delete archives automatically Zapne automatické uchovávání.
Archives conservation time (days) Doba ve dnech, od 1 do nakonfigurovaného maxima. K dispozici pouze tehdy, je-li zaškrtnuto předchozí políčko. Výchozí: 365.

Zvolte typ služby a vyplňte specifické parametry. Po zvolení typu se zobrazí několik skupin polí:

  • Access — cílový server, port, dynamický režim (rozsah IP, seznam IP, IP + maska), doména ověřování, zprostředkovatel připojení RDS…
  • SSO — viz část SSO.
  • Remote application — pouze pro typy RDP: režim RemoteApp, název publikované aplikace, spouštěcí složka, parametry.
  • View — rozlišení, barevná hloubka, dynamická změna velikosti, rozložení klávesnice, tapeta, režim konzoly.
  • Advanced settings — sbalitelná skupina polí s možnostmi specifickými pro daný typ služby (CREDSSP/NLA, Restricted Admin, zakázání protokolu Kerberos, přesměrování, časové limity atd.).

Dynamický režim

U typů RDS, HTML5 (RDP), SSH, HTML5 (SSH), VNC, HTML5 (VNC) a Generic tunnel lze cíl místo pevného serveru zadat jako rozsah IP, seznam IP nebo IP + maska. Koncový uživatel pak při spuštění zadá přesnou adresu.

Uložte kliknutím na Validate. Před uložením proběhne několik kontrol:

  • formulář musí být platný;
  • zkontrolují se data SSO předběžného ověřování (u prostředků Web);
  • je-li SSO Fixed, musí být vybrán alespoň jeden alias Keeper;
  • u obecného tunelu musí být definován alespoň jeden cíl (kromě dynamického režimu);
  • u nedynamických cílů proběhne kontrola duplicitního cílového serveru; zobrazí se seznam aplikací, které již sdílejí stejný cíl, a správce je požádán o potvrzení.

Úprava nebo odstranění aplikace

  • Úprava: vyberte aplikaci a klikněte na ikonu Properties nebo na řádek dvakrát klikněte. Formulář je stejný jako formulář pro vytvoření.
  • Odstranění: vyberte jednu nebo více aplikací a klikněte na tlačítko ×. Vyžaduje se potvrzení; text se liší podle toho, zda je vybrána jedna, nebo více aplikací.
  • Duplikace: vyberte jednu nebo více aplikací a klikněte na Duplicate Application. Každá kopie převezme původní název, za nímž následuje číslo v závorce — (1), pak (2), (3)… až po první volný název. Zkopírují se: parametry služby, značky, přidružené skupiny správců a, je-li SSO v režimu Fixed, připojené aliasy z Vault. Tlačítko zůstává neaktivní, jakmile výběr obsahuje aplikaci, kterou nelze duplikovat.

SSO

Pro každý kompatibilní typ služby určuje pole SSO metodu ověřování použitou při spuštění.

Režim Popis
Enabled Přihlašovací údaje uživatele Bastion se předávají cílové službě.
Disabled Neodesílají se žádné přihlašovací údaje; uživatel se ověří ručně.
Request Uživatel zadá přihlašovací údaje těsně před spuštěním.
Fixed Přihlašovací údaje se převezmou z aliasu ve Vault. Zobrazí se pole Alias pro výběr aliasu, který se má použít.

SSO není k dispozici

U typů SMB a netBIOS SSO z principu není k dispozici: pole místo rozevíracího seznamu zobrazuje šedě neaktivní popisek.

SSO není kompatibilní s doménami SAML

Režim Enabled předpokládá, že platforma zná heslo uživatele, aby jej mohla předat cílové službě. To neplatí, když se uživatel ověřuje vůči doméně ověřování SAML: heslo se zadává u zprostředkovatele identity, který ho dál nepředává. Aplikaci v režimu SSO Enabled proto uživatelé takových domén nemohou používat — vyhraďte pro ně režim Request nebo Fixed, které oba získávají přihlašovací údaje odjinud.

SSO pro typy Reverse proxy a Web

Pokud je u typů Reverse proxy a Web režim SSO jiný než Disabled, zobrazí se na kartě Service další oddíl SSO.

U Reverse proxy nabízí oddíl tři souhrnná pole:

Pole Popis
Login attribute Název parametru, který ponese přihlašovací jméno.
Password attribute Název parametru, který ponese heslo.
Extra attributes Doplňkové parametry.

Zaškrtávací políčko Advanced settings zpřístupní konfiguraci ve volném formátu (parametry a hlavičky).

U Web nabízí oddíl navíc pole SSO type:

Typ Popis
Classic Chování stejné jako u Reverse proxy.
Form preload Formulář HTML se automaticky načte, vyplní a odešle. Další pole: SSO URL, Form mode (metoda HTTP), CSRF token input name.
Preauthentication Před konečným přesměrováním se odešle řada požadavků HTTP. Tlačítko Configuration of preauthentication steps otevře samostatné okno.

Konfigurace kroků předběžného ověřování

Okno konfigurace uvádí již definované požadavky (adresa URL, metoda, pořadí odeslání).

Přidáním požadavku tlačítkem + se otevře formulář s těmito poli:

Pole Popis
URL Adresa URL požadavku s předponou nakonfigurovaného hostitele služby.
Method GET nebo POST.
Enable cache Užitečné pouze pro GET.
Login parameter / Password parameter Volitelné názvy parametrů.
ContentType (MIME) Umožňuje zadat například application/json.

Zaškrtávací políčko Advanced settings zpřístupní dvě další karty: Settings a Headers, z nichž každá slouží k přidávání dvojic název/hodnota.

Speciální syntaxe hodnot

Pole Value (parametry, hlavičky, hodnoty souborů cookie) přijímá zástupné texty. Zaškrtávací políčko Disable special syntax způsobí, že se hodnota použije doslovně; takto vytvořené položky se v seznamu zobrazují kurzívou.

Zástupný text Účinek
%user% Přihlašovací jméno použité pro SSO.
%password% Heslo použité pro SSO.
%base64([...])% Kódování Base64.
%lowercase([...])% / %uppercase([...])% Převod na malá / velká písmena.
%trim([...])% Odstranění prázdných znaků na začátku a na konci.
%uriencoded([...])% Kódování speciálních znaků pro URI.
%md5([...])% Hodnota hash MD5.
%sha256([...])% Hodnota hash SHA-256.
%hmacmd5(data,key)% HMAC-MD5 (parametry oddělené pomocí %,%).
%rsa(key,data)% Šifrování RSA.
%rsaoaep(key,data)% Šifrování RSA-OAEP (klíč PEM).
%reqresult(n)% / %reqresult(n,key)% Načte výsledek n-tého dříve odeslaného požadavku, volitelně filtrovaný podle názvu klíče.
\% Doslovný znak procenta.

Kroky vytváření dat

Podnabídka tlačítka pro přidání umožňuje přidat krok vytvoření dat (na rozdíl od požadavku). Typ dat může být:

Typ Účinek
Local variable Uloží se do místního úložiště prohlížeče.
Session variable Uloží se do úložiště relace prohlížeče.
Cookie Uloží se do souboru cookie. Nabízí další pole: Path (výchozí /), Lifetime (v hodinách; prázdné = bez vypršení platnosti, 0 nebo záporná hodnota = okamžité vypršení), Secured cookie (vyžaduje HTTPS), SameSite (Strict, Lax, None).

Akce agenta

Akce agenta se nabízejí pouze u privilegovaných aplikací typu RDS nebo HTML5 (RDP), a to jen tehdy, když není zaškrtnut režim bez agenta. Na panelu nástrojů jsou k dispozici dvě tlačítka.

Nasazení agenta

Kliknutím na Agent deployment se otevře formulář předvyplněný seznamem vybraných serverů.

Pole Popis
Target server Adresa cílového serveru (u jediného serveru se vyplní automaticky).
Target drive Písmeno jednotky, na kterou se má agent nainstalovat (například C).
Target directory Instalační cesta.
Gateway Server Edge Gateway použitý pro nasazení.
Domain Doména Active Directory.
Username / Password Účet místního nebo doménového správce oprávněný k instalaci agenta.

Klikněte na Validate; konzola pak průběžně zjišťuje stav instalace.

Odebrání agenta

Kliknutím na Agent removal se otevře podobný formulář, který k odinstalaci agenta shromáždí stejné údaje o ověřování a cíli.

Export / import

  • Export: stáhne vyfiltrovaný seznam jako soubor .csv. Předběžná kontrola může zobrazit upozornění, která musí správce jedno po druhém potvrdit.
  • Import: otevře okno importu souboru .csv. Pole k vyplnění:

    • File — soubor .csv;
    • Record delimiter — oddělovač sloupců, ; u souboru vytvořeného exportem;
    • Field values delimiter — oddělovač více hodnot, + u souboru vytvořeného exportem.

    Po potvrzení okno shrne výsledek pro každý řádek souboru.

Sloupce souboru

Soubor obsahuje jeden řádek záhlaví a poté jeden řádek na každou aplikaci. Sloupce jsou v celém souboru stejné bez ohledu na exportované typy služeb: export vytvoří sjednocení všech možných parametrů a každý řádek pak vyplní jen sloupce, které se týkají jeho vlastního typu. Ostatní zůstanou prázdné.

Sloupce jsou níže uvedeny podle skupin typů služeb. Společný základ se vyplňuje bez ohledu na typ; ostatní karty se týkají pouze aplikací uvedeného typu.

V praxi začněte exportem

Pro hromadné vytvoření aplikací zůstává nejjednodušší cestou exportovat již nakonfigurovanou aplikaci cílového typu a pak duplikovat a upravit její řádky: nepoužité sloupce zůstanou prázdné a záhlaví uvádí přesné názvy v jazyce konzoly.

Sdílený sloupec se v souboru objevuje jen jednou

Několik typů služeb používá stejné parametry: sloupec jako Resolution je proto uveden na každé příslušné kartě, ale soubor jej obsahuje jen jednou.

Sloupec Očekávaný formát
Name (povinný) text
Description text
Category (povinný) text
Comment True / False
Integrity True / False
Manual deletion True / False
Archives conservation time celé číslo
Service Type (povinný) text
Presented message text
Authorized IP address text
End IP range adresa IP
Start IP range adresa IP
Subnet IP adresa IP
SSO text
Subnet mask text
Authorized networks text
Dynamic True / False
Vidéo recording text
Server text
Port celé číslo
Application type text
Launch VNC application True / False
Sloupec Dotčené typy Očekávaný formát
Without agent HTML5 (RDP), RDS True / False
Embedded gateway HTML5 (RDP), RDS True / False
Gateway name HTML5 (RDP), RDS text
Resolution HTML5 (RDP), RDS text
Console mode HTML5 (RDP), RDS True / False
Remote Executable HTML5 (RDP), RDS text
Launch Directory HTML5 (RDP), RDS text
Authentication Domain HTML5 (RDP), RDS text
Background HTML5 (RDP), RDS True / False
RemoteApp mode HTML5 (RDP), RDS True / False
RemoteApp name HTML5 (RDP), RDS text
RDS Broker HTML5 (RDP), RDS True / False
Disable Kerberos HTML5 (RDP), RDS True / False
Acquire the Kerberos TGT HTML5 (RDP), RDS text
Time before disconnection (seconds) HTML5 (RDP), RDS celé číslo
RDP broker server collection HTML5 (RDP), RDS text
Use another client program RDS True / False
Alternate client program executable RDS text
Client program arguments RDS text
Full Screen RDS True / False
CSSP RDS True / False
Clipboard RDS True / False
Plug and play RDS text
Redirect Audio RDS True / False
Install Disks RDS True / False
Install Printers RDS True / False
Connect COM Ports RDS True / False
Colors HTML5 (RDP), RDS celé číslo
Change title of RDP RDS True / False
Enable the restrictedadmin option RDS True / False
Custom RDP file parameters RDS text
Mstsc args RDS text
Enable AUP RDS True / False
Launch TSE executable RDS True / False
Force RDP auth on client side RDS True / False
Enable wallpaper RDS True / False
Ignore client-side cert RDS True / False
Ask interaction mode HTML5 (RDP) True / False
Redirect Clipboard HTML5 (RDP) True / False
Keyboard format HTML5 (RDP) text
Security HTML5 (RDP) text
User Domain HTML5 (RDP) True / False
Visual styles HTML5 (RDP) text
Customize variable clientname HTML5 (RDP) text
RemoteApp parameters HTML5 (RDP) text
Resize method HTML5 (RDP) text
Extended Clipboard (HTML) HTML5 (RDP) True / False
Font smoothing HTML5 (RDP) True / False
Change the title of tab HTML5 (RDP) True / False
Enable file transfer HTML5 (RDP) True / False
Sloupec Dotčené typy Očekávaný formát
Command to execute at launch HTML5 (SSH), SSH text
Enable file transfer HTML5 (SSH), SSH True / False
Password injection settings HTML5 (SSH), SSH seznam (+)
Use another client program SSH True / False
Alternate client program executable SSH text
Client program arguments SSH text
Remote Executable SSH text
Parameters SSH text
Local Port SSH celé číslo
Remote Server SSH text
Enable X11 forwarding SSH True / False
local ip SSH adresa IP
local port SSH celé číslo
Launch Executable SSH True / False
Remote commands file SSH text
Ask interaction mode HTML5 (SSH) True / False
Redirect Clipboard HTML5 (SSH) True / False
Authentication Domain HTML5 (SSH) text
Console mode HTML5 (SSH) True / False
Backspace character HTML5 (SSH) celé číslo
Terminal type (xterm, vt100 ...) HTML5 (SSH) text
Sloupec Dotčené typy Očekávaný formát
VNC proxy address HTML5 (VNC), VNC text
Resize method HTML5 (VNC), VNC celé číslo
Encoding HTML5 (VNC), VNC text
VNC proxy port HTML5 (VNC), VNC text
Compression level HTML5 (VNC), VNC celé číslo
JPEG Quality HTML5 (VNC), VNC celé číslo
Change title of RDP HTML5 (VNC), VNC True / False
Change the title of tab HTML5 (VNC), VNC True / False
Ignore client-side cert HTML5 (VNC), VNC True / False
Custom RDP file parameters HTML5 (VNC), VNC text
Use another client program VNC True / False
Alternate client program executable VNC text
Client program arguments VNC text
Resolution VNC text
Ask interaction mode HTML5 (VNC) True / False
Redirect Clipboard HTML5 (VNC) True / False
Sloupec Dotčené typy Očekávaný formát
Virtualhost Reverse proxy, Web text
URL Reverse proxy, Web text
https Reverse proxy, Web True / False
Authentication type Reverse proxy, Web celé číslo
SSO type Reverse proxy, Web text
Form mode Reverse proxy, Web celé číslo
Login attribute Reverse proxy, Web text
Password attribute Reverse proxy, Web text
Extra attributes Reverse proxy, Web text
SSO settings Reverse proxy, Web text
SSO URL Reverse proxy, Web text
Forbidden Urls Reverse proxy, Web seznam (+)
SSO on classic HTML forms Reverse proxy, Web True / False
Advanced settings Reverse proxy, Web True / False
csrf Reverse proxy, Web text
IP address(es) Web seznam (+)
additional networks Web True / False
Sloupec Dotčené typy Očekávaný formát
Authentication Domain Citrix ICA, Citrix Storefront text
Number of colors Citrix ICA celé číslo
Resolution Citrix ICA text
Keyboard type Citrix ICA text
Keyboard Configuration Citrix ICA text
Remote application Citrix ICA text
Borderless window Citrix ICA True / False
Launch ICA application Citrix ICA True / False
Storefront server URL Citrix Storefront text
Protocol Citrix Storefront text
URL Citrix Storefront text
composed URL Citrix Storefront text
List of IPs or domains Citrix Storefront text
Citrix version Citrix Storefront celé číslo
Enable SSO for web portal access Citrix Storefront text
Enable SSO for ICA connections Citrix Storefront text
Enable web parsing Citrix Storefront True / False
Enable handling of Session Reliability mode Citrix Storefront True / False
Sloupec Dotčené typy Očekávaný formát
Display VPN state graphical user interface VPN True / False
Mode VPN text
Protocol Generic tunnel, VPN text
Network VPN adresa IP
Netmask VPN adresa IP
User IP address allocation policy VPN text
DNS suffixes VPN text
Redirect all network flows in the VPN tunnel (full tunneling) VPN True / False
Routes pushed VPN seznam (+)
Authorized IP addresses VPN seznam (+)
Forbidden IP VPN seznam (+)
IP ranges VPN seznam (+)
Allowed network masks VPN seznam (+)
DNS Servers VPN seznam (+)
URL Generic tunnel text
Remote Server Generic tunnel text
Remote port Generic tunnel celé číslo
Local server Generic tunnel text
Local Port Generic tunnel celé číslo
Default remote port Generic tunnel celé číslo
Inform user Generic tunnel True / False
Launch Executable Generic tunnel True / False
Launch in a web client Generic tunnel True / False
Executable Generic tunnel text
Parameters Generic tunnel text
Enable URL rewriting Generic tunnel True / False
Avoid windows authentication Generic tunnel True / False
Preserve Host header Generic tunnel True / False
SSO on classic HTML forms Generic tunnel text
Login attribute Generic tunnel text
Password attribute Generic tunnel text
Form mode Generic tunnel celé číslo
Extra attributes Generic tunnel text
Redirections Generic tunnel seznam (+)
Sloupec Dotčené typy Očekávaný formát
Share(s) SMB text
Force download SMB True / False
Display IP SMB True / False
Drive choice netBIOS text
Drive label netBIOS text
Replace an existing network drive netBIOS True / False
Launch Windows explorer netBIOS True / False
Share netBIOS text

Syntaxe

Prvek Oddělovač Příklad
Sloupce ; Name;Description;Category;…
Více hodnot v jedné buňce + 10.0.0.1+10.0.0.2
Skupina delegovaných správců @ mezi skupinou a její doménou AdminsAccounting@AD-Internal
Logické hodnoty — True nebo False; prázdná buňka se počítá jako False
Celá čísla — Samotná hodnota; prázdná buňka převezme výchozí hodnotu pole

Sloupce Name, Category a Service Type jsou povinné: řádek, kterému některý z nich chybí, je odmítnut. Kategorie je jediným případem, kdy se neznámá hodnota při importu vytvoří; všechny ostatní odkazované hodnoty již musí existovat.

Smlouvy o přístupu

Deklarací aplikace ji uživatelům ještě nezpřístupníte. Poté musíte vytvořit smlouvu o přístupu, která propojuje aplikaci, jednu nebo více skupin uživatelů a volitelnou podmínku přístupu.