Instrukcja do pobrania w formacie PDF
Instrukcja tworzenia aplikacji oAuth2 w usłudze Okta, w celu realizacji integracji z Worksmile
- Integracja oparta jest o protokół oAuth2 oraz authorization code flow, Worksmile potrzebuje jedynie najniższe uprawnienie: profile, email, openid, offline_access (aby weryfikować czy konto nie zostało zablokowane). To uprawnienie umożliwia nam odczytywanie jedynie podstawowych danych konta pojedynczego użytkownika, który zdecydował się na integrację konta Worksmile z Okta.
- Do integracji konieczne jest stworzenie aplikacji w panelu administracyjnym Okta: https://[tenant] -admin.okta.com/admin/getting-started, administrator usługi Okta musi tutaj zalogować się.
- Następnie wejść w zakładkę aplikacji i kliknąć „Add Application”
- Następnie kliknąć na „Create New App” po prawej stronie
- Na ekranie konfiguracji należy wybrać opcję: Web oraz OpenID Connect i kliknąć „Create”
- Następnie należy uzupełnić poszczególne pola wartościami i kliknąć „Save”:
- Worksmile
- Pobierz ikonę Worksmile tutaj
-
https://webhooks.worksmile.com/authentication/connect/okta
- Następnie kliknąć przycisk „Edit” po prawej stronie, tak aby można było edytować poniższe wartości. Chcemy zaznaczyć pole „Refresh Token” w sekcji „Allowed grant types”.
- Następnie należy przypisać do aplikacji wszystkich użytkowników w Okta. Najłatwiej to zrobić przez przypisanie grupy Everyone:
- Ostatnim krokiem jest skopiowanie danych dostępowych „Client ID” i „Client secret”. Dane proszę przesłać w formie poufnej do osoby kontaktowej w Worksmile.