Konfiguracja Google IDP
- Wejść na stronę https://developers.google.com/
- W prawym górnym rogu kliknąć przycisk "Sign in" oraz zalogować się na konto google.
- Zjechać do samego końca strony, oraz w kolumnie "Developer consoles" kliknąć "Google API Console".
- Po kliknięciu użytkownik zostanie przekierowany na inną stronę. W okienku wyświetlonym na stronie zaznaczyć checkbox "Wyrażam zgodę na Warunki korzystania z Google Cloud Platform [...]", następnie zatwierdzić przyciskiem "ZGADZAM SIĘ I CHCĘ PRZEJŚĆ DALEJ".
- W głównym widoku kliknąć "UTWÓRZ PROJEKT".
- Uzupełnić pole "Nazwa projektu*". Nazwa może być dowolna, jednak zaleca się, aby w polu wpisać nazwę aplikacji wraz z nazwą instytucji, np. dla instytucji RCIN nazwą byłby "dLibra - RCIN". Nazwa ta służy do identyfikacji podłączonych na koncie aplikacji, powinna więc mówić, której aplikacji dotyczy.
- Kliknąć przycisk "UTWÓRZ".
- Z panelu po lewej stronie kliknąć zakładkę "Ekran akceptacji OAuth", następnie wybrać "User Type": "Zewnętrzny" oraz kliknąć przycisk "UTWÓRZ". Wyświetlony zostanie "Ekran Akceptacji OAuth".
- Uzupełnić pole "Nazwa aplikacji". Wartość z tego pola będzie wyświetlana użytkownikowi przy próbie logowania dLibry za pomocą konta google. Podobnie jak wcześniej zaleca się użycia nazwy aplikacji połączonej z nazwą instytucji.
- Opcjonalnie uzupełnić "Logo aplikacji", które również jest wyświetlane przy próbie logowania.
- Opcjonalnie uzupełnić sekcję "Autoryzowane domeny". W pierwszym polu podać pełną nazwę domenową, np. "rcin.org.pl" oraz zatwierdzić wpis ENTER-em. W sekcji "Link do strony głównej" np. "https://rcin.org.pl/dlibra". W sekcji "Link do polityki porywatności aplikacji" np. "https://rcin.org.pl/dlibra/text?id=polityka". Można również uzupełnić sekcję "Link do Warunków korzystania z usługi", jeśli takowe zostały zdefiniowane.
- Kliknąć przycisk "Zapisz" na dole strony w celu zapisania konfiguracji.
- Przejść do sekcji "Dane logowanie". Kliknąć "UTWÓRZ DANE LOGOWANIA" oraz wybrać opcję "Identyfikator klienta OAuth".
- W wyświetlonym formularzu, w liście "Typ aplikacji" wybrać opcję "Aplikacja internetowa".
- Uzupełnić pole "Nazwa". Dowolnie, zaleca się jednak, aby nazwa w jakiś sposób wiązała się z aplikacją oraz instytucją.
- W sekcji "Autoryzowane źródła JavaScript" dodać rekordy z nazwą domenową, bez ścieżki kontekstowej, np. "http://rcin.org.pl" oraz "https://rcin.org.pl".
- W sekcji "Autoryzowane identyfikatory przekierowania dodać rekordy z nazwą domenową wraz ze ścieżką kontekstową, np. "https://rcin.org.pl/dlibra" oraz "http://rcin.org.pl/dlibra".
- Skopiować wartość pokazaną z prawej strony formularza: "Identyfikator klienta".
- Kliknąć przycisk "ZAPISZ" w celu zapisania konfiguracji.
Edytować plik "user-providers.xml" znajdujący się pod ścieżką "WEB-INF/conf" w katalogu aplikacji webowej. Odkomentować poniższy węzeł oraz za wartość CLIENT_ID wkleić wcześniej skopiowany identyfikator.
user-providers.xml<pl.psnc.dlibra.web.comp.user.oauth.google.GoogleUserInformationProvider>--> <configuration>--> <loginPage>${homepage}/dlibra/login</loginPage>--> <logoutPage>${homepage}/dlibra/main?action=LogoutAction</logoutPage>--> <methodNameResourceKey>LoginComponent.uip.google.name</methodNameResourceKey>--> </configuration>--> <additionalConfiguration>--> <clientId>CLIENT_ID</clientId>--> </additionalConfiguration>--> </pl.psnc.dlibra.web.comp.user.oauth.google.GoogleUserInformationProvider>- Zrestartować serwer aplikacji webowej. Po restarcie na stronie logowania powinien pojawić się przycisk logowania za pomocą konta google.
Konfiguracja Facebook IDP
- Wejść na stronę https://developers.facebook.com/
- W prawym górnym rogu kliknąć przycisk "Log in" oraz zalogować się na konto facebook.
- Po zalogowaniu w prawym górnym rogu kliknąć "My Apps". W rozwiniętym menu kliknąć "Create APP". Wyświetlony zostanie formularz tworzenia aplikacji.
- Uzupełnić pole "Display Name". Wartość z tego pola będzie wyświetlana jako nazwa aplikacji przy próbie logowania za pomocą konta facebook. Zaleca się użycie wartości na wzór "dLibra - NAZWA_INSTYTUCJI".
- Pole "Contact Email" powinno zawierać email osoby odpowiedzialnej za utworzoną konfigurację. Domyślnie zostanie uzupełnione emailem osoby tworzącej konfigurację.
- Kliknąć "Create APP ID" oraz potwierdzić, że nie jest się robotem.
- Po przekierowaniu do kolejnego ekranu z dostępnych opcji przez kliknięcie "Set Up" wybieramy "Facebook Login".
- W następnym formularzu wybrać "WEB".
- W polu "Site URL" podać adres własnego serwisu webowego, np. dla RCIN-u wyglądałby tak: "https://rcin.org.pl". Następnie zatwierdzić przyciskiem "Save".
- Przejść do zakładki "Settings" -> "Basic".
- W polu "App Domains" wpisać domenę aplikacji, np. dla RCIN-u "rcin.org.pl".
- Uzupełnić pole "Privacy Policy URL" (URL polityki prywatności, np. "https://dingo.psnc.pl/en/privacy-policy/"), opcjonalnie uzupełnić "Terms of Service URL".
- Opcjonalnie uzupełnić "App Icon", które będzie wyświetlane przy próbie logowania.
- Wybrać kategorię do jakiej należy aplikacja. Bazując na opisach zapewnianych przez facebook-a, dLibra przynależy do kategorii "Entertainment".
- Należy zatwierdzić konfigurację przyciskiej "Save Changes".
- Należy skopiować wartości "App ID" oraz "App Secret".
- Kliknąć przełącznik "In development", następnie zatwierdzić przyciskiem "Switch Mode". "In development" powinno zmienić się na "Live". Oznacza to, że aplikacja została aktywowana.
Edytować plik "user-providers.xml" znajdujący się pod ścieżką "WEB-INF/conf" w katalogu aplikacji webowej. Odkomentować poniższy węzeł zamienić wartości CLIENT_ID oraz CLIENT_SECRET na wcześniej skopiowane "App ID" oraz "App Secret".
user-providers.xml<pl.psnc.dlibra.web.comp.user.oauth.facebook.FacebookUserInformationProvider> <configuration> <loginPage>${homepage}/dlibra/login</loginPage> <logoutPage>${homepage}/dlibra/main?action=LogoutAction</logoutPage> <methodNameResourceKey>LoginComponent.uip.facebook.name</methodNameResourceKey> </configuration> <additionalConfiguration> <clientId>CLIENT_ID</clientId> <clientSecret>CLIENT_SECRET</clientSecret> </additionalConfiguration> </pl.psnc.dlibra.web.comp.user.oauth.facebook.FacebookUserInformationProvider>- Zrestartować serwer aplikacji webowej. Po restarcie na stronie logowania powinien pojawić się przycisk logowania za pomocą konta facebook.