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

• Guidewire Developer Portal

• Cloud API Authentication

• Guidewire Hub Registration

• Guidewire Cloud Console

Next Steps

After successful auth, proceed to guidewire-hello-world for your first API calls.