Document toolboxDocument toolbox

Integrace s YouTrack (OpenID Connect)

Krok 1: Nastavení na straně 2Element

Vytvoříme novou chráněnou aplikaci (Nastavení - Chráněné aplikace - Přidat) typu OpenID Connect a jako konfigurační profil vybereme YouTrack. Přejdeme k sekci Informace pro integraci do chráněné aplikace kde jsou informace potřebné v dalším kroku. V kroku 3 se k otevřenému formuláři vrátíme.

Krok 2: Nastavení na straně YouTrack

Přidáme nový autentizační modul typu OAuth 2.0 (Administration - Access Management - Auth Modules - New module) a jako Authorization URL nastavíme hodnotu parametru Authorization Endpoint URI ze sekce Informace pro integraci do chráněné aplikace ve formuláři z předchozího kroku.

Po vytvoření modulu se zobrazí formulář pro jeho nastavení. Přejdeme k sekci Authorization Service Endpoints a nastavíme následující parametry s pomocí informací ve formuláři v předchozím kroku:

  • Authorization - zapíšeme hodnotu parametru Authorization Endpoint URI

  • Token - zapíšeme hodnotu parametru Token Endpoint URI

  • User data - zapíšeme hodnotu parametru UserInfo Endpoint URI

Přejdeme k sekci Field Mapping a nastavíme následující hodnoty:

  • User ID - zapíšeme hodnotu preferred_username

  • Email - zapíšeme hodnotu email

  • Full name - zapíšeme hodnotu name

  • Groups - zapíšeme hodnotu groups

V sekci Additional Settings nastavíme následující hodnoty:

  • Scope - zapíšeme hodnotu openid profile email groups

Přejdeme na začátek konfiguračního formuláře k parametru Redirect URI a pokračujeme dalším krokem.

Krok 3: Nastavení na straně 2Element

Do parametru URI pro přesměrování 1 zapíšeme hodnotu Redirect URI z konfiguračního formuláře YouTrack a odešleme formulář pro přidání chráněné aplikace. Otevře se detail chráněné aplikace kde přejdeme na konec sekce Informace pro integraci do chráněné aplikace a pokračujeme v dalším kroku.

Krok 4: Nastavení na straně YouTrack

Hodnoty parametrů Client ID a Client Secret z detailu chráněné aplikace přepíšeme do parametrů Client ID a Client secret v YouTracku a uložíme formulář autentizačního modulu. Po uložení autentizační modul povolíme pomocí tlačítka Enable module v pravé horní části stránky.

Pokud chceme používat uživatelské skupiny, musíme nastavit jejich mapování v záložce Group Mappings v horní části konfigurační stránky autentizačního modulu.

Poznámky

Pokud je aktivní volba User creation v nastavení autentizačního modulu, vytvoří se nový uživatel automaticky. Pokud již v YouTracku existuje účet pro danou osobu, je možné účty sloučit pomocí akce Merge v seznamu uživatelů.