Skip To Content

Używanie portalu z protokołem LDAP i uwierzytelnianiem w warstwie portalu

Dostęp do portalu można zabezpieczyć przy użyciu protokołu LDAP (Lightweight Directory Access Protocol). W przypadku użycia protokołu LDAP loginy są zarządzane przez serwer LDAP instytucji. Po skonfigurowaniu magazynu tożsamości portalu dla protokołu LDAP można skonfigurować uwierzytelnianie w warstwie portalu.

Konfigurowanie portalu tak, aby do komunikacji korzystał wyłącznie z protokołu HTTPS

Domyślnie Portal for ArcGIS wymusza zastosowanie protokołu HTTPS dla całej komunikacji. Jeśli wcześniej zmieniono tę opcję, aby zezwolić na komunikację z użyciem zarówno protokołu HTTP, jak i protokołu HTTPS, należy zrekonfigurować portal tak, aby używana była komunikacja wyłącznie za pomocą protokołu HTTPS, postępując zgodnie z poniższymi wskazówkami.

  1. Zaloguj się w witrynie portalu jako administrator instytucji. Adres URL ma format https://webadaptorhost.domain.com/webadaptorname/home.
  2. Na stronie Instytucja kliknij kartę Ustawienia, a następnie opcję Bezpieczeństwo.
  3. Zaznacz pole Zezwalaj na dostęp do portalu tylko za pośrednictwem protokołu HTTPS.
  4. Kliknij Zapisz, aby zastosować zmiany.

Aktualizowanie magazynu tożsamości portalu

Następnie zaktualizuj magazyn tożsamości portalu w celu korzystania z użytkowników i grup LDAP.

Aktualizacja magazynu tożsamości portalu w celu korzystania z protokołu LDAP

  1. Zaloguj się do aplikacji ArcGIS Portal Directory jako administrator instytucji. Adres URL ma format https://webadaptorhost.domain.com/webadaptorname/portaladmin.
  2. Kliknij kolejno opcje Bezpieczeństwo > Konfiguracja > Aktualizacja magazynu tożsamości.
  3. W polu tekstowym Konfiguracja magazynu użytkownika (w formacie JSON) wklej dane konfiguracji użytkowników LDAP w instytucji (w formacie JSON). Alternatywnie możesz zaktualizować poniższy przykład przy użyciu informacji o użytkownikach, które są specyficzne dla Twojej instytucji.

    {
      "type": "LDAP",
      "properties": {
        "userPassword": "secret",
        "isPasswordEncrypted": "false",
        "user": "uid=admin,ou=system",
        "userFullnameAttribute": "cn",
        "ldapURLForUsers": "ldaps://myLdapServer:10636/ou=users,ou=ags,dc=example,dc=com",
        "userEmailAttribute": "mail",
        "usernameAttribute": "uid",
        "caseSensitive": "false",
        "userSearchAttribute": "uid"
      }
    }

    W większości przypadków wystarczy zmienić wartości parametrów user, userPassword i ldapURLForUsers. Adres URL protokołu LDAP musi zostać dostarczony przez administratora LDAP.

    W powyższym przykładzie adres URL LDAP odwołuje się do użytkowników o określonej wartości elementu OU (ou=users). Jeśli użytkownicy istnieją w wielu elementach OU, adres URL LDAP może wskazywać element OU wyższego poziomu, a nawet element poziomu głównego. W tym przypadku adres URL będzie wyglądał następująco:

    "ldapURLForUsers": "ldaps://myLdapServer:10636/dc=example,dc=com",

    Konto używane dla parametru użytkownika powinno posiadać odpowiednie uprawnienia do wyszukiwania adresów e-mail i nazw użytkowników będących członkami instytucji. Pomimo tego, że hasło zostanie wpisane w postaci zwykłego tekstu, zostanie zaszyfrowane po kliknięciu przycisku Aktualizuj konfigurację (poniżej).

    Jeśli w protokole LDAP skonfigurowano rozróżnianie wielkości liter, należy parametrowi caseSensitive przypisać wartość true.

  4. Jeśli chcesz utworzyć grupy w portalu, które wykorzystują istniejące grupy korporacyjne w magazynie tożsamości, wklej dane konfiguracji grup LDAP w instytucji (w formacie JSON) w polu tekstowym Konfiguracja magazynu grupy (w formacie JSON), jak pokazano poniżej. Alternatywnie możesz zaktualizować poniższy przykład przy użyciu informacji o grupach, które są specyficzne dla Twojej instytucji. Jeśli chcesz używać tylko wbudowanych grup portalu, usuń wszystkie informacje z tego pola tekstowego i pomiń ten etap.

    {
      "type": "LDAP",  "properties": {
        "userPassword": "secret",    "isPasswordEncrypted": "false",    "user": "uid=admin,ou=system",    "ldapURLForUsers": "ldaps://myLdapServer:10636/ou=users,ou=ags,dc=example,dc=com",    "ldapURLForRoles": "ldaps://myLdapServer:10636/dc=example,dc=com",    "usernameAttribute": "uid",    "caseSensitive": "false",    "userSearchAttribute": "uid",    "memberAttributeInRoles": "member",    "rolenameAttribute":"cn"
      }
    }

    W większości przypadków wystarczy zmienić wartości parametrów user, userPassword i ldapURLForUsers. Adres URL protokołu LDAP musi zostać dostarczony przez administratora LDAP.

    W powyższym przykładzie adres URL LDAP odwołuje się do użytkowników o określonej wartości elementu OU (ou=users). Jeśli użytkownicy istnieją w wielu elementach OU, adres URL LDAP może wskazywać element OU wyższego poziomu, a nawet element poziomu głównego. W tym przypadku adres URL będzie wyglądał następująco:

    "ldapURLForUsers": "ldaps://bar2:10636/dc=example,dc=com",

    Konto używane dla parametru użytkownika powinno posiadać odpowiednie uprawnienia do wyszukiwania adresów e-mail i nazw użytkowników będących członkami instytucji. Pomimo tego, że hasło zostanie wpisane w postaci zwykłego tekstu, zostanie zaszyfrowane po kliknięciu przycisku Aktualizuj konfigurację (poniżej).

    Jeśli w protokole LDAP skonfigurowano rozróżnianie wielkości liter, należy parametrowi caseSensitive przypisać wartość true.

  5. Aby zapisać zmiany, kliknij przycisk Aktualizuj konfigurację.

Opcjonalna konfiguracja dodatkowych parametrów magazynu tożsamości

Istnieją dodatkowe parametry konfiguracji magazynu danych, które można zmodyfikować przy użyciu interfejsu API administrowania ArcGIS Portal Directory. Parametry te obejmują opcje takie jak ograniczanie automatyczne odświeżania grup, gdy użytkownik korporacyjny zaloguje się do portalu, ustawianie interwału odświeżania członkostwa oraz definiowanie, czy należy sprawdzać wiele formatów nazwy użytkownika. Szczegółowe informacje można znaleźć w temacie Aktualizacja magazynu tożsamości.

Konfiguracja uwierzytelniania w warstwie portalu

Po skonfigurowaniu portalu przy użyciu magazynu tożsamości protokołu LDAP należy włączyć dostęp anonimowy za pośrednictwem adaptera internetowego (web adaptor) na serwerze aplikacji Java. Użytkownik, po otwarciu strony logowania portalu, może wybrać logowanie przy użyciu poświadczeń korporacyjnych lub wbudowanych. Użytkownicy korporacyjni będą musieli wprowadzać swoje poświadczenia każdorazowo podczas logowania się w portalu. Nie mogą oni korzystać z logowania automatycznego lub jednokrotnego. Ten rodzaj uwierzytelniania umożliwia również użytkownikom anonimowym dostęp do map i innych zasobów portalu udostępnionych wszystkim użytkownikom.

Weryfikacja dostępu do portalu przy użyciu poświadczeń

  1. Otwórz witrynę portalu. Adres URL ma format https://webadaptorhost.domain.com/webadaptorname/home.
  2. Zaloguj się za pomocą poświadczeń konta korporacyjnego (przykładowa składnia została podana poniżej).

Członkowie korporacji korzystający z uwierzytelnienia w warstwie portalu logują się, stosując następującą składnię:

  • Przy korzystaniu z portalu przy użyciu protokołu LDAP, składnia zawsze ma postać username. Konto jest wyświetlane w witrynie portalu także w tym formacie.

Dodawanie kont korporacyjnych do portalu

Domyślnie użytkownicy korporacyjni mogą uzyskać dostęp do witryny portalu. Jednak mogą oni tylko wyświetlać elementy, które zostały udostępnione wszystkim osobom w instytucji. Jest to spowodowane tym, że konta korporacyjne nie zostały dodane do portalu i nie przyznano im uprawnień dostępu.

Dodaj konta do portalu przy użyciu jednej z następujących metod:

Zaleca się, aby przynajmniej jedno konto korporacyjne wyznaczyć jako konto administratora portalu. Można to zrobić, wybierając rolę Administrator podczas dodawania konta. Mając alternatywne konto administratora portalu, możesz przypisać rolę Użytkownik do początkowego konta administratora lub usunąć to konto. Więcej informacji można znaleźć w temacie Informacje o początkowym koncie administratora.

Po dodaniu kont użytkownicy będą mogli zalogować się w instytucji i uzyskać dostęp do zasobów.