Konfigurowanie dostawcy tożsamości LDAP

Wraz z modernizacją poziomu SSO w Apigee w wersji 4.54.00 bazowy broker tożsamości wymaga natywnie wiązania pośredniego (wyszukiwanie i wiązanie) i nie obsługuje już wiązania bezpośredniego (prostego). Aby zachować standardy bezpieczeństwa związane z jak najmniejszymi uprawnieniami, SSO w Apigee korzysta teraz z dedykowanego konta usługi z uprawnieniami tylko do odczytu do wyszukiwania w katalogu.

W tej sekcji opisujemy mechanizmy, za pomocą których możesz używać LDAP jako dostawcy tożsamości w Apigee Edge dla chmury prywatnej.

Mechanizm uwierzytelniania: wyszukiwanie i powiązanie (powiązanie pośrednie)

W przypadku wyszukiwania i powiązania użytkownik podaje względną nazwę wyróżniającą (RDN), np. nazwę użytkownika lub adres e-mail, oraz hasło. Następnie SSO w Apigee znajduje nazwę wyróżniającą użytkownika i próbuje ją powiązać. Wyszukiwanie i wiązanie umożliwia dopasowania częściowe.

Poniżej przedstawiamy kroki operacji wyszukiwania i powiązania:

  • Użytkownik podaje identyfikator, np. nazwę użytkownika lub adres e-mail, oraz hasło.
  • Usługa SSO w Apigee przeprowadza wyszukiwanie przy użyciu filtra LDAP i zestawu danych logowania konta usługi z uprawnieniami tylko do odczytu.
  • Jeśli istnieje dokładnie jedno dopasowanie, SSO w Apigee pobiera DN użytkownika. Jeśli nie ma żadnych dopasowań lub jest ich więcej niż jedno, SSO w Apigee odrzuca użytkownika.
  • Następnie SSO w Apigee próbuje powiązać nazwę wyróżniającą użytkownika i podane hasło z serwerem LDAP.
  • Serwer LDAP przeprowadza uwierzytelnianie.
  • Jeśli się powiedzie, SSO w Apigee zwraca token OIDC/OAuth2, który klient może dołączyć do swoich żądań do usług Edge.

Wewnętrzny OpenLDAP (konfiguracja domyślna)

Jeśli używasz wbudowanego serwera Apigee OpenLDAP (gdzie host LDAP jest ustawiony na localhost), proces instalacji automatycznie zabezpiecza konfigurację. Podczas konfiguracji system automatycznie udostępnia konto usługi z jak najmniejszymi uprawnieniami (cn=sso-reader) z losowo wygenerowanym obiektem tajnym i ograniczonym dostępem tylko do odczytu.

Dane logowania administratora roota OpenLDAP (cn=manager) są usuwane z plików konfiguracji SSO w Apigee, aby zapobiec ujawnieniu danych logowania z wysokimi uprawnieniami na dysku.

Jeśli używasz wewnętrznego OpenLDAP, przejdź do sekcji Instalowanie i konfigurowanie SSO w Apigee.

Zewnętrzny firmowy katalog LDAP

Jeśli łączysz SSO w Apigee z zewnętrznym katalogiem LDAP, takim jak firmowa usługa Active Directory, przed konfiguracją musisz podać wstępnie udostępnione konto usługi tylko do odczytu w katalogu. SSO w Apigee będzie używać tego konta wyłącznie do operacji wyszukiwania i powiązania.

Właściwości konfiguracji zewnętrznego serwera LDAP

Aby skonfigurować zewnętrzny katalog LDAP, podaj w pliku konfiguracji szczegóły konta usługi tylko do odczytu. Skrypt setup-sso automatycznie wstrzyknie niezbędne tokeny do konfiguracji.

Dodaj do pliku konfiguracji te właściwości, na przykład /opt/silent.conf:

ENABLE_SSO=y
SSO_EXTERNAL_LDAP=y
SSO_LDAP_HOST=corp-ad.company.com
SSO_LDAP_PORT=636

# Set to false for secure connection
SSO_LDAP_INSECURE_SKIP_VERIFY=false

# The DN and password of your pre-provisioned read-only service account
SSO_LDAP_BIND_DN="cn=svc-apigee,ou=ServiceAccounts,dc=corp,dc=com"
SSO_LDAP_BIND_PW="password"

# The base DN for user searches
SSO_LDAP_USER_BASE_DN="ou=Employees,dc=corp,dc=com"

# The filter used to search for the user
SSO_LDAP_USER_FILTER="(&(objectClass=user)(objectCategory=person))"

# The attribute containing the user's email address
SSO_LDAP_USER_EMAIL_ATTR="mail"

# (Optional) The attribute containing the user's ID
# SSO_LDAP_USER_ID_ATTR="sAMAccountName"

# (Optional) The attribute containing the user's display name
# SSO_LDAP_USER_NAME_ATTR="displayName"

Po zdefiniowaniu tych właściwości przejdź do sekcji Instalowanie i konfigurowanie SSO w Apigee.