External Provider Configuration
External provider setup requirements for delegated CAS authentication
This guide covers the external provider setup requirements when using delegated CAS authentication with providers like Azure AD B2C, Auth0, and Okta.
Configuration by Wicket Team: External provider configuration is performed by Wicket implementation team, not through a self-service UI. Contact Wicket support to set up delegated authentication.
For Developers: Your application code remains unchanged when using delegated authentication. You still implement standard CAS authentication (see CAS Implementation Guide). This guide documents what you need to provide to Wicket implementation team.
Overview
When CAS is configured for delegated authentication:
- Application redirects user to CAS (standard CAS flow)
- CAS delegates authentication to external provider (transparent proxy)
- External Provider (B2C, Auth0, Okta) authenticates user
- CAS receives authentication result and translates it back to CAS protocol
- CAS returns service ticket with person UUID to application (standard CAS response)
- Application validates ticket and extracts person UUID (standard CAS flow)
Key Point: Your application sees this as standard CAS authentication. The delegation happens entirely within CAS infrastructure.
Configuration Workflow
You: Set Up External Provider
Configure your external provider (B2C, Auth0, Okta, etc.) and gather connection details:
- Provider type and endpoints
- Client credentials
- Certificates (for SAML)
- Attribute/claim mappings
You: Provide Details to Wicket Team
Send connection details and requirements to Wicket implementation team via support ticket.
Wicket Team: Configures CAS Delegation
Wicket implementation team configures:
- External provider connection in Wicket infrastructure
- CAS delegation to your provider
- Attribute translation (external claims → CAS attributes)
- Person UUID resolution
You: Set Up Middleware iPaaS
Configure middleware iPaaS to sync users:
- Listen for Wicket webhooks (
roles.granted, etc.) - Create/update users in external provider
- Call
/user_identities/provisionto link accounts
You: Deploy Standard CAS Authentication
Your application uses standard CAS authentication (no special code for delegation).
OpenID Connect (OIDC)
Supported Providers
- Azure AD B2C
- Auth0
- Okta
- Google Identity Platform
- Keycloak
- Any OIDC-compliant provider
Configuration Requirements
When setting up OIDC providers, administrators need:
| Field | Description | Example |
|---|---|---|
| Discovery URL | OIDC discovery endpoint | https://your-tenant.b2clogin.com/.well-known/openid-configuration |
| Client ID | OAuth client identifier | a1b2c3d4-e5f6-... |
| Client Secret | OAuth client secret | secret_abc123... |
| Scopes | Requested scopes | openid email profile |
| Callback URL | Redirect URI after auth | https://your-wicket.com/auth/callback |
Example: Azure AD B2C
This example shows the Azure B2C configuration you'll set up and provide to Wicket implementation team.
In Azure Portal:
- Navigate to Azure AD B2C → App registrations
- Click New registration
- Configure:
- Name: Wicket CAS Integration
- Redirect URI:
https://your-wicket-cas.com/oauth2/callback(CAS callback, not your app) - Supported account types: Accounts in this organizational directory only
- After creation, note:
- Application (client) ID:
12345678-1234-... - Directory (tenant) ID:
87654321-4321-...
- Application (client) ID:
- Go to Certificates & secrets → Create new client secret
- Note the Client secret value:
abc123...
User Flow Setup:
- Navigate to User flows → Create new user flow
- Select Sign up and sign in
- Configure attributes to collect:
- Email address (required)
- Given name
- Family name
- Object ID (for external_id)
- Note the user flow name:
B2C_1_signupsignin
Discovery URL format:
https://{tenant-name}.b2clogin.com/{tenant-name}.onmicrosoft.com/{user-flow}/v2.0/.well-known/openid-configurationInformation to provide Wicket implementation team:
Submit a support ticket with:
Provider Type: Azure AD B2C (OpenID Connect)
Tenant Name: your-tenant
Discovery URL: https://your-tenant.b2clogin.com/your-tenant.onmicrosoft.com/B2C_1_signupsignin/v2.0/.well-known/openid-configuration
Client ID: 12345678-1234-...
Client Secret: abc123...
Scopes: openid email profile
Attribute Mappings:
- External ID: sub (OIDC subject claim)
- Email: email or emails[0]
- Given Name: given_name
- Family Name: family_name
CAS Callback URL: (Wicket team will provide this)Wicket team will configure:
- External provider connection
- CAS delegation settings
- Attribute translation (B2C claims → CAS attributes)
- Person UUID resolution from external_id
You'll receive:
- CAS callback URL to whitelist in Azure B2C
- Provider slug for middleware iPaaS configuration
- Confirmation when setup is complete
iPaaS Integration:
Middleware handles syncing users between Wicket and B2C:
// Example: iPaaS webhook handler (NOT application code)
async function handleRolesGrantedWebhook(webhookData) {
const { person_id, email, given_name, family_name } = webhookData.person;
// 1. Create user in B2C
const b2cUser = await createB2CUser({
email,
givenName: given_name,
surname: family_name
});
// 2. Link B2C user to Wicket person
await provisionUserIdentity({
provider_slug: 'b2c',
external_id: b2cUser.id, // B2C object ID
person_id: person_id
});
console.log(`Provisioned B2C user ${b2cUser.id} for person ${person_id}`);
}Provisioning Flow:
- Person created/updated in Wicket Admin
roles.grantedwebhook fires to iPaaS- iPaaS creates/updates B2C user account
- iPaaS calls
/user_identities/provisionto link B2C ID to Wicket person - Person can now authenticate via CAS → B2C delegation
Example: Auth0
Your Auth0 Setup:
- Navigate to Applications → Applications → Create Application
- Select Regular Web Application
- Configure:
- Name: Wicket CAS Integration
- Application Type: Regular Web Application
- Note these details for Wicket team:
- Domain:
your-tenant.auth0.com - Client ID:
abc123... - Client Secret:
secret...
- Domain:
- Settings → Application URIs:
- Allowed Callback URLs: (Wicket team will provide CAS callback URL)
- Allowed Logout URLs: (Wicket team will provide)
Provide to Wicket Team:
Provider Type: Auth0 (OpenID Connect)
Domain: your-tenant.auth0.com
Discovery URL: https://your-tenant.auth0.com/.well-known/openid-configuration
Client ID: abc123...
Client Secret: secret...
Scopes: openid email profile
Attribute Mappings:
- External ID: sub
- Email: email
- Given Name: given_name
- Family Name: family_nameWicket implementation team will configure delegation and provide CAS callback URL to whitelist in Auth0.
SAML 2.0
Supported Providers
- Azure AD
- Okta
- OneLogin
- Shibboleth
- Any SAML 2.0 compliant IdP
Configuration Requirements
Provide these details to Wicket implementation team:
| Field | Description |
|---|---|
| IdP Entity ID | SAML identity provider entity identifier |
| SSO URL | SAML single sign-on endpoint |
| SLO URL | Single logout endpoint (optional) |
| X.509 Certificate | IdP signing certificate (PEM format) |
| Metadata URL | IdP metadata endpoint (if available) |
Attribute Mappings:
- External ID (NameID or specific attribute)
- Given name
- Family name
Example: Okta SAML
Your Okta Setup:
-
Applications → Create App Integration
-
Select SAML 2.0
-
Configure (use placeholder values, Wicket team will provide actual URLs):
- Single sign-on URL: (Wicket team will provide CAS ACS URL)
- Audience URI (SP Entity ID): (Wicket team will provide)
- Attribute Statements:
email→user.emailfirstName→user.firstNamelastName→user.lastNameexternalId→user.id
-
Download the X.509 Certificate
-
Note the Identity Provider metadata URL
Provide to Wicket Team:
Provider Type: Okta (SAML 2.0)
IdP Entity ID: http://www.okta.com/exkAbc123...
SSO URL: https://your-okta.okta.com/app/abc123/sso/saml
Metadata URL: https://your-okta.okta.com/app/abc123/sso/saml/metadata
X.509 Certificate: [Attach certificate file]
Attribute Mappings:
- External ID: NameID or externalId attribute
- Email: email
- Given Name: firstName
- Family Name: lastNameWicket implementation team will configure SAML integration and provide SP Entity ID and ACS URL to complete Okta setup.
OAuth 2.0
Custom OAuth Providers
For OAuth 2.0 providers that don't support OpenID Connect.
Information to Provide Wicket Team:
Provider Type: OAuth 2.0
Provider Name: [Your Provider]
Authorization URL: https://provider.com/oauth/authorize
Token URL: https://provider.com/oauth/token
User Info URL: https://provider.com/api/user
Client ID: your-client-id
Client Secret: your-client-secret
Scopes: user:read user:email
Attribute Mappings:
- External ID: id (from user info endpoint)
- Email: email
- Given Name: first_name
- Family Name: last_name
Callback URL: (Wicket team will provide)Wicket implementation team will configure OAuth integration. Your application uses standard CAS authentication — CAS handles OAuth flow internally.
External CAS Providers
In some scenarios, you might integrate with an external CAS server (not Wicket's CAS) that manages authentication for another system (e.g., university CAS, corporate CAS).
Information to Provide Wicket Team:
Provider Type: CAS Protocol
CAS Server URL: https://cas.your-university.edu
CAS Version: 3.0
Service URL: (Wicket team will provide)
Attribute Mappings:
- External ID: username or uid attribute
- Email: email attribute
- Given Name: givenName attribute
- Family Name: sn or surname attributeHow it works:
- Your app → Wicket CAS → External CAS → User authenticates → External CAS → Wicket CAS (resolves person UUID) → Your app
Wicket implementation team configures CAS-to-CAS delegation, allowing Wicket to integrate with existing CAS infrastructure while maintaining standard CAS interface for your application.
Attribute Mapping
When configuring external providers, specify how provider attributes map to Wicket person fields.
Common Mappings
| Wicket Field | OIDC Claim | SAML Attribute | Description |
|---|---|---|---|
external_id | sub | NameID | Unique user identifier (required) |
email | email | email | Email address |
given_name | given_name | firstName | First name |
family_name | family_name | lastName | Last name |
Custom Attribute Mappings
Include custom attribute mappings when providing details to Wicket team:
Standard Mappings:
- External ID: sub (or NameID for SAML)
- Email: email
- Given Name: given_name
- Family Name: family_name
Custom Mappings:
- Department: department claim/attribute
- Employee ID: employeeId claim/attribute
- Job Title: jobTitle claim/attributeWicket implementation team will configure these mappings. Middleware iPaaS automatically includes custom attributes when calling /user_identities/provision.
Testing Delegated Authentication
1. Test CAS Delegation Flow
As a developer:
- Implement standard CAS authentication in your application (see SSO Guide)
- Test with standard Wicket CAS (should work)
- Have administrator configure external provider delegation
- Test again — should work identically (CAS handles delegation transparently)
2. Verify User Can Authenticate
Test steps:
- Navigate to your application login
- Application redirects to CAS
- CAS detects delegation and redirects to external provider (B2C, Auth0, etc.)
- User authenticates with external provider
- External provider returns to CAS
- CAS translates response and returns ticket to your application
- Application validates ticket and extracts person UUID (standard CAS flow)
- User logged in successfully
3. Verify User Identity Linkage
Check that the user identity was provisioned by middleware:
GET /people/{person_id}/user_identitiesShould return:
{
"data": [{
"type": "user_identities",
"attributes": {
"provider_slug": "b2c",
"external_id": "external-user-id-from-b2c",
"provider_type": "generic_oidc"
}
}]
}Troubleshooting
Invalid Redirect URI
Error: redirect_uri_mismatch
Solutions:
- Verify redirect URI in provider config matches exactly
- Check for trailing slashes (
/callbackvs/callback/) - Ensure HTTPS in production
Invalid Client Credentials
Error: invalid_client
Solutions:
- Verify Client ID and Secret are correct
- Check credentials haven't expired or been rotated
- Ensure correct environment (dev/staging/prod) credentials
Missing Email Claim
Error: Provisioning fails, email required
Solutions:
- Request
emailscope in authorization request - Check attribute mapping includes email
- Verify provider returns email in token/assertion
User Identity Not Created
Error: CAS authentication succeeds but user identity not in Wicket
Solutions:
- Verify middleware iPaaS is receiving webhooks
- Check iPaaS logs for provisioning errors
- Ensure iPaaS has admin token with proper permissions
- Verify
provider_slugin iPaaS matches Wicket Admin configuration - Review Wicket webhook delivery logs