Skip to content

Quick Start — Basic Auth

Basic auth is the fastest way to deploy AgentCube. It uses a service account for all Oracle API calls — every user shares the same Oracle credentials and data access.

When to use basic auth

Basic auth is ideal for evaluations, demos, development, and deployments where per-user data security is not required. You can upgrade to SSO later without redeploying.

Prerequisites

  • Oracle EPM environment with REST API access
  • A service account with appropriate Oracle permissions
  • Container hosting platform (Azure Container Apps, Docker, etc.)

Step 1: Gather Oracle Credentials

For Essbase

Value Description Example
Server URL Essbase REST API base URL https://{essbase_host}
Username Service account (email format for Essbase 21c) {user}@{domain}
Password Service account password —

For Planning

Value Description Example
Planning URL Planning REST API base URL https://{planning_host}/HyperionPlanning
Username Service account username {username}
Password Service account password —
Identity Domain Optional, required for some environments {identity_domain}

Step 2: Deploy the Container

See Container Deployment for detailed instructions. The minimum configuration requires just three environment variables per connector.

Essbase — Minimum Configuration

ESSBASE_SERVER_URL={essbase_url}
ESSBASE_USERNAME={username}
ESSBASE_PASSWORD={password}

Planning — Minimum Configuration

PLANNING_URL={planning_url}
PLANNING_USERNAME={username}
PLANNING_PASSWORD={password}

Note

AGENTCUBE_AUTH_MODE defaults to basic when not set. You do not need to set it explicitly.

Step 3: Connect Your AI Platform

Step 4: Verify

See Verification to confirm your deployment is working correctly.

Next Steps