eric/onix
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Issue 530 - docs: update SETUP.md and README.md

Browse Source
This commit is contained in:
ameersohel45
2025-10-10 12:30:38 +05:30
parent 64f5f550c0
commit 08ea8bf10d
2 changed files with 265 additions and 259 deletions
Download Patch File Download Diff File Expand all files Collapse all files

71
README.md
View File

@@ -118,19 +118,23 @@ The **Beckn Protocol** is an open protocol that enables location-aware, local co
#### 3. **Plugin Types** #### 3. **Plugin Types**
- **Cache**: Redis-based response caching - **Cache**: Redis-based response caching
- **Router**: YAML-based routing rules engine - **Router**: YAML-based routing rules engine for request forwarding
- **Signer/SignValidator**: Ed25519 signature handling - **Signer**: Ed25519 digital signature creation for outgoing requests
- **SignValidator**: Ed25519 signature validation for incoming requests
- **SchemaValidator**: JSON schema validation - **SchemaValidator**: JSON schema validation
- **KeyManager**: HashiCorp Vault integration - **KeyManager**: HashiCorp Vault integration for production key management
- **Publisher**: RabbitMQ message publishing - **SimpleKeyManager**: Embedded key management for local development (no external dependencies)
- **Encrypter/Decrypter**: AES encryption/decryption - **Publisher**: RabbitMQ message publishing for asynchronous processing
- **Encrypter**: AES encryption for sensitive data protection
- **Decrypter**: AES decryption for encrypted data processing
- **ReqPreprocessor**: Request preprocessing (UUID generation, headers) - **ReqPreprocessor**: Request preprocessing (UUID generation, headers)
- **Registry**: Standard Beckn registry lookup for participant information
- **DeDiRegistry**: DeDi registry to lookup public keys for NP.
## Quick Start ## Quick Start
### Prerequisites ### Prerequisites
- Go 1.23 or higher - Go 1.24 or higher
- Redis (for caching) - Redis (for caching)
- Docker (optional, for containerized deployment) - Docker (optional, for containerized deployment)
- HashiCorp Vault (optional, for production key management) - HashiCorp Vault (optional, for production key management)
@@ -151,21 +155,54 @@ go build -o server cmd/adapter/main.go
3. **Build plugins** 3. **Build plugins**
```bash ```bash
./build-plugins.sh ./install/build-plugins.sh
``` ```
4. **Start Redis** (if not running) 4. **Extract schemas**
```bash
unzip schemas.zip
```
5. **Start Redis** (if not running)
```bash ```bash
docker run -d -p 6379:6379 redis:alpine docker run -d -p 6379:6379 redis:alpine
``` ```
5. **Run the application** 6. **Run the application**
**Note**: You can modify the configuration file to suit your environment before starting the server.
```bash ```bash
./server --config=config/local-dev.yaml ./server --config=config/local-simple.yaml
``` ```
The server will start on `http://localhost:8081` The server will start on `http://localhost:8081`
### Automated Setup (Recommended)
For local setup ,starts only redis and onix adapter:
```bash
# Clone and setup everything automatically
git clone https://github.com/beckn/beckn-onix.git
cd beckn-onix/install
chmod +x setup.sh
./setup.sh
```
This automated script will:
- Start Redis container
- Build all plugins with correct Go version
- Build the adapter server
- Start ONIX adapter in Docker
- Create environment configuration
**Note:** Extract schemas before running: `unzip schemas.zip` (required for schema validation)
**Services Started:**
- Redis: localhost:6379
- ONIX Adapter: http://localhost:8081
### Docker Deployment ### Docker Deployment
```bash ```bash
@@ -173,9 +210,11 @@ The server will start on `http://localhost:8081`
docker build -f Dockerfile.adapter -t beckn-onix:latest . docker build -f Dockerfile.adapter -t beckn-onix:latest .
# Run the container # Run the container
docker run -p 8080:8080 \ docker run -p 8081:8081 \
-v $(pwd)/config:/app/config \ -v $(pwd)/config:/app/config \
-v $(pwd)/schemas:/app/schemas \ -v $(pwd)/schemas:/app/schemas \
-v $(pwd)/plugins:/app/plugins \
-e CONFIG_FILE="/app/config/local-simple.yaml" \
beckn-onix:latest beckn-onix:latest
``` ```
@@ -186,14 +225,13 @@ docker run -p 8080:8080 \
```bash ```bash
curl -X POST http://localhost:8081/bap/caller/search \ curl -X POST http://localhost:8081/bap/caller/search \
-H "Content-Type: application/json" \ -H "Content-Type: application/json" \
-H "Authorization: Signature keyId=\"bap.example.com|key1|ed25519\",algorithm=\"ed25519\",created=\"1234567890\",expires=\"1234567990\",headers=\"(created) (expires) digest\",signature=\"base64signature\"" \
-d '{ -d '{
"context": { "context": {
"domain": "nic2004:60221", "domain": "nic2004:60221",
"country": "IND", "country": "IND",
"city": "std:080", "city": "std:080",
"action": "search", "action": "search",
"core_version": "0.9.4", "version": "0.9.4",
"bap_id": "bap.example.com", "bap_id": "bap.example.com",
"bap_uri": "https://bap.example.com/beckn", "bap_uri": "https://bap.example.com/beckn",
"transaction_id": "550e8400-e29b-41d4-a716-446655440000", "transaction_id": "550e8400-e29b-41d4-a716-446655440000",
@@ -265,10 +303,11 @@ modules:
### Deployment Modes ### Deployment Modes
1. **Combined Mode**: Single instance handling both BAP and BPP (`config/onix/`) 1. **Combined Mode**: Single instance handling both BAP and BPP (`config/onix/`) - Uses `secretskeymanager` (HashiCorp Vault) for production key management
2. **BAP-Only Mode**: Dedicated buyer-side deployment (`config/onix-bap/`) 2. **BAP-Only Mode**: Dedicated buyer-side deployment (`config/onix-bap/`)
3. **BPP-Only Mode**: Dedicated seller-side deployment (`config/onix-bpp/`) 3. **BPP-Only Mode**: Dedicated seller-side deployment (`config/onix-bpp/`)
4. **Local Development**: Simplified configuration (`config/local-dev.yaml`) 4. **Local Development Combined Mode**: Simplified configuration (`config/local-simple.yaml`) - Uses `simplekeymanager` with embedded Ed25519 keys, no vault setup needed.
5. **Local Development Combined Mode (Alternative)**: Development configuration (`config/local-dev.yaml`) - Uses `keymanager` vault setup needed
## API Endpoints ## API Endpoints

431
SETUP.md
View File

@@ -61,35 +61,78 @@ redis-cli --version
## Quick Start (Recommended) ## Quick Start (Recommended)
For a complete Beckn network setup with all services, use our automated setup: ### Option 1: ONIX Adapter Only (Fastest)
For just the ONIX adapter with Redis (no Vault required):
```bash ```bash
# Clone the repository # Clone the repository
git clone https://github.com/beckn/beckn-onix.git git clone https://github.com/beckn/beckn-onix.git
cd beckn-onix cd beckn-onix/install
# Run the setup (includes only adapter services) # Run the automated setup
cd install
chmod +x setup.sh chmod +x setup.sh
./setup.sh ./setup.sh
# Start the Beckn-ONIX server
source .env.vault && ./server --config=config/local-dev.yaml
``` ```
This will automatically: This will automatically:
- Run & Configure Redis and Vault - Start Redis container
- Build all plugins - Build all plugins
- Set up authentication - Build adapter server
- Create environment variables - Start ONIX adapter in Docker using `local-simple.yaml` (with `simplekeymanager`)
- Create .env file
**Services Started:** **Services Started:**
- Vault: http://localhost:8200
- Redis: localhost:6379 - Redis: localhost:6379
- Beckn-ONIX: http://localhost:8081 - ONIX Adapter: http://localhost:8081
**To stop all services:** `docker compose down` **Key Management:** Uses `simplekeymanager` with embedded keys - no Vault setup required!
**To view logs:** `docker compose logs -f [service-name]`
**Note:** Extract schemas before running: `unzip schemas.zip` (required for schema validation)
### Option 2: Complete Beckn Network
For a full local Beckn network with all components:
```bash
cd beckn-onix/install
chmod +x beckn-onix.sh
./beckn-onix.sh
# Choose option 3: "Set up a network on your local machine"
```
This will automatically:
- Install and configure Registry service
- Install and configure Gateway service
- Create BAP Protocol Server registry entries
- Create BPP Protocol Server registry entries
- Build ONIX adapter plugins
- **Detect config file** from `docker-compose-adapter2.yml`
- **Extract keys** from protocol server configs (`bap-client.yml`, `bpp-client.yml`)
- **Auto-update simplekeymanager** in the detected config file with extracted keys
- Start ONIX Adapter with Redis
**Services Started:**
- Registry: http://localhost:3030
- Gateway: http://localhost:4030
- Sandbox API: http://localhost:3000
- ONIX Adapter: http://localhost:8081
- Redis: localhost:6379
**Note:** Extract schemas before running: `unzip schemas.zip` (required for schema validation)
**Intelligent Key Management:**
The script reads `docker-compose-adapter2.yml` to detect which config file is being used (default: `local-simple.yaml`), extracts keys from protocol server configs, and automatically updates the `simplekeymanager` section in that config file - no manual configuration needed!
**Note:** Update `docker-compose-adapter2.yml` to use the correct config file:
- For combined setup (simplekeymanager): `CONFIG_FILE: "/app/config/local-simple.yaml"`
- For combined setup (keymanager with Vault): `CONFIG_FILE: "/app/config/local-dev.yaml"`
- For combined setup (production): `CONFIG_FILE: "/app/config/onix/adapter.yaml"`
- For BAP only: `CONFIG_FILE: "/app/config/onix-bap/adapter.yaml"`
- For BPP only: `CONFIG_FILE: "/app/config/onix-bpp/adapter.yaml"`
The script will automatically detect and configure whichever file you specify.
--- ---
@@ -130,7 +173,7 @@ The application uses a plugin architecture. Build all plugins:
# Make the build script executable # Make the build script executable
chmod +x install/build-plugins.sh chmod +x install/build-plugins.sh
# Build all plugins # Build all plugins (run from project root)
./install/build-plugins.sh ./install/build-plugins.sh
``` ```
@@ -141,7 +184,10 @@ This creates `.so` files in the `plugins/` directory:
- `signvalidator.so` - Signature validation - `signvalidator.so` - Signature validation
- `schemavalidator.so` - JSON schema validation - `schemavalidator.so` - JSON schema validation
- `keymanager.so` - Vault integration - `keymanager.so` - Vault integration
- `simplekeymanager.so` - Simple key management (no Vault)
- `publisher.so` - RabbitMQ publishing - `publisher.so` - RabbitMQ publishing
- `registry.so` - Registry lookup
- `dediregistry.so` - registry type plugin for public key lookup
- `encrypter.so` / `decrypter.so` - Encryption/decryption - `encrypter.so` / `decrypter.so` - Encryption/decryption
- `reqpreprocessor.so` - Request preprocessing - `reqpreprocessor.so` - Request preprocessing
@@ -177,221 +223,102 @@ redis-cli ping
# Expected: PONG # Expected: PONG
``` ```
### Step 6: Create Required Directories ### Step 6: Setup Schemas
```bash ```bash
# Create schemas directory for validation # Create schemas directory
mkdir -p schemas mkdir -p schemas
# Extract schemas from the provided schemas.zip
unzip schemas.zip
# Create logs directory (optional) # Create logs directory (optional)
mkdir -p logs mkdir -p logs
``` ```
**Note:** The `schemas.zip` file is included in the repository. You must extract it before running the adapter for schema validation to work.
### Step 7: Configure for Local Development ### Step 7: Configure for Local Development
Create or modify `config/local-dev.yaml`: For local development, use the existing `config/local-simple.yaml` which includes:
- All 4 modules (BAP + BPP)
- Simple key management (no Vault required)
- Redis caching
- Basic routing configuration
```yaml The file is pre-configured with embedded sample keys and ready to use for standalone testing.
appName: "onix-local"
log:
level: debug
destinations:
- type: stdout
contextKeys:
- transaction_id
- message_id
- subscriber_id
- module_id
http:
port: 8081
timeout:
read: 30
write: 30
idle: 30
pluginManager:
root: ./plugins
modules:
- name: bapTxnReceiver
path: /bap/receiver/
handler:
type: std
role: bap
registryUrl: http://localhost:8080/reg
plugins:
keyManager:
id: keymanager
config:
projectID: beckn-onix-local
vaultAddr: http://localhost:8200
kvVersion: v2
mountPath: beckn
cache:
id: cache
config:
addr: localhost:6379
schemaValidator:
id: schemavalidator
config:
schemaDir: ./schemas
signValidator:
id: signvalidator
config:
publicKeyPath: beckn/keys
router:
id: router
config:
routingConfig: ./config/local-routing.yaml
middleware:
- id: reqpreprocessor
config:
uuidKeys: transaction_id,message_id
role: bap
steps:
- validateSign
- addRoute
- validateSchema
- name: bapTxnCaller **Note:** When using `beckn-onix.sh` (Option 2 in Quick Start), the script automatically extracts keys from protocol server configs and updates the `simplekeymanager` section in this file - no manual configuration needed!
path: /bap/caller/
handler:
type: std
role: bap
registryUrl: http://localhost:8080/reg
plugins:
keyManager:
id: keymanager
config:
projectID: beckn-onix-local
vaultAddr: http://localhost:8200
kvVersion: v2
mountPath: beckn
cache:
id: cache
config:
addr: localhost:6379
router:
id: router
config:
routingConfig: ./config/local-routing.yaml
signer:
id: signer
middleware:
- id: reqpreprocessor
config:
uuidKeys: transaction_id,message_id
role: bap
steps:
- addRoute
- sign
- name: bppTxnReceiver ### Step 8: Configuration Files Overview
path: /bpp/receiver/
handler:
type: std
role: bpp
registryUrl: http://localhost:8080/reg
plugins:
keyManager:
id: keymanager
config:
projectID: beckn-onix-local
vaultAddr: http://localhost:8200
kvVersion: v2
mountPath: beckn
cache:
id: cache
config:
addr: localhost:6379
schemaValidator:
id: schemavalidator
config:
schemaDir: ./schemas
signValidator:
id: signvalidator
config:
publicKeyPath: beckn/keys
router:
id: router
config:
routingConfig: ./config/local-routing.yaml
steps:
- validateSign
- addRoute
- validateSchema
- name: bppTxnCaller The `config/` directory contains deployment configurations:
path: /bpp/caller/
handler: ```
type: std config/
role: bpp ├── local-dev.yaml # Local development with Vault
registryUrl: http://localhost:8080/reg ├── local-simple.yaml # Local development (no Vault)
plugins: ├── local-routing.yaml # Local routing rules
keyManager: ├── local-simple-routing.yaml # Simple routing rules
id: keymanager ├── local-simple-routing-BAPCaller.yaml # BAP caller routing
config: ├── local-simple-routing-BPPReceiver.yaml # BPP receiver routing
projectID: beckn-onix-local ├── onix/ # Combined BAP+BPP deployment
vaultAddr: http://localhost:8200 │ ├── adapter.yaml
kvVersion: v2 │ ├── plugin.yaml
mountPath: beckn │ ├── bapTxnCaller-routing.yaml
cache: │ ├── bapTxnReciever-routing.yaml
id: cache │ ├── bppTxnCaller-routing.yaml
config: │ └── bppTxnReciever-routing.yaml
addr: localhost:6379 ├── onix-bap/ # BAP-only deployment
router: │ ├── adapter.yaml
id: router │ ├── plugin.yaml
config: │ ├── bapTxnCaller-routing.yaml
routingConfig: ./config/local-routing.yaml │ └── bapTxnReciever-routing.yaml
signer: └── onix-bpp/ # BPP-only deployment
id: signer ├── adapter.yaml
steps: ├── plugin.yaml
- addRoute ├── bppTxnCaller-routing.yaml
- sign └── bppTxnReciever-routing.yaml
``` ```
### Step 8: Create Routing Configuration Routing configuration files for local-simple are already provided and referenced in `local-simple.yaml`.
Create `config/local-routing.yaml`:
```yaml ### Step 9: Run the Application
routingRules:
- domain: "nic2004:60221" # Mobility domain
version: "0.9.4"
targetType: "url"
target:
url: "http://localhost:9001/beckn"
endpoints:
- search
- select
- init
- confirm
- status
- track
- cancel
- update
- rating
- support
- domain: "nic2004:52110" # Retail domain **Choose your key management approach:**
version: "1.0.0"
targetType: "url" #### Option A: Simple Key Manager (Recommended for Local Development)
target:
url: "http://localhost:9002/beckn" **No Vault setup required!** Use this for quick local testing.
endpoints:
- search ```bash
- select # Run with local-simple.yaml (uses simplekeymanager plugin)
- init ./server --config=config/local-simple.yaml
- confirm
- status # Or run with go
- track go run cmd/adapter/main.go --config=config/local-simple.yaml
- cancel
- update
- rating
- support
``` ```
### Step 9: Run the Application with HashiCorp Vault The `local-simple.yaml` config uses `simplekeymanager` plugin with embedded keys - no external dependencies needed.
Since the configuration now includes the keyManager plugin for signing capabilities, you need to set up Vault: **With Docker:**
```bash
cd install
docker compose -f docker-compose-adapter2.yml up -d
```
The server will start on `http://localhost:8081`
---
#### Option B: HashiCorp Vault (Production-like Setup)
**Only use this if your config has `keymanager` plugin (not `simplekeymanager`).**
Configs that require Vault:
- `config/local-dev.yaml` - uses `keymanager` plugin
- `config/onix/adapter.yaml` - uses `secretskeymanager` plugin
#### Quick Setup (Recommended) #### Quick Setup (Recommended)
@@ -552,6 +479,7 @@ curl http://localhost:8081/bap/receiver/
--- ---
## Production Setup ## Production Setup
### Additional Requirements for Production ### Additional Requirements for Production
@@ -799,22 +727,29 @@ sudo systemctl status beckn-onix
``` ```
config/ config/
├── local-dev.yaml # Local development ├── local-dev.yaml # Local development with Vault
├── local-simple.yaml # Local development (no Vault)
├── local-routing.yaml # Local routing rules ├── local-routing.yaml # Local routing rules
├── onix/ # Combined BAP+BPP ├── local-simple-routing.yaml # Simple routing rules
├── local-simple-routing-BAPCaller.yaml # BAP caller routing
├── local-simple-routing-BPPReceiver.yaml # BPP receiver routing
├── onix/ # Combined BAP+BPP deployment
│ ├── adapter.yaml │ ├── adapter.yaml
│ ├── plugin.yaml
│ ├── bapTxnCaller-routing.yaml │ ├── bapTxnCaller-routing.yaml
│ ├── bapTxnReceiver-routing.yaml │ ├── bapTxnReciever-routing.yaml
│ ├── bppTxnCaller-routing.yaml │ ├── bppTxnCaller-routing.yaml
│ └── bppTxnReceiver-routing.yaml │ └── bppTxnReciever-routing.yaml
├── onix-bap/ # BAP-only deployment ├── onix-bap/ # BAP-only deployment
│ ├── adapter.yaml │ ├── adapter.yaml
│ ├── plugin.yaml
│ ├── bapTxnCaller-routing.yaml │ ├── bapTxnCaller-routing.yaml
│ └── bapTxnReceiver-routing.yaml │ └── bapTxnReciever-routing.yaml
└── onix-bpp/ # BPP-only deployment └── onix-bpp/ # BPP-only deployment
├── adapter.yaml ├── adapter.yaml
├── plugin.yaml
├── bppTxnCaller-routing.yaml ├── bppTxnCaller-routing.yaml
└── bppTxnReceiver-routing.yaml └── bppTxnReciever-routing.yaml
``` ```
### Module Configuration ### Module Configuration
@@ -1042,12 +977,28 @@ Open `http://localhost:3000` in your browser.
# Build the image # Build the image
docker build -f Dockerfile.adapter -t beckn-onix:latest . docker build -f Dockerfile.adapter -t beckn-onix:latest .
# Tag for registry # Tag for registry (optional)
docker tag beckn-onix:latest registry.example.com/beckn-onix:v1.0.0 docker tag beckn-onix:latest registry.example.com/beckn-onix:v1.0.0
``` ```
### Docker Compose Setup ### Docker Compose Setup
**Important: Create docker.yaml config and plugins bundle first**
```bash
# Create symlink to existing config
cd config
ln -s onix/adapter.yaml docker.yaml
cd ..
# Build plugins first
./install/build-plugins.sh
# Create plugins bundle for Docker
cd plugins
zip -r plugins_bundle.zip *.so
cd ..
```
Create `docker-compose.yml`: Create `docker-compose.yml`:
```yaml ```yaml
@@ -1063,7 +1014,7 @@ services:
command: redis-server --appendonly yes command: redis-server --appendonly yes
vault: vault:
image: vault:1.15 image: hashicorp/vault:latest
ports: ports:
- "8200:8200" - "8200:8200"
environment: environment:
@@ -1088,7 +1039,7 @@ services:
beckn-onix: beckn-onix:
image: beckn-onix:latest image: beckn-onix:latest
ports: ports:
- "8080:8080" - "8081:8081"
depends_on: depends_on:
- redis - redis
- vault - vault
@@ -1103,7 +1054,7 @@ services:
volumes: volumes:
- ./config:/app/config - ./config:/app/config
- ./schemas:/app/schemas - ./schemas:/app/schemas
- ./plugins:/app/plugins - ./plugins:/mnt/gcs/plugins
command: ["./server", "--config=/app/config/docker.yaml"] command: ["./server", "--config=/app/config/docker.yaml"]
volumes: volumes:
@@ -1112,8 +1063,12 @@ volumes:
rabbitmq-data: rabbitmq-data:
``` ```
Run with: **Important: Build the image first**
```bash ```bash
# Build the beckn-onix image before running docker-compose
docker build -f Dockerfile.adapter -t beckn-onix:latest .
# Then run docker-compose
docker-compose up -d docker-compose up -d
``` ```
@@ -1313,17 +1268,16 @@ curl http://localhost:8081/health
### Test Search Request ### Test Search Request
```bash ```bash
# Create a test search request # Create a test search request (no Authorization header needed - ONIX auto-generates it)
curl -X POST http://localhost:8081/bap/caller/search \ curl -X POST http://localhost:8081/bap/caller/search \
-H "Content-Type: application/json" \ -H "Content-Type: application/json" \
-H "Authorization: Signature keyId=\"test.bap.com|key1|ed25519\",algorithm=\"ed25519\",created=\"$(date +%s)\",expires=\"$(date -d '+5 minutes' +%s)\",headers=\"(created) (expires) digest\",signature=\"test-signature\"" \
-d '{ -d '{
"context": { "context": {
"domain": "nic2004:52110", "domain": "nic2004:52110",
"country": "IND", "country": "IND",
"city": "std:080", "city": "std:080",
"action": "search", "action": "search",
"core_version": "1.0.0", "version": "1.0.0",
"bap_id": "test.bap.com", "bap_id": "test.bap.com",
"bap_uri": "https://test.bap.com/beckn", "bap_uri": "https://test.bap.com/beckn",
"transaction_id": "'$(uuidgen)'", "transaction_id": "'$(uuidgen)'",
@@ -1363,9 +1317,8 @@ Use Apache Bench or similar tools:
# Install ab # Install ab
sudo apt-get install apache2-utils sudo apt-get install apache2-utils
# Simple load test # Simple load test (no Authorization header needed - ONIX auto-generates it)
ab -n 1000 -c 10 -p search.json -T application/json \ ab -n 1000 -c 10 -p search.json -T application/json \
-H "Authorization: Signature keyId=\"test|key1|ed25519\",..." \
http://localhost:8081/bap/caller/search http://localhost:8081/bap/caller/search
``` ```
@@ -1417,8 +1370,8 @@ done
**Solution**: **Solution**:
```bash ```bash
# Rebuild plugins # Rebuild plugins from project root
./build-plugins.sh ./install/build-plugins.sh
# Check plugin files exist # Check plugin files exist
ls -la plugins/ ls -la plugins/
@@ -1428,6 +1381,18 @@ go version
file plugins/cache.so file plugins/cache.so
``` ```
**Error**: `plugin was built with a different version of package internal/godebugs`
**Solution**: Plugin version mismatch - rebuild with same Go version:
```bash
# Clean and rebuild plugins
rm -rf plugins/*.so
./install/build-plugins.sh
# Ensure same Go version for server and plugins
go version
```
#### 2. Redis Connection Issues #### 2. Redis Connection Issues
**Error**: `dial tcp 127.0.0.1:6379: connect: connection refused` **Error**: `dial tcp 127.0.0.1:6379: connect: connection refused`
@@ -1570,7 +1535,7 @@ redis-cli CONFIG SET timeout 300
"country": "IND", "country": "IND",
"city": "std:080", "city": "std:080",
"action": "search", "action": "search",
"core_version": "1.0.0", "version": "1.0.0",
"bap_id": "buyerapp.com", "bap_id": "buyerapp.com",
"bap_uri": "https://buyerapp.com/beckn", "bap_uri": "https://buyerapp.com/beckn",
"transaction_id": "6d5f4c3b-2a1e-4b8c-9f7d-3e2a1b5c8d9f", "transaction_id": "6d5f4c3b-2a1e-4b8c-9f7d-3e2a1b5c8d9f",
@@ -1612,7 +1577,7 @@ redis-cli CONFIG SET timeout 300
"country": "IND", "country": "IND",
"city": "std:080", "city": "std:080",
"action": "select", "action": "select",
"core_version": "1.0.0", "version": "1.0.0",
"bap_id": "buyerapp.com", "bap_id": "buyerapp.com",
"bap_uri": "https://buyerapp.com/beckn", "bap_uri": "https://buyerapp.com/beckn",
"bpp_id": "sellerapp.com", "bpp_id": "sellerapp.com",
@@ -1676,7 +1641,7 @@ redis-cli CONFIG SET timeout 300
"country": "IND", "country": "IND",
"city": "std:080", "city": "std:080",
"action": "init", "action": "init",
"core_version": "1.0.0", "version": "1.0.0",
"bap_id": "buyerapp.com", "bap_id": "buyerapp.com",
"bap_uri": "https://buyerapp.com/beckn", "bap_uri": "https://buyerapp.com/beckn",
"bpp_id": "sellerapp.com", "bpp_id": "sellerapp.com",
@@ -1780,7 +1745,7 @@ redis-cli CONFIG SET timeout 300
"country": "IND", "country": "IND",
"city": "std:080", "city": "std:080",
"action": "confirm", "action": "confirm",
"core_version": "1.0.0", "version": "1.0.0",
"bap_id": "buyerapp.com", "bap_id": "buyerapp.com",
"bap_uri": "https://buyerapp.com/beckn", "bap_uri": "https://buyerapp.com/beckn",
"bpp_id": "sellerapp.com", "bpp_id": "sellerapp.com",
@@ -1953,13 +1918,15 @@ redis-cli CONFIG SET timeout 300
### Authorization Header Structure ### Authorization Header Structure
All requests must include proper authorization: **Note:** ONIX adapter automatically generates and adds the Authorization signature header to outgoing requests. You don't need to manually create it when calling ONIX endpoints.
For reference, the Authorization header format is:
``` ```
Authorization: Signature keyId="{subscriber_id}|{key_id}|{algorithm}",algorithm="{algorithm}",created="{created}",expires="{expires}",headers="(created) (expires) digest",signature="{base64_signature}" Authorization: Signature keyId="{subscriber_id}|{key_id}|{algorithm}",algorithm="{algorithm}",created="{created}",expires="{expires}",headers="(created) (expires) digest",signature="{base64_signature}"
``` ```
Example generation in bash: Example of how ONIX generates it internally:
```bash ```bash
#!/bin/bash #!/bin/bash