Integration
To integrate Goiabada with your app, you’ll need an OAuth2/OpenID Connect client library for your platform. Most platforms provide such libraries.
Configuration
Section titled “Configuration”When configuring your OAuth2/OpenID Connect client to work with Goiabada, you’ll typically need:
- Client ID and Client Secret (from Goiabada admin console)
- Issuer URL (normally the auth server base URL) - e.g.,
https://auth.example.com - Authorization Endpoint -
<auth-server-base-url>/auth/authorize - Token Endpoint -
<auth-server-base-url>/auth/token - UserInfo Endpoint -
<auth-server-base-url>/auth/userinfo - JWKS URI -
<auth-server-base-url>/.well-known/jwks.json - End Session Endpoint -
<auth-server-base-url>/auth/logout
Most libraries support automatic configuration via the OpenID Connect Discovery endpoint at <auth-server-base-url>/.well-known/openid-configuration.
Sample integrations
Section titled “Sample integrations”The Goiabada GitHub repository includes sample integrations for various platforms:
JavaScript (browser)
Section titled “JavaScript (browser)”A browser-based JavaScript test client using the oauth4webapi library.
Go web application
Section titled “Go web application”A sample integration using Go. See the go-webapp example.
React SPA with Vite and Node.js
Section titled “React SPA with Vite and Node.js”A React application demonstrating authentication and role (group) based authorization with token auto-refresh.
API endpoints
Section titled “API endpoints” Endpoints reference Complete API documentation for OAuth2/OIDC endpoints.