tessl install github:jeremylongshore/claude-code-plugins-plus-skills --skill guidewire-install-authInstall and configure Guidewire InsuranceSuite development environment and Cloud API authentication. Use when setting up a new Guidewire integration, configuring OAuth2 credentials, registering with Guidewire Hub, or initializing Guidewire Studio. Trigger with phrases like "install guidewire", "setup guidewire", "guidewire auth", "configure guidewire API", "guidewire cloud credentials".
Review Score
81%
Validation Score
13/16
Implementation Score
65%
Activation Score
100%
Set up Guidewire InsuranceSuite development environment and configure Cloud API authentication with Guidewire Hub using OAuth2 and JWT tokens.
# Verify Java installation
java -version
# Required: openjdk 17.x or 11.x
# Install Gradle if needed
sdk install gradle 8.5
# Clone your InsuranceSuite configuration repository
git clone https://your-org@dev.azure.com/your-org/PolicyCenter/_git/PolicyCenter
cd PolicyCenter# Set environment variables
export GW_HOME=/path/to/guidewire/installation
export JAVA_HOME=/path/to/jdk17
# Import project into IntelliJ IDEA (recommended IDE)
# File > Open > Select the build.gradle filehttps://gcc.guidewire.comclient_id and client_secret# Create environment configuration
cat > .env << 'EOF'
# Guidewire Cloud API Configuration
GW_TENANT_ID=your-tenant-id
GW_CLIENT_ID=your-client-id
GW_CLIENT_SECRET=your-client-secret
GW_HUB_URL=https://hub.guidewire.com
GW_API_BASE_URL=https://your-tenant.cloud.guidewire.com
# Application endpoints
POLICYCENTER_URL=${GW_API_BASE_URL}/pc/rest
CLAIMCENTER_URL=${GW_API_BASE_URL}/cc/rest
BILLINGCENTER_URL=${GW_API_BASE_URL}/bc/rest
EOF// TypeScript/Node.js - OAuth2 Client Credentials Flow
import axios from 'axios';
interface TokenResponse {
access_token: string;
token_type: string;
expires_in: number;
}
async function getAccessToken(): Promise<string> {
const tokenUrl = `${process.env.GW_HUB_URL}/oauth/token`;
const response = await axios.post<TokenResponse>(tokenUrl,
new URLSearchParams({
grant_type: 'client_credentials',
client_id: process.env.GW_CLIENT_ID!,
client_secret: process.env.GW_CLIENT_SECRET!,
scope: 'pc.policies cc.claims bc.billing'
}),
{
headers: { 'Content-Type': 'application/x-www-form-urlencoded' }
}
);
return response.data.access_token;
}// Test API connection
async function verifyConnection(): Promise<void> {
const token = await getAccessToken();
const response = await axios.get(
`${process.env.POLICYCENTER_URL}/common/v1/system-info`,
{
headers: {
'Authorization': `Bearer ${token}`,
'Content-Type': 'application/json'
}
}
);
console.log('Connected to PolicyCenter:', response.data);
}// Gosu - Internal authentication for plugins
uses gw.api.system.server.ServerUtil
uses gw.api.web.SessionUtil
class AuthHelper {
static function getAuthenticatedUser() : User {
return SessionUtil.CurrentUser
}
static function runAsSystemUser<T>(block() : T) : T {
return ServerUtil.runAsSystemUser(\-> block())
}
}| 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 |
Configure in Guidewire Cloud Console:
# Recommended API roles for service applications
api_roles:
- PolicyCenter:
- pc_policy_admin
- pc_submission_handler
- pc_product_read
- ClaimCenter:
- cc_claim_admin
- cc_fnol_handler
- BillingCenter:
- bc_billing_admin
- bc_payment_handlerimport axios, { AxiosInstance } from 'axios';
class GuidewireClient {
private token: string | null = null;
private tokenExpiry: Date | null = null;
private httpClient: AxiosInstance;
constructor(
private clientId: string,
private clientSecret: string,
private hubUrl: string,
private apiBaseUrl: string
) {
this.httpClient = axios.create({
baseURL: apiBaseUrl,
timeout: 30000
});
}
private async ensureToken(): Promise<string> {
if (this.token && this.tokenExpiry && this.tokenExpiry > new Date()) {
return this.token;
}
const response = await axios.post(`${this.hubUrl}/oauth/token`,
new URLSearchParams({
grant_type: 'client_credentials',
client_id: this.clientId,
client_secret: this.clientSecret
})
);
this.token = response.data.access_token;
this.tokenExpiry = new Date(Date.now() + (response.data.expires_in - 60) * 1000);
return this.token;
}
async request<T>(method: string, path: string, data?: any): Promise<T> {
const token = await this.ensureToken();
const response = await this.httpClient.request<T>({
method,
url: path,
data,
headers: {
'Authorization': `Bearer ${token}`,
'Content-Type': 'application/json'
}
});
return response.data;
}
}
// Usage
const client = new GuidewireClient(
process.env.GW_CLIENT_ID!,
process.env.GW_CLIENT_SECRET!,
process.env.GW_HUB_URL!,
process.env.POLICYCENTER_URL!
);After successful auth, proceed to guidewire-hello-world for your first API calls.