Google Drive
Aplikace Helpdesk (Requestor) nabízí integraci na disk Google (Google Drive). Po aktivaci a konfiguraci integrace je možné u komentářů požadavků přidávat přílohy, které se nachazí na disku Google. Technicky je možné využít jak účet organizace, tak sokromé účty Google.
Postup konfigurace se skládá ze dvou částí. První část je potřeba provést v Google Cloud console, druhou část pak provedeme v aplikaci Helpdesk (Requestor). Na konci návodu naleznete i ukázku přidání přílohy k požadavku.
Konfigurace na straně Google Cloud console
Před zahájením samotné konfigurace doporučujeme se nejprve příhlásit pod odpovídajícím účtem do Google Cloud console. Při úplně prvním přihlášení je potřeba odsouhlasit podmínky služeb, pokud již nějaké cloudové služby Google vuyžíváte, máte s největší pravděpodobností jeden či více existujících projektů.
Jeden projekt bude aktivní, a ten je vidět v levé části záhlaví stránky. Pokud máte projektů více, kliknutím na tlačítko s názvem projektu vyvolá dialog, kterým je možné aktivní projekt změnit. V této fázi tedy doporučujeme zvolit projekt, v rámci kterého budete chtít konfigurovat přístup k disku Google.
Google Picker API může být již povolený. Na této adrese je možné zkontrolovat, zda již nemáte v rámci daného projektu povolený Google Picker API. Pokud ano, povolení Google Picker API v následujících odstavcích lze přeskočit.
Jakmile budete mít zvolený správný projekt, přejděte na následující adresu:
URL: https://console.cloud.google.com/flows/enableapi?apiid=picker&credential=client_key&pli=1
Zobrazí se webový průvodce, jehož cílem je povolit Google Picker API.
Pokud žádný projekt zatím nemáte, zobrazí se informace o nutnosti projekt vybrat (nicméně tam žádny nebude), takže je možné třeba rovnou z této stránky kliknout na tlačítko Create project a nový projekt vytvořit.
Vytvoření projektu v praxi znamená zadat Project name a zvolit Location. U soukromých účtú (adresy končící na gmail.com) nebude žádná lokace (resp. doména organizace Google Workspace) existovat a ani nebude možné ji vytvořit, proto v takovém případě ponecháme výchozí No organization (u pracovních účtů je možné lokaci zvolit dle potřeby), volitelně si přejmenujeme projekt a klikneme na Create.
Po vytvoření projektu by mělo dojít automaticky k přesměrování do průvodce povolením Google Picker API. Pokud by se tak nestalo, je možné adresu zmíněnou výše zadat znovu.
V prvním kroku tedy potvrdíme dříve zvolený, resp. nově vytvořený projekt a klikneme na tlačítko Next.
Potvrdíme, že dojde k povolení Google Picker API.
Jakmile máme Google Picker API povolený, přejdeme do jeho konfigurace, která je k dispozici na této adrese:
URL: https://console.cloud.google.com/apis/api/picker.googleapis.com/
Zde přejdeme do sekce Credentials.
Klikneme na tlačítko Create credentials a vybereme API key.
Dojde k vytvoření klíče, který budeme následně editovat, například hned z okna, které se nám zobrazí po vytvoření klíče. Zde klikneme na Edit API key. Alternativně můžeme na nově vytvořený klíč kliknout přímo ze sekce Credentials.
Na nově otevřené stránce v sekci Application restrictions vybereme Websites.
Tím se nám dynamicky zobrazí možnost přidat adresy. Zde klikneme na tlačítko Add a zadáme adresu aplikace Requestor ve tvaru zakaznik.servicedesk.net/*.
Formulář uložíme tlačítkem Save ve spodní části stránky.
Dalším krokem je vytvoření OAuth 2.0 Client ID, který vytvoříme tak, že na stejné záložce Credentials (jako v předchozím kroku, lze se sem dostat i přímým odkazem) klikneme na Create credentials a vybereme OAuth client ID.
Pokud tento typ konfigurace provádíme poprvé, dost pravděpodobně nebude umožněno OAuth Client ID vytvořit, dokud nebude nakonfigurován consent screen.
V takovém případě klikneme na tlačítko Configure consent screen. To nás přesune do sekce Branding, ve které klikneme na Get started.
V novém formuláři vyplníme název aplikace a email, který se bude na OAuth Consent Screen zobrazovat. Dále klikneme na tlačítko Next.
Krok Audience umožňuje určit, zda bude aplikace k dispozici jen pro interní uživatele (tato volba je aktivní pouze u organizačních účtů Google Workspace), případně zda bude k dispozici i pro externí účty (což bude později vyžadovat projít procesem ověření).
V dalším kroku vyplníme kontaktní email pro notifikace od Google (může být stejný jako předchozí, případně se může lišit).
Po kliknutí na tlačítko Next se nám zobrazí možnost přečíst si podmínky a ty je následně potřeba odsouhlasit. Pak klikneme na Continue a na Create.
V rámci Google Auth Platform přejdeme do záložky Branding a pomocí tlačítka Add domain přidáme všechny domény (zde vyplňujeme jen domény 2. řádu), na kterých se aplikace Requestor nachází.
Změny uložíme tlačítkem Save ve spodní části stránky.
Nyní přejdeme ke kroku tvorby OAuth Client ID, které lze vytvořit i v rámci Google Auth Platform, pouze přejdeme do záložky Clients. Zde pak klikneme na tlačítko Create client.
Na nově otevřené stránce zvolíme Application type - v roletovém menu vybereme Web application.
Do Authorized JavaScript origins i Authorized redirect URIs přidáme primární adresu aplikace Requestor ve tvaru https://zakaznik.servicedesk.net. Pak klikneme na tlačítko Create.
Po kliknutí na Create se nám zobrazí okno, ve kterém máme Client ID a Client secret. Secret se již znovu nezobrazí, proto je nyní potřeba si informace zkopírovat, eventuálně kliknout na Download JSON pro uložení konfigurace do počítače.
Na záložce Audience pak můžeme přidat testovací uživatele, případně kliknout na Publish app.
Tím bychom měli mít registraci na straně Google dokončenou a můžeme přejít ke konfiguraci v aplikaci Requestor.
Konfigurace v aplikaci Requestor
V aplikaci Requestor přejdeme do Administrace, kde v levém menu zvolíme kategorii Integrace/Aplikace a klikneme na Google Drive.
V nově otevřeném okně vyplníme dříve získané Client ID a AppKey (client secret). AppId je shodné s Project ID, které lze najít na úvodní stránce Google Cloud Console.
Nezapomeneme integraci aktivovat a klikneme na tlačítko Uložit.
Tím je nastavení dokončeno a můžeme přejít k ukázce práce s přílohami.
Přidání přílohy z Google Drive do požadavku
Při práci s požadavky (tvorba nového požadavku, přidání veřejného nebo interního komentáře) máme možnost přiložit přílohy. Po aktivaci integrace Google Drive se zobrazí odpovídající ikona, na kterou klikneme.
Nejdříve je potřeba se přihlásit s účtem Google, během prvního přihlášení můžeme být vyzváni k odsouhlasení sdílení informací o přihlašovacích údajích.
Po úspěšném ověření se nám zobrazí File Picker, ze kterého zvolíme odpovídající soubor k přiložení (je možné využít i vyhledávání).
Následně se vybraný soubor přidá ke komentáři.
Uživatel aplikace Requestor, který soubor přiložil, jej pak následně má možnost i odstranit.