Overview
When authenticating to the Tyk Enterprise Developer Portal via Single Sign-On (SSO) using an OpenID Connect (OIDC) identity provider, the authentication redirect may fail at the callback URL with a generic Login Failed message on the portal screen.
Root Cause
During the SSO callback flow, the Developer Portal attempts to auto-provision or retrieve the developer profile using user attributes supplied by the Identity Provider (IdP). If the IdP returns an ID token or a /userinfo response where the email claim is omitted, null, or empty, user registration fails because an email address is mandatory for developer accounts.
Reviewing the Enterprise Developer Portal container logs reveals the following error:
Register | Creating user. Email: SSO key:
message: saving user in store: email is requiredSteps to Resolve
- Inspect the ID Token: Decode the JWT ID token issued by your IdP using a JWT decoder tool and verify whether the
emailclaim exists and contains a non-empty string. - Query the UserInfo Endpoint: If
SkipUserInfoRequestis set tofalsein your TIB profile or the ID token does not contain user profile attributes, query the IdP/userinfoendpoint using the access token:
curl -X GET -H "Authorization: Bearer "Confirm that the returned JSON payload includes the email field with a valid address.
- Verify Identity Provider Scopes and Mappings: Ensure the
openidandemailscopes are requested in the TIB profile and permitted in the IdP client configuration. Confirm that your IdP user directory maps a valid email address to the standardemailclaim. - Configure Custom Email Field if Necessary: If your Identity Provider returns the email address under a non-standard claim name (such as
mailorupn), specify that attribute in the TIB profile under theCustomEmailFieldproperty.
Verification
Retry the SSO login flow from the Developer Portal login page. Upon completing authentication at the IdP, verify that the redirect completes successfully and the developer profile is provisioned in the portal.
Applies To
- Tyk Enterprise Developer Portal
- Tyk Identity Broker (TIB) OIDC / SocialProvider Redirect Flow
- Tyk Cloud and Self-Managed Deployments
Comments
0 comments
Please sign in to leave a comment.