Signing Key Generation
AgentCube uses an RSA key pair to sign JWT assertions for Oracle token exchange. The private key stays with AgentCube; the public certificate is imported into OCI. The signing happens in the connector, which performs the Oracle token exchange (Layer 2) on behalf of the identity the Context Engine validated at its inbound edge.
Generate the Key Pair
Section titled “Generate the Key Pair”You need OpenSSL. Windows does not include it by default: install it with winget install ShiningLight.OpenSSL.Light, or use the openssl.exe that ships with Git for Windows.
# Generate RSA private key (2048-bit)openssl genrsa -out agentcube-signing.pem 2048
# Generate self-signed X.509 certificate (5-year validity)openssl req -new -x509 -key agentcube-signing.pem -out agentcube-signing.cer -days 1825 -subj "/CN=AgentCube MCP/O={organization_name}"# Generate RSA private key (2048-bit)openssl genrsa -out agentcube-signing.pem 2048
# Generate self-signed X.509 certificate (5-year validity)openssl req -new -x509 \ -key agentcube-signing.pem \ -out agentcube-signing.cer \ -days 1825 \ -subj "/CN=AgentCube MCP/O={organization_name}"This produces two files:
| File | Purpose | Where It Goes |
|---|---|---|
agentcube-signing.pem | Private key — signs JWT assertions | Each EPM connector container (AGENTCUBE_SIGNING_KEY_BASE64 or AGENTCUBE_SIGNING_KEY_PATH) |
agentcube-signing.cer | Public certificate — verifies signatures | OCI Identity Domain trusted partner certificates |
Store the Private Key
Section titled “Store the Private Key”The private key is required on each EPM connector (Planning, FCCS, Essbase) that runs in oidc or internal auth mode. It is not set on the Context Engine. The Context Engine has its own, separate signing key for federated SSO, AGENTCUBE_CE_INTERNAL_SIGNING_KEY, generated the same way (openssl genrsa with 2048 bits); see Certificate Rotation. See Auth Modes and Environment Variables.
For container deployments, base64-encode the private key as a single line:
[Convert]::ToBase64String([IO.File]::ReadAllBytes("agentcube-signing.pem")) | Set-Content agentcube-signing.b64 -NoNewlinebase64 < agentcube-signing.pem | tr -d '\n' > agentcube-signing.b64Set the contents of agentcube-signing.b64 as the AGENTCUBE_SIGNING_KEY_BASE64 environment variable.
Also set AGENTCUBE_SIGNING_KID to the alias you give the certificate in OCI (default agentcube-mcp). The two must match exactly, or the Oracle token exchange fails.
Import the Certificate to OCI
Section titled “Import the Certificate to OCI”See OCI Identity Domain Setup — Step 4.
Security Notes
Section titled “Security Notes”- Protect the private key — treat it like a password. Store it in your platform’s secret management (Azure Key Vault, environment secrets, etc.)
- Never commit the private key or the
.b64file to source control - Certificate expiry — the certificate expires after 5 years (1825 days). See Certificate Rotation for renewal procedures.