eiman-eltigani-ttd · Oct 29, 2025 · Oct 28, 2025 · Oct 28, 2025 · Oct 28, 2025 · Oct 28, 2025
diff --git a/.env.sample b/.env.sample
diff --git a/.env.sample.euid b/.env.sample.euid
@@ -0,0 +1,60 @@
+# ==============================================================================
+# EUID Environment Configuration
+# ==============================================================================
+# This file provides default EUID integration settings.
+# Edit the first section with your EUID credentials and keys.
+# The values in the bottom section are EUID-specific constants and should NOT 
+# be changed unless you are configuring for a different EUID environment.
+#
+# ⚠️ EDIT THESE VALUES FIRST - Your EUID Credentials ⚠️
+# ==============================================================================
+
+# Server-Side & Client-Server Examples - Provided by your EUID integration representative
+UID_API_KEY="your-api-key"
+UID_CLIENT_SECRET="your-client-secret"
+
+# Server-Side Examples - Any secure random string for session encryption
+SESSION_KEY="your-session-key-here"
+
+# Client-Side Token Generation (CSTG) - Provided by your EUID integration representative
+UID_CSTG_SERVER_PUBLIC_KEY="your-euid-server-public-key"
+UID_CSTG_SUBSCRIPTION_ID="your-euid-subscription-id"
+
+# React Client-Side Examples - Provided by your EUID integration representative
+# Note: These are the same values as the variables above, prefixed with REACT_APP_
+# for use in React applications. Use your same EUID credentials from above.
+REACT_APP_UID_CSTG_SERVER_PUBLIC_KEY="your-euid-server-public-key"
+REACT_APP_UID_CSTG_SUBSCRIPTION_ID="your-euid-subscription-id"
+
+# ==============================================================================
+# EUID Constants (Do NOT change unless working with different EUID environment)
+# ==============================================================================
+
+# API Endpoints (Integration environment)
+UID_SERVER_BASE_URL="https://integ.euid.eu" # ← For local development, use: http://host.docker.internal:8080
+UID_CLIENT_BASE_URL="https://integ.euid.eu" # ← For local development, use: http://localhost:8080
+
+# JavaScript SDK Configuration
+UID_JS_SDK_URL="https://cdn.integ.euid.eu/euid-sdk-4.0.1.js"
+UID_JS_SDK_NAME="__euid"
+
+# Google Secure Signals Configuration
+UID_SECURE_SIGNALS_SDK_URL="https://cdn.integ.euid.eu/euidSecureSignal.js"
+UID_SECURE_SIGNALS_STORAGE_KEY="_GESPSK-euid.eu"
+
+# Prebid Configuration
+UID_STORAGE_KEY="__euid_advertising_token"
+
+# UI Display Configuration
+IDENTITY_NAME="EUID"
+DOCS_BASE_URL="https://euid.eu/docs"
+
+
+# React Constants (for React-based examples)
+REACT_APP_UID_CLIENT_BASE_URL="https://integ.euid.eu" # ← For local development, use: http://localhost:8080
+REACT_APP_UID_JS_SDK_NAME="__euid"
+REACT_APP_UID_SECURE_SIGNALS_SDK_URL="https://cdn.integ.euid.eu/euidSecureSignal.js"
+REACT_APP_UID_SECURE_SIGNALS_STORAGE_KEY="_GESPSK-euid.eu"
+REACT_APP_IDENTITY_NAME="EUID"
+REACT_APP_DOCS_BASE_URL="https://euid.eu/docs"
+
diff --git a/.env.sample.uid2 b/.env.sample.uid2
@@ -0,0 +1,58 @@
+# ==============================================================================
+# UID2 Environment Configuration
+# ==============================================================================
+# This file provides default UID2 integration settings.
+# Edit the first section with your UID2 credentials and keys.
+# The values in the bottom section are UID2-specific constants and should NOT 
+# be changed unless you are configuring for a different UID2 environment.
+#
+# ⚠️ EDIT THESE VALUES FIRST - Your UID2 Credentials ⚠️
+# ==============================================================================
+
+# Server-Side & Client-Server Examples 
+UID_API_KEY="your-api-key"
+UID_CLIENT_SECRET="your-client-secret"
+
+# Server-Side Examples - Any secure random string for session encryption
+SESSION_KEY="your-session-key-here"
+
+# Client-Side Token Generation (CSTG)
+UID_CSTG_SERVER_PUBLIC_KEY="UID2-X-I-MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEo+jcPlk8GWn3iG0R5Il2cbFQI9hR3TvHxaBUKHl5Vh+ugr+9uLMiXihka8To07ETFGghEifY96Hrpe5RnYko7Q=="
+UID_CSTG_SUBSCRIPTION_ID="DMr7uHxqLU"
+
+# React Client-Side Examples
+# Note: These are the same values as the variables above, prefixed with REACT_APP_
+# for use in React applications. Use your same UID2 credentials from above.
+REACT_APP_UID_CSTG_SERVER_PUBLIC_KEY="UID2-X-I-MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEo+jcPlk8GWn3iG0R5Il2cbFQI9hR3TvHxaBUKHl5Vh+ugr+9uLMiXihka8To07ETFGghEifY96Hrpe5RnYko7Q=="
+REACT_APP_UID_CSTG_SUBSCRIPTION_ID="DMr7uHxqLU"
+
+# ==============================================================================
+# UID2 Constants (Do NOT change unless working with different UID2 environment)
+# ==============================================================================
+
+# API Endpoints (Integration environment)
+UID_SERVER_BASE_URL="https://operator-integ.uidapi.com" # ← For local development, use: http://host.docker.internal:8080
+UID_CLIENT_BASE_URL="https://operator-integ.uidapi.com" # ← For local development, use: http://localhost:8080
+
+# JavaScript SDK Configuration
+UID_JS_SDK_URL="https://cdn.integ.uidapi.com/uid2-sdk-4.0.1.js"
+UID_JS_SDK_NAME="__uid2"
+
+# Google Secure Signals Configuration
+UID_SECURE_SIGNALS_SDK_URL="https://cdn.integ.uidapi.com/uid2SecureSignal.js"
+UID_SECURE_SIGNALS_STORAGE_KEY="_GESPSK-uidapi.com"
+
+# Prebid Configuration
+UID_STORAGE_KEY="__uid2_advertising_token"
+
+# UI Display Configuration
+IDENTITY_NAME="UID2"
+DOCS_BASE_URL="https://unifiedid.com/docs"
+
+# React Constants (for React-based examples)
+REACT_APP_UID_CLIENT_BASE_URL="https://operator-integ.uidapi.com" # ← For local development, use: http://localhost:8080
+REACT_APP_UID_JS_SDK_NAME="__uid2"
+REACT_APP_UID_SECURE_SIGNALS_SDK_URL="https://cdn.integ.uidapi.com/uid2SecureSignal.js"
+REACT_APP_UID_SECURE_SIGNALS_STORAGE_KEY="_GESPSK-uidapi.com"
+REACT_APP_IDENTITY_NAME="UID2"
+REACT_APP_DOCS_BASE_URL="https://unifiedid.com/docs"
diff --git a/README.md b/README.md
@@ -77,15 +77,32 @@ docker-compose up -d --build prebid-client
 
 ### Environment Configuration
 
-Edit the `.env` file in the base directory to configure your UID2 settings:
-```
-# UID2 Configuration for all services
-UID2_BASE_URL="http://localhost:8080"
-SERVER_PUBLIC_KEY="your-public-key"
-SUBSCRIPTION_ID="your-subscription-id"
-
-# Additional variables for client-server example
-UID2_API_KEY="your-api-key"
-UID2_CLIENT_SECRET="your-client-secret"
-```
+This repository includes sample environment files for both UID2 and EUID configurations:
+
+- **`.env.sample.uid2`** - UID2 configuration template
+- **`.env.sample.euid`** - EUID configuration template
+
+**To get started:**
+
+1. Copy the appropriate sample file to `.env`:
+   ```bash
+   # For UID2
+   cp .env.sample.uid2 .env
+
+   # For EUID
+   cp .env.sample.euid .env
+   ```
+
+2. Update the `.env` file with your credentials:
+   - Replace `your-api-key` with your actual API key
+   - Replace `your-client-secret` with your actual client secret
+   - Update other placeholder values as needed
+
+The sample files include all necessary environment variables for running the examples, including configuration for:
+- Core API endpoints
+- JavaScript SDK settings
+- Google Secure Signals integration
+- Prebid integration
+- React client examples
+- UI/Display preferences