Skip To Content

Używanie protokołu LDAP i infrastruktury PKI do zabezpieczenia dostępu do portalu

Kiedy protokół LDAP (Lightweight Directory Access Protocol) jest używany do uwierzytelniania użytkowników, możesz użyć infrastruktury klucza publicznego (PKI) do zabezpieczenia dostępu do portalu.

Aby używać protokołu LDAP i infrastruktury PKI, należy skonfigurować uwierzytelnianie oparte na certyfikacie klienta PKI przy użyciu aplikacji ArcGIS Web Adaptor (Java Platform) wdrożonej na serwerze aplikacji Java. Do uwierzytelniania opartego na certyfikacie klienta PKI przy użyciu protokołu LDAP nie można używać aplikacji ArcGIS Web Adaptor (IIS). Jeśli nie zostało to jeszcze zrobione, zainstaluj i skonfiguruj aplikację ArcGIS Web Adaptor (Java Platform) w portalu.

Notatka:

Jeśli zamierzasz dodać witrynę serwera ArcGIS Server do portalu i chcesz korzystać z protokołu LDAP i infrastruktury PKI na serwerze, konieczne jest wyłączenie uwierzytelniania opartego na certyfikacie klienta PKI w witrynie serwera ArcGIS Server i aktywowanie dostępu anonimowego przed dodaniem go do portalu. Choć może się to wydać nieintuicyjne, takie postępowanie jest konieczne, aby umożliwić serwerowi integrację z portalem oraz odczytanie użytkowników i ról na portalu. Jeśli witryna ArcGIS Server nie używa jeszcze uwierzytelniania opartego na certyfikacie klienta PKI, od użytkownika nie wymaga się żadnego działania. Aby uzyskać instrukcje na temat dodania serwera do portalu, należy zapoznać się z tematem Integrowanie serwera ArcGIS z własnym portalem.

Skonfiguruj protokół LDAP w portalu

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.

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

  1. Zaloguj się w witrynie portalu jako administrator instytucji. Adres URL ma format https://webadaptorhost.domain.com/webadaptorname/home.
  2. Kliknij opcję Instytucja, kliknij kartę Ustawienia, a następnie kliknij pozycję Bezpieczeństwo po lewej stronie.
  3. Włącz opcję Zezwalaj na dostęp do portalu tylko za pośrednictwem protokołu HTTPS.

Aktualizowanie magazynu tożsamości portalu

Następnie zaktualizuj magazyn tożsamości portalu w celu korzystania z użytkowników i grup 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",
        "userGivenNameAttribute": "givenName",
        "userSurnameAttribute": "sn",
        "ldapURLForUsers": "ldaps://bar2:10636/ou=users,ou=ags,dc=example,dc=com",
        "userEmailAttribute": "mail",
        "usernameAttribute": "uid",
        "caseSensitive": "false",
        "userSearchAttribute": "dn"
      }
    }

    W większości przypadków wystarczy zmienić wartości user, userPassword, ldapURLForUsers oraz parametry userSearchAttribute. Atrybut userSearchAttribute jest wartością parametru Subject w certyfikacie PKI. Jeżeli Twoja instytucja używa innego atrybutu w certyfikacie PKI, na przykład adresu e-mail, konieczna jest aktualizacja atrybutu userSearchAttribute w taki sposób, aby był zgodny z parametrem Subject w certyfikacie PKI. 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.

  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://bar2:10636/ou=users,ou=ags,dc=example,dc=com",
        "ldapURLForRoles": "ldaps://bar2:10636/dc=example,dc=com",
        "usernameAttribute": "uid",
        "caseSensitive": "false",
        "userSearchAttribute": "dn",
        "memberAttributeInRoles": "member",
        "rolenameAttribute":"cn"
      }
    }

    W większości przypadków wystarczy zmienić wartości parametrów user, userPassword, ldapURLForUsers, ldapURLForUsers i userSearchAttribute. Atrybut userSearchAttribute jest wartością parametru Subject w certyfikacie PKI. Jeżeli Twoja instytucja używa innego atrybutu w certyfikacie PKI, na przykład adresu e-mail, konieczna jest aktualizacja atrybutu userSearchAttribute w taki sposób, aby był zgodny z parametrem Subject w certyfikacie PKI. 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 mieć odpowiednie uprawnienia do wyszukiwania nazw grup w 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ę.
  6. Jeśli skonfigurowano portal o wysokiej dostępności, uruchom ponownie każdy komputer portalu. Pełne instrukcje można znaleźć w temacie Zatrzymywanie i uruchamianie portalu.

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 i wykonaniu poniższych czynności użytkownicy będą mogli logować się do instytucji i uzyskiwać dostęp do zawartości.

Konfiguracja aplikacji ArcGIS Web Adaptor w celu użycia uwierzytelniania PKI

Gdy aplikacja ArcGIS Web Adaptor (Java Platform) zostanie zainstalowana i skonfigurowana z portalem, skonfiguruj obszar LDAP na serwerze aplikacji Java oraz metodę uwierzytelniania na podstawie certyfikatu klienta opartego na infrastrukturze PKI dla aplikacji ArcGIS Web Adaptor. Aby uzyskać instrukcje, skontaktuj się z administratorem systemu lub zapoznaj się z dokumentacją serwera aplikacji Java.

Weryfikacja dostępu do portalu przy użyciu protokołu LDAP i infrastruktury PKI

  1. Otwórz witrynę portalu. Adres URL ma format https://webadaptorhost.domain.com/webadaptorname/home.
  2. Upewnij się, że zostaje wyświetlony monit o poświadczenia zabezpieczeń i można uzyskać dostęp do witryny.

Uniemożliwianie użytkownikom tworzenia własnych kont wbudowanych

Można zabronić użytkownikom tworzenia własnych kont wbudowanych, wyłączając im tę możliwość w ustawieniach instytucji.