Service Module

The Service Module enables Binacle.Net to function as a managed service in public environments, providing:

• ✅ Rate limiting
• ✅ User management
• ✅ Authentication

Authenticated users can bypass rate limits, ensuring seamless access to API endpoints.

This module is disabled by default.

While Binacle.Net is primarily designed for private cloud hosting, the Service Module enables controlled public deployment by balancing performance, security, and cost-effectiveness.

⚙️ Configuration

All configuration files for the Service Module are located in the /app/Config_Files/ServiceModule directory.

📑 Directory Structure

app
└── Config_Files
    └── ServiceModule
        ├── ConnectionStrings.json
        ├── JwtAuth.json
        ├── RateLimiter.json
        └── Users.json

🗄️ Database

The Service Module relies on a database to manage users. You must configure a database for proper operation.

🔗 Learn more about database configuration →

🔐 Authentication

The module uses stateless JWT tokens for authentication. Users authenticate using their email and password to receive a token.

🔗 See authentication configuration →

👥 Users

When the Service Module is first enabled, a default admin user is created.

🔗 Users configuration guide →

📊 Rate Limiter

To prevent excessive requests, unauthenticated users are rate-limited.

🔗 Configure rate limiting →

📡 API Endpoints

Once enabled, the Service Module exposes additional API endpoints for user authentication and management.

🔗 See User’s API details →

🔧 Activating the Service Module

To enable the Service Module, set the environment variable:

SERVICE_MODULE=True