Guidewire Install & Auth
Overview
Set up Guidewire InsuranceSuite development environment and configure Cloud API authentication with Guidewire Hub using OAuth2 and JWT tokens.
Prerequisites
- JDK 11 or 17 (Guidewire Cloud 202503+ requires JDK 17)
- Gradle 7.x or 8.x
- Guidewire Cloud account with developer access
- Access to Guidewire Cloud Console (GCC)
- Guidewire Hub registration for your application
Instructions
Step 1: Install Development Tools
Step 2: Configure Guidewire Studio
Step 3: Register Application with Guidewire Hub
For detailed implementation code and configurations, load the reference guide:
Read(${CLAUDE_SKILL_DIR}/references/implementation-guide.md)
- Log into Guidewire Cloud Console (GCC) at
https://gcc.guidewire.com
- Navigate to Identity & Access > Applications
- Click Register Application
- Select application type:
-
Browser Application - For Jutro frontends (OAuth2 Authorization Code flow)
-
Service Application - For backend integrations (OAuth2 Client Credentials flow)
- Record the
client_id and client_secret
Step 4: Configure OAuth2 Credentials
Step 5: Obtain Access Token (Service Application)
Step 6: Verify Connection
Gosu Authentication (Server-Side)
Output
- Configured Guidewire Studio project
- OAuth2 credentials in environment variables
- Verified connection to Cloud API endpoints
- JWT token acquisition working
Error Handling
| Error |
Cause |
Solution |
invalid_client |
Wrong client credentials |
Verify client_id and secret in GCC |
invalid_scope |
Unauthorized scope requested |
Check API role assignments in GCC |
401 Unauthorized |
Expired or invalid token |
Refresh token, check clock sync |
403 Forbidden |
Missing API role permissions |
Assign appropriate API roles in GCC |
PKIX path building failed |
SSL certificate issue |
Import Guidewire CA certificates |
API Roles Configuration
Configure in Guidewire Cloud Console:
Examples
Complete TypeScript Client Setup
Resources
Next Steps
After successful auth, proceed to guidewire-hello-world for your first API calls.
