Als u foutmeldingen krijgt voor een Security Assertion Markup Language-app (SAML), kunt u deze stappen voor probleemoplossing volgen.
SAML-verzoeken en -reacties coderen of decoderen
Gebruik de SAML-coderings-/decoderings-tool om een SAML-verzoek en -reactie in een door mensen leesbare vorm te verwerken vanuit het HAR-bestand (HTTP Archive Format) om problemen op te lossen. Ga naar https://toolbox.googleapps.com/apps/encode_decode/.
Foutmeldingen bij het maken van SAML-apps
Als u een SAML-app maakt in de Beheerdersconsole, kan de volgende 400-fout worden weergegeven:
400 duplicate entity id
U ziet dit als u een app probeert te maken met een entiteits-ID die al bestaat.
Zo lost u de fout 400 duplicate entity id op:
Gebruik de app die al is ingesteld of gebruik een andere entiteits-ID.
500 fouten bij het maken van SAML-apps
Als u een SAML-app maakt in de Beheerdersconsole, kunt u de volgende 500-fouten krijgen:
- Als je in het gedeelte Gegevens Google-identiteitsprovider op de knop Certificaat downloaden of Metadata downloaden klikt terwijl de backend-service voor certificaten niet beschikbaar is, verschijnt er bovenaan het scherm een 500-fout.
- Als er een time-out optreedt in de schemaservice of als er een backend-uitzondering wordt weergegeven terwijl de schema's worden geladen in NameID-toewijzing of Kenmerktoewijzing, verschijnt er een 500-fout bovenaan het scherm.
- Als de service Service Provider Config niet beschikbaar is, verschijnt er een 500-fout bovenaan het scherm als u op Voltooien klikt.
Zo lost u 500-fouten op bij het maken van SAML-apps:
Wacht even en probeer het proces opnieuw. Als er nog steeds fouten optreden, neemt u contact op met Google Cloud-support.
SAML-runtimefouten
De volgende foutscenario's kunnen optreden als u een SAML Single sign-on-flow (SSO) probeert in door de identiteitsprovider (IdP) of door de serviceprovider (SP) gestarte flows:
403 app_not_configured
Deze fout kan optreden in de volgende situaties:
- In een door de serviceprovider gestarte proces is de app die overeenkomt met de entiteits-ID die in het verzoek wordt genoemd, niet gemaakt in de Beheerdersconsole.
- In een door de serviceprovider gestart proces komt de entiteits-ID in het SAMLRequest niet overeen met een van de entiteits-ID's van de momenteel geïnstalleerde apps. Als iemand de app-ID (SP-ID) in de door de IdP gestarte URL wijzigt, wordt de fout
app_not_configuredweergegeven.
Zo lost u de fout 403 app_not_configured op:
- Zorg dat de app die overeenkomt met de entiteits-ID die in het verzoek wordt vermeld, is geïnstalleerd voordat je het verzoek start.
- Zorg dat de entiteits-ID in het SAMLRequest correct is en overeenkomt met de ID die u heeft ingevoerd toen u de app maakte.
- Zorg dat de SP-ID in de verzoek-URL hetzelfde is als de app-ID app_not_enabled.
403 app_not_configured_for_user
Zo lost u de fout 403 app_not_configured_for_user op:
Controleer of de waarde in de tag saml:Issuer in de SAMLRequest overeenkomt met de waarde van de Entiteits-ID die is ingesteld in het gedeelte Gegevens van de SAML-serviceprovider in de Beheerdersconsole. Deze waarde is hoofdlettergevoelig.
403 app_not_enabled_for_user
Zo lost u de fout 403 app_not_enabled_for_user op:
-
Ga in de Google Beheerdersconsole naar Menu
Apps
Web- en mobiele apps.
Hiervoor is het beheerdersrecht Beheer van mobiele apparaten vereist.
- Zoek in de app-lijst de SAML-app waarvoor de fout is gemaakt.
- Klik op de SAML-app om de pagina Instellingen te openen.
- Klik op Gebruikerstoegang.
- Zet de app AAN voor iedereen of voor de organisatie van de gebruiker.
400 saml_invalid_user_id_mapping
Als een SP een NAMEID-parameter stuurt in het SAMLRequest, moet deze parameter hetzelfde zijn als de parameter die is ingesteld aan de IdP-kant. Anders mislukt het SAMLRequest met deze foutmelding.
Zo lost u de fout 400 saml_invalid_user_id_mapping op:
- Ga naar Basisgegevens en controleer de parameter NAMEID.
- Zorg dat de parameter NAMEID die wordt doorgegeven in het SAMLRequest hetzelfde is als de parameter die is ingesteld aan de IdP-kant.
400 saml_invalid_sp_id
Deze fout treedt op als de serviceprovider-ID in de URL van het IdP-proces onjuist is, vanwege een onjuiste configuratie of manipulatie van de URL.
Zo lost u de fout 400 saml_invalid_sp_id op:
- Ga naar Basisgegevens en vink het veld app-id aan.
- Controleer of de SP-ID in de verzoek-URL hetzelfde is als de app-ID.
De SAML-reactie stuurt de status DENIED in de volgende situaties. Je kunt een van de volgende 3 gerelateerde foutmeldingen krijgen.
SP-initiated Flow Invalid request, ACS URL in request $parameter doesn't match configured ACS URL $parameter.
In dit geval komen de ACS-URL die is ingevoerd in het SAMLRequest en de ACS-URL die is ingesteld in de Beheerdersconsole voor de bijbehorende app niet overeen.
Zo lost u de foutmelding 'ACS-URL in verzoek $parameter komt niet overeen met geconfigureerde ACS-URL $parameter' op:
- Ga naar Gegevens van de serviceprovider.
- Controleer of de ACS-URL overeenkomt met die in het SAML-verzoek.
Invalid idpid provided in the url
De IdP-ID (een verborgen klant-ID) in de URL is gewijzigd en is onjuist.
Zo lost u de fout 'Ongeldige IdP-ID in URL' op:
-
Ga in de Google Beheerdersconsole naar Menu
Beveiliging
Verificatie
SSO met SAML-apps.
U moet zijn ingelogd als hoofdbeheerder om deze taak te kunnen uitvoeren.
- Haal de tekenreeks idpid op aan het einde van de URL Entiteits-ID.
- Zorg dat de IdP-ID in de verzoek-URL hetzelfde is als de ID in de URL van de entiteits-ID.
IdP-initiated Flow Invalid idpid provided in the request.
De beller heeft de door de IdP gestarte SSO-URL gemanipuleerd en de IdP-ID gewijzigd in een andere klant-ID (onherkenbaar gemaakt).
Zo lost u de foutmelding 'Ongeldige IdP-ID in verzoek' op:
-
Ga in de Google Beheerdersconsole naar Menu
Beveiliging
Verificatie
SSO met SAML-apps.
U moet zijn ingelogd als hoofdbeheerder om deze taak te kunnen uitvoeren.
- Haal de tekenreeks idpid op aan het einde van de URL Entiteits-ID.
- Zorg dat de IdP-ID in de verzoek-URL hetzelfde is als de ID in de entiteits-ID-URL.
500-fouten bij het testen van een SAML SSO-flow
Als je gebruikers een SAML SSO-proces testen in door IdP of SP gestarte processen, kunnen ze een van de verschillende 500-fouten tegenkomen omdat backend-processen niet beschikbaar zijn.
Zo lost u 500-fouten op bij het testen van een SAML SSO-proces:
Wacht even en voer het proces dan opnieuw uit. Als dit nog steeds niet werkt, neemt u contact op met Google Cloud-support.
Foutmeldingen bij toegang tot SAML-apps
1000 bij toegang tot de pagina van een SAML-app
Zo lost u de foutmelding over de toegang tot de SAML-app-pagina op:
Neem contact op met Google Cloud-support.
1000 bij toegang tot de instellingen van een SAML-app
Zo lost u de foutmelding over de toegang tot de instellingen van de SAML-app op:
Neem contact op met Google Cloud-support.
Foutmelding 'SAML app user schema deletion'
400
Deze fout treedt op als u een aangepast schema probeert te verwijderen dat is gekoppeld als kenmerktoewijzing voor een SAML-app die al is verwijderd. Als je het schema hebt gemaakt voordat dit probleem werd opgelost, kan deze fout optreden.
Zo lost u de fout bij het verwijderen van het gebruikersschema voor SAML-apps op:
Neem contact op met Google Cloud-support.