Skip to main content

Overview

GDELT Cloud supports multiple authentication methods depending on your use case:
MethodUse CaseWhere
Session AuthWeb dashboard, interactive useBrowser
API KeysProgrammatic access, automationREST API, MCP Server

Session Authentication

Session authentication is used when accessing GDELT Cloud through the web dashboard.

How It Works

1

Login

Navigate to gdeltcloud.com/auth/sign-in and enter your credentials.
2

Session created

Upon successful login, a secure session cookie is created and stored in your browser.
3

Automatic authentication

All dashboard features and internal API calls are automatically authenticated using this session.
Sessions are powered by Supabase Auth and include automatic token refresh for seamless long-term use.

Session Security

  • Sessions expire after 7 days of inactivity
  • HTTPS-only cookies prevent interception
  • CSRF protection on all state-changing operations
  • Optional two-factor authentication (coming soon)