Jeśli zobaczysz komunikat o błędzie aplikacji SAML (Security Assertion Markup Language), wykonaj te czynności, aby rozwiązać problem.
Kodowanie oraz dekodowanie żądań i odpowiedzi SAML
Aby ułatwić rozwiązywanie problemów, użyj narzędzia do kodowania/dekodowania SAML, aby przetworzyć żądanie i odpowiedź SAML w formacie czytelnym dla człowieka z pliku HAR (HTTP Archive Format). Zobacz https://toolbox.googleapps.com/apps/encode_decode/.
Błędy tworzenia aplikacji SAML
Podczas tworzenia aplikacji SAML w konsoli administracyjnej może pojawić się ten błąd 400:
400 duplicate entity id (zduplikowany identyfikator jednostki)
Ten komunikat pojawi się, jeśli spróbujesz utworzyć aplikację z istniejącym już identyfikatorem jednostki.
Aby rozwiązać problem z błędem 400 dotyczącym zduplikowanego identyfikatora jednostki:
Użyj aplikacji, która jest już skonfigurowana, lub użyj innego identyfikatora jednostki.
Błędy 500 podczas tworzenia aplikacji SAML
Podczas tworzenia aplikacji SAML w konsoli administracyjnej mogą pojawić się te błędy 500:
- Jeśli w sekcji Informacje o dostawcy tożsamości Google klikniesz przycisk Pobierz certyfikat lub Pobierz metadane, gdy usługa backendu usługi certyfikatów jest niedostępna, u góry ekranu pojawi się błąd 500.
- Jeśli podczas wczytywania schematów w sekcji Mapowanie NameID lub Mapowanie atrybutów upłynie limit czasu usługi schematu lub pojawi się wyjątek backendu, u góry ekranu wyświetli się błąd 500.
- Jeśli usługa Service Provider Config jest niedostępna, po kliknięciu Zakończ u góry ekranu pojawi się błąd 500.
Aby rozwiązać błędy 500 podczas tworzenia aplikacji SAML:
Zaczekaj chwilę i spróbuj ponownie. Jeśli błędy nadal występują, skontaktuj się z zespołem pomocy Google Cloud.
Błędy środowiska wykonawczego SAML
Podczas testowania logowania jednokrotnego (SSO) przez SAML inicjowanego przez dostawcę tożsamości (IdP) lub dostawcę usług (SP) mogą wystąpić te błędy:
403 app_not_configured (aplikacja nie jest skonfigurowana)
Ten błąd może wystąpić w następujących przypadkach:
- W przepływie inicjowanym przez dostawcę usługi aplikacja odpowiadająca identyfikatorowi jednostki wymienionemu w żądaniu nie została utworzona w konsoli administracyjnej.
- W przepływie inicjowanym przez dostawcę usługi identyfikator jednostki podany w żądaniu SAMLRequest nie pasuje do żadnego z identyfikatorów jednostek obecnie zainstalowanych aplikacji. Jeśli ktoś zmodyfikuje identyfikator aplikacji (identyfikator dostawcy usługi) podany w adresie URL zainicjowanym przez dostawcę tożsamości, pojawi się błąd
app_not_configured.
Aby rozwiązać problem z błędem 403 app_not_configured:
- Przed zainicjowaniem żądania upewnij się, że aplikacja odpowiadająca identyfikatorowi jednostki wymienionemu w żądaniu została zainstalowana.
- Upewnij się, że identyfikator jednostki podany w SAMLRequest jest prawidłowy i zgodny z identyfikatorem podanym podczas tworzenia aplikacji.
- Upewnij się, że identyfikator dostawcy usług przekazywany w adresie URL żądania jest taki sam jak identyfikator aplikacji. app_not_enabled.
403 app_not_configured_for_user (aplikacja nieskonfigurowana dla użytkownika)
Aby rozwiązać problem z błędem 403 app_not_configured_for_user:
Sprawdź, czy wartość w tagu saml:Issuer w SAMLRequest odpowiada wartości Identyfikator jednostki skonfigurowanej w sekcji Informacje o dostawcy usługi SAML w konsoli administracyjnej. W przypadku tej wartości wielkość liter ma znaczenie.
403 app_not_enabled_for_user (aplikacja wyłączona dla użytkownika)
Aby rozwiązać problem z błędem 403 app_not_enabled_for_user:
-
W konsoli administracyjnej Google otwórz Menu
Aplikacje
Aplikacje internetowe i mobilne.
Wymaga uprawnień administratora Zarządzanie urządzeniami mobilnymi.
- Na liście aplikacji znajdź aplikację SAML generującą błąd.
- Kliknij aplikację SAML, aby otworzyć jej stronę ustawień.
- Kliknij Dostęp użytkownika.
- Włącz aplikację dla wszystkich lub dla organizacji użytkownika.
400 saml_invalid_user_id_mapping (nieprawidłowe mapowanie identyfikatora użytkownika SAML)
Jeśli dostawca usługi wysyła parametr NAMEID w żądaniu SAMLRequest, musi on być taki sam jak parametr skonfigurowany po stronie dostawcy tożsamości. W przeciwnym razie żądanie SAMLRequest nie powiedzie się i pojawi się ten błąd.
Aby rozwiązać problem z błędem 400 saml_invalid_user_id_mapping:
- Otwórz Informacje podstawowe i sprawdź parametr NAMEID.
- Upewnij się, że parametr NAMEID przekazywany w SAMLRequest jest taki sam jak ten skonfigurowany po stronie dostawcy tożsamości.
400 saml_invalid_sp_id (nieprawidłowy identyfikator dostawcy usług SAML)
Ten błąd występuje, gdy identyfikator dostawcy usługi w adresie URL przepływu dostawcy tożsamości jest nieprawidłowy z powodu nieprawidłowej konfiguracji lub manipulowania adresem URL.
Aby rozwiązać błąd 400 saml_invalid_sp_id:
- Otwórz Informacje podstawowe i sprawdź pole app-id.
- Upewnij się, że identyfikator dostawcy usług przekazywany w adresie URL żądania jest taki sam jak app-id.
W następujących przypadkach w odpowiedzi SAML jest odsyłany stan DENIED (ODRZUCONO). Może wyświetlić się jeden z 3 powiązanych komunikatów o błędzie.
SP-initiated Flow Invalid request (Nieprawidłowe żądanie przepływu inicjowanego przez dostawcę usługi), ACS URL in request $parameter doesn't match configured ACS URL $parameter (Parametr $parameter adresu URL usługi ACS w żądaniu nie odpowiada skonfigurowanemu parametrowi $parameter adresu URL usługi ACS).
W tym przypadku adres URL usługi ACS określony w SAMLRequest i adres URL usługi ACS skonfigurowany w konsoli administracyjnej dla odpowiedniej aplikacji nie są zgodne.
Aby rozwiązać problem z błędem „Adres URL usługi ACS w żądaniu $parameter nie jest zgodny ze skonfigurowanym adresem URL usługi ACS $parameter”:
- Otwórz Informacje o dostawcy usługi.
- Upewnij się, że URL usługi ACS jest taki sam jak w żądaniu SAMLRequest.
Invalid idpid provided in the url (W adresie URL podano nieprawidłowy identyfikator dostawcy tożsamości)
Identyfikator dostawcy tożsamości (ukryty identyfikator klienta) podany w adresie URL został zmieniony i jest nieprawidłowy.
Aby rozwiązać problem z nieprawidłowym identyfikatorem dostawcy tożsamości w adresie URL:
-
W konsoli administracyjnej Google otwórz Menu
Bezpieczeństwo
Uwierzytelnianie
Logowanie jednokrotne w aplikacjach SAML.
Aby wykonać te czynności, musisz zalogować się na konto superadministratora.
- Skopiuj ciąg idpid z końca adresu URL identyfikatora jednostki.
- Upewnij się, że Identyfikator dostawcy tożsamości w adresie URL żądania jest taki sam jak w adresie URL identyfikatora jednostki.
IdP-initiated Flow Invalid idpid provided in the request (W żądaniu podano nieprawidłowy identyfikator dostawcy tożsamości przepływu inicjowanego przez tego dostawcę)
Użytkownik wywołujący zmodyfikował adres URL logowania jednokrotnego inicjowanego przez dostawcę tożsamości i zmienił identyfikator dostawcy tożsamości na inny identyfikator klienta (ukryty).
Aby rozwiązać problem z błędem nieprawidłowego identyfikatora dostawcy tożsamości w żądaniu:
-
W konsoli administracyjnej Google otwórz Menu
Bezpieczeństwo
Uwierzytelnianie
Logowanie jednokrotne w aplikacjach SAML.
Aby wykonać te czynności, musisz zalogować się na konto superadministratora.
- Pobierz ciąg idpid z końca adresu URL identyfikatora jednostki.
- Upewnij się, że Identyfikator dostawcy tożsamości w adresie URL żądania jest taki sam jak w adresie URL identyfikatora jednostki.
Błędy 500 podczas testowania procesu logowania jednokrotnego SAML
Gdy użytkownicy testują proces logowania jednokrotnego SAML inicjowany przez dostawcę tożsamości lub dostawcę usługi, mogą napotkać jeden z kilku błędów 500 z powodu niedostępności procesów backendu.
Aby rozwiązać błędy 500 podczas testowania procesu logowania jednokrotnego przez SAML:
Poczekaj, a następnie spróbuj ponownie wykonać ten proces. Jeśli to nie pomoże, skontaktuj się z zespołem pomocy Google Cloud.
Komunikaty o błędach związane z dostępem do aplikacji SAML
Błąd 1000 przy próbie uzyskania dostępu do strony w aplikacji SAML
Aby rozwiązać problem z błędem dostępu do strony aplikacji SAML:
Skontaktuj się z zespołem pomocy Google Cloud.
Błąd 1000 przy próbie uzyskania dostępu do ustawień aplikacji SAML
Aby rozwiązać problem z błędem dostępu do ustawień aplikacji SAML:
Skontaktuj się z zespołem pomocy Google Cloud.
Komunikat o błędzie informujący o usunięciu schematu użytkownika aplikacji SAML
400
Ten błąd występuje, gdy próbujesz usunąć schemat niestandardowy powiązany jako mapowanie atrybutów z aplikacją SAML, która została już usunięta. Jeśli schemat został utworzony przed rozwiązaniem tego problemu, może wystąpić ten błąd.
Aby rozwiązać problem z błędem usuwania schematu użytkownika aplikacji SAML:
Skontaktuj się z zespołem pomocy Google Cloud.