Konfigurace generátoru projektů

Generátor projektů Mervis vyžaduje pro přístup k Project Manageru a Data Hubu specifické přihlašovací údaje. Tyto údaje musí být před generováním projektu definovány v lokálním konfiguračním souboru params.txt.

UKONČENÍ PODPORY PŘIHLAŠOVACÍCH ÚDAJŮ „TODO“

Dříve bylo možné pro přihlašovací údaje k Data Hubu používat zástupnou hodnotu TODO (--dataHubLogin TODO a --dataHubPass TODO). Tato možnost již není podporována.
  • Aktuální fáze: Při generování nových projektů je nyní nutné zadávat skutečné uživatelské jméno a heslo k Data Hubu. Stávající soubory params.txt obsahující hodnotu TODO musí být neprodleně aktualizovány, aby nedocházelo k chybám při generování projektů.
  • Plánovaná druhá fáze: V nadcházející druhé fázi přestanou zcela fungovat také již vygenerované projekty, které stále používají přihlašovací údaje TODO. Pouhá aktualizace konfigurace pro nově generované projekty nebude dostačující. Před aktivací druhé fáze je nutné zkontrolovat a aktualizovat také stávající projekty a doplnit do nich platné přihlašovací údaje k Data Hubu. Předejdete tak výpadkům provozu.

V souboru params.txt je nutné definovat dvě sady přihlašovacích údajů: jednu pro Project Manager a druhou pro Data Hub.

Příklad konfigurace:

--pmLogin GlobalDomain\test-generator-manage
--pmPass rw
--dataHubLogin GlobalDomain\test-generator-data-2
--dataHubPass rws

(Poznámka: Je nutné ověřit přesný název parametru pro heslo k Project Manageru, tedy zda se v konkrétní verzi generátoru používá --pmPass, nebo --pmPassword.)

Pro zajištění optimální bezpečnosti by účty pro Project Manager a Data Hub měly být oddělené. Oba účty musí dodržovat princip minimálních oprávnění.

  • Účet Project Manageru: Měl by se jednat o vyhrazený účet s omezenými oprávněními, používaný výhradně pro generování projektů. Teoreticky lze použít i osobní účet uživatele, který projekt generuje, důrazně se však doporučuje použít samostatný účet. (V budoucnu může být pro tento účet podporováno vícefaktorové ověřování (MFA).)
  • Účet Data Hubu: Obvykle by měl být nastaven jako servisní nebo systémový účet. Tento účet nebude podporovat vícefaktorové ověřování (MFA).
  • Ochrana souboru params.txt: Protože jsou uživatelská jména a hesla uložena v prostém textu na lokálním disku v souboru params.txt, nepoužívejte osobní účty s vysokými oprávněními. Soubor musí být chráněn před neoprávněným přístupem a nesmí být nikdy zařazen do správy verzí zdrojového kódu (např. pomocí Gitu).

Účet pmLogin používá generátor projektů pro přístup k Project Manageru. Vyžaduje oprávnění Manage přiřazené ke všem datovým uzlům v cílové doméně.

Postup konfigurace oprávnění v Portálu:

  1. Přejděte do sekce Manage domain.
  2. V nabídce akcí vyberte možnost Change datanodes permissions.
  3. U požadovaných uzlů zaškrtněte pro účet Project Manageru oprávnění Manage.

Přístup k oprávněním datových uzlů prostřednictvím nabídky Manage Domain

Přístup k oprávněním datových uzlů prostřednictvím nabídky Manage Domain

Přiřazení oprávnění Manage účtu Project Manageru

Přiřazení oprávnění Manage účtu Project Manageru

Účet dataHubLogin je vložen do vygenerovaného projektu, který jej používá pro operace s Data Hubem. Požadovaná oprávnění závisí výhradně na funkci projektu:

  • GetValues: Je vyžadováno pro čtení datových hodnot. Projekt určený pouze pro čtení potřebuje pouze toto oprávnění.
  • ExecuteCommand: Je vyžadováno pro zápis hodnot nebo provádění příkazů.
  • Kombinovaný požadavek: Ačkoli je v Portálu technicky možné nakonfigurovat projekt pouze s oprávněním ExecuteCommand, projekt nebude správně fungovat, protože stále potřebuje možnost číst data. Každý projekt, který zapisuje data, proto obvykle vyžaduje obě oprávnění: GetValues a ExecuteCommand.

Pokud jsou přihlašovací údaje nebo oprávnění nakonfigurovány nesprávně, generátor projektů zobrazí konkrétní chybová hlášení.

Chyba: ArgumentException: Not valid arguments: Invalid project manager login. Invalid project manager password.

Možné příčiny:

  • V souboru params.txt chybí argument --pmLogin.
  • Chybí argument --pmPass (nebo --pmPassword).

Chyba ArgumentException v grafickém rozhraní generátoru

Příklad chyby ArgumentException v grafickém rozhraní generátoru

Chyba: Exception: Getting datanodes problem. Code:42-InvalidCredentials InvalidCredentials.

Možné příčiny:

  • Zadané uživatelské jméno je nesprávné.
  • Zadané heslo je nesprávné.

Chyba: Exception: Getting datanodes problem. Code:40-ErrorByMessage Request cannot be completed for some of the requested data nodes:

Možná příčina:

  • Účet Project Manageru nemá povolené oprávnění Manage pro všechny datové uzly požadované generátorem. Vraťte se do Portálu a ověřte oprávnění účtu pro jednotlivé datové uzly.