Developer Documentation
Integrate with AWS LPU SSO.
Connect your application to AWS LPU Identity Services and let users sign in using one AWS LPU account.
Protocol
OAuth 2.0 + OIDC
Authorization
Authorization Code + PKCE
Identity
OpenID Connect
Quick Start
Your application only needs to do four things.
Register your application
Register your application and configure the exact URL where users should return after signing in.
Example
Keep your client secret on your server. Never expose it in frontend code.
Send the user to AWS LPU SSO
Redirect the user to the authorization endpoint with your application details.
https://sso.awslpu.in/authorize?client_id=YOUR_CLIENT_ID&redirect_uri=YOUR_REDIRECT_URI&response_type=code&scope=openid%20profile%20email&state=YOUR_STATE&nonce=YOUR_NONCE&code_challenge=YOUR_CHALLENGE&code_challenge_method=S256client_id
The Client ID generated when you registered your application.
redirect_uri
Must exactly match a redirect URL registered for your application.
state
A random value created before login and verified after the user returns.
nonce + PKCE
Security values generated before sending the user to sign in.
Handle the callback
After the user signs in, AWS LPU SSO redirects them back to your registered redirect URL.
https://yourapp.com/auth/callback?code=AUTHORIZATION_CODE&state=YOUR_STATEVerify that the returned state matches the value created before login. Then use the authorization code to get the user's identity.
Exchange the authorization code
Send the authorization code to the token endpoint from your server.
POST https://sso.awslpu.in/oauth/token
Authorization: Basic BASE64(CLIENT_ID:CLIENT_SECRET)
Content-Type: application/x-www-form-urlencoded
grant_type=authorization_code
&code=AUTHORIZATION_CODE
&redirect_uri=YOUR_REDIRECT_URI
&code_verifier=YOUR_CODE_VERIFIERThe response contains an access token and, when you request the openid scope, an ID token.
{
"access_token": "...",
"token_type": "Bearer",
"expires_in": 900,
"scope": "openid profile email",
"id_token": "..."
}Get user information
Use the access token to get the authenticated user's information.
GET https://sso.awslpu.in/oauth/userinfo
Authorization: Bearer ACCESS_TOKENDepending on the scopes requested, the user information can include their identity, name, email, and profile picture.
{
"sub": "user-id",
"name": "User Name",
"email": "user@example.com",
"picture": "https://..."
}Reference
AWS LPU SSO endpoints
Use these endpoints when integrating your application with AWS LPU Identity Services.
https://sso.awslpu.in/authorizeStarts the user sign-in and authorization process.
https://sso.awslpu.in/oauth/tokenExchanges an authorization code for access and identity tokens.
https://sso.awslpu.in/oauth/userinfoReturns information about the authenticated user.
https://sso.awslpu.in/oauth/jwksProvides public keys used to verify ID tokens.
https://sso.awslpu.in/.well-known/openid-configurationProvides the complete OpenID Connect configuration.
